Udostępnij przez

Adobe Experience Manager (wersja zapoznawcza)

Integracja programu Adobe Experience Manager umożliwia dostęp do usług powiązanych z formularzami programu Adobe Experience Manager (np. communications i innych). Ta integracja umożliwi również wyzwalanie przepływów po przesłaniu formularza za pośrednictwem formularzy programu Adobe Experience Manager.

Ten łącznik jest dostępny w następujących produktach i regionach:

Usługa Class Regions
Copilot Studio Premium Wszystkie regiony usługi Power Automate z wyjątkiem następujących:
     - Rząd USA (GCC)
     - Rząd USA (GCC High)
     - China Cloud obsługiwane przez firmę 21Vianet
     - Departament Obrony USA (DoD)
Logic Apps Standard Wszystkie regiony usługi Logic Apps z wyjątkiem następujących:
     — Regiony platformy Azure Government
     — Regiony platformy Azure (Chiny)
     - Departament Obrony USA (DoD)
Power Apps Premium Wszystkie regiony usługi Power Apps z wyjątkiem następujących:
     - Rząd USA (GCC)
     - Rząd USA (GCC High)
     - China Cloud obsługiwane przez firmę 21Vianet
     - Departament Obrony USA (DoD)
Power Automate Premium Wszystkie regiony usługi Power Automate z wyjątkiem następujących:
     - Rząd USA (GCC)
     - Rząd USA (GCC High)
     - China Cloud obsługiwane przez firmę 21Vianet
     - Departament Obrony USA (DoD)
Kontakt
Name Formularze programu Adobe Experience Manager
adres URL https://www.adobe.com/go/adobe-experience-manager-forms-community
Email aem-pa@adobe.com
Metadane łącznika
Publisher Adobe
Witryna internetowa https://business.adobe.com/products/experience-manager/forms/aem-forms.html
Zasady ochrony prywatności https://www.adobe.com/in/privacy/policy.html
Kategorie Produktywność; Zarządzanie biznesem

Łącznik programu Adobe Experience Manager umożliwia uzyskiwanie dostępu do formularzy programu Adobe Experience Manager — komunikacja w celu utworzenia dokumentu PDF opartego na danych formularza i formularza XML lub utworzeniu języka PostScript (PS), języka poleceń drukarki (PCL), języka drukowania Zebra (ZPL) i innych dokumentów języka definicji drukarki.

Wymagania wstępne

Do korzystania z łącznika wymagana jest licencja i dostęp do formularzy programu Adobe Experience Manager jako usługi w chmurze — interfejsy API komunikacji .

Jak uzyskać poświadczenia

Możesz łatwo rozpocząć pracę z programem Adobe Experience Manager, wykonując kilka kroków:

Generowanie poświadczeń usługi

Użyj konsoli dewelopera programu Adobe Experience Manager, aby wygenerować poświadczenia usługi.

Konfigurowanie połączenia

Dodaj poświadczenia usługi do łącznika programu Adobe Experience Manager. Możesz pobrać poświadczenia z pliku JSON poświadczeń usługi i skopiować te szczegóły poświadczeń do konfiguracji połączenia jednorazowego:

  • Identyfikator organizacji
  • ID klienta
  • Tajemnica klienta
  • Identyfikator konta technicznego
  • Zakresy meta
  • Klucz prywatny
  • Adres URL hosta programu Adobe IMS

W polu Serwer AEM określ adres URL swojego wystąpienia usługi w chmurze programu Adobe Experience Manager lub opublikuj. Na przykład https://publish-pXXXX-eXXXXX.adobeaemcloud.com

Wprowadzenie do łącznika

Łącznik obsługuje następujące operacje:

Generowanie dokumentu PDF na podstawie szablonu i scalanie danych

Możesz utworzyć dokument PDF oparty na projekcie formularza i danych formularza XML. Ułatwia tworzenie zatwierdzonych przez markę, spersonalizowanych i ustandaryzowanych dokumentów, takich jak korespondencja biznesowa, oświadczenia, listy przetwarzania roszczeń, powiadomienia o świadczeniach, miesięczne rachunki lub zestawy powitalne.

Podstawowym przepływem pracy jest scalanie danych formularza XML z projektem formularza w celu utworzenia dokumentu PDF. Szablon można utworzyć w projektancie formularzy programu Adobe Experience Manager.

Dane wyjściowe operacji to nieinterakcyjny dokument PDF. Oznacza to, że użytkownicy nie mogą wprowadzać ani modyfikować danych formularza. Możesz określić następujące parametry, aby skonfigurować różne opcje dla operacji:

