Adobe Experience Manager (preview)
Integratie van Adobe Experience Manager biedt toegang tot aan Adobe Experience Manager Forms gerelateerde services (bijvoorbeeld Communicatie en meer). Met deze integratie kunnen stromen ook worden geactiveerd wanneer een formulier wordt verzonden via Adobe Experience Manager Forms.
Deze connector is beschikbaar in de volgende producten en regio's:
| Dienst | Class | Regions |
|---|---|---|
| Copilot Studio | Premium | Alle Power Automate-regio's , met uitzondering van het volgende: - Amerikaanse overheid (GCC) - Amerikaanse overheid (GCC High) - China Cloud beheerd door 21Vianet - Us Department of Defense (DoD) |
| Logic-apps | Standaard | Alle Logic Apps-regio's , met uitzondering van het volgende: - Azure Government-regio's - Azure China-regio's - Us Department of Defense (DoD) |
| Power Apps | Premium | Alle Power Apps-regio's , met uitzondering van het volgende: - Amerikaanse overheid (GCC) - Amerikaanse overheid (GCC High) - China Cloud beheerd door 21Vianet - Us Department of Defense (DoD) |
| Power Automate | Premium | Alle Power Automate-regio's , met uitzondering van het volgende: - Amerikaanse overheid (GCC) - Amerikaanse overheid (GCC High) - China Cloud beheerd door 21Vianet - Us Department of Defense (DoD) |
| Contactpersoon | |
|---|---|
| Naam | Adobe Experience Manager Forms |
| URL | https://www.adobe.com/go/adobe-experience-manager-forms-community |
| E-mailen | aem-pa@adobe.com |
| Connectormetagegevens | |
|---|---|
| Uitgever | Adobe |
| Webpagina | https://business.adobe.com/products/experience-manager/forms/aem-forms.html |
| Privacybeleid | https://www.adobe.com/in/privacy/policy.html |
| Categorieën | Productiviteit; Bedrijfsbeheer |
U kunt de Adobe Experience Manager-connector gebruiken om toegang te krijgen tot Adobe Experience Manager Forms - Communicatiemogelijkheden om een PDF-document te maken dat is gebaseerd op een formulierontwerp en XML-formuliergegevens of PostScript (PS), Printer Command Language (PCL), Zebra Printing Language (ZPL) en andere documenten over printerdefinitietaal te maken.
Vereiste voorwaarden
U hebt een licentie en toegang tot Adobe Experience Manager Forms nodig als cloudservice - Communicatie-API's om de connector te kunnen gebruiken.
Referenties ophalen
U kunt eenvoudig aan de slag met Adobe Experience Manager met slechts een paar stappen:
De servicereferenties genereren
Gebruik de Ontwikkelaarsconsole van Adobe Experience Manager om de servicereferenties te genereren .
Uw verbinding instellen
Voeg uw servicereferenties toe aan de Adobe Experience Manager-connector. U kunt referenties ophalen uit de JSON voor servicereferenties en deze referentiegegevens kopiëren naar de eenmalige installatie van de verbinding:
- Organisatie-id
- Klant-ID
- Clientgeheim
- Technische account-id
- Metabereiken
- Persoonlijke sleutel
- Host-URL van Adobe IMS
Geef voor AEM Server de URL op van uw Instantie van Adobe Experience Manager Cloud Service Author of Publish. Bijvoorbeeld https://publish-pXXXX-eXXXXX.adobeaemcloud.com
Aan de slag met uw connector
De connector ondersteunt de volgende bewerkingen:
Een PDF-document genereren op basis van een sjabloon en gegevens samenvoegen
U kunt een PDF-document maken dat is gebaseerd op een formulierontwerp en XML-formuliergegevens. Het helpt u bij het maken van goedgekeurde, gepersonaliseerde en gestandaardiseerde documenten, zoals zakelijke correspondenties, instructies, claimverwerkingsbrieven, kennisgevingen van voordelen, maandelijkse facturen of welkomstkits.
Een eenvoudige werkstroom is het samenvoegen van XML-formuliergegevens met een formulierontwerp om een PDF-document te maken. U kunt een sjabloon maken in Adobe Experience Manager Forms Designer.
De uitvoer van de bewerking is een niet-interactief PDF-document. Dat wil gezegd, gebruikers kunnen de formuliergegevens niet invoeren of wijzigen. U kunt de volgende parameters opgeven om verschillende opties voor de bewerking te configureren:
| Kenmerk | Verplicht (vereist) | Description |
|---|---|---|
| Template | Yes | De sjabloon definieert het uiterlijk en gedrag van het PDF-document. De API ondersteunt sjablonen van indeling: XDP en PDF-document. U kunt een volledig gekwalificeerd pad, referentiepad van uw Adobe Experience Manager-opslagplaats of een binair bestand opgeven. |
| Gegevens | Yes | Een XML-bestand met de gegevens die moeten worden samengevoegd met een sjabloon. U kunt een volledig gekwalificeerde HTTP-locatie of een binair bestand opgeven. |
| XCI-configuratie | Nee. | De service gebruikt een XCI-configuratiebestand om verschillende eigenschappen van het PDF-document te configureren. De parameter XCI heeft alleen effect wanneer de sjabloon van het type XDP of een PDF-document op basis van XDP is. U kunt een volledig gekwalificeerd pad, referentiepad van uw Adobe Experience Manager-opslagplaats of een binair bestand opgeven. |
| Lokatie | Nee. | Landinstelling waarin pdf moet worden weergegeven. |
| Inhoudsroot | Nee. | Locatie van sjabloonresources (afbeeldingen, fragmenten en meer). Dit pad is relatief ten opzichte van de locatie van de sjabloon. |
| Tags toevoegen aan PDF | Nee. | Geef op om een PDF te maken met tags om het te optimaliseren voor gebruik met schermlezers en andere ondersteunende technologie. |
| Lettertypen insluiten in PDF | Nee. | Wanneer u een lettertype insluit, ziet het ingesloten lettertype er ook op alle apparaten hetzelfde uit, maar wordt er een groter uitvoerbestand geproduceerd. |
| PDF lineariseren (Snelle webweergave) | Nee. | Kies ervoor om het PDF-bestand voor snelle webweergave te optimaliseren |
| Status behouden | Nee. | Een interactief PDF-document bevat verschillende elementen die een formulier vormen. Deze elementen kunnen velden bevatten (om gegevens te accepteren of weer te geven), knoppen (om gebeurtenissen te activeren) en scripts (opdrachten om een specifieke actie uit te voeren). Als u op een knop klikt, kan een gebeurtenis worden geactiveerd waarmee de status van een veld wordt gewijzigd. Als u bijvoorbeeld een geslachtsoptie kiest, kan de kleur van een veld of het uiterlijk van het formulier worden gewijzigd. Dit is een voorbeeld van een handmatige gebeurtenis waardoor de formulierstatus wordt gewijzigd. Wanneer een dergelijk interactief PDF-document wordt afgevlakt met de mogelijkheden van Adobe Experience Manager Forms Communication, blijft de status van het formulier niet behouden. Als u ervoor wilt zorgen dat de status van het formulier behouden blijft, zelfs nadat het formulier is afgevlakt, stelt u de Booleaanse waarde Behoudstatus in op Waar om de status van het formulier op te slaan en te behouden. |
| Niet-ondertekende handtekeningvelden behouden | Nee. | Hiermee geeft u op of ondertekende en niet-ondertekende handtekeningvelden worden bewaard wanneer een PDF-bestand wordt afgevlakt |
| Adobe Acrobat Reader-versie | Nee. | Hiermee geeft u de minimale versie van Acrobat Reader vereist om het PDF-document te openen. De standaardversie is Adobe Acrobat 11. |
Een PostScript (PS), Printer Command Language (PCL), Zebra Printing Language (ZPL), DPL (Datamax Programming Language), IPL (Intermec Printer Language), TPCL -bestanden (TEC Printer Command Language) genereren vanuit een sjabloon en gegevens
U kunt API's voor het genereren van documenten gebruiken om PostScript (PS), Printer Command Language (PCL), Zebra Printing Language (ZPL), DPL (Datamax Programming Language), IPL (Intermec Printer Language), TPCL -document (TEC Printer Command Language) te maken dat is gebaseerd op een XDP-formulierontwerp of PDF-document. Deze API's helpen bij het samenvoegen van een formulierontwerp met formuliergegevens om een document te genereren. U kunt het document opslaan in een bestand en Power Automate gebruiken om het naar een printer te verzenden. U kunt de volgende parameters opgeven om verschillende opties voor de bewerking te configureren:
| Kenmerk | Verplicht (vereist) | Description |
|---|---|---|
| Template | Yes | De sjabloon definieert het uiterlijk en gedrag van het PDF-document. De API ondersteunt sjablonen van indeling: XDP en PDF-document. U kunt een volledig gekwalificeerd pad, referentiepad van uw Adobe Experience Manager-opslagplaats of een binair bestand opgeven. |
| Gegevens | Yes | Een XML-bestand met de gegevens die moeten worden samengevoegd met een sjabloon. U kunt een volledig gekwalificeerde HTTP-locatie of een binair bestand opgeven. |
| Printerprofiel | Yes | Hiermee geeft u het XDC-bestand te gebruiken. XDC-bestanden zijn printerbeschrijvingsbestanden in XML-indeling. Adobe Experience Manager Forms Communications maakt gebruik van XDC-bestanden om documenten uit te voeren voor indelingen zoals PostScript, PCL, DPL, TPCL en ZPL. XDC-bestanden worden ook gebruikt om afdrukopties op te geven, zoals het aantal exemplaren, of dubbelzijdige printer wordt gebruikt of nietjesopties. |
| Uitvoertype | Yes | Hiermee geeft u het uitvoerbestandstype voor de bewerking. De ondersteunde opties zijn PostScript (PS), Printer Command Language (PCL), Zebra Printing Language (ZPL), DPL (Datamax Programming Language), IPL (Intermec Printer Language), TPCL (TEC Printer Command Language). |
| XCI-configuratie | Nee. | Hiermee geeft u het XCI-bestand te gebruiken. XCI-bestanden worden gebruikt om lettertypen te beschrijven die worden gebruikt voor formulierontwerpelementen. U kunt een volledig gekwalificeerd pad, referentiepad van uw Adobe Experience Manager-opslagplaats of een binair bestand opgeven. |
| Lokatie | Nee. | Landinstelling waarin uitvoer moet worden weergegeven. |
| Inhoudsroot | Nee. | Locatie van sjabloonresources (afbeeldingen, fragmenten en meer). Dit pad is relatief ten opzichte van de locatie van de sjabloon. |
| Aantal exemplaren | Nee. | Hiermee geeft u het aantal exemplaren van het uitvoerbestand dat moet worden geproduceerd. |
| Pagina-indeling | Nee. | Hiermee geeft u op of dubbelzijdig of enkelzijdig afdrukken moet worden gebruikt. Printers die PostScript en PCL ondersteunen, gebruiken deze waarde. |
Veelvoorkomende fouten en oplossingen
| Foutcode | Description | Resolutie / Besluit |
|---|---|---|
| 403 | Verboden. U moet lid zijn van de groep formulieren-gebruikers om de API uit te voeren. | Maak het technische account lid van de groep formulieren-gebruikers, publiceer zowel de gebruiker (technisch account) als de groep (formulieren-gebruikers). |
| 400 | De opgegeven sjabloon is ongeldig. Geef een geldige sjabloon op en probeer het opnieuw. | Wanneer de waarde van de template parameter tekst zonder opmaak is en geen URL, converteert u de gegevens-XML-tekenreeks naar binair. U kunt de binaire() expressie van Microsoft Power Automate gebruiken om de conversie te maken. Wanneer u het JCR-pad gebruikt, voegt u crx:// voorvoegsel toe aan het pad. |
| 400 | De opgegeven gegevens zijn ongeldig. Probeer het opnieuw met een geldig gegevensbestand. | Wanneer de waarde van de data parameter tekst zonder opmaak is en geen URL, converteert u de gegevens-XML-tekenreeks naar binair. U kunt de binaire() expressie van Microsoft Power Automate gebruiken om de conversie te maken. |
| 400 | De opgegeven XCI-configuratie bevat enkele ongeldige waarden. Herstel het configuratiebestand en probeer het opnieuw. | Wanneer de waarde van de XCI configuration parameter tekst zonder opmaak is en geen URL, converteert u de gegevens-XML-tekenreeks naar binair. U kunt de binaire() expressie van Microsoft Power Automate gebruiken om de conversie te maken |
Een verbinding maken
De connector ondersteunt de volgende verificatietypen:
| standaard | Parameters voor het maken van verbinding. | Alle regio's | Niet deelbaar |
Verstek
Van toepassing: Alle regio's
Parameters voor het maken van verbinding.
Dit is geen deelbare verbinding. Als de power-app wordt gedeeld met een andere gebruiker, wordt een andere gebruiker gevraagd om expliciet een nieuwe verbinding te maken.
| Naam | Typologie | Description | Verplicht |
|---|---|---|---|
| AEM-server | touw | Geef de URL op van uw exemplaar van AEM Author of Publish. | Klopt |
| Organisatie-id (organisatie) | touw | Geef uw organisatie-id op. | Klopt |
| Client-id (clientId) | touw | Geef de client-id op uit uw servicereferenties. | Klopt |
| Clientgeheim (clientSecret) | beveiligde string | Geef het clientgeheim op uit uw servicereferenties. | Klopt |
| Technische account-id (id) | touw | Geef de id van uw technische AEM-account op. | Klopt |
| Metabereiken (metascopen) | touw | Geef metabereiken op van uw servicereferenties. | Klopt |
| Persoonlijke sleutel (privateKey) | beveiligde string | Geef de persoonlijke sleutel op. Deze is opgenomen in de servicereferenties. | Klopt |
| Adobe IMS-host-URL (imsEndpoint) | touw | Geef de host-URL van de Adobe Identity Management-service op. | Klopt |
Beperkingslimieten
| Name | Aanroepen | Verlengingsperiode |
|---|---|---|
| API-aanroepen per verbinding | 100 | 60 seconden |
Acties
| Een PDF genereren op basis van een sjabloon en gegevens (preview) |
Genereer een PDF-document op basis van een PDF- of XDP-sjabloon en voeg ER XML-gegevens aan toe. |
| Een PS-, PCL-, ZPL-, DPL-, IPL- of TPCL-bestand genereren op basis van een sjabloon en gegevens (preview) |
Genereer een PostScript-document (PS), Printer Command Language (PCL), Zebra Printing Language (ZPL), DPL (Datamax Programming Language), IPL -document (Intermec Printer Language) of TPCL (TEC Printer Command Language) uit een XDP-bestand of PDF-document en voeg XML-gegevens eraan samen. |
Een PDF genereren op basis van een sjabloon en gegevens (preview)
Genereer een PDF-document op basis van een PDF- of XDP-sjabloon en voeg ER XML-gegevens aan toe.
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Template
|
template | True | binary |
Geef het binaire bestand of de locatie van de XDP- of PDF-sjabloon op. |
|
Gegevens
|
data | True | binary |
Geef het binaire bestand of de locatie op van de XML-gegevens die moeten worden samengevoegd met de sjabloon. |
|
XCI-configuratie
|
xci | binary |
Geef het binaire bestand of de locatie van het XCI-configuratiebestand op. |
|
|
Lokatie
|
locale | string |
Selecteer een landinstelling voor het PDF-document. |
|
|
Inhoudsroot
|
contentRoot | string |
Geef de URI, absolute verwijzing of locatie op om assets op te halen die in de sjabloon worden gebruikt. |
|
|
Tags toevoegen aan PDF
|
isTagged | boolean |
Maak een PDF met tags om PDF te optimaliseren voor degenen die schermlezers en andere ondersteunende technologie gebruiken. |
|
|
Lettertypen insluiten in PDF
|
embedFonts | boolean |
Lettertypen insluiten in PDF voor een consistent uiterlijk op apparaten en schermen |
|
|
PDF lineariseren (Snelle webweergave)
|
linearizedPDF | boolean |
Kies ervoor om het PDF-bestand voor snelle webweergave te optimaliseren |
|
|
Status behouden
|
retainFormState | boolean |
Kies ervoor om de status van het document te behouden nadat het is afgevlakt. |
|
|
Niet-ondertekende handtekeningvelden behouden
|
retainUnsignedSignatureFields | boolean |
Selecteer deze optie om de niet-ondertekende handtekeningvelden te behouden of te verwijderen |
|
|
Adobe Acrobat Reader-versie
|
acrobatVersion | string |
Selecteer de minimale versie van Acrobat Reader die is vereist om het PDF-document te openen. |
Retouren
- response
- PDFResult
Een PS-, PCL-, ZPL-, DPL-, IPL- of TPCL-bestand genereren op basis van een sjabloon en gegevens (preview)
Genereer een PostScript-document (PS), Printer Command Language (PCL), Zebra Printing Language (ZPL), DPL (Datamax Programming Language), IPL -document (Intermec Printer Language) of TPCL (TEC Printer Command Language) uit een XDP-bestand of PDF-document en voeg XML-gegevens eraan samen.
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Template
|
template | True | binary |
Geef het binaire bestand of de locatie van de XDP- of PDF-sjabloon op. |
|
Gegevens
|
data | True | binary |
Geef het binaire bestand of de locatie op van de XML-gegevens die moeten worden samengevoegd met de sjabloon. |
|
XCI-configuratie
|
xci | binary |
Geef het binaire bestand of de locatie van het XCI-configuratiebestand op. |
|
|
Lokatie
|
locale | string |
Selecteer de landinstelling voor het uitvoerbestand. |
|
|
Inhoudsroot
|
contentRoot | string |
Geef de URI, absolute verwijzing of locatie op om assets op te halen die in de sjabloon worden gebruikt. |
|
|
Aantal exemplaren
|
copies | integer |
Geef het aantal exemplaren op dat moet worden geproduceerd. |
|
|
Pagina-indeling
|
paginationOverride | string |
Stel de optie in om aan één zijde of beide zijden van een pagina af te drukken. |
|
|
Printerprofiel
|
xdcUri | True | string |
Kies een XDC-bestand met een beschrijving van de printermogelijkheden, zoals de printerfuncties en de papiertypen. |
|
Uitvoertype
|
renderType | True | string |
Kies uit de beschikbare uitvoertypen. |
Retouren
- response
- PrintedResult
Definities
PDFResult
- PDFOutput
- binary
PrintedResult
- PrintedOutput
- binary