Freigeben über

Adobe Experience Manager (Vorschau)

Die Adobe Experience Manager-Integration ermöglicht den Zugriff auf adobe Experience Manager Forms-bezogene Dienste (z. B. Kommunikation und mehr). Diese Integration ermöglicht auch das Auslösen von Flüssen, wenn ein Formular über Adobe Experience Manager Forms übermittelt wird.

Dieser Connector ist in den folgenden Produkten und Regionen verfügbar:

Dienstleistung Class Regions
Copilot Studio Premium Alle Power Automate-Regionen mit Ausnahme der folgenden Bereiche:
     - US Government (GCC)
     - US Government (GCC High)
     - China Cloud betrieben von 21Vianet
     - US Department of Defense (DoD)
Logik-Apps Norm Alle Logik-Apps-Regionen mit Ausnahme der folgenden Bereiche:
     – Azure Government-Regionen
     - Azure China-Regionen
     - US Department of Defense (DoD)
Power Apps Premium Alle Power Apps-Regionen mit Ausnahme der folgenden:
     - US Government (GCC)
     - US Government (GCC High)
     - China Cloud betrieben von 21Vianet
     - US Department of Defense (DoD)
Power Automate Premium Alle Power Automate-Regionen mit Ausnahme der folgenden Bereiche:
     - US Government (GCC)
     - US Government (GCC High)
     - China Cloud betrieben von 21Vianet
     - US Department of Defense (DoD)
Kontakt
Name Adobe Experience Manager Forms
URL https://www.adobe.com/go/adobe-experience-manager-forms-community
Email aem-pa@adobe.com
Connectormetadaten
Herausgeber Adobe
Webseite https://business.adobe.com/products/experience-manager/forms/aem-forms.html
Datenschutzrichtlinie https://www.adobe.com/in/privacy/policy.html
Kategorien Produktivität; Unternehmensführung

Sie können adobe Experience Manager Connector verwenden, um auf Adobe Experience Manager Forms zuzugreifen – Kommunikationsfunktionen , um ein PDF-Dokument zu erstellen, das auf formulardesign- und XML-Formulardaten basiert, oder PostScript (PS), Printer Command Language (PCL), Zebra Printing Language (ZPL) und andere Dokumente der Druckerdefinitionssprache erstellen.

Voraussetzungen

Sie benötigen eine Lizenz und Zugriff auf Adobe Experience Manager Forms as a Cloud Service – Kommunikations-APIs für die Verwendung des Connectors.

So erhalten Sie Anmeldeinformationen

Mit nur wenigen Schritten können Sie mit Adobe Experience Manager ganz einfach beginnen:

Generieren der Dienstanmeldeinformationen

Verwenden Sie adobe Experience Manager Developer Console, um die Dienstanmeldeinformationen zu generieren .

Einrichten Ihrer Verbindung

Fügen Sie Dem Adobe Experience Manager Connector Ihre Dienstanmeldeinformationen hinzu. Sie können Anmeldeinformationen aus dem JSON-Code für Dienstanmeldeinformationen abrufen und diese Anmeldeinformationen in Ihr einmaliges Verbindungssetup kopieren:

  • Organisations-ID
  • Kunden-ID
  • Geheimer Clientschlüssel
  • Id des technischen Kontos
  • Metabereiche
  • Privater Schlüssel
  • Adobe IMS-Host-URL

Geben Sie für AEM Server die URL Ihrer Adobe Experience Manager Cloud Service Author- oder Publish-Instanz an. Beispiel: https://publish-pXXXX-eXXXXX.adobeaemcloud.com

Erste Schritte mit Ihrem Connector

Der Connector unterstützt die folgenden Vorgänge:

Generieren eines PDF-Dokuments aus einer Vorlage und Zusammenführen von Daten

Sie können ein PDF-Dokument erstellen, das auf formularentwurfs- und XML-Formulardaten basiert. Es hilft Ihnen beim Erstellen von markenbestimmten, personalisierten und standardisierten Dokumenten wie Geschäftskorrespondenz, Aussagen, Anspruchsverarbeitungsschreiben, Leistungshinweisen, monatlichen Rechnungen oder Willkommenskits.

