Bekende problemen en best practices best-practices-known-issues-and-limitations

Voordat u de communicatie-API's gaat gebruiken, moet u de volgende overwegingen, bekende problemen en vaak gestelde vragen doornemen:

Overwegingen considerations-for-communications-apis

Formuliergegevens form-data

Communicatie-API's accepteren zowel een formulierontwerp dat gewoonlijk in Designer en XML-formuliergegevens wordt gemaakt als invoer. Als u een document wilt vullen met gegevens, moet de XML-formuliergegevens een XML-element bevatten voor elk formulierveld dat u wilt vullen. De naam van het XML-element moet overeenkomen met de veldnaam. Een XML-element wordt genegeerd als het niet overeenkomt met een formulierveld of als de naam van het XML-element niet overeenkomt met de veldnaam. Het is niet nodig de volgorde aan te passen waarin de XML-elementen worden weergegeven. De belangrijkste factor is dat de XML-elementen met de overeenkomende waarden worden opgegeven.

Bekijk het volgende voorbeeld van een aanvraagformulier voor een lening:

Als u gegevens wilt samenvoegen in dit formulierontwerp, maakt u een XML-gegevensbron die overeenkomt met het formulier. De volgende XML vertegenwoordigt een XML-gegevensbron die overeenkomt met het voorbeeld van een hypotheektoepassingsformulier.

<?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>

Ondersteunde documenttypen supported-document-types

Voor volledige toegang tot de renderingmogelijkheden van de communicatie-API's wordt aanbevolen een XDP-bestand als invoer te gebruiken. Soms kan een PDF-bestand worden gebruikt. Het gebruik van een PDF-bestand als invoer heeft echter de volgende beperkingen:

Een PDF-document dat geen XFA-stream bevat, kan niet worden gerenderd als PostScript, PCL of ZPL. Communicatie-API's kunnen PDF-documenten met XFA-streams (dat wil zeggen, formulieren die zijn gemaakt in Designer) weergeven in laser- en labelindelingen. Als het PDF-document is ondertekend, gecertificeerd of gebruiksrechten bevat (toegepast met de AEM Forms Reader Extensions-service), kan het niet worden gerenderd naar deze afdrukindelingen.

Afdrukbare gebieden printable-areas

De standaard niet-afdrukbare marge van 0,25 inch is niet exact voor labelprinters en varieert van printer tot printer en van labelgrootte tot labelgrootte. Het is echter aan te raden de marge van 0,25 inch te behouden of te verkleinen. U wordt echter aangeraden de niet-afdrukbare marge niet te verhogen. Anders wordt de informatie in het afdrukbare gebied niet correct afgedrukt.

Zorg altijd dat u het juiste XDC-bestand voor de printer gebruikt. Vermijd bijvoorbeeld het kiezen van een XDC-bestand voor een 300 dpi-printer en het verzenden van het document naar een 200 dpi-printer.

Scripts voor alleen XFA-formulieren (XDP/PDF) scripts

Een formulierontwerp dat wordt gebruikt met de communicatie-API's kan scripts bevatten die op de server worden uitgevoerd. Zorg ervoor dat een formulierontwerp geen scripts bevat die op de client worden uitgevoerd. Voor informatie over het creëren van manuscripten van het vormontwerp, zie Hulp van Designer.

Lettertypetoewijzing font-mapping

Als u een formulier wilt ontwerpen waarin printerresidente lettertypen worden gebruikt, kiest u een lettertypenaam in Designer die overeenkomt met de lettertypen die op de printer beschikbaar zijn. Een lijst met lettertypen die worden ondersteund voor PCL of PostScript, vindt u in de bijbehorende apparaatprofielen (XDC-bestanden). U kunt ook lettertypetoewijzing maken om niet-printerresidente lettertypen toe te wijzen aan printerresidente lettertypen met een andere lettertypenaam. In een PostScript-scenario kunnen verwijzingen naar het lettertype Arial® bijvoorbeeld worden toegewezen aan het printerresidente Helvetica®-lettertype.

Als een lettertype op een clientcomputer is geïnstalleerd, is het beschikbaar in de vervolgkeuzelijst in Designer. Als het lettertype niet is geïnstalleerd, moet u de lettertypenaam handmatig opgeven. De optie Niet-beschikbare lettertypen permanent vervangen in Designer kan zijn uitgeschakeld. Als het XDP-bestand in Designer wordt opgeslagen, wordt de naam van het vervangende font naar het XDP-bestand geschreven. Dit betekent dat het printerresidente lettertype niet wordt gebruikt.

