新しいレンダリングおよび送信サービス new-render-and-submit-service
はじめに introduction
Workbench で AssignTask
操作を定義する場合は、特定のフォーム(XDP または PDF フォーム)を指定します。また、アクションプロファイル経由で一連のレンダリングサービスと送信サービスを指定します。
XDP は、PDF フォームまたは HTML フォームとしてレンダリングすることができます。新しい機能により、以下のことが可能です。
- XDP フォームを HTML としてレンダリングして送信する
- XDP フォームをデスクトップで PDF として、およびモバイルデバイス(iPad など)で HTML としてレンダリングして送信する
新しい HTML フォームサービス new-html-forms-service
新しい HTML フォームサービスでは、フォームの新しい機能を使用して HTML としての XDP フォームのレンダリングをサポートします。新しい HTML フォームサービスでは以下のメソッドを表示します。
/*
* Generates a URL (for the HTML Form) to be passed to client, given a TaskContext.
* The output of this API is something like this - /lc/content/xfaforms/profiles/default.ws.html?ContentRoot=repository://Applications/MyApplication/MyFolder&template=MyForm.xdp
* @param taskContext task context
* @param profileName Forms servlet URL.
* @return form URL string
*/
public String generateFormURL(TaskContext taskContext, String profileName);
/*
* Render the XDP Form as HTML. Can be used directly for updating the runtimeMap in render.
* It adds the following keys to the map -
* hint:new html form = true
* newHTMLFormURL = the URL returned after calling 'generateFormURL' API.
* @param TaskContext taskContext
* @param profileName Forms servlet URL.
* @param runtimeMap runtime map<string,object> associated with form rendering.
* return runtimeMap
*/
public Map<String, Object> renderHTMLForm (TaskContext taskContext, String profileName, Map<String,Object> runtimeMap);
モバイルフォームプロファイルについて詳しくは、カスタムプロファイルの作成を参照してください。
新しい HTML フォームのレンダリングおよび送信プロセス new-html-form-render-amp-submit-processes
各「タスクの割り当て」操作で、フォームでレンダリングプロセスと送信プロセスを指定します。カスタム処理ができるように、これらのプロセスは TaskManager renderForm
および submitForm
API によって呼び出されます。新しい HTML フォームのためのこれらのプロセスのセマンティック:
新しい HTML フォームのレンダリング render-a-new-html-form
すべてのレンダリングプロセスと同様に、HTML をレンダリングするための新しいプロセスには以下の I/O パラメーターがあります。
必要情報 - taskContext
出力 - runtimeMap
出力 - outFormDoc
このメソッドは、NewHTMLFormsService の renderHTMLForm
API の正確な動作をシミュレーションします。これは、generateFormURL
API を呼び出してフォームの HTML 表示の URL を取得します。その後、runtimeMapに以下のキーや値を入力します:
new html form = true
newHTMLFormURL = generateFormURL
API を呼び出した後で返された URL
新しい HTML フォームの送信 submit-a-new-html-form
新しい HTML フォームを送信するこのプロセスには、以下の I/O パラメーターと連携します。
必要情報 - taskContext
出力 - runtimeMap
出力 - outputDocument
プロセスは、outputDocument
を taskContext
から取得した inputDocument
に設定します。
デフォルトのレンダリングプロセスまたは送信プロセス、およびアクションプロファイル default-render-or-submit-processes-and-action-profiles
デフォルトのレンダリングサービスと送信サービスにより、デスクトップで PDF を、モバイルデバイス(iPad)で HTML をレンダリングするためのサポートが可能です。
デフォルトのレンダリングフォーム default-render-form
このプロセスでは、XDP フォームを複数のプラットフォームにシームレスにレンダリングします。プロセスは、taskContext
からユーザーエージェントを取得し、データを使用して HTML または PDF のいずれかをレンダリングするプロセスを呼び出します。
デフォルトの送信フォーム default-submit-form
このプロセスでは、XDP フォームを複数のプラットフォームにシームレスに送信します。taskContext
からユーザーエージェントを取得し、データを使用して HTML または PDF のいずれかを送信するプロセスを呼び出します。
モバイルフォームのレンダリングを PDF から HTML に切り替える switch-the-rendering-of-mobile-forms-from-pdf-to-html
ブラウザーは、Adobe Acrobat および Adobe Acrobat Reader のプラグインを含め、NPAPI ベースのプラグインを徐々にサポートしなくなっています。モバイルフォームのレンダリングを PDF から HTML に変更するには、次の手順を実行します。
-
有効なユーザーとして Workbench にログインします。
-
File/Get Applications を選択します。
Get Applications ダイアログが表示されます。
-
モバイルフォームのレンダリングを変更する対象のアプリケーションを選択し、「OK」をクリックします。
-
レンダリングを変更する対象のプロセスを開きます。
-
対象のスタートポイント/タスクを開き、「Presentation & Data」セクションに移動して、「Manage Action Profiles」をクリックします。
Manage Action Profiles ダイアログが表示されます。
-
デフォルトのレンダリングプロファイル設定を PDF から HTML に変更し、「OK」をクリックします。
-
プロセスをチェックインします。
-
手順を繰り返して、他のプロセスのレンダリングを変更します。
-
変更したプロセスに関連するアプリケーションをデプロイします。
デフォルトのアクションプロファイル default-action-profile
デフォルトのアクションプロファイルは、XDP フォームを PDF としてレンダリングしていました。このビヘイビアーは、デフォルトのレンダリングフォームプロセスとデフォルトの送信フォームプロセスを使用するように変更されました。
アクションプロファイルに関するよくある質問の一部を次に示します。
どのようなレンダリング/ 送信プロセスが追加設定なしで使用できますか?
- Guide のレンダリング(Guide は推奨されていません)
- フォームガイドのレンダリング
- PDF フォームのレンダリング
- HTML フォームのレンダリング
- 新規 HTML フォームのレンダリング(新規)
- デフォルトのフォームのレンダリング(新規)
および同等の送信プロセス。
どのようなアクションプロファイルが追加設定なしで使用できますか?
XDP フォームの場合:
- デフォルト(新しい「デフォルトのレンダリング/送信」プロセスを使用したレンダリング/送信プロセス)
フォームをデバイス上では HTML およびデスクトップ上では PDF にレンダリングされるようにするには、プロセスデザイナーは何を行う必要がありますか?
何も必要ありません。デフォルトのアクションプロファイルが自動的に選択されて、レンダリングのモードも同じく自動的に処理されます。
フォームをデスクトップ上で HTML にレンダリングされるようにするには、何を行う必要がありますか?
ユーザーは、デフォルトプロファイルで HTML ラジオボタンを選択する必要があります。
デフォルトのアクションプロファイルの動作を変更すると、アップグレードに何らかの影響がありますか?
はい。デフォルトのアクションプロファイルに関連付けられた以前のレンダリングと送信サービスは異なるため、それらは既存のフォームのカスタマイズとして処理されます。「デフォルトを復元」をクリックすると、デフォルトのレンダリングと送信サービスが代わりに設定されます。
既存のレンダリングまたは送信 PDF Form サービスを変更した場合またはカスタムサービス(例えば custom1)を作成した場合、HTML レンダリングに対して同じ機能を使用するとします。新しいレンダリングまたは送信サービス(custom2)をレプリケートして、これらに同様のカスタマイズを適用する必要があります。次に、XDP のアクションプロファイルを変更し、レンダリングや送信で、custom1 の代わりに custom2 のサービスを使用するようにします。
デバイス上では HTML、デスクトップ上では PDF にフォームをレンダリングする場合、プロセスデザイナーは何を行う必要がありますか?
デバイス上では HTML、デスクトップ上では PDF にフォームをレンダリングする場合、プロセスデザイナーは何を行う必要がありますか?