Ein grundlegender Workflow besteht darin, XML-Formulardaten mit einem Formularentwurf zusammenzuführen, um ein PDF-Dokument zu erstellen. Sie können eine Vorlage in Adobe Experience Manager Forms Designer erstellen.

Die Ausgabe des Vorgangs ist ein nicht interaktives PDF-Dokument. Das heißt, Benutzer können die Formulardaten nicht eingeben oder ändern. Sie können die folgenden Parameter angeben, um verschiedene Optionen für den Vorgang zu konfigurieren:

Parameter Obligatorisch (erforderlich) Description
Template Yes Die Vorlage definiert das Aussehen und Verhalten des PDF-Dokuments. Die API unterstützt Formatvorlagen: XDP und PDF-Dokument. Sie können einen vollqualifizierten Pfad, einen Referenzpfad Ihres Adobe Experience Manager-Repositorys oder eine Binärdatei angeben.
Daten Yes Eine XML-Datei mit den Daten, die mit der Vorlage zusammengeführt werden sollen. Sie können einen vollqualifizierten HTTP-Speicherort oder eine Binärdatei angeben.
XCI-Konfiguration Nein Der Dienst verwendet eine XCI-Konfigurationsdatei, um verschiedene Eigenschaften des PDF-Dokuments zu konfigurieren. Der XCI-Parameter hat nur dann Auswirkungen, wenn die Vorlage vom Typ XDP oder einem XDP-basierten PDF-Dokument ist. Sie können einen vollqualifizierten Pfad, einen Referenzpfad Ihres Adobe Experience Manager-Repositorys oder eine Binärdatei angeben.
Gebietsschema Nein Gebietsschema, in dem pdf gerendert werden soll.
Inhaltsstamm Nein Speicherort von Vorlagenressourcen (Bilder, Fragmente und mehr). Dieser Pfad ist relativ zum Vorlagenspeicherort.
Hinzufügen von Tags zu PDF Nein Geben Sie an, eine PDF mit Tags zu erstellen, um sie für die Verwendung mit Sprachausgaben und anderen Hilfstechnologien zu optimieren.
Einbetten von Schriftarten in PDF Nein Wenn Sie eine Schriftart einbetten, sieht die eingebettete Schriftart auch auf allen Geräten gleich aus, aber eine größere Ausgabedatei wird erstellt.
Linearisieren von PDF (schnelle Webansicht) Nein Optimieren der PDF-Datei für schnelle Webansicht
Beibehalten des Zustands Nein Ein interaktives PDF-Dokument enthält verschiedene Elemente, die ein Formular darstellen. Diese Elemente können Felder (zum Akzeptieren oder Anzeigen von Daten), Schaltflächen (zum Auslösen von Ereignissen) und Skripts (Befehle zum Ausführen einer bestimmten Aktion) enthalten. Durch Klicken auf eine Schaltfläche kann ein Ereignis ausgelöst werden, das den Status eines Felds ändert. Beispielsweise kann die Auswahl einer Geschlechtsoption die Farbe eines Felds oder die Darstellung des Formulars ändern. Dies ist ein Beispiel für ein manuelles Ereignis, das dazu führt, dass sich der Formularstatus ändert. Wenn ein solches interaktives PDF-Dokument mithilfe von Adobe Experience Manager Forms Communication-Funktionen vereinfacht wird, wird der Status des Formulars nicht beibehalten. Um sicherzustellen, dass der Status des Formulars auch nach einer Flachung des Formulars beibehalten wird, legen Sie den Booleschen Wert "Beibehalten" auf "True" fest, um den Status des Formulars zu speichern und beizubehalten.
Nicht signierte Signaturfelder beibehalten Nein Gibt an, ob signierte und nicht signierte Signaturfelder beibehalten werden, wenn eine PDF-Datei vereinfacht wird.
Adobe Acrobat Reader-Version Nein Gibt die Mindestversion von Acrobat Reader an, die zum Öffnen des PDF-Dokuments erforderlich ist. Die Standardversion ist Adobe Acrobat 11.