Parameter Obowiązkowe (wymagane) Description
Template Tak Szablon definiuje wygląd i zachowanie dokumentu PDF. Interfejs API obsługuje szablony formatu: XDP i PDF. Możesz określić w pełni kwalifikowaną ścieżkę, ścieżkę referencyjną repozytorium programu Adobe Experience Manager lub plik binarny.
Dane Tak Plik XML zawierający dane do scalenia z szablonem. Możesz określić w pełni kwalifikowaną lokalizację HTTP lub plik binarny.
Konfiguracja XCI Nie. Usługa używa pliku konfiguracji XCI do konfigurowania różnych właściwości dokumentu PDF. Parametr XCI ma wpływ tylko wtedy, gdy szablon jest typu XDP lub dokument PDF oparty na protokole XDP. Możesz określić w pełni kwalifikowaną ścieżkę, ścieżkę referencyjną repozytorium programu Adobe Experience Manager lub plik binarny.
Lokalizacja Nie. Ustawienia regionalne, w których ma być renderowany plik PDF.
Katalog główny zawartości Nie. Lokalizacja zasobów szablonu (obrazy, fragmenty i inne). Ta ścieżka jest względna do lokalizacji szablonu.
Dodawanie tagów do formatu PDF Nie. Określ, aby utworzyć plik PDF z tagami, aby zoptymalizować go do użycia z czytnikami zawartości ekranu i inną technologią pomocną.
Osadzanie czcionek w formacie PDF Nie. Po osadzeniu czcionki osadzona czcionka wygląda tak samo na wszystkich urządzeniach, ale generowany jest większy plik wyjściowy.
Liniowy plik PDF (szybki widok internetowy) Nie. Wybierz, aby zoptymalizować plik PDF dla szybkiego widoku internetowego
Zachowaj stan Nie. Interaktywny dokument PDF zawiera różne elementy, które stanowią formularz. Te elementy mogą obejmować pola (w celu akceptowania lub wyświetlania danych), przyciski (wyzwalanie zdarzeń) i skrypty (polecenia do wykonania określonej akcji). Kliknięcie przycisku może wyzwolić zdarzenie, które zmienia stan pola. Na przykład wybranie opcji płci może zmienić kolor pola lub wygląd formularza. Jest to przykład zdarzenia ręcznego powodującego zmianę stanu formularza. Gdy taki interaktywny dokument PDF jest spłaszczone przy użyciu funkcji komunikacji formularzy programu Adobe Experience Manager, stan formularza nie jest zachowywany. Aby upewnić się, że stan formularza jest zachowywany nawet po spłaszczeniu formularza, ustaw wartość logiczną Zachowaj stan Na wartość True, aby zapisać i zachować stan formularza.
Zachowywanie niepodpisanych pól podpisu Nie. Określa, czy pola podpisów podpisanych i niepodpisanych są przechowywane, gdy plik PDF jest spłaszczone
Wersja programu Adobe Acrobat Reader Nie. Określa minimalną wersję programu Acrobat Reader wymaganą do otwarcia dokumentu PDF. Domyślną wersją jest Adobe Acrobat 11.

Generowanie kodu PostScript (PS), języka poleceń drukarki (PCL), zebra printing language (ZPL), DPL (Datamax Programming Language), IPL (Intermec Printer Language), TPCL (TEC Printer Command Language) z szablonu i danych

Interfejsy API generowania dokumentów umożliwiają tworzenie dokumentów PostScript (PS), języka poleceń drukarki (PCL), języka drukowania Zebra (ZPL), DPL (Datamax Programming Language), IPL (Intermec Printer Language), dokumentu TPCL (TEC Printer Command Language) opartego na projekcie formularza XDP lub dokumencie PDF. Te interfejsy API ułatwiają scalanie projektu formularza z danymi formularza w celu wygenerowania dokumentu. Dokument można zapisać w pliku i użyć usługi Power Automate, aby wysłać go do drukarki. Możesz określić następujące parametry, aby skonfigurować różne opcje dla operacji:

