알려진 문제 및 모범 사례 고려 사항 best-practices-known-issues-and-limitations

커뮤니케이션 API 사용을 시작하기 전에 다음 고려 사항, 알려진 문제 및 자주 묻는 질문을 검토하십시오.

고려 사항 considerations-for-communications-apis

양식 데이터 form-data

커뮤니케이션 API는 일반적으로 Designer에서 생성되는 양식 디자인과 XML 양식 데이터를 모두 입력으로 허용합니다. 문서로 데이터를 채우려면 채울 모든 양식 필드에 대해 XML 요소가 XML 양식 데이터에 있어야 합니다. XML 요소 이름은 필드 이름과 일치해야 합니다. XML 요소가 양식 필드에 해당하지 않거나 XML 요소 이름이 필드 이름과 일치하지 않으면 XML 요소가 무시됩니다. XML 요소가 표시되는 순서를 일치시킬 필요는 없습니다. 중요한 요소는 XML 요소가 해당 값으로 지정된다는 것입니다.

다음 예시 대출 신청 양식을 고려하십시오.

이 양식 디자인에 데이터를 병합하려면 양식에 해당하는 XML 데이터 소스를 만듭니다. 다음 XML은 예제 담보 대출 신청 양식에 해당하는 XML 데이터 소스를 나타냅니다.

<?xml version="1.0" encoding="UTF-8" ?>
- <xfa:datasets xmlns:xfa="http://www.xfa.org/schema/xfa-data/1.0/">
- <xfa:data>
- <data>
    - <Layer>
        <closeDate>1/26/2007</closeDate>
        <lastName>Johnson</lastName>
        <firstName>Jerry</firstName>
        <mailingAddress>JJohnson@NoMailServer.com</mailingAddress>
        <city>New York</city>
        <zipCode>00501</zipCode>
        <state>NY</state>
        <dateBirth>26/08/1973</dateBirth>
        <middleInitials>D</middleInitials>
        <socialSecurityNumber>(555) 555-5555</socialSecurityNumber>
        <phoneNumber>5555550000</phoneNumber>
    </Layer>
    - <Mortgage>
        <mortgageAmount>295000.00</mortgageAmount>
        <monthlyMortgagePayment>1724.54</monthlyMortgagePayment>
        <purchasePrice>300000</purchasePrice>
        <downPayment>5000</downPayment>
        <term>25</term>
        <interestRate>5.00</interestRate>
    </Mortgage>
</data>
</xfa:data>
</xfa:datasets>

지원되는 문서 유형 supported-document-types

통신 API의 렌더링 기능에 완전히 액세스하려면 XDP 파일을 입력으로 사용하는 것이 좋습니다. 경우에 따라 PDF 파일을 사용할 수 있습니다. 그러나 PDF 파일을 입력으로 사용하는 데에는 다음과 같은 제한 사항이 있습니다.

XFA 스트림이 포함되지 않은 PDF 문서는 PostScript, PCL 또는 ZPL로 렌더링할 수 없습니다. 통신 API는 XFA 스트림(즉, Designer에서 생성된 양식)을 사용하는 PDF 문서를 레이저 및 레이블 형식으로 렌더링할 수 있습니다. PDF 문서에 서명, 인증 또는 사용 권한이 포함된 경우(AEM Forms Reader 확장 서비스를 사용하여 적용됨) 이러한 인쇄 형식으로 렌더링할 수 없습니다.

인쇄 가능 영역 printable-areas

기본 0.25인치 인쇄할 수 없는 여백은 라벨 프린터에 대해 정확하지 않으며 프린터마다 라벨 크기마다 다르지만 0.25인치 여백을 유지하거나 줄이는 것이 좋습니다. 그러나 인쇄할 수 없는 여백은 증가시키지 않는 것이 좋습니다. 그렇지 않으면 인쇄 가능 영역의 정보가 제대로 인쇄되지 않습니다.

항상 프린터에 올바른 XDC 파일을 사용하는지 확인하십시오. 예를 들어 300dpi 프린터용 XDC 파일을 선택하고 문서를 200dpi 프린터로 보내지 마십시오.

XFA 양식(XDP/PDF)용 스크립트 전용 scripts

통신 API와 함께 사용되는 양식 디자인에는 서버에서 실행되는 스크립트가 포함될 수 있습니다. 양식 디자인에 클라이언트에서 실행되는 스크립트가 없는지 확인합니다. 양식 디자인 스크립트 만들기에 대한 자세한 내용은 Designer 도움말을 참조하세요.

글꼴 매핑 font-mapping

프린터 상주 글꼴을 사용하는 양식을 디자인하려면 Designer에서 프린터에서 사용할 수 있는 글꼴과 일치하는 글꼴 이름을 선택합니다. PCL 또는 PostScript에 대해 지원되는 글꼴 목록은 해당 장치 프로필(XDC 파일)에 있습니다. 또는 다른 서체 이름의 프린터 상주 글꼴에 비프린터 상주 글꼴을 매핑하기 위해 글꼴 매핑을 만들 수 있습니다. 예를 들어 PostScript 시나리오에서 Arial® 글꼴에 대한 참조를 프린터 상주 Helvetica® 서체에 매핑할 수 있습니다.