Generieren einer PostScript -Datei (PS), Druckerbefehlssprache (PCL), Zebra Printing Language (ZPL), DPL (Datamax Programming Language), IPL (Intermec Printer Language), TPCL (TEC Printer Command Language) Dateien aus einer Vorlage und Daten

Sie können APIs für die Dokumentgenerierung verwenden, um PostScript (PS), Printer Command Language (PCL), Zebra Printing Language (ZPL), DPL (Datamax Programming Language), IPL (Intermec Printer Language), TPCL (TEC Printer Command Language) Dokument zu erstellen, das auf einem XDP-Formularentwurf oder PDF-Dokument basiert. Diese APIs helfen beim Zusammenführen eines Formularentwurfs mit Formulardaten zum Generieren eines Dokuments. Sie können das Dokument in einer Datei speichern und Power Automate verwenden, um es an einen Drucker zu senden. Sie können die folgenden Parameter angeben, um verschiedene Optionen für den Vorgang zu konfigurieren:

Parameter Obligatorisch (erforderlich) Description
Template Yes Die Vorlage definiert das Aussehen und Verhalten des PDF-Dokuments. Die API unterstützt Formatvorlagen: XDP und PDF-Dokument. Sie können einen vollqualifizierten Pfad, einen Referenzpfad Ihres Adobe Experience Manager-Repositorys oder eine Binärdatei angeben.
Daten Yes Eine XML-Datei mit den Daten, die mit der Vorlage zusammengeführt werden sollen. Sie können einen vollqualifizierten HTTP-Speicherort oder eine Binärdatei angeben.
Druckerprofil Yes Gibt die zu verwendende XDC-Datei an. XDC-Dateien sind Druckerbeschreibungsdateien im XML-Format. Die Adobe Experience Manager Forms Communications-Funktion verwendet XDC-Dateien zum Ausgeben von Dokumenten in Formate wie PostScript, PCL, DPL, TPCL und ZPL. XDC-Dateien werden auch verwendet, um Druckoptionen wie die Anzahl der Exemplare, ob Duplexdrucker verwendet wird, oder Hefteroptionen anzugeben.
Ausgabetyp Yes Gibt den Ausgabedateityp für den Vorgang an. Die unterstützten Optionen sind PostScript (PS), Printer Command Language (PCL), Zebra Printing Language (ZPL), DPL (Datamax Programming Language), IPL (Intermec Printer Language), TPCL (TEC Printer Command Language).
XCI-Konfiguration Nein Gibt die zu verwendende XCI-Datei an. XCI-Dateien werden verwendet, um Schriftarten zu beschreiben, die für Formularentwurfselemente verwendet werden. Sie können einen vollqualifizierten Pfad, einen Referenzpfad Ihres Adobe Experience Manager-Repositorys oder eine Binärdatei angeben.
Gebietsschema Nein Gebietsschema, in dem die Ausgabe gerendert werden soll.
Inhaltsstamm Nein Speicherort von Vorlagenressourcen (Bilder, Fragmente und mehr). Dieser Pfad ist relativ zum Vorlagenspeicherort.
Anzahl der Kopien Nein Gibt die Anzahl der Zu erstellenden Kopien der Ausgabedatei an.
Paginierung Nein Gibt an, ob zweiseitiges oder einseitiges Drucken verwendet werden soll. Drucker, die PostScript und PCL unterstützen, verwenden diesen Wert.

Häufige Fehler und Abhilfemaßnahmen