Parameter Obowiązkowe (wymagane) Description
Template Tak Szablon definiuje wygląd i zachowanie dokumentu PDF. Interfejs API obsługuje szablony formatu: XDP i PDF. Możesz określić w pełni kwalifikowaną ścieżkę, ścieżkę referencyjną repozytorium programu Adobe Experience Manager lub plik binarny.
Dane Tak Plik XML zawierający dane do scalenia z szablonem. Możesz określić w pełni kwalifikowaną lokalizację HTTP lub plik binarny.
Profil drukarki Tak Określa plik XDC do użycia. Pliki XDC to pliki opisu drukarki w formacie XML. Funkcja Adobe Experience Manager Forms Communications używa plików XDC do wyprowadzania dokumentów w formatach, takich jak PostScript, PCL, DPL, TPCL i ZPL. Pliki XDC są również używane do określania opcji drukowania, takich jak liczba kopii, niezależnie od tego, czy jest używana drukarka dwukierunkowa, czy też opcje zszywacza.
Typ danych wyjściowych Tak Określa typ pliku wyjściowego dla operacji. Obsługiwane opcje to PostScript (PS), Printer Command Language (PCL), Zebra Printing Language (ZPL), DPL (Datamax Programming Language), IPL (Intermec Printer Language), TPCL (TEC Printer Command Language).
Konfiguracja XCI Nie. Określa plik XCI do użycia. Pliki XCI służą do opisywania czcionek używanych do tworzenia elementów projektu formularza. Możesz określić w pełni kwalifikowaną ścieżkę, ścieżkę referencyjną repozytorium programu Adobe Experience Manager lub plik binarny.
Lokalizacja Nie. Ustawienia regionalne, w których powinny być renderowane dane wyjściowe.
Katalog główny zawartości Nie. Lokalizacja zasobów szablonu (obrazy, fragmenty i inne). Ta ścieżka jest względna do lokalizacji szablonu.
Liczba kopii Nie. Określa liczbę kopii pliku wyjściowego do utworzenia.
Paginacja Nie. Określa, czy należy używać drukowania dwustronnego, czy jednostronnego. Drukarki obsługujące język PostScript i PCL używają tej wartości.

Typowe błędy i środki zaradcze

Kod błędu Description Rezolucja
403 Zakazany. Aby móc korzystać z interfejsu API, należy być członkiem grupy użytkowników formularzy. Utwórz członka konta technicznego grupy użytkowników formularzy, opublikuj zarówno użytkownika (konto techniczne) jak i grupę (formularze-użytkownicy).
400 Określony szablon jest nieprawidłowy. Określ prawidłowy szablon i spróbuj ponownie. Gdy wartość parametru template jest zwykłym tekstem, a nie adresem URL, przekonwertuj ciąg xml danych na binarny. Aby dokonać konwersji, możesz użyć wyrażenia binary() usługi Microsoft Power Automate. W przypadku używania ścieżki JCR dodaj crx:// prefiks do ścieżki.
400 Określone dane są nieprawidłowe. Ponów próbę przy użyciu prawidłowego pliku danych. Gdy wartość parametru data jest zwykłym tekstem, a nie adresem URL, przekonwertuj ciąg xml danych na binarny. Aby dokonać konwersji, możesz użyć wyrażenia binary() usługi Microsoft Power Automate.
400 Określona konfiguracja XCI zawiera kilka nieprawidłowych wartości. Napraw plik konfiguracji i ponów próbę. Gdy wartość parametru XCI configuration jest zwykłym tekstem, a nie adresem URL, przekonwertuj ciąg xml danych na binarny. Aby dokonać konwersji, możesz użyć wyrażenia binary() usługi Microsoft Power Automate

Tworzenie połączenia

Łącznik obsługuje następujące typy uwierzytelniania:
Wartość domyślna Parametry tworzenia połączenia. Wszystkie regiony Nie można udostępniać

Domyślny

Dotyczy: wszystkie regiony

Parametry tworzenia połączenia.

Nie jest to możliwe do udostępnienia połączenie. Jeśli aplikacja power zostanie udostępniona innemu użytkownikowi, zostanie wyświetlony monit o jawne utworzenie nowego połączenia.

Name Typ Description Wymagane
Serwer AEM ciąg Określ adres URL wystąpienia AEM Author lub Publish. Prawda
Identyfikator organizacji (organizacja) ciąg Określ identyfikator organizacji. Prawda
Identyfikator klienta (clientId) ciąg Określ identyfikator klienta z poświadczeń usługi. Prawda
Klucz tajny klienta (clientSecret) securestring Określ klucz tajny klienta z poświadczeń usługi. Prawda
Identyfikator konta technicznego (id) ciąg Określ identyfikator konta technicznego AEM. Prawda
Meta zakresy (metazakresy) ciąg Określ meta zakresy na podstawie poświadczeń usługi. Prawda
Klucz prywatny (privateKey) securestring Podaj klucz prywatny. Jest on uwzględniony w poświadczeniach usługi. Prawda
Adres URL hosta programu Adobe IMS (imsEndpoint) ciąg Podaj adres URL hosta usługi Adobe Identity Management. Prawda

Limity ograniczania

Nazwa Wywołania Okres odnowienia
Wywołania interfejsu API na połączenie 100 60 sekund

Akcje

Generowanie pliku PDF na podstawie szablonu i danych (wersja zapoznawcza)

Wygeneruj dokument PDF z szablonu PDF lub XDP i scal dane XML.
Generowanie pliku PS, PCL, ZPL, DPL, IPL lub TPCL na podstawie szablonu i danych (wersja zapoznawcza)

Wygeneruj kod PostScript (PS), język poleceń drukarki (PCL), język drukowania Zebra (ZPL), DPL (Język programowania Datamax), IPL (Intermec Printer Language) lub dokument TPCL (język poleceń drukarki TEC) z pliku XDP lub dokumentu PDF i scal dane XML.

Generowanie pliku PDF na podstawie szablonu i danych (wersja zapoznawcza)

Identyfikator operacji:
GeneratePDFOutput

Wygeneruj dokument PDF z szablonu PDF lub XDP i scal dane XML.

Parametry

Nazwa Klucz Wymagane Typ Opis
Template
 template True binary

Podaj plik binarny lub lokalizację szablonu XDP lub PDF.
Dane
 data True binary

Podaj plik binarny lub lokalizację danych XML do scalenia z szablonem.
Konfiguracja XCI
 xci binary

Podaj plik binarny lub lokalizację pliku konfiguracji XCI.
Lokalizacja
 locale string

Wybierz ustawienia regionalne dla dokumentu PDF.
Katalog główny zawartości
 contentRoot string

Określ identyfikator URI, odwołanie bezwzględne lub lokalizację, aby pobrać zasoby używane w szablonie.
Dodawanie tagów do formatu PDF
 isTagged boolean

Utwórz plik PDF z tagami, aby zoptymalizować plik PDF dla osób korzystających z czytników zawartości ekranu i innej technologii pomocniczej.
Osadzanie czcionek w formacie PDF
 embedFonts boolean

Osadzanie czcionek w formacie PDF w celu uzyskania spójnego wyglądu na urządzeniach i ekranach
Liniowy plik PDF (szybki widok internetowy)
 linearizedPDF boolean

Wybierz, aby zoptymalizować plik PDF dla szybkiego widoku internetowego
Zachowaj stan
 retainFormState boolean

Wybierz, aby zachować stan dokumentu po spłaszczeniu.
Zachowywanie niepodpisanych pól podpisu
 retainUnsignedSignatureFields boolean

Wybierz, aby zachować lub usunąć niepodpisane pola podpisu
Wersja programu Adobe Acrobat Reader
 acrobatVersion string

Wybierz minimalną wersję programu Acrobat Reader wymaganą do otwarcia dokumentu PDF.

Zwraca

response
PDFResult

Generowanie pliku PS, PCL, ZPL, DPL, IPL lub TPCL na podstawie szablonu i danych (wersja zapoznawcza)

Identyfikator operacji:
GeneratePrintedOutput

Wygeneruj kod PostScript (PS), język poleceń drukarki (PCL), język drukowania Zebra (ZPL), DPL (Język programowania Datamax), IPL (Intermec Printer Language) lub dokument TPCL (język poleceń drukarki TEC) z pliku XDP lub dokumentu PDF i scal dane XML.

Parametry

Nazwa Klucz Wymagane Typ Opis
Template
 template True binary

Podaj plik binarny lub lokalizację szablonu XDP lub PDF.
Dane
 data True binary

Podaj plik binarny lub lokalizację danych XML do scalenia z szablonem.
Konfiguracja XCI
 xci binary

Podaj plik binarny lub lokalizację pliku konfiguracji XCI.
Lokalizacja
 locale string

Wybierz ustawienia regionalne dla pliku wyjściowego.
Katalog główny zawartości
 contentRoot string

Określ identyfikator URI, odwołanie bezwzględne lub lokalizację, aby pobrać zasoby używane w szablonie.
Liczba kopii
 copies integer

Określ liczbę kopii do utworzenia.
Paginacja
 paginationOverride string

Ustaw opcję drukowania po jednej lub obu stronach strony.
Profil drukarki
 xdcUri True string

Wybierz plik XDC opisujący możliwości drukarki, takie jak funkcje drukarki i typy papieru.
Typ danych wyjściowych
 renderType True string

Wybierz spośród dostępnych typów danych wyjściowych.

Zwraca

response
PrintedResult

Definicje

PDFResult

PDFOutput
binary

PrintedResult

PrintedOutput
binary