Er zijn twee typen OpenType®-lettertypen. Eén type is een TrueType OpenType®-font dat door PCL wordt ondersteund. Het andere is CFF OpenType®. PDF- en PostScript-uitvoer ondersteunen ingesloten Type-1-, TrueType- en OpenType®-lettertypen. PCL-uitvoer ondersteunt ingesloten TrueType-fonts.

Type-1- en OpenType®-lettertypen worden niet ingesloten in PCL-uitvoer. Inhoud die is opgemaakt met Type-1- en OpenType®-lettertypen wordt gerasterd en gegenereerd als een bitmapafbeelding die groot en langzamer kan zijn om te genereren.

Gedownloade of ingesloten lettertypen worden automatisch vervangen bij het genereren van PostScript-, PCL- of PDF-uitvoer. Dit betekent dat alleen de subset van de lettertypeglyphs die vereist zijn om het gegenereerde document correct weer te geven, in de gegenereerde uitvoer wordt opgenomen.

Werken met apparaatprofielbestanden (XDC-bestand) working-with-xdc-files

Een apparaatprofiel (XDC-bestand) is een printerbeschrijvingsbestand in XML-indeling. Met dit bestand kunnen de communicatie-API's documenten uitvoeren als laser- of labelprinterindelingen. Communicatie-API's gebruiken de XDC-bestanden, waaronder de volgende:

U kunt de meegeleverde XDC-bestanden gebruiken om afdrukdocumenten te genereren of deze naar wens aan te passen.

Deze bestanden zijn referentie-XDC-bestanden die de functies van specifieke printers ondersteunen, zoals residente lettertypen, papierladen en nietmachines. Het doel van deze naslaggids is om u te helpen begrijpen hoe u uw eigen printers kunt instellen met apparaatprofielen. De verwijzing is ook een uitgangspunt voor gelijkaardige printers in de zelfde productlijn.

Werken met het XCI-configuratiebestand working-with-xci-files

Communicatie APIs gebruikt een XCI configuratiedossier om taken uit te voeren, zoals het controleren of de output één enkel paneel of gepagineerd is. Hoewel dit bestand instellingen bevat die kunnen worden ingesteld, is het niet standaard om deze waarde te wijzigen.

U kunt een gewijzigd XCI-bestand doorgeven terwijl u een communicatie-API gebruikt. Als u dit doet, maakt u een kopie van het standaardbestand, wijzigt u alleen de waarden die moeten worden gewijzigd om aan uw bedrijfsvereisten te voldoen en gebruikt u het aangepaste XCI-bestand.

Communicatie API's beginnen met het standaard XCI-bestand (of het gewijzigde bestand). Vervolgens worden waarden toegepast die zijn opgegeven met de communicatie-API's. Deze waarden overschrijven XCI-instellingen.

In de volgende tabel worden XCI-opties opgegeven.

Bekende problemen

Aanbevolen procedures

Veelgestelde vragen faq

kan ik een gecontroleerde omslag of andere opslagmechanismen gebruiken om input en output op te slaan?

Op dit moment kunt u Microsoft Azure Storage gebruiken om invoergegevens en gegenereerde documenten op te slaan. De opslag van Microsoft Azure verstrekt diverse opties om verrichtingen van de gegevensbewegingte automatiseren.

is een Microsoft Azure rekening van de Opslag inbegrepen met de vergunning van de Cloud Service van Experience Manager Forms?

Microsoft Azure Storage account is onafhankelijk van Experience Manager Forms Cloud Service license.

slaat Communicatie APIs gegevens op de servers van de Cloud Service van Experience Manager Forms op?

Invoer- en uitvoergegevens worden alleen opgeslagen op Microsoft Azure Storage.

Zijn Communicatie APIs beschikbaar slechts voor de Cloud Service van Experience Manager Forms? Kan ik gelijkaardige functionaliteit op-gebouw milieu krijgen?

U kunt de dienst van de Output van AEM Forms gebruiken om een malplaatje (XFA of PDF) met klantengegevens te combineren om documenten in PDF, PS, PCL, en formaten te produceren ZPL.

In vergelijking met een omgeving op locatie biedt de Cloud Service extra voordelen van automatisch schalen en kosteneffectiviteit.

Kan ik veelvoudige partijverrichtingen gelijktijdig in werking stellen?
Ja, u kunt meerdere batchbewerkingen tegelijk uitvoeren. Gebruik altijd verschillende bron- en doelmappen voor elke bewerking om conflicten te voorkomen.