Fehlercode Description Beschluss
403 Unzulässig. Sie sollten Mitglied der Gruppe "Formularbenutzer" sein, um die API zu verwenden. Stellen Sie das technische Konto mitglied der Gruppe "Formulare-Benutzer" fest, veröffentlichen Sie sowohl den Benutzer (technisches Konto) als auch die Gruppe (Formularbenutzer).
400 Die angegebene Vorlage ist ungültig. Geben Sie eine gültige Vorlage an, und wiederholen Sie den Vorgang. Wenn der Wert des template Parameters nur Text und keine URL ist, konvertieren Sie die Daten-XML-Zeichenfolge in eine Binärdatei. Sie können den binär()-Ausdruck von Microsoft Power Automate verwenden, um die Konvertierung vorzunehmen. Wenn Sie den JCR-Pfad verwenden, fügen Sie dem Pfad crx:// Präfix hinzu.
400 Die angegebenen Daten sind ungültig. Wiederholen Sie den Vorgang mit einer gültigen Datendatei. Wenn der Wert des data Parameters nur Text und keine URL ist, konvertieren Sie die Daten-XML-Zeichenfolge in eine Binärdatei. Sie können den binär()-Ausdruck von Microsoft Power Automate verwenden, um die Konvertierung vorzunehmen.
400 Die angegebene XCI-Konfiguration enthält einige ungültige Werte. Beheben Sie die Konfigurationsdatei, und wiederholen Sie den Vorgang. Wenn der Wert des XCI configuration Parameters nur Text und keine URL ist, konvertieren Sie die Daten-XML-Zeichenfolge in eine Binärdatei. Sie können den binär()-Ausdruck von Microsoft Power Automate verwenden, um die Konvertierung vorzunehmen.

Erstellen einer Verbindung

Der Connector unterstützt die folgenden Authentifizierungstypen:
Vorgabe Parameter zum Erstellen einer Verbindung. Alle Regionen Nicht teilbar

Vorgabe

Anwendbar: Alle Regionen

Parameter zum Erstellen einer Verbindung.

Dies ist keine freigabefähige Verbindung. Wenn die Power-App für einen anderen Benutzer freigegeben wird, wird ein anderer Benutzer aufgefordert, eine neue Verbindung explizit zu erstellen.

Name Typ Description Erforderlich
AEM Server Schnur Geben Sie die URL Ihrer AEM Author- oder Publish-Instanz an. Richtig
Organisations-ID (Organisation) Schnur Geben Sie Ihre Organisations-ID an. Richtig
Client-ID (clientId) Schnur Geben Sie die Client-ID aus Ihren Dienstanmeldeinformationen an. Richtig
Geheimer Clientschlüssel (clientSecret) securestring Geben Sie den geheimen Clientschlüssel aus Ihren Dienstanmeldeinformationen an. Richtig
ID des technischen Kontos (ID) Schnur Geben Sie die ID Ihres technischen AEM-Kontos an. Richtig
Metabereiche (Metascopes) Schnur Geben Sie Metabereiche aus Ihren Dienstanmeldeinformationen an. Richtig
Privater Schlüssel (privateKey) securestring Geben Sie den privaten Schlüssel an. Sie ist in den Dienstanmeldeinformationen enthalten. Richtig
Adobe IMS-Host-URL (imsEndpoint) Schnur Stellen Sie die Host-URL des Adobe Identity Management-Diensts bereit. Richtig

Drosselungsgrenzwerte

Name Aufrufe Verlängerungszeitraum
API-Aufrufe pro Verbindung 100 60 Sekunden

Aktionen

Generieren einer PDF aus einer Vorlage und Daten (Vorschau)

Generieren Sie ein PDF-Dokument aus einer PDF- oder XDP-Vorlage, und führen Sie XML-Daten darin zusammen.
Generieren einer PS-, PCL-, ZPL-, DPL-, IPL- oder TPCL-Datei aus einer Vorlage und Daten (Vorschau)

Generieren Sie ein PostScript -Dokument (PS), Druckerbefehlssprache (PCL), Zebra Printing Language (ZPL), DPL (Datamax Programming Language), IPL (Intermec Printer Language) oder TPCL (TEC Printer Command Language) -Dokument aus einer XDP-Datei oder einem PDF-Dokument und zusammenführen XML-Daten mit ihr.

Generieren einer PDF aus einer Vorlage und Daten (Vorschau)

Vorgangs-ID:
GeneratePDFOutput