글꼴이 클라이언트 컴퓨터에 설치되어 있으면 Designer의 드롭다운 목록에서 사용할 수 있습니다. 글꼴이 설치되지 않은 경우 글꼴 이름을 수동으로 지정해야 합니다. Designer의 "사용할 수 없는 글꼴 영구적으로 바꾸기" 옵션을 해제할 수 있습니다. 그렇지 않으면 XDP 파일을 Designer에 저장하면 대체 글꼴 이름이 XDP 파일에 기록됩니다. 프린터 상주 글꼴이 사용되지 않음을 의미합니다.

두 가지 유형의 OpenType® 글꼴이 있습니다. 한 가지 유형은 PCL이 지원하는 TrueType OpenType® 글꼴입니다. 다른 하나는 CFF OpenType®입니다. PDF 및 PostScript 출력은 내장 Type-1, TrueType 및 OpenType® 글꼴을 지원합니다. PCL 출력은 임베드된 트루타입 글꼴을 지원합니다.

Type-1 및 OpenType® 글꼴은 PCL 출력에 포함되지 않습니다. Type-1 및 OpenType® 글꼴로 서식이 지정된 콘텐츠는 큰 비트맵 이미지로 래스터화되고 생성이 느려질 수 있습니다.

다운로드하거나 임베드한 글꼴은 PostScript, PCL 또는 PDF 출력을 생성할 때 자동으로 대체됩니다. 즉, 생성된 문서를 올바르게 렌더링하는 데 필요한 글꼴 글리프의 하위 집합만 생성된 출력에 포함됩니다.

장치 프로필 파일(XDC 파일) 작업 working-with-xdc-files

장치 프로필(XDC 파일)은 XML 형식의 프린터 설명 파일입니다. 이 파일을 사용하면 Communications API에서 문서를 레이저 또는 라벨 프린터 형식으로 출력할 수 있습니다. 통신 API는 다음을 포함한 XDC 파일을 사용합니다.

제공된 XDC 파일을 사용하여 인쇄 문서를 생성하거나 필요에 따라 수정할 수 있습니다.

이러한 파일은 상주 글꼴, 용지함 및 스테이플러와 같은 특정 프린터의 기능을 지원하는 참조 XDC 파일입니다. 이 참조의 목적은 장치 프로필을 사용하여 나만의 프린터를 설정하는 방법을 이해하는 데 도움이 됩니다. 이 참조는 동일한 제품 라인에 있는 유사한 프린터의 시작점이기도 합니다.

XCI 구성 파일 작업 working-with-xci-files

통신 API는 XCI 구성 파일을 사용하여 출력이 단일 패널인지 또는 페이지 번호를 매기는지 제어하는 등의 작업을 수행합니다. 이 파일에는 설정할 수 있는 설정이 포함되어 있지만 일반적으로 이 값을 수정하는 것은 아닙니다.

통신 API를 사용하는 동안 수정된 XCI 파일을 전달할 수 있습니다. 기본 파일의 사본을 만들고 비즈니스 요구 사항에 맞게 수정해야 하는 값만 변경한 다음 수정된 XCI 파일을 사용하십시오.

통신 API는 기본 XCI 파일(또는 수정된 파일)로 시작합니다. 그런 다음 통신 API를 사용하여 지정된 값을 적용합니다. 이러한 값은 XCI 설정을 재정의합니다.

다음 표는 XCI 옵션을 지정합니다.

알려진 문제

모범 사례

자주 묻는 질문 faq

감시 폴더 또는 기타 저장소 메커니즘을 사용하여 입력 및 출력을 저장할 수 있습니까?

현재 Microsoft Azure Storage를 사용하여 입력 데이터와 생성된 문서를 저장할 수 있습니다. Microsoft Azure 스토리지는 데이터 이동 작업을 자동화하는 다양한 옵션을 제공합니다.

Microsoft Azure 저장소 계정이 Experience Manager Forms Cloud Service 라이선스에 포함되어 있습니까?

Microsoft Azure 스토리지 계정은 Experience Manager Forms Cloud Service 라이선스와 독립적입니다.

통신 API가 Experience Manager Forms Cloud Service 서버에 데이터를 저장합니까?

입력 및 출력 데이터는 Microsoft Azure 스토리지에만 저장됩니다.

통신 API는 Experience Manager Forms Cloud Service에 대해서만 사용할 수 있습니까? 온-프레미스 환경에서 유사한 기능을 사용할 수 있습니까?

AEM Forms 출력 서비스를 사용하여 템플릿(XFA 또는 PDF)을 고객 데이터와 결합하여 PDF, PS, PCL 및 ZPL 형식의 문서를 생성할 수 있습니다.

이 Cloud Service은 온-프레미스 환경과 비교하여 자동 확장 및 비용 효율성의 추가적인 이점을 제공합니다.

여러 일괄 처리 작업을 동시에 실행할 수 있습니까?
예. 여러 배치 작업을 동시에 실행할 수 있습니다. 모든 작업에 대해 항상 다른 소스 및 대상 폴더를 사용하여 충돌을 방지하십시오.