Adobe Experience Manager (предварительная версия)
Интеграция Adobe Experience Manager позволяет получать доступ к связанным службам Adobe Experience Manager(например, коммуникациям и т. д.). Эта интеграция также позволит активировать потоки при отправке формы с помощью форм Adobe Experience Manager Forms.
Этот соединитель доступен в следующих продуктах и регионах:
| Услуга | Class | Регионы |
|---|---|---|
| Copilot Studio | Премия | Все регионы Power Automate , кроме следующих: - Правительство США (GCC) - Правительство США (GCC High) — Облако Китая, управляемое 21Vianet - Министерство обороны США (DoD) |
| Логические приложения | Стандарт | Все регионы Logic Apps , кроме следующих: — Регионы Azure для государственных организаций — Регионы Azure Для Китая - Министерство обороны США (DoD) |
| Power Apps | Премия | Все регионы Power Apps , кроме следующих: - Правительство США (GCC) - Правительство США (GCC High) — Облако Китая, управляемое 21Vianet - Министерство обороны США (DoD) |
| Power Automate | Премия | Все регионы Power Automate , кроме следующих: - Правительство США (GCC) - Правительство США (GCC High) — Облако Китая, управляемое 21Vianet - Министерство обороны США (DoD) |
| Контакт | |
|---|---|
| Имя | Формы Adobe Experience Manager |
| URL | https://www.adobe.com/go/adobe-experience-manager-forms-community |
| Адрес электронной почты | aem-pa@adobe.com |
| Метаданные соединителя | |
|---|---|
| Publisher | Adobe |
| Веб-сайт | https://business.adobe.com/products/experience-manager/forms/aem-forms.html |
| Политика конфиденциальности | https://www.adobe.com/in/privacy/policy.html |
| Категории | Продуктивность; Управление бизнесом |
Соединитель Adobe Experience Manager можно использовать для доступа к формам Adobe Experience Manager — возможности коммуникации для создания PDF-документа, основанного на данных формы и XML-формы или создании postScript (PS), языка команд принтера (PCL), языка печати Zebra (ZPL) и других документов языка определения принтера.
Предпосылки
Для использования соединителя требуется лицензия и доступ к Adobe Experience Manager Forms в качестве облачной службы — API связи .
Получение учетных данных
Вы можете легко приступить к работе с Adobe Experience Manager с помощью нескольких шагов.
Создание учетных данных службы
Используйте консоль разработчика Adobe Experience Manager для создания учетных данных службы.
Настройка подключения
Добавьте учетные данные службы в соединитель Adobe Experience Manager. Вы можете получить учетные данные из JSON учетных данных службы и скопировать эти учетные данные в настройку однократного подключения:
- Идентификатор организации
- Идентификатор клиента
- Секрет клиента
- Идентификатор технической учетной записи
- Области метаданных
- Закрытый ключ
- URL-адрес узла Adobe IMS
Для сервера AEM укажите URL-адрес экземпляра облачной службы Adobe Experience Manager или публикации. Например: https://publish-pXXXX-eXXXXX.adobeaemcloud.com
Начало работы с соединителем
Соединитель поддерживает следующие операции:
Создание PDF-документа из шаблона и слияние данных
Вы можете создать PDF-документ, основанный на структуре формы и xml-данных формы. Это помогает создавать утвержденные брендом, персонализированные и стандартизированные документы, такие как бизнес-переписка, заявления, письма об обработке утверждений, уведомления о преимуществах, ежемесячные счета или приветственные комплекты.
Базовый рабочий процесс заключается в слиянии xml-данных формы с конструктором формы для создания PDF-документа. Шаблон можно создать в конструкторе форм Adobe Experience Manager.
Выходные данные операции — это неинтерактивный PDF-документ. То есть пользователи не могут вводить или изменять данные формы. Для настройки различных параметров для операции можно указать следующие параметры:
| Параметр | Обязательный (обязательный) | Description |
|---|---|---|
| Template | Да | Шаблон определяет внешний вид и поведение PDF-документа. API поддерживает шаблоны формата: XDP и PDF-документ. Можно указать полный путь, ссылочный путь репозитория Adobe Experience Manager или двоичный файл. |
| Данные | Да | XML-файл, содержащий данные для объединения с шаблоном. Можно указать полное расположение HTTP или двоичный файл. |
| Конфигурация XCI | нет | Служба использует файл конфигурации XCI для настройки различных свойств PDF-документа. Параметр XCI действует только в том случае, если шаблон имеет тип XDP или PDF-документ на основе XDP. Можно указать полный путь, ссылочный путь репозитория Adobe Experience Manager или двоичный файл. |
| Региональные настройки | нет | Языковой стандарт, в котором должен отображаться pdf-файл. |
| Корневой каталог содержимого | нет | Расположение ресурсов шаблона (изображения, фрагменты и многое другое). Этот путь относится к расположению шаблона. |
| Добавление тегов в PDF | нет | Укажите, чтобы создать PDF-файл с тегами, чтобы оптимизировать его для использования с средствами чтения с экрана и другими вспомогательными технологиями. |
| Внедрение шрифтов в PDF | нет | При внедрении шрифта внедренный шрифт также выглядит одинаково на всех устройствах, но создается более крупный выходной файл. |
| Линейная классификация PDF (быстрое веб-представление) | нет | Выбор оптимизации PDF-файла для быстрого веб-представления |
| Сохранение состояния | нет | Интерактивный PDF-документ содержит различные элементы, составляющие форму. Эти элементы могут включать поля (для принятия или отображения данных), кнопок (для активации событий) и скриптов (команд для выполнения определенного действия). Нажатие кнопки может активировать событие, которое изменяет состояние поля. Например, выбор параметра пола может изменить цвет поля или внешний вид формы. Это пример события вручную, вызывающего изменение состояния формы. Если такой интерактивный PDF-документ не поддерживается с помощью возможностей коммуникации Adobe Experience Manager Forms, состояние формы не сохраняется. Чтобы убедиться, что состояние формы сохраняется даже после выравнивания формы, задайте логическое значение "Сохранить" значение True, чтобы сохранить и сохранить состояние формы. |
| Сохранение полей подписи без знака | нет | Указывает, хранятся ли подписанные и неподписанные поля подписи, если PDF-файл неструктурирован |
| Версия Adobe Acrobat Reader | нет | Указывает минимальную версию средства чтения Acrobat, необходимую для открытия PDF-документа. Версия по умолчанию — Adobe Acrobat 11. |
Создание postScript (PS), языка команд принтера (PCL), языка печати Zebra (ZPL), DPL (язык программирования Datamax), IPL (язык принтера Intermec), TPCL (язык команд принтера TEC) из шаблона и данных
API создания документов можно использовать для создания postScript (PS), языка команд принтера (PCL), языка печати Zebra (ZPL), DPL (язык программирования Datamax), IPL (язык принтера Intermec), документа TPCL (TEC Printer Command Language), основанного на дизайне формы XDP или PDF-документе. Эти API-интерфейсы помогают объединить структуру формы с данными формы для создания документа. Вы можете сохранить документ в файл и использовать Power Automate для отправки документа на принтер. Для настройки различных параметров для операции можно указать следующие параметры:
| Параметр | Обязательный (обязательный) | Description |
|---|---|---|
| Template | Да | Шаблон определяет внешний вид и поведение PDF-документа. API поддерживает шаблоны формата: XDP и PDF-документ. Можно указать полный путь, ссылочный путь репозитория Adobe Experience Manager или двоичный файл. |
| Данные | Да | XML-файл, содержащий данные для объединения с шаблоном. Можно указать полное расположение HTTP или двоичный файл. |
| Профиль принтера | Да | Указывает используемый XDC-файл. XDC-файлы — это файлы описания принтера в формате XML. Возможности Adobe Experience Manager Forms Communications используют XDC-файлы для вывода документов в такие форматы, как PostScript, PCL, DPL, TPCL и ZPL. Файлы XDC также используются для указания параметров печати, таких как количество копий, используется ли дуплексный принтер или параметры скобок. |
| Тип вывода | Да | Указывает тип выходного файла для операции. Поддерживаемые варианты: PostScript (PS), язык команд принтера (PCL), язык печати Zebra (ZPL), DPL (язык программирования Datamax), IPL (язык принтера intermec), TPCL (язык команд принтера TEC). |
| Конфигурация XCI | нет | Указывает используемый XCI-файл. XCI-файлы используются для описания шрифтов, используемых для элементов конструктора форм. Можно указать полный путь, ссылочный путь репозитория Adobe Experience Manager или двоичный файл. |
| Региональные настройки | нет | Языковой стандарт, в котором должны отображаться выходные данные. |
| Корневой каталог содержимого | нет | Расположение ресурсов шаблона (изображения, фрагменты и многое другое). Этот путь относится к расположению шаблона. |
| Количество копий | нет | Указывает количество копий выходного файла для создания. |
| Постраничная разбивка | нет | Указывает, следует ли использовать двухсторонняя или односторонняя печать. Принтеры, поддерживающие PostScript и PCL, используют это значение. |
Распространенные ошибки и средства устранения неполадок
| Код ошибки | Description | Резолюция |
|---|---|---|
| Ошибка 403: Доступ запрещён | Запретный. Чтобы использовать API, вы должны быть членом группы пользователей форм. | Сделайте технической учетной записью членом группы пользователей форм, опубликуйте пользователя (техническую учетную запись) и группу (forms-users). |
| 400 | Указанный шаблон недопустим. Укажите допустимый шаблон и повторите попытку. | Если значение template параметра является обычным текстом, а не URL-адресом, преобразуйте xml-строку данных в двоичный файл. Для преобразования можно использовать двоичное выражение Microsoft Power Automate. При использовании пути JCR добавьте в путь префикс crx://. |
| 400 | Указанные данные недопустимы. Повторите попытку с допустимым файлом данных. | Если значение data параметра является обычным текстом, а не URL-адресом, преобразуйте xml-строку данных в двоичный файл. Для преобразования можно использовать двоичное выражение Microsoft Power Automate. |
| 400 | Указанная конфигурация XCI содержит некоторые недопустимые значения. Исправьте файл конфигурации и повторите попытку. | Если значение XCI configuration параметра является обычным текстом, а не URL-адресом, преобразуйте xml-строку данных в двоичный файл. Для преобразования можно использовать двоичное выражение Microsoft Power Automate. |
Создание подключения
Соединитель поддерживает следующие типы проверки подлинности:
| По умолчанию | Параметры для создания подключения. | Все регионы | Недоступен для совместного использования |
По умолчанию
Применимо: все регионы
Параметры для создания подключения.
Это недоступно для общего доступа. Если приложение power предоставляется другому пользователю, пользователю будет предложено явно создать новое подключение.
| Имя | Тип | Description | Обязательно |
|---|---|---|---|
| Сервер AEM | струна | Укажите URL-адрес экземпляра AEM Author или Publish. | True |
| Идентификатор организации (организация) | струна | Укажите идентификатор организации. | True |
| Идентификатор клиента (clientId) | струна | Укажите идентификатор клиента из учетных данных службы. | True |
| Секрет клиента (clientSecret) | securestring | Укажите секрет клиента из учетных данных службы. | True |
| Идентификатор технической учетной записи (id) | струна | Укажите идентификатор технической учетной записи AEM. | True |
| Области метаданных (метаскопы) | струна | Укажите метаданные областей из учетных данных службы. | True |
| Закрытый ключ (privateKey) | securestring | Укажите закрытый ключ. Он включен в учетные данные службы. | True |
| URL-адрес узла Adobe IMS (imsEndpoint) | струна | Укажите URL-адрес узла службы Adobe Identity Management. | True |
Ограничения регулирования
| Имя | Вызовы | Период обновления |
|---|---|---|
| Вызовы API для каждого подключения | 100 | 60 секунд |
Действия
| Создание PDF-файла из шаблона и данных (предварительная версия) |
Создайте PDF-документ из шаблона PDF или XDP и объедините XML-данные с ним. |
| Создание PS, PCL, ZPL, DPL, IPL или TPCL-файла из шаблона и данных (предварительная версия) |
Создайте postScript (PS), язык команд принтера (PCL), язык печати Zebra (ZPL), DPL (язык программирования Datamax), IPL (язык принтера intermec) или TPCL (TEC Printer Command Language) из XDP-файла или PDF-документа и слияние XML-данных с ним. |
Создание PDF-файла из шаблона и данных (предварительная версия)
Создайте PDF-документ из шаблона PDF или XDP и объедините XML-данные с ним.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Template
|
template | True | binary |
Укажите двоичный файл или расположение шаблона XDP или PDF. |
|
Данные
|
data | True | binary |
Укажите двоичный файл или расположение XML-данных, которые необходимо объединить с шаблоном. |
|
Конфигурация XCI
|
xci | binary |
Укажите двоичный файл или расположение файла конфигураций XCI. |
|
|
Региональные настройки
|
locale | string |
Выберите языковой стандарт для pdf-документа. |
|
|
Корневой каталог содержимого
|
contentRoot | string |
Укажите универсальный код ресурса (URI), абсолютную ссылку или расположение для извлечения ресурсов, используемых в шаблоне. |
|
|
Добавление тегов в PDF
|
isTagged | boolean |
Создайте PDF-файл с тегами для оптимизации PDF для тех, кто использует средства чтения с экрана и другие вспомогательные технологии. |
|
|
Внедрение шрифтов в PDF
|
embedFonts | boolean |
Внедрение шрифтов в PDF для согласованного просмотра на разных устройствах и экранах |
|
|
Линейная классификация PDF (быстрое веб-представление)
|
linearizedPDF | boolean |
Выбор оптимизации PDF-файла для быстрого веб-представления |
|
|
Сохранение состояния
|
retainFormState | boolean |
Выберите сохранить состояние документа после его выравнивания. |
|
|
Сохранение полей подписи без знака
|
retainUnsignedSignatureFields | boolean |
Выберите, чтобы сохранить или удалить поля подписи без знака |
|
|
Версия Adobe Acrobat Reader
|
acrobatVersion | string |
Выберите минимальную версию Средства чтения Acrobat, необходимую для открытия PDF-документа. |
Возвращаемое значение
- response
- PDFResult
Создание PS, PCL, ZPL, DPL, IPL или TPCL-файла из шаблона и данных (предварительная версия)
Создайте postScript (PS), язык команд принтера (PCL), язык печати Zebra (ZPL), DPL (язык программирования Datamax), IPL (язык принтера intermec) или TPCL (TEC Printer Command Language) из XDP-файла или PDF-документа и слияние XML-данных с ним.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Template
|
template | True | binary |
Укажите двоичный файл или расположение шаблона XDP или PDF. |
|
Данные
|
data | True | binary |
Укажите двоичный файл или расположение XML-данных, которые необходимо объединить с шаблоном. |
|
Конфигурация XCI
|
xci | binary |
Укажите двоичный файл или расположение файла конфигураций XCI. |
|
|
Региональные настройки
|
locale | string |
Выберите языковой стандарт для выходного файла. |
|
|
Корневой каталог содержимого
|
contentRoot | string |
Укажите универсальный код ресурса (URI), абсолютную ссылку или расположение для извлечения ресурсов, используемых в шаблоне. |
|
|
Количество копий
|
copies | integer |
Укажите количество копий для создания. |
|
|
Постраничная разбивка
|
paginationOverride | string |
Задайте параметр для печати на одной стороне или обеих сторонах страницы. |
|
|
Профиль принтера
|
xdcUri | True | string |
Выберите XDC-файл, описывающий возможности принтера, такие как функции принтера и типы бумаги. |
|
Тип вывода
|
renderType | True | string |
Выберите доступные типы выходных данных. |
Возвращаемое значение
- response
- PrintedResult
Определения
PDFResult
- PDFOutput
- binary
PrintedResult
- PrintedOutput
- binary