Generieren Sie ein PDF-Dokument aus einer PDF- oder XDP-Vorlage, und führen Sie XML-Daten darin zusammen.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Template
 template True binary

Geben Sie die Binärdatei oder den Speicherort der XDP- oder PDF-Vorlage an.
Daten
 data True binary

Geben Sie die Binärdatei oder den Speicherort der XML-Daten an, die mit der Vorlage zusammengeführt werden sollen.
XCI-Konfiguration
 xci binary

Geben Sie die Binärdatei oder den Speicherort der XCI-Konfigurationsdatei an.
Gebietsschema
 locale string

Wählen Sie ein Gebietsschema für das PDF-Dokument aus.
Inhaltsstamm
 contentRoot string

Geben Sie den URI, absoluten Verweis oder Speicherort an, um objekte abzurufen, die in der Vorlage verwendet werden.
Hinzufügen von Tags zu PDF
 isTagged boolean

Erstellen Sie eine PDF mit Tags, um PDF für Personen zu optimieren, die Bildschirmsprachausgaben und andere Hilfstechnologien verwenden.
Einbetten von Schriftarten in PDF
 embedFonts boolean

Einbetten von Schriftarten in PDF für ein einheitliches Erscheinungsbild auf Geräten und Bildschirmen
Linearisieren von PDF (schnelle Webansicht)
 linearizedPDF boolean

Optimieren der PDF-Datei für schnelle Webansicht
Beibehalten des Zustands
 retainFormState boolean

Wählen Sie aus, dass der Status des Dokuments beibehalten wird, nachdem es abgeflacht wurde.
Nicht signierte Signaturfelder beibehalten
 retainUnsignedSignatureFields boolean

Auswählen, um die nicht signierten Signaturfelder beizubehalten oder zu entfernen
Adobe Acrobat Reader-Version
 acrobatVersion string

Wählen Sie die Mindestversion von Acrobat Reader aus, die zum Öffnen des PDF-Dokuments erforderlich ist.

Gibt zurück

response
PDFResult

Generieren einer PS-, PCL-, ZPL-, DPL-, IPL- oder TPCL-Datei aus einer Vorlage und Daten (Vorschau)

Vorgangs-ID:
GeneratePrintedOutput

Generieren Sie ein PostScript -Dokument (PS), Druckerbefehlssprache (PCL), Zebra Printing Language (ZPL), DPL (Datamax Programming Language), IPL (Intermec Printer Language) oder TPCL (TEC Printer Command Language) -Dokument aus einer XDP-Datei oder einem PDF-Dokument und zusammenführen XML-Daten mit ihr.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Template
 template True binary

Geben Sie die Binärdatei oder den Speicherort der XDP- oder PDF-Vorlage an.
Daten
 data True binary

Geben Sie die Binärdatei oder den Speicherort der XML-Daten an, die mit der Vorlage zusammengeführt werden sollen.
XCI-Konfiguration
 xci binary

Geben Sie die Binärdatei oder den Speicherort der XCI-Konfigurationsdatei an.
Gebietsschema
 locale string

Wählen Sie das Gebietsschema für die Ausgabedatei aus.
Inhaltsstamm
 contentRoot string

Geben Sie den URI, absoluten Verweis oder Speicherort an, um objekte abzurufen, die in der Vorlage verwendet werden.
Anzahl der Kopien
 copies integer

Geben Sie die Anzahl der zu erstellenden Kopien an.
Paginierung
 paginationOverride string

Legen Sie die Option fest, um auf einer Seite oder auf beiden Seiten einer Seite zu drucken.
Druckerprofil
 xdcUri True string

Wählen Sie eine XDC-Datei aus, die Druckerfunktionen beschreibt, z. B. die Druckerfeatures und die Papiertypen.
Ausgabetyp
 renderType True string

Wählen Sie aus den verfügbaren Ausgabetypen aus.

Gibt zurück

response
PrintedResult

Definitionen

PDFResult

PDFOutput
binary

PrintedResult

PrintedOutput
binary