自動フォーム変換サービス（AFCS）の設定
- トピック：
- アダプティブフォーム
作成対象：
- 初心者
- 中級
- 管理者
- 開発者
- ユーザー
この記事では、AEM の管理者が自動フォーム変換サービス（AFCS）を設定して、PDF フォームを自動的にアダプティブフォームに変換する方法について説明します。 この記事は、組織内の IT 管理者と AEM 管理者を対象としています。 この記事の情報は、以下のテクノロジーに関する十分な知識があるユーザーを対象としています。
-
Adobe Experience Manager パッケージと AEM パッケージのインストール、設定、管理
-
Linux® オペレーティングシステムと Microsoft® Windows® オペレーティングシステムの使用
オンボーディング
このサービスは、AEM 6.5 Forms のオンプレミスユーザーと Adobe Managed Services のエンタープライズユーザーに無料で提供されます。 変換サービスを使用する場合は、アドビのセールスチームまたはアドビの営業担当者に問い合わせてください。 また、AEM Forms as a Cloud Service のお客様は無料でご利用いただけ、事前に有効化されています。
お客様の組織で変換サービスを使用できるように設定し、組織の管理者に対して必要な権限を設定します。 必要な権限を設定された管理者は、変換サービスに接続するためのアクセス権限を、組織内の AEM Forms 開発ユーザーに付与することができます。
前提条件
自動フォーム変換サービス（AFCS）を使用するには、以下の条件を満たしている必要があります。
- 組織で自動フォーム変換サービス（AFCS）が有効になっていること
- 変換サービス用の管理者権限が設定された Adobe ID アカウントが作成されていること
- 実行中の AEM 6.5 に最新の AEM サービスパックが適用されているか、AEM Forms as a Cloud Service オーサーインスタンスに最新のアップデートが適用されていること
- AEM インスタンス上の AEM ユーザーが forms-user グループのメンバーになっていること
環境を設定する
変換サービスを使用する前の準備として、Adobe Cloud 上で稼働しているサーバーに AEM オーサーインスタンスを接続する必要があります。 このインスタンスの準備を行うには、以下の手順を上から順に実行します。
1. AEM 6.5 をダウンロードしてインストールするか、AEM Forms as a Cloud Service をオンボード
自動フォーム変換サービス（AFCS）は、AEM オーサーインスタンス上で稼働します。 AEM オーサーインスタンスを設定するには、AEM 6.5 または AEM Forms as a Cloud Service が必要です。
-
AEM 6.5 が稼働していない場合は、以下の場所から AEM をダウンロードしてください。 AEM をダウンロードしたら、デプロイとメンテナンスの説明に従い、AEM オーサーインスタンスの設定を行ってください。
-
既に AEM を使用している場合は、アドビライセンス Web サイトから AEM 6.5 をダウンロードしてください。
-
アドビパートナーの場合は、アドビパートナートレーニングプログラムから AEM 6.5 をリクエストしてください。
-
-
AEM Forms as a Cloud Service を使用している場合は、AEM Forms as a Cloud Service へのオンボードを参照し、ローカル開発環境を設定してください。
2. （AEM 6.5 のみの場合）最新の AEM サービスパックをダウンロードしてインストール
最新の AEM サービスパックをダウンロードしてインストールします。 手順について詳しくは、AEM 6.5 サービスパックリリースノートを参照してください。
3. （AEM 6.5 のみの場合）AEM Forms アドオンパッケージをダウンロードしてインストール
AEM インスタンスには、基本的なフォーム機能が付属しています。 変換サービスを使用するには、AEM Forms のすべての機能が必要になります。 AEM Forms のすべての機能を使用するには、AEM Forms アドオンパッケージをダウンロードしてインストールする必要があります。 変換サービスを設定して使用するには、このパッケージが必要になります。 手順について詳しくは、データ取得機能をインストールして設定するを参照してください。
https://adminconsole.adobe.com/
NOTE4. カスタムのテーマとテンプレートを作成
参照パッケージには、サンプルのテーマとテンプレートが含まれています。 自動フォーム変換サービス（AFCS）では、PDF フォームをアダプティブフォームに変換するために、少なくとも 1 つのテーマと 1 つのテンプレートが必要です。 変換サービスを使用する前に、専用のカスタムテーマとカスタムテンプレートを作成し、それらのテーマとテンプレートを使用するように変換サービスを設定してください。
また、AEM Forms リファレンスアセットパッケージをダウンロードして、オーサーインスタンスにインストールすることもできます。 参照テーマとテンプレートが作成されます。
アクセスと権限の設定
Adobe Cloud 上で稼働するサービスの設定を行い、そのサービスにローカルインスタンスを接続する前に、サービスの接続時に必要となるペルソナと権限について説明します。 サービスを接続する場合、管理者と開発者という 2 種類のユーザーが必要になります。
- 管理者：管理者は、組織内で使用するアドビソフトウェアとアドビサービスの管理を担当します。 管理者は、組織内の開発者に、Adobe Cloud 上で実行されている自動フォーム変換サービス（AFCS）に接続するためのアクセス権を付与します。 管理者を組織に対してプロビジョニングすると、「アドビのソフトウェアとサービスを組織内で管理するための管理者権限が付与されました」というタイトルのメールが管理者に送信されます。 管理者は、このタイトルのメールを受信していることを確認し、組織内の開発者に権限を付与する必要があります。
- 開発者：開発者は、AEM Forms オーサーインスタンスを Adobe Cloud 上で稼働する自動フォーム変換サービス（AFCS）に接続します。 管理者が開発者に対して自動フォーム変換サービス（AFCS）に接続する権限を付与すると、「組織の Adobe API 統合を管理するための開発者アクセス権が付与されました」というタイトルのメールが開発者に送信されます。 開発者は、このタイトルのメールを受信していることを確認し、ローカルの AEM インスタンスを Adobe Cloud 上の自動フォーム変換サービスに接続する必要があります。
組織の開発者へのアクセス権の付与
組織に対するアクセスを有効化と、管理者に対する必要な権限の付与がアドビによって行われたら、管理者は、Admin Console にログインして（詳しい手順については、以下の説明を参照してください）、プロファイルを作成し、そのプロファイルに開発者を追加できます。 開発者は、AEM Forms のインスタンスを Adobe Cloud 上の自動フォーム変換サービス（AFCS）に接続できます。
開発者とは、変換サービスの実行を担当する組織内のメンバーのことです。 アドビ自動フォーム変換サービス（AFCS）プロファイルに追加された開発者のみが、自動フォーム変換サービス（AFCS）を使用する資格があります。
プロファイルを作成して開発者をそのプロファイルに登録するには、以下の手順を実行します。 組織の開発者に必要なアクセスを付与するには、少なくとも 1 つのプロファイルが必要です。
-
Admin Console にログインします。 プロビジョニングされた管理者の Adobe ID で自動フォーム変換サービス（AFCS）を使用してログインします。
-
「自動フォーム変換」オプションをクリックします。
-
「製品」タブで「新しいプロファイル」をクリックします。
-
プロファイルの 名前、表示名、説明 を入力します。 「完了」をクリックします。 例えば、プロファイルを AFC_Flamingo_Test_Dev として作成します。
-
プロファイルに開発者を追加します。 プロファイルに開発者を追加するには、以下の手順を実行します。
- Admin Console で「概要」タブに移動します。
- 目的の製品カードで、「開発者の割り当て」をクリックします。
- 開発者のメールアドレスを入力し、必要に応じて姓名を入力します。
- 製品プロファイルを選択します。 「保存」をクリックします。
すべての開発者について、上記の手順を繰り返します。 開発者の詳しい追加手順については、「開発者の管理」を参照してください。
管理者が Adobe I/O プロファイルに開発者を追加すると、その管理者にメール通知が送信されます（設定されている場合）。
ユーザーを forms-users グループに追加する
変換サービスの実行を許可する AEM ユーザーのプロファイル内でメールアドレスを指定します。 ユーザーが forms-users グループのメンバーであることを確認してください。 変換サービスの実行を許可されたユーザーのメールアドレスにメールが送信されます。 ユーザーのメールアドレスを指定し、そのユーザーを forms-user グループに追加するには、以下の手順を実行します。
-
AEM 管理者として、AEM Forms のオーサーインスタンスにログインします。 ローカルの AEM 資格情報を使用してログインします。
-
Adobe Experience Manager／ツール／セキュリティ／ユーザー をクリックします。
-
変換サービスを実行するように指定されたユーザーを選択し、「プロパティ」をクリックします。 ユーザー設定を編集 ページが開きます。
-
「メール」フィールドにメールアドレスを指定して、「保存」をクリックします。 指定のメールアドレスに、変換処理の成否が記載されたメール通知が送信されます。
-
「グループ」タブをクリックします。 「グループを選択」タブで、forms-users グループを入力して選択します。
-
「保存して閉じる」をクリックします。 これで、ユーザーが forms-users グループのメンバーとして登録されました。
Adobe Cloud 上の自動フォーム変換サービス（AFCS）への AEM Forms インスタンスの接続
管理者が開発者アクセス権を付与した後、Adobe Cloud 上で稼働する自動フォーム変換サービス（AFCS）に AEM Forms インスタンスを接続できます。
AEM Forms インスタンスを自動フォーム変換サービスに接続するには、次の手順を実行します。
1. Adobe Developer Console でサービス API を設定
1. Adobe Developer Console でサービス API を設定
自動フォーム変換サービス（AFCS）を使用するには、Adobe Developer Console でプロジェクトを作成し、Automated Forms Configuration Service API をプロジェクトに追加します。 統合により、API キー、クライアント秘密鍵、テクニカルアカウント ID、スコープ、組織 ID が生成されます。
Adobe Developer Console で Automated Forms Conversion Service API を設定するには、次の手順を実行します。
-
https://developer.adobe.com/console にログインします 。 Adobe ID と、管理者がプロビジョニングした開発者アカウントを使用して、Adobe I/O コンソールにログインします。
-
右上隅で組織を選択します。 自分がどの組織に属しているかわからない場合は、管理者に問い合わせてください。
-
「新規プロジェクトを作成」をクリックします。 新規プロジェクトを開始する画面が表示されます。
-
「API を追加」をクリックします。 お使いのアカウントで有効になっているすべての API を示す画面が表示されます。
-
「自動フォーム変換サービス」を選択し、「次へ」をクリックします。 API を設定する画面が表示されます。
-
OAuth サーバー間 認証方式を選択します。
-
資格情報名 を指定して、「次へ」をクリックします。
-
製品プロファイル を作成します。 例えば、プロファイルを AFC_Flamingo_Test_Dev として選択します。
-
「設定済み API を保存」をクリックします。
NOTE組織の開発者にアクセス権を付与する際に作成されたプロファイルを選択します。 選択するプロファイルがわからない場合は、管理者に問い合わせてください。 -
「OAuth サーバー間」をクリックすると、AEM インスタンスを自動フォーム変換サービス（AFCS）に接続するのに必要な API キー、クライアント秘密鍵、その他の情報が表示されます。
IMS 設定の作成に使用されるページについて詳しくは、AEM オーサーインスタンスでの IMS テクニカル設定の作成の節を参照してください。
2. Adobe IMS 設定を作成
オーサーインスタンスにログインして、Adobe IMS 設定を作成します。 OAuth 資格情報の詳細 を使用して、API キー、クライアント秘密鍵、テクニカルアカウント ID、スコープ、組織 ID を取得します。
-
AEM Forms オーサーインスタンスにログインします。 ツール／セキュリティ／Adobe IMS 設定 に移動します。
-
「作成」をクリックします。
-
「Adobe IMS テクニカルアカウント設定」ページが表示されます。
-
クラウドソリューション で「自動フォーム変換サービス」を選択します。
-
以下の情報を入力します。
-
タイトル：タイトルを指定します。
-
Adobe Developer Console でサービス API を設定の節から次の情報を取得します。
- クライアント ID：API キー（クライアント ID） をコピー＆ペーストします。
- クライアント秘密鍵：クライアント秘密鍵 をコピー＆ペーストします。
- スコープ：スコープ をコピー＆ペーストします。
- 組織 ID：テクニカルアカウント ID をコピー＆ペーストします。
-
-
「保存」をクリックします。 Adobe IMS 設定が作成されます。
CAUTIONIMS 設定は 1 つだけ作成してください。 複数の IMS 設定を作成しないでください。 -
「Adobe IMS 設定」を選択し、「ヘルスをチェック」をクリックします。 ダイアログボックスが表示されます。
チェック ダイアログボックスが表示されます。
-
「チェック」をクリックします。
接続が成功すると、トークンが正常に取得された ことを示すメッセージが表示されます。
-
「閉じる」をクリックします。
3. 自動フォーム変換設定を作成
自動フォーム変換設定を作成して、AEM インスタンスを変換サービスに接続します。 この設定を作成すると、変換用のテンプレート、テーマ、フォームフラグメントも指定できるようになります。 フォームの各セットとは独立した複数のクラウドサービス設定を作成できます。
例えば、販売部門用のフォームや顧客サポート用のフォームとは独立した設定を作成することができます。 クラウドサービス設定を作成するには、以下の手順を実行します。
-
AEM Forms インスタンスで、Adobe Experience Manager／ツール／Cloud Services／自動フォーム変換設定 をクリックします。
-
グローバル フォルダーを選択し、「作成」をクリックします。
自動フォーム変換設定を作成 するページが表示されます。 設定が グローバル フォルダーに作成されます。 別のフォルダー内に設定を作成することも、フォルダーを作成して設定を保存することもできます。
-
自動フォーム変換設定を作成 ページで、次のフィールドに値を指定し、「次へ」をクリックします。
フィールド説明タイトル一意の設定タイトル。 このタイトルが、変換処理を開始する UI に表示されます。名前一意の設定名。 この名前で、CRX-Repository ディレクトリに設定が保存されます。 設定名と設定タイトルは、同じ値にすることができます。サムネイルの場所設定のサムネイルの場所。サービス URLAdobe Cloud 上の自動フォーム変換サービス（AFCS）の URL。 「https://aemformsconversion.adobe.io/」を入力してください。テンプレート変換後のフォームに適用されるデフォルトのテンプレート。 変換処理を開始する前であれば、いつでも別のテンプレートを指定することができます。 テンプレートには、アダプティブフォーム用の基本的な構成情報と初期コンテンツが含まれています。 すぐに使用できる一連のテンプレートから、任意のテンプレートを選択することができます。 また、カスタムテンプレートを作成することもできます。テーマ変換後のフォームに適用されるデフォルトのテーマ。 変換処理を開始する前であれば、いつでも別のテーマを指定することができます。 アイコンをクリックすると、すぐに使用できるテーマを選択することができます。 また、カスタムテーマを作成することもできます。既存のフラグメント既存のフラグメントの場所（存在する場合）。カスタムメタモデルカスタムメタモデルの .schema.json ファイルのパス。 英語、フランス語、ドイツ語、スペイン語、イタリア語、ポルトガル語の各言語用に個別のメタモデルを作成できます。 -
「自動フォーム変換設定の作成」ページの「詳細」タブで、以下のフィールドに値を入力します。
フィールド説明レコードのドキュメントを生成変換後のフォームに対してレコードのドキュメントを自動的に生成するには、このオプションを選択します。 これは、XFA ベースフォーム（XDP フォームと PDF フォーム）専用のオプションです。 このオプションを有効にしてフォームを送信すると、フォームに入力した情報のレコードを、印刷形式またはドキュメント形式で、今後の参照用に保存することができます。 これを、レコードのドキュメントといいます。Analytics を有効にする（AEM 6.5 の場合）変換されたすべてのフォームで Adobe Analytics を有効にするオプションを選択します。 このオプションを選択する前に、AEM Forms インスタンスで Adobe Analytics が有効になっているかどうかを確認してください。- 「.XDP」という拡張子が付いている XFA ベースフォームをソースとして使用する場合、XFA レイアウトが出力 DOR に保存されます。それ以外の場合、変換サービスは付属のテンプレートを使用して、その他の XFA ベースフォーム用の DOR を生成します。
- XFA フォームを送信すると、そのフォームの送信データが XML 要素または属性として保存されます。 例えば、
<Amount currency="USD"> 10.00 </Amount>のようになります。 この場合、「currency」は属性と金額として保存され、「10.00」は要素として保存されます。 アダプティブフォームの送信データに含まれているのは要素だけで、属性は含まれていません。 そのため、XFA ベースフォームをアダプティブフォームに変換すると、アダプティブフォームの送信データの各属性には要素が保管されます。 例：
{ "Type": "Principal", "Amount": "10.00", "currency": "USD" } -
「作成」をクリックします。 クラウド設定が作成されます。 これで、AEM Forms インスタンスを使用して、従来のフォームをアダプティブフォームに変換する準備が整いました。