エンドポイントレジストリサービスについて
Endpoint Registry サービスは、エンドポイントをプログラムで管理する機能を提供します。 例えば、次の種類のエンドポイントをサービスに追加できます。
EJB
SOAP
監視フォルダー
電子メール
(AEM forms では非推奨 )Remoting
タスクマネージャー
SOAP、EJB、および (JEE 上のAEM forms では非推奨 ) リモートエンドポイントは、アクティブ化された各サービスに対して自動的に作成されます。 SOAP および EJB エンドポイントは、すべてのサービス操作で SOAP および EJB を有効にします。
リモートエンドポイントを使用すると、Flexクライアントは、エンドポイントが追加されるAEM Formsサービスで操作を呼び出すことができます。 エンドポイントと同じ名前のFlex宛先が作成され、Flexクライアントは、この宛先を指す RemoteObjects を作成して、関連するサービスの操作を呼び出すことができます。
電子メール、タスクマネージャー、監視フォルダーの各エンドポイントでは、サービスの特定の操作のみが公開されます。 これらのエンドポイントを追加するには、呼び出すメソッドを選択し、設定パラメーターを設定し、入力および出力パラメーターのマッピングを指定する、2 番目の設定手順が必要です。
TaskManager エンドポイントは、 カテゴリ. その後、これらのカテゴリは TaskManager を通じて Workspace に公開され、エンドユーザーは TaskManager エンドポイントを分類されたとおりに表示します。 Workspace 内では、エンドユーザーはナビゲーションウィンドウにこれらのカテゴリを表示します。 各カテゴリ内のエンドポイントは、Workspace の「Start Processes」ページにプロセスカードとして表示されます。
Endpoint Registry サービスを使用して、次のタスクを実行できます。
EJB エンドポイントを追加します。 ( EJB エンドポイントの追加.)
SOAP エンドポイントを追加します。 ( SOAP エンドポイントの追加.)
監視フォルダーエンドポイントを追加する ( 監視フォルダーエンドポイントの追加.)
電子メールエンドポイントを追加します。 ( 電子メールエンドポイントの追加.)
リモートエンドポイントを追加します。 ( リモートエンドポイントの追加.)
TaskManager エンドポイントを追加します ( TaskManager エンドポイントの追加.)
エンドポイントを変更する ( エンドポイントの変更.)
エンドポイントを削除します ( エンドポイントの削除.)
エンドポイントコネクタ情報の取得 ( エンドポイントコネクタ情報の取得.)
EJB エンドポイントは、AEM Forms Java API を使用して、プログラムによってサービスに追加できます。 EJB エンドポイントをサービスに追加すると、クライアントアプリケーションで EJB モードを使用してサービスを呼び出すことができます。 つまり、AEM Formsを呼び出すために必要な接続プロパティを設定する場合、EJB モードを選択できます。 (接続プロパティの設定を参照。)
Web サービスを使用して EJB エンドポイントを追加することはできません。
通常、EJB エンドポイントはデフォルトでサービスに追加されますが、EJB エンドポイントは、プログラムでデプロイされたプロセスや、EJB エンドポイントが削除され、再度追加される必要があるプロセスに追加できます。
EJB エンドポイントをサービスに追加するには、次のタスクを実行します。
EndpointRegistry Client
オブジェクト。プロジェクトファイルを含める
開発プロジェクトに必要なファイルを含めます。 次の JAR ファイルをプロジェクトのクラスパスに追加する必要があります。
これらの JAR ファイルの場所について詳しくは、 AEM Forms Java ライブラリファイルを含める.
EndpointRegistry Client オブジェクトの作成
EJB エンドポイントをプログラムで追加する前に、 EndpointRegistryClient
オブジェクト。
EJB エンドポイント属性を設定する
サービスの EJB エンドポイントを作成するには、次の値を指定します。
EJB
.*
) をクリックします。 ただし、すべてのサービス操作を呼び出すのとは異なり、特定の操作を指定する場合は、ワイルドカード文字 ( *
) をクリックします。EJB エンドポイントの作成
EJB エンドポイント属性を設定した後、サービス用の EJB エンドポイントを作成できます。
エンドポイントを有効にする
新しいエンドポイントを作成したら、そのエンドポイントを有効にする必要があります。 エンドポイントを有効にした後は、エンドポイントを使用してサービスを呼び出すことができます。 エンドポイントを有効にすると、管理コンソール内で表示できます。
関連トピック
Java API を使用して EJB エンドポイントを追加します。
プロジェクトファイルを含めます。
Java プロジェクトのクラスパスに、adobe-livecycle-client.jar などのクライアント JAR ファイルを含めます。 (
EndpointRegistry Client オブジェクトを作成します。
ServiceClientFactory
オブジェクトを作成します。EndpointRegistryClient
オブジェクトのコンストラクタを使用し、 ServiceClientFactory
オブジェクト。EJB エンドポイント属性を設定します。
CreateEndpointInfo
オブジェクトを作成します。CreateEndpointInfo
オブジェクトの setConnectorId
メソッドと文字列値を渡す EJB
.CreateEndpointInfo
オブジェクトの setDescription
メソッドを使用してエンドポイントを表す string 値を渡す方法を示します。CreateEndpointInfo
オブジェクトの setName
メソッドを使用して、名前を指定する string 値を渡す。CreateEndpointInfo
オブジェクトの setServiceId
メソッドを使用して、サービス名を指定する string 値を渡す。CreateEndpointInfo
オブジェクトの setOperationName
メソッドを使用して、操作名を指定する string 値を渡します。 SOAP および EJB エンドポイントの場合、ワイルドカード文字 ( *
) で始まり、すべての操作を示します。EJB エンドポイントを作成します。
を呼び出してエンドポイントを作成する EndpointRegistryClient
オブジェクトの createEndpoint
メソッドおよび CreateEndpointInfo
オブジェクト。 このメソッドは、 Endpoint
新しい EJB エンドポイントを表すオブジェクト。
エンドポイントを有効にします。
を呼び出してエンドポイントを有効にする EndpointRegistryClient
オブジェクトの enable メソッドおよび Endpoint
が返したオブジェクト createEndpoint
メソッド。
関連トピック
クイックスタート:Java API を使用した EJB エンドポイントの追加
AEM Forms Java API を使用して、プログラムによって SOAP エンドポイントをサービスに追加できます。 SOAP エンドポイントを追加すると、SOAP モードを使用してクライアントアプリケーションからサービスを呼び出すことができます。 つまり、AEM Formsを呼び出すために必要な接続プロパティを設定する場合、SOAP モードを選択できます。
Web サービスを使用して SOAP エンドポイントを追加することはできません。
通常、SOAP エンドポイントはデフォルトでサービスに追加されます。ただし、SOAP エンドポイントは、プログラムによってデプロイされたプロセスや、SOAP エンドポイントが削除され、再度追加される必要があるプロセスに追加できます。
SOAP エンドポイントをサービスに追加するには、次のタスクを実行します。
EndpointRegistryClient
オブジェクト。プロジェクトファイルを含める
必要なファイルを開発プロジェクトに含めます。 Java を使用してクライアントアプリケーションを作成する場合は、必要な JAR ファイルを含めます。 Web サービスを使用している場合は、必ずプロキシファイルを含めてください。
次の JAR ファイルをプロジェクトのクラスパスに追加する必要があります。
これらの JAR ファイルは、SOAP エンドポイントを作成するために必要です。 ただし、SOAP エンドポイントを使用してサービスを呼び出す場合は、追加の JAR ファイルが必要です。 AEM Forms JAR ファイルについて詳しくは、 AEM Forms Java ライブラリファイルを含める.
EndpointRegistry Client オブジェクトの作成
プログラムによって SOAP エンドポイントをサービスに追加するには、 EndpointRegistryClient
オブジェクト。
SOAP エンドポイント属性の設定
SOAP エンドポイントをサービスに追加するには、次の値を指定します。
SOAP
.*
) をクリックします。 ただし、すべてのサービス操作を呼び出すのとは異なり、特定の操作を指定する場合は、ワイルドカード文字 ( *
) をクリックします。SOAP エンドポイントの作成
SOAP エンドポイント属性を設定した後、SOAP エンドポイントを作成できます。
エンドポイントを有効にする
新しいエンドポイントを作成したら、そのエンドポイントを有効にする必要があります。 エンドポイントが有効な場合、エンドポイントを使用してサービスを呼び出すことができます。 エンドポイントを有効にすると、管理コンソール内に表示されます。
関連トピック
Java API を使用した SOAP エンドポイントの追加
Java API を使用して、SOAP エンドポイントをサービスに追加します。
プロジェクトファイルを含めます。
Java プロジェクトのクラスパスに、adobe-livecycle-client.jar などのクライアント JAR ファイルを含めます。
EndpointRegistry Client オブジェクトを作成します。
ServiceClientFactory
オブジェクトを作成します。EndpointRegistryClient
オブジェクトのコンストラクタを使用し、 ServiceClientFactory
オブジェクト。SOAP エンドポイント属性を設定します。
CreateEndpointInfo
オブジェクトを作成します。CreateEndpointInfo
オブジェクトの setConnectorId
メソッドと文字列値を渡す SOAP
.CreateEndpointInfo
オブジェクトの setDescription
メソッドを使用してエンドポイントを表す string 値を渡す方法を示します。CreateEndpointInfo
オブジェクトの setName
メソッドを使用して、名前を指定する string 値を渡す。CreateEndpointInfo
オブジェクトの setServiceId
メソッドを使用して、サービス名を指定する string 値を渡す。CreateEndpointInfo
オブジェクトの setOperationName
メソッドを使用して、操作名を指定する string 値を渡す。 SOAP および EJB エンドポイントの場合、ワイルドカード文字 ( *
) で始まり、すべての操作を示します。SOAP エンドポイントを作成します。
を呼び出してエンドポイントを作成する EndpointRegistryClient
オブジェクトの createEndpoint
メソッドおよび CreateEndpointInfo
オブジェクト。 このメソッドは、 Endpoint
新しい SOAP エンドポイントを表すオブジェクト。
エンドポイントを有効にします。
を呼び出してエンドポイントを有効にする EndpointRegistryClient
オブジェクトの enable メソッドを参照し、 Endpoint
が返したオブジェクト createEndpoint
メソッド。
関連トピック
クイックスタート:Java API を使用した SOAP エンドポイントの追加
AEM Forms Java API を使用して、プログラムによって監視フォルダーエンドポイントをサービスに追加できます。 監視フォルダーエンドポイントを追加すると、ユーザーはフォルダーにファイル (PDFファイルなど ) を配置できます。 ファイルがフォルダーに配置されると、設定済みのサービスが呼び出され、ファイルが操作されます。 サービスが指定の操作を実行した後に、変更されたファイルが指定の出力フォルダーに保存されます。監視フォルダーは、毎週月曜日、水曜日、金曜日の正午など、一定の速度の間隔で、または Cron スケジュールでスキャンするように設定されます。
監視フォルダーエンドポイントをプログラムによってサービスに追加する場合は、次の短時間のみ有効なプロセスを考慮してください。 EncryptDocument. ( AEM Formsプロセスについて.)
このプロセスは、セキュリティで保護されていないPDFドキュメントを入力値として受け取り、セキュリティで保護されていないPDFドキュメントを Encryption サービスの EncryptPDFUsingPassword
操作。 PDFドキュメントはパスワードで暗号化され、PDFドキュメントはこのプロセスの出力値です。 入力値 ( 保護されていないPDFドキュメント ) の名前は InDoc
データタイプは com.adobe.idp.Document
. 出力値の名前 ( パスワードで暗号化されたPDFドキュメント ) は SecuredDoc
データタイプは com.adobe.idp.Document
.
Web サービスを使用して監視フォルダーエンドポイントを追加することはできません。
監視フォルダーエンドポイントをサービスに追加するには、次のタスクを実行します。
EndpointRegistryClient
オブジェクト。プロジェクトファイルを含める
必要なファイルを開発プロジェクトに含めます。 Java を使用してクライアントアプリケーションを作成する場合は、必要な JAR ファイルを含めます。 Web サービスを使用している場合は、必ずプロキシファイルを含めてください。
次の JAR ファイルをプロジェクトのクラスパスに追加する必要があります。
これらの JAR ファイルの場所について詳しくは、 AEM Forms Java ライブラリファイルを含める.
EndpointRegistry Client オブジェクトの作成
プログラムによって監視フォルダーエンドポイントを追加するには、 EndpointRegistryClient
オブジェクト。
監視フォルダーエンドポイントの属性を設定する
サービスの監視フォルダーエンドポイントを作成するには、次の値を指定します。
WatchedFolder
.EncryptDocument
.invoke
.設定値の指定
プログラムによって監視フォルダーエンドポイントをサービスに追加する場合は、監視フォルダーエンドポイントの設定値を指定する必要があります。 管理コンソールを使用して監視フォルダーエンドポイントを追加した場合、これらの設定値は管理者が指定します。
次のリストでは、監視フォルダーエンドポイントをプログラムでサービスに追加する際に設定される設定値を指定します。
data*
、 data*
取り出されていません。 これには、 data1
, data2
など。 また、ファイルパターンを指定するワイルドカードパターンをパターンに追加することもできます。 監視フォルダーでは、ワイルドカードパターン ( *.*
および *.pdf
. これらのワイルドカードパターンは、正規表現ではサポートされていません。*
、 input*
拾い上げられた これには、 input1
, input2
など。 デフォルト値は *
です。この値は、すべてのファイルとフォルダーを示します。 また、ファイルパターンを指定するワイルドカードパターンをパターンに追加することもできます。 監視フォルダーでは、ワイルドカードパターン ( *.*
および *.pdf
. これらのワイルドカードパターンは、正規表現ではサポートされていません。 この値は必須です。result/%Y/%M/%D/
です。これは、監視フォルダー内の結果フォルダーです。preserve/%Y/%M/%D/
です。failure/%Y/%M/%D/
です。入力パラメーター値の定義
監視フォルダーエンドポイントを作成する場合は、入力パラメーターの値を定義する必要があります。 つまり、監視フォルダーによって呼び出される操作に渡される入力値を記述する必要があります。 例えば、このトピックで導入されたプロセスを考えてみましょう。 これには、 InDoc
で、そのデータタイプは com.adobe.idp.Document
. このプロセスの監視フォルダーエンドポイントを作成する場合(プロセスがアクティブ化されると、そのエンドポイントがサービスになります)、入力パラメーターの値を定義する必要があります。
監視フォルダーエンドポイントに必要な入力パラメーター値を定義するには、次の値を指定します。
パラメーター名を入力:入力パラメーターの名前。 入力値の名前は、プロセスに対して Workbench で指定されます。 入力値がサービス操作(Workbench で作成されたプロセスではないサービス)に属する場合、入力名は component.xml ファイルで指定されます。 例えば、この節で紹介するプロセスの入力パラメーターの名前は、 InDoc
.
マッピングタイプ:サービス操作を呼び出すために必要な入力値を設定するために使用します。 マッピングには次の 2 つのタイプがあります。
Literal
:監視フォルダーエンドポイントは、フィールドに入力された値を表示どおりに使用します。 すべての基本 Java 型がサポートされます。例えば、String、long、int、Boolean などの入力を使用する API の場合、文字列は適切な型に変換され、サービスが呼び出されます。Variable
:入力された値は、監視フォルダーが入力の選択に使用するファイルパターンです。 例えば、マッピングの種類に「変数」を選択し、入力ドキュメントをPDF・ファイルにする場合、 *.pdf
をマッピング値として使用します。マッピング値:マッピングタイプの値を指定します。 例えば、 Variable
マッピングのタイプ、 *.pdf
をファイルパターンとして使用します。
データタイプ:入力値のデータタイプを指定します。 例えば、この節で紹介するプロセスの入力値のデータ型は、 com.adobe.idp.Document
.
出力パラメータ値の定義
監視フォルダーエンドポイントを作成する場合は、出力パラメーターの値を定義する必要があります。 つまり、監視フォルダーエンドポイントによって呼び出されるサービスによって返される出力値を記述する必要があります。 例えば、このトピックで導入されたプロセスを考えてみましょう。 これには、 SecuredDoc
で、そのデータタイプは com.adobe.idp.Document
. このプロセスの監視フォルダーエンドポイントを作成する場合(プロセスがアクティブ化されると、そのエンドポイントがサービスになります)、出力パラメーターの値を定義する必要があります。
監視フォルダーエンドポイントに必要な出力パラメーター値を定義するには、次の値を指定します。
出力パラメーター名:出力パラメーターの名前。 プロセス出力値の名前は、Workbench で指定します。 出力値がサービス操作(Workbench で作成されたプロセスではないサービス)に属する場合、出力名は component.xml ファイルで指定されます。 例えば、この節で紹介するプロセスの出力パラメーターの名前は、 SecuredDoc
.
マッピングタイプ:サービスと操作の出力を設定するために使用します。 以下のオプションが利用できます。
%F.pdf
ソースの宛先は sourcefilename.pdf です。 例えば、この節で紹介したプロセスは、1 つのドキュメントを返します。 その結果、マッピングタイプは %F.pdf
( %F
は、指定されたファイル名を使用することを意味します )。 パターン %E
入力ドキュメントの拡張を指定します。Result\%F\
の場合、ソースの宛先は Result\sourcefilename\source1 (出力 1)および Result\sourcefilename\source2 (出力 2)です。Result\%F\
の場合、ソースの宛先は Result\sourcefilename\file1 および Result\sourcefilename\file2 です。 マップに複数のオブジェクトがある場合、パターンは次のようになります。 Result\%F.pdf
ソースの宛先は Result\sourcefilename1.pdf (出力 1)、Result\sourcefilenam2.pdf (出力 2)などです。データタイプ:戻り値のデータ型を指定します。 例えば、この節で導入されるプロセスの戻り値のデータ型はです com.adobe.idp.Document
.
監視フォルダーエンドポイントの作成
エンドポイントの属性、設定値を設定し、入力パラメーターと出力パラメーターの値を定義した後、監視フォルダーエンドポイントを作成する必要があります。
エンドポイントを有効にする
監視フォルダーエンドポイントを作成したら、そのエンドポイントを有効にする必要があります。 エンドポイントが有効な場合、エンドポイントを使用してサービスを呼び出すことができます。 エンドポイントを有効にすると、管理コンソール内で表示できます。
関連トピック
Java API を使用した監視フォルダーエンドポイントの追加
AEM Forms Java API を使用して、監視フォルダーエンドポイントを追加します。
プロジェクトファイルを含めます。
Java プロジェクトのクラスパスに、adobe-livecycle-client.jar などのクライアント JAR ファイルを含めます。
EndpointRegistry Client オブジェクトを作成します。
ServiceClientFactory
オブジェクトを作成します。EndpointRegistryClient
オブジェクトのコンストラクタを使用し、 ServiceClientFactory
オブジェクト。監視フォルダーエンドポイント属性を設定します。
CreateEndpointInfo
オブジェクトを作成します。CreateEndpointInfo
オブジェクトの setConnectorId
メソッドと文字列値を渡す WatchedFolder
.CreateEndpointInfo
オブジェクトの setDescription
メソッドを使用してエンドポイントを表す string 値を渡す方法を示します。CreateEndpointInfo
オブジェクトの setName
メソッドを使用して、名前を指定する string 値を渡す。CreateEndpointInfo
オブジェクトの setServiceId
メソッドを使用して、サービス名を指定する string 値を渡す。CreateEndpointInfo
オブジェクトの setOperationName
メソッドを使用して、操作名を指定する string 値を渡す。 通常、Workbench で作成されたプロセスから生成されたサービスの監視フォルダーエンドポイントを作成する場合、操作の名前は invoke になります。設定値を指定します。
設定値ごとに、監視フォルダーエンドポイントに対してを呼び出す必要があります。 CreateEndpointInfo
オブジェクトの setConfigParameterAsText
メソッド。 例えば、 url
設定値、 CreateEndpointInfo
オブジェクトの setConfigParameterAsText
メソッドを使用して、次の文字列値を渡します。
url
設定値、指定 url
.url
設定値で、監視フォルダーの場所を指定します。EncryptDocument サービスに設定されたすべての設定値を確認するには、次の Java コードの例を参照してください。 クイックスタート:Java API を使用した監視フォルダーエンドポイントの追加.
入力パラメーター値を定義します。
を呼び出して、入力パラメーター値を定義する CreateEndpointInfo
オブジェクトの setInputParameterMapping
メソッドを使用して、次の値を渡します。
InDoc
.InDoc
入力パラメーター: com.adobe.idp.Document
.variable
.を呼び出す setInputParameterMapping
メソッドを使用します。 EncryptDocument プロセスには 1 つの入力パラメーターしかないので、このメソッドを 1 回呼び出す必要があります。
出力パラメータ値を定義します。
を呼び出して、出力パラメーター値を定義する CreateEndpointInfo
オブジェクトの setOutputParameterMapping
メソッドを使用して、次の値を渡します。
SecuredDoc
.SecuredDoc
出力パラメーターは com.adobe.idp.Document
.%F.pdf
.監視フォルダーエンドポイントを作成します。
を呼び出してエンドポイントを作成する EndpointRegistryClient
オブジェクトの createEndpoint
メソッドおよび CreateEndpointInfo
オブジェクト。 このメソッドは、 Endpoint
オブジェクトを返します。
エンドポイントを有効にします。
を呼び出してエンドポイントを有効にする EndpointRegistryClient
オブジェクトの enable
メソッドおよび Endpoint
が返したオブジェクト createEndpoint
メソッド。
関連トピック
クイックスタート:Java API を使用した監視フォルダーエンドポイントの追加
この クイックスタート:Java API を使用した監視フォルダーエンドポイントの追加 は、クイックスタートをコンパイルするために Java プロジェクトの一部である必要がある定数ファイルを使用します。 この定数ファイルは、監視フォルダーエンドポイントを追加する際に設定する必要がある設定値を表します。 次の Java コードは、定数ファイルを表しています。
/**
* This class contains constants that can be used when setting Watched Folder
* configuration values
*/
public final class WatchedFolderEndpointConfigConstants {
public static final String PROPERTY_FILEPROVIDER_URL = "url";
public static final String PROPERTY_PROPERTY_ASYNCHRONOUS = "asynchronous";
public static final String PROPERTY_CRON_EXPRESSION = "cronExpression";
public static final String PROPERTY_PURGE_DURATION = "purgeDuration";
public static final String PROPERTY_REPEAT_INTERVAL = "repeatInterval";
public static final String PROPERTY_REPEAT_COUNT = "repeatCount";
public static final String PROPERTY_THROTTLE = "throttleOn";
public static final String PROPERTY_USERNAMER = "userName";
public static final String PROPERTY_DOMAINNAME = "domainName";
public static final String PROPERTY_FILEPROVIDER_BATCH_SIZE = "batchSize";
public static final String PROPERTY_FILEPROVIDER_WAIT_TIME = "waitTime";
public static final String PROPERTY_EXCLUDE_FILE_PATTERN = "excludeFilePattern";
public static final String PROPERTY_INCLUDE_FILE_PATTERN = "excludeFilePattern";
public static final String PROPERTY_FILEPROVIDER_RESULT_FOLDER_NAME = "resultFolderName";
public static final String PROPERTY_FILEPROVIDER_PRESERVE_FOLDER_NAME = "preserveFolderName";
public static final String PROPERTY_FILEPROVIDER_FAILURE_FOLDER_NAME = "failureFolderName";
public static final String PROPERTY_FILEPROVIDER_PRESERVE_ON_FAILURE = "preserveOnFailure";
public static final String PROPERTY_FILEPROVIDER_OVERWRITE_DUPLICATE_FILENAME = "overwriteDuplicateFilename";
}
AEM Forms Java API を使用して、プログラムによって電子メールエンドポイントをサービスに追加できます。 電子メールエンドポイントを追加すると、1 つ以上の添付ファイルを含む電子メールメッセージを、指定した電子メールアカウントに送信できます。 次に、configure サービス操作が呼び出され、ファイルが操作されます。 指定した操作を実行すると、変更されたファイルが添付ファイルとして送信者に電子メールメッセージが送信されます。
E メールエンドポイントをプログラムでサービスに追加する場合は、次のような短時間のみ有効なプロセスを考慮してください。 MyApplication\EncryptDocument. 短時間のみ有効なプロセスについては、 AEM Formsプロセスについて.
このプロセスは、セキュリティで保護されていないPDFドキュメントを入力値として受け取り、セキュリティで保護されていないPDFドキュメントを Encryption サービスの EncryptPDFUsingPassword
操作。 このプロセスは、PDFドキュメントをパスワードで暗号化し、パスワードで暗号化されたPDFドキュメントを出力値として返します。 入力値 ( 保護されていないPDFドキュメント ) の名前は InDoc
データタイプは com.adobe.idp.Document
. 出力値の名前 ( パスワードで暗号化されたPDFドキュメント ) は SecuredDoc
データタイプは com.adobe.idp.Document
.
Web サービスを使用して E メールエンドポイントを追加することはできません。
E メールエンドポイントをサービスに追加するには、次のタスクを実行します。
EndpointRegistryClient
オブジェクト。プロジェクトファイルを含める
必要なファイルを開発プロジェクトに含めます。 Java を使用してクライアントアプリケーションを作成する場合は、必要な JAR ファイルを含めます。 Web サービスを使用している場合は、必ずプロキシファイルを含めてください。
次の JAR ファイルをプロジェクトのクラスパスに追加する必要があります。
これらの JAR ファイルの場所について詳しくは、 AEM Forms Java ライブラリファイルを含める.
EndpointRegistry Client オブジェクトの作成
プログラムで電子メールエンドポイントを追加する前に、 EndpointRegistryClient
オブジェクト。
電子メールエンドポイント属性を設定
サービスの電子メールエンドポイントを作成するには、次の値を指定します。
Email
.EncryptDocument
.invoke
.設定値の指定
プログラムによって電子メールエンドポイントをサービスに追加する場合は、電子メールエンドポイントの設定値を指定する必要があります。 これらの設定値は、管理コンソールを使用して E メールエンドポイントを追加した場合、管理者が指定します。
監視対象の電子メールアカウントは、電子メールエンドポイントにのみ使用される特別なアカウントです。 このアカウントは通常のユーザーの電子メールアカウントではありません。 通常のユーザーの電子メールアカウントは、電子メールプロバイダーが使用するアカウントとして設定してはいけません。電子メールプロバイダーは、メッセージの使用が完了した後で、インボックスから電子メールメッセージを削除します。
プログラムによって電子メールエンドポイントをサービスに追加する際に、次の設定値が設定されます。
SuperAdmin
です。DefaultDom
です。adobe.com
が使用される場合、adobe.com からの電子メールのみが処理され、他のドメインからの電子メールは無視されます。*
です。sender
と入力すると、電子メールの結果は送信者に送信されます。最大 100 人の受信者を指定できます。追加の受信者を電子メールアドレスで指定します。各受信者はコンマで区切ります。 このオプションをオフにするには、この値を空白のままにします。 場合によっては、プロセスをトリガーし、結果の電子メール通知を受け取りたくないことがあります。 デフォルト値は sender
です。sender
と入力すると、電子メールの結果は送信者に送信されます。最大 100 人の受信者を指定できます。追加の受信者を電子メールアドレスで指定します。各受信者はコンマで区切ります。 このオプションをオフにするには、この値を空白のままにします。 デフォルト値は sender
です。IMAP
または POP3
. 指定のプロトコルはインボックスホストメールサーバーでサポートされている必要があります。UTF-8
です。入力パラメーター値の定義
E メールエンドポイントを作成する場合、入力パラメーターの値を定義する必要があります。 つまり、E メールエンドポイントによって呼び出される操作に渡される入力値を記述する必要があります。 例えば、このトピックで導入されたプロセスを考えてみましょう。 これには、 InDoc
で、そのデータタイプは com.adobe.idp.Document
. このプロセスの E メールエンドポイントを作成する場合(プロセスがアクティブ化されると、サービスになります)、入力パラメーター値を定義する必要があります。
電子メールエンドポイントに必要な入力パラメーター値を定義するには、次の値を指定します。
パラメーター名を入力:入力パラメーターの名前。 入力値の名前は、プロセスに対して Workbench で指定されます。 入力値がサービス操作 (Workbench で作成されたプロセスではないFormsサービス ) に属する場合、入力名は component.xml ファイルで指定されます。 例えば、この節で紹介するプロセスの入力パラメーターの名前は、 InDoc
.
マッピングタイプ:サービス操作を呼び出すために必要な入力値を設定するために使用します。 マッピングのタイプには次の 2 種類があります。
Literal
:E メールエンドポイントは、フィールドに表示されるとおりに入力された値を使用します。 すべての基本 Java 型がサポートされます。例えば、String、long、int および Boolean などの入力が使用される API の場合、文字列は適切な型に変換され、サービスが呼び出されます。Variable
:入力された値は、E メールエンドポイントが入力の選択に使用するファイルパターンです。 例えば、マッピングの種類に「変数」を選択し、入力ドキュメントをPDF・ファイルにする場合、 *.pdf
をマッピング値として使用します。マッピング値:マッピングタイプの値を指定します。 例えば、変数マッピングタイプを選択した場合、 *.pdf
をファイルパターンとして使用します。
データタイプ:入力値のデータタイプを指定します。 例えば、この節で紹介するプロセスの入力値のデータ型は com.adobe.idp.Document です。
出力パラメータ値の定義
電子メールエンドポイントを作成する場合、出力パラメーターの値を定義する必要があります。 つまり、E メールエンドポイントによって呼び出されるサービスによって返される出力値を記述する必要があります。 例えば、このトピックで導入されたプロセスを考えてみましょう。 これには、 SecuredDoc
で、そのデータタイプは com.adobe.idp.Document
. このプロセスの E メールエンドポイントを作成する場合(プロセスがアクティブ化されると、サービスになります)、出力パラメーターの値を定義する必要があります。
電子メールエンドポイントに必要な出力パラメーター値を定義するには、次の値を指定します。
出力パラメーター名:出力パラメーターの名前。 プロセス出力値の名前は、Workbench で指定します。 出力値がサービス操作(Workbench で作成されたプロセスではないサービス)に属する場合、出力名は component.xml ファイルで指定されます。 例えば、この節で紹介するプロセスの出力パラメーターの名前は、 SecuredDoc
.
マッピングタイプ:サービスと操作の出力を設定するために使用します。 以下のオプションが利用できます。
%F.pdf
ソースの宛先は sourcefilename.pdf です。 例えば、この節で紹介したプロセスは、1 つのドキュメントを返します。 その結果、マッピングタイプは %F.pdf
( %F
は、指定されたファイル名を使用することを意味します )。 パターン %E
入力ドキュメントの拡張を指定します。Result\%F\
の場合、ソースの宛先は Result\sourcefilename\source1 (出力 1)および Result\sourcefilename\source2 (出力 2)です。Result\%F\
の場合、ソースの宛先は Result\sourcefilename\file1 および Result\sourcefilename\file2 です。 マップに複数のオブジェクトがある場合、パターンは次のようになります。 Result\%F.pdf
ソースの宛先は Result\sourcefilename1.pdf (出力 1)、Result\sourcefilenam2.pdf (出力 2)などです。データタイプ:戻り値のデータ型を指定します。 例えば、この節で導入されるプロセスの戻り値のデータ型はです com.adobe.idp.Document
.
E メールエンドポイントの作成
電子メールエンドポイントの属性と設定値を設定し、入力および出力パラメーターの値を定義した後、電子メールエンドポイントを作成する必要があります。
エンドポイントを有効にする
E メールエンドポイントを作成したら、そのエンドポイントを有効にする必要があります。 エンドポイントが有効な場合、エンドポイントを使用してサービスを呼び出すことができます。 エンドポイントを有効にすると、管理コンソール内で表示できます。
関連トピック
Java API を使用して電子メールエンドポイントを追加します。
プロジェクトファイルを含めます。
Java プロジェクトのクラスパスに、adobe-livecycle-client.jar などのクライアント JAR ファイルを含めます。
EndpointRegistry Client オブジェクトを作成します。
ServiceClientFactory
オブジェクトを作成します。EndpointRegistryClient
オブジェクトのコンストラクタを使用し、 ServiceClientFactory
オブジェクト。電子メールエンドポイント属性を設定します。
CreateEndpointInfo
オブジェクトを作成します。CreateEndpointInfo
オブジェクトの setConnectorId
メソッドと文字列値を渡す Email
.CreateEndpointInfo
オブジェクトの setDescription
メソッドを使用してエンドポイントを表す string 値を渡す方法を示します。CreateEndpointInfo
オブジェクトの setName
メソッドを使用して、名前を指定する string 値を渡す。CreateEndpointInfo
オブジェクトの setServiceId
メソッドを使用して、サービス名を指定する string 値を渡す。CreateEndpointInfo
オブジェクトの setOperationName
メソッドを使用して、操作名を指定する string 値を渡す。 通常、Workbench で作成されたプロセスから生成されたサービスの電子メールエンドポイントを作成する場合、操作の名前は invoke になります。設定値を指定します。
電子メールエンドポイントに設定する設定値ごとに、 CreateEndpointInfo
オブジェクトの setConfigParameterAsText
メソッド。 例えば、 smtpHost
設定値、 CreateEndpointInfo
オブジェクトの setConfigParameterAsText
メソッドを使用して、次の値を渡します。
smtpHost
設定値、指定 smtpHost
.smtpHost
設定値:SMTP サーバーの名前を指定する string 値を指定します。この節で紹介する EncryptDocument サービスに設定されたすべての設定値を確認するには、次の Java コードの例を参照してください。 クイックスタート:Java API を使用した電子メールエンドポイントの追加.
入力パラメーター値を定義します。
を呼び出して、入力パラメーター値を定義する CreateEndpointInfo
オブジェクトの setInputParameterMapping
メソッドを使用して、次の値を渡します。
InDoc
.InDoc
入力パラメーター: com.adobe.idp.Document
.variable
.を呼び出す setInputParameterMapping
メソッドを使用します。 EncryptDocument プロセスには 1 つの入力パラメーターしかないので、このメソッドを 1 回呼び出す必要があります。
出力パラメータ値を定義します。
を呼び出して、出力パラメーター値を定義する CreateEndpointInfo
オブジェクトの setOutputParameterMapping
メソッドを使用して、次の値を渡します。
SecuredDoc
.SecuredDoc
出力パラメーターは com.adobe.idp.Document
.%F.pdf
.E メールエンドポイントを作成します。
を呼び出してエンドポイントを作成する EndpointRegistryClient
オブジェクトの createEndpoint
メソッドおよび CreateEndpointInfo
オブジェクト。 このメソッドは、 Endpoint
E メールエンドポイントを表すオブジェクト。
エンドポイントを有効にします。
を呼び出してエンドポイントを有効にする EndpointRegistryClient
オブジェクトの enable
メソッドおよび Endpoint
が返したオブジェクト createEndpoint
メソッド。
関連トピック
クイックスタート:Java API を使用した監視フォルダーエンドポイントの追加
この クイックスタート:Java API を使用した電子メールエンドポイントの追加 は、クイックスタートをコンパイルするために Java プロジェクトの一部である必要がある定数ファイルを使用します。 この定数ファイルは、電子メールエンドポイントを追加する際に設定する必要がある設定値を表します。 次の Java コードは、定数ファイルを表しています。
/**
* This class contains constants that can be used when setting email endpoint
* configuration values
*/
public class EmailEndpointConfigConstants {
public static final String PROPERTY_EMAILPROVIDER_CRON_EXPRESSION = "cronExpression";
public static final String PROPERTY_EMAILPROVIDER_REPREAT_COUNT = "repeatCount";
public static final String PROPERTY_EMAILPROVIDER_REPREAT_INTERVAL = "repeatInterval";
public static final String PROPERTY_EMAILPROVIDER_START_DELAY = "startDelay";
public static final String PROPERTY_EMAILPROVIDER_BATCH_SIZE = "batchSize";
public static final String PROPERTY_EMAILPROVIDER_USERNAME = "userName";
public static final String PROPERTY_EMAILPROVIDER_DOMAINNAME = "domainName";
public static final String PROPERTY_EMAILPROVIDER_DOMAINPATTERN = "domainPattern";
public static final String PROPERTY_EMAILPROVIDER_FILEPATTERN = "filePattern";
public static final String PROPERTY_EMAILPROVIDER_RECIPIENT_SUCCESSFUL_JOB = "recipientSuccessfulJob";
public static final String PROPERTY_EMAILPROVIDER_RECIPIENT_FAILED_JOB = "recipientFailedJob";
public static final String PROPERTY_EMAILPROVIDER_INBOX_HOST = "inboxHost";
public static final String PROPERTY_EMAILPROVIDER_INBOX_PORT = "inboxPort";
public static final String PROPERTY_EMAILPROVIDER_PROTOCOL = "inboxProtocol";
public static final String PROPERTY_EMAILPROVIDER_INBOX_TIMEOUT = "inboxTimeOut";
public static final String PROPERTY_EMAILPROVIDER_INBOX_USER = "inboxUser";
public static final String PROPERTY_EMAILPROVIDER_INBOX_PASSWORD = "inboxPassword";
public static final String PROPERTY_EMAILPROVIDER_INBOX_SSL = "inboxSSLEnabled";
public static final String PROPERTY_EMAILPROVIDER_SMTP_HOST = "smtpHost";
public static final String PROPERTY_EMAILPROVIDER_SMTP_PORT = "smtpPort";
public static final String PROPERTY_EMAILPROVIDER_SMTP_USER = "smtpUser";
public static final String PROPERTY_EMAILPROVIDER_SMTP_PASSWORD = "smtpPassword";
public static final String PROPERTY_EMAILPROVIDER_CHARSET = "charSet";
public static final String PROPERTY_EMAILPROVIDER_SMTP_SSL = "smtpSSLEnabled";
public static final String PROPERTY_EMAILPROVIDER_FAILED_FOLDER = "failedJobFolder";
public static final String PROPERTY_EMAILPROVIDER_ASYNCHRONOUS = "asynchronous";
}
JEE 上のAEM forms で非推奨となったLiveCycle RemotingAPI。
AEM Forms Java API を使用して、プログラムによってリモートエンドポイントをサービスに追加できます。 リモートエンドポイントを追加すると、リモート処理を使用してFlexアプリケーションからサービスを呼び出すことができます。 ( (AEM forms では廃止 )AEM Forms Remoting を使用したAEM Formsの呼び出し.)
リモートエンドポイントをプログラムでサービスに追加する場合は、次の短時間のみ有効なプロセスを考慮してください。 EncryptDocument.
このプロセスは、セキュリティで保護されていないPDFドキュメントを入力値として受け取り、セキュリティで保護されていないPDFドキュメントを Encryption サービスの EncryptPDFUsingPassword
操作。 PDFドキュメントはパスワードで暗号化され、PDFドキュメントはこのプロセスの出力値です。 入力値 ( 保護されていないPDFドキュメント ) の名前は InDoc
データタイプは com.adobe.idp.Document
. 出力値の名前 ( パスワードで暗号化されたPDFドキュメント ) は SecuredDoc
データタイプは com.adobe.idp.Document
.
このセクションでは、EncryptDocument という名前のサービスにリモートエンドポイントを追加する方法を示します。
Web サービスを使用してリモートエンドポイントを追加することはできません。
エンドポイントをサービスから削除するには、次のタスクを実行します。
EndpointRegistryClient
オブジェクト。プロジェクトファイルを含める
必要なファイルを開発プロジェクトに含めます。 Java を使用してクライアントアプリケーションを作成する場合は、必要な JAR ファイルを含めます。 Web サービスを使用している場合は、必ずプロキシファイルを含めてください。
次の JAR ファイルをプロジェクトのクラスパスに追加する必要があります。
これらの JAR ファイルの場所について詳しくは、 AEM Forms Java ライブラリファイルを含める.
EndpointRegistry Client オブジェクトの作成
プログラムによってリモートエンドポイントを追加するには、 EndpointRegistryClient
オブジェクト。
リモートエンドポイント属性の設定
サービスのリモートエンドポイントを作成するには、次の値を指定します。
Remoting
.EncryptDocument
.リモートエンドポイントの作成
リモートエンドポイント属性を設定した後、サービスのリモートエンドポイントを作成できます。
エンドポイントを有効にする
新しいエンドポイントを作成したら、そのエンドポイントを有効にする必要があります。 リモートエンドポイントが有効な場合、Flexクライアントがサービスを呼び出すことができます。
関連トピック
Java API を使用してリモートエンドポイントを追加します。
プロジェクトファイルを含めます。
Java プロジェクトのクラスパスに、adobe-livecycle-client.jar などのクライアント JAR ファイルを含めます。
EndpointRegistry Client オブジェクトを作成します。
ServiceClientFactory
オブジェクトを作成します。EndpointRegistryClient
オブジェクトのコンストラクタを使用し、 ServiceClientFactory
オブジェクト。リモートエンドポイントの属性を設定します。
CreateEndpointInfo
オブジェクトを作成します。CreateEndpointInfo
オブジェクトの setConnectorId
メソッドと文字列値を渡す Remoting
.CreateEndpointInfo
オブジェクトの setDescription
メソッドを使用してエンドポイントを表す string 値を渡す方法を示します。CreateEndpointInfo
オブジェクトの setName
メソッドを使用して、名前を指定する string 値を渡す。CreateEndpointInfo
オブジェクトの setServiceId
メソッドを使用して、サービス名を指定する string 値を渡す。CreateEndpointInfo
オブジェクトの setOperationName
メソッドを使用して、操作名を指定する string 値を渡す。 リモートエンドポイントの場合は、ワイルドカード文字 (*) を指定します。リモートエンドポイントを作成します。
を呼び出してエンドポイントを作成する EndpointRegistryClient
オブジェクトの createEndpoint
メソッドおよび CreateEndpointInfo
オブジェクト。 このメソッドは、 Endpoint
新しい Remoting エンドポイントを表すオブジェクト。
エンドポイントを有効にします。
を呼び出してエンドポイントを有効にする EndpointRegistryClient
オブジェクトの enable
メソッドおよび Endpoint
が返したオブジェクト createEndpoint
メソッド。
関連トピック
クイックスタート:Java API を使用したリモートエンドポイントの追加
AEM Forms Java API を使用して、TaskManager エンドポイントをプログラムでサービスに追加できます。 TaskManager エンドポイントをサービスに追加することで、Workspace ユーザーがサービスを呼び出せるようにします。 つまり、Workspace で作業しているユーザーは、対応する TaskManager エンドポイントを持つプロセスを呼び出すことができます。
Web サービスを使用して TaskManager エンドポイントを追加することはできません。
TaskManager エンドポイントをサービスに追加するには、次のタスクを実行します。
EndpointRegistryClient
オブジェクト。プロジェクトファイルを含める
必要なファイルを開発プロジェクトに含めます。 Java を使用してクライアントアプリケーションを作成する場合は、必要な JAR ファイルを含めます。 Web サービスを使用している場合は、必ずプロキシファイルを含めてください。
次の JAR ファイルをプロジェクトのクラスパスに追加する必要があります。
これらの JAR ファイルの場所について詳しくは、 AEM Forms Java ライブラリファイルを含める.
EndpointRegistry Client オブジェクトの作成
TaskManager エンドポイントをプログラムで追加する前に、 EndpointRegistryClient
オブジェクト。
エンドポイントのカテゴリの作成
カテゴリは、Workspace 内のサービスを整理するために使用されます。 つまり、Workspace ユーザーは、Workspace 内のカテゴリを選択することで、TaskManager エンドポイントを持つサービスを呼び出すことができます。 TaskManager エンドポイントを作成する場合、既存のカテゴリを参照するか、新しいカテゴリをプログラムで作成できます。
このセクションでは、TaskManager エンドポイントをサービスに追加する際に、新しいカテゴリを作成します。
TaskManager エンドポイント属性の設定
サービスの TaskManager エンドポイントを作成するには、次の値を指定します。
TaskManagerConnector
.invoke
.TaskManager エンドポイントの作成
TaskManager エンドポイント属性を設定した後、サービスの TaskManager エンドポイントを作成できます。
エンドポイントを有効にする
新しいエンドポイントを作成したら、そのエンドポイントを有効にする必要があります。 エンドポイントが有効な場合、Workspace 内からサービスを呼び出すために使用できます。 エンドポイントを有効にすると、管理コンソール内で表示できます。
関連トピック
Java API を使用した TaskManager エンドポイントの追加
Java API を使用して TaskManager エンドポイントを追加します。
プロジェクトファイルを含めます。
Java プロジェクトのクラスパスに、adobe-livecycle-client.jar などのクライアント JAR ファイルを含めます。
EndpointRegistry Client オブジェクトを作成します。
ServiceClientFactory
オブジェクトを作成します。EndpointRegistryClient
オブジェクトのコンストラクタを使用し、 ServiceClientFactory
オブジェクト。エンドポイントのカテゴリを作成します。
の作成 CreateEndpointCategoryInfo
オブジェクトを作成するには、コンストラクタを使用し、次の値を渡します。
を呼び出して、カテゴリを作成します。 EndpointRegistryClient
オブジェクトの createEndpointCategory
メソッドおよび CreateEndpointCategoryInfo
オブジェクト。 このメソッドは、 EndpointCategory
新しいカテゴリを表すオブジェクト。
TaskManager エンドポイント属性を設定します。
CreateEndpointInfo
オブジェクトを作成します。CreateEndpointInfo
オブジェクトの setConnectorId
メソッドと文字列値を渡す TaskManagerConnector
.CreateEndpointInfo
オブジェクトの setDescription
メソッドを使用してエンドポイントを表す string 値を渡す方法を示します。CreateEndpointInfo
オブジェクトの setName
メソッドを使用して、名前を指定する string 値を渡す。CreateEndpointInfo
オブジェクトの setServiceId
メソッドを使用して、サービス名を指定する string 値を渡す。CreateEndpointInfo
オブジェクトの setCategoryId
メソッドを使用して、カテゴリ識別子の値を指定する string 値を渡す。 を呼び出すことができます。 EndpointCategory
オブジェクトの getId
メソッドを使用して、このカテゴリの識別子の値を取得します。CreateEndpointInfo
オブジェクトの setOperationName
メソッドを使用して、操作名を指定する string 値を渡す。 通常、 TaskManager
Workbench で作成されたプロセスから派生するサービスのエンドポイントで、操作の名前は invoke
.TaskManager エンドポイントを作成します。
を呼び出してエンドポイントを作成する EndpointRegistryClient
オブジェクトの createEndpoint
メソッドおよび CreateEndpointInfo
オブジェクト。 このメソッドは、 Endpoint
新しい TaskManager エンドポイントを表すオブジェクト。
エンドポイントを有効にします。
を呼び出してエンドポイントを有効にする EndpointRegistryClient
オブジェクトの enable
メソッドおよび Endpoint
が返したオブジェクト createEndpoint
メソッド。
関連トピック
クイックスタート:Java API を使用した TaskManager エンドポイントの追加
AEM Forms Java API を使用して、既存のエンドポイントをプログラムで変更できます。 エンドポイントを変更すると、エンドポイントの動作を変更できます。 例えば、監視フォルダーとして使用するフォルダーを指定する監視フォルダーエンドポイントがあるとします。 監視フォルダーエンドポイントに属する設定値をプログラムで変更することで、別のフォルダーが監視フォルダーとして機能するようになります。 監視フォルダーエンドポイントに属する設定値について詳しくは、 監視フォルダーエンドポイントの追加.
この節では、エンドポイントを変更する方法を示すために、監視フォルダーとして動作するフォルダーを変更して、監視フォルダーエンドポイントを変更します。
Web サービスを使用してエンドポイントを変更することはできません。
エンドポイントを変更するには、次のタスクを実行します。
EndpointRegistryClient
オブジェクト。プロジェクトファイルを含める
必要なファイルを開発プロジェクトに含めます。 Java を使用してクライアントアプリケーションを作成する場合は、必要な JAR ファイルを含めます。 Web サービスを使用している場合は、必ずプロキシファイルを含めてください。
次の JAR ファイルをプロジェクトのクラスパスに追加する必要があります。
これらの JAR ファイルの場所について詳しくは、 AEM Forms Java ライブラリファイルを含める.
EndpointRegistry Client オブジェクトの作成
エンドポイントをプログラムで変更するには、 EndpointRegistryClient
オブジェクト。
変更するエンドポイントを取得します
エンドポイントを変更する前に、エンドポイントを取得する必要があります。 エンドポイントを取得するには、エンドポイントにアクセスできるユーザーとして接続する必要があります。 管理者として接続することをお勧めします。 ( 接続プロパティの設定) をクリックします。
エンドポイントのリストを取得して、エンドポイントを取得できます。 その後、リストを繰り返し処理し、削除する特定のエンドポイントを検索できます。 例えば、エンドポイントに対応するサービスとエンドポイントのタイプを指定して、エンドポイントを特定できます。 エンドポイントを見つけたら、変更できます。
新しい設定値を指定する
エンドポイントを変更する場合は、新しい設定値を指定します。 例えば、監視フォルダーエンドポイントを変更するには、変更するエンドポイントだけでなく、すべての監視フォルダーエンドポイント設定値をリセットします。 監視フォルダーエンドポイントに属する設定値について詳しくは、 監視フォルダーエンドポイントの追加.
E メールエンドポイントに属する設定値について詳しくは、 電子メールエンドポイントの追加.
エンドポイントによって呼び出されたサービスは変更できません。 サービスを変更しようとすると、例外が発生します。 特定のエンドポイントに関連付けられているサービスを変更するには、エンドポイントを削除し、新しく作成します。 ( エンドポイントの削除.)
関連トピック
Java API を使用してエンドポイントを変更します。
プロジェクトファイルを含めます。
Java プロジェクトのクラスパスに、adobe-livecycle-client.jar などのクライアント JAR ファイルを含めます。
EndpointRegistry Client オブジェクトを作成します。
ServiceClientFactory
オブジェクトを作成します。EndpointRegistryClient
オブジェクトのコンストラクタを使用し、 ServiceClientFactory
オブジェクト。変更するエンドポイントを取得します。
EndpointRegistryClient
オブジェクトの getEndpoints
メソッドと PagingFilter
オブジェクトを指定します。 次の条件を満たす場合に、 (PagingFilter)null
値を指定して、すべてのエンドポイントを返します。 このメソッドは、 java.util.List
各要素が Endpoint
オブジェクト。 詳しくは、 PagingFilter
オブジェクト: AEM Forms API リファレンス.java.util.List
オブジェクトを使用して、エンドポイントがあるかどうかを判断します。 エンドポイントが存在する場合、各要素は EndPoint
インスタンス。EndPoint
オブジェクトの getServiceId
メソッド。 このメソッドは、サービス名を指定する string 値を返します。EndPoint
オブジェクトの getConnectorId
メソッド。 このメソッドは、エンドポイントのタイプを指定する string 値を返します。 例えば、エンドポイントが監視フォルダーエンドポイントの場合、このメソッドは WatchedFolder
.新しい設定値を指定します。
の作成 ModifyEndpointInfo
オブジェクトを指定します。
設定する設定値ごとに、 ModifyEndpointInfo
オブジェクトの setConfigParameterAsText
メソッド。 例えば、URL 設定値を設定するには、 ModifyEndpointInfo
オブジェクトの setConfigParameterAsText
メソッドを使用して、次の値を渡します。
url
設定値、指定 url
.url
設定値で、監視フォルダーの場所を指定します。を呼び出す EndpointRegistryClient
オブジェクトの modifyEndpoint
メソッドを使用して、 ModifyEndpointInfo
オブジェクト。
関連トピック
クイックスタート:Java API を使用したエンドポイントの変更
AEM Forms Java API を使用して、プログラムによってエンドポイントをサービスから削除できます。 エンドポイントを削除すると、エンドポイントが有効になっている呼び出しメソッドを使用してサービスを呼び出すことはできなくなります。 例えば、サービスから SOAP エンドポイントを削除した場合、SOAP モードを使用してサービスを呼び出すことはできません。
この節では、サービスからエンドポイントを削除する方法を示すために、EJB エンドポイントを、という名前のサービスから削除します EncryptDocument.
Web サービスを使用してエンドポイントを削除することはできません。
エンドポイントをサービスから削除するには、次のタスクを実行します。
EndpointRegistryClient
オブジェクト。プロジェクトファイルを含める
必要なファイルを開発プロジェクトに含めます。 Java を使用してクライアントアプリケーションを作成する場合は、必要な JAR ファイルを含めます。 Web サービスを使用している場合は、必ずプロキシファイルを含めてください。
次の JAR ファイルをプロジェクトのクラスパスに追加する必要があります。
これらの JAR ファイルの場所について詳しくは、 AEM Forms Java ライブラリファイルを含める.
EndpointRegistry Client オブジェクトの作成
プログラムによってエンドポイントを削除するには、 EndpointRegistryClient
オブジェクト。
削除するエンドポイントを取得します
エンドポイントを削除する前に、エンドポイントを取得する必要があります。 エンドポイントを取得するには、エンドポイントにアクセスできるユーザーとして接続する必要があります。 管理者として接続することをお勧めします。 ( 接続プロパティの設定) をクリックします。
エンドポイントのリストを取得して、エンドポイントを取得できます。 その後、リストを繰り返し処理し、削除する特定のエンドポイントを検索できます。 例えば、エンドポイントに対応するサービスとエンドポイントのタイプを指定して、エンドポイントを特定できます。 エンドポイントを見つけたら、そのエンドポイントを削除できます。
エンドポイントを削除
新しいエンドポイントを作成したら、そのエンドポイントを有効にする必要があります。 エンドポイントが有効な場合、エンドポイントを使用してサービスを呼び出すことができます。 エンドポイントを有効にすると、管理コンソール内で表示できます。
関連トピック
Java API を使用してエンドポイントを削除します。
プロジェクトファイルを含めます。
Java プロジェクトのクラスパスに、adobe-livecycle-client.jar などのクライアント JAR ファイルを含めます。
EndpointRegistry Client オブジェクトを作成します。
ServiceClientFactory
オブジェクトを作成します。EndpointRegistryClient
オブジェクトのコンストラクタを使用し、 ServiceClientFactory
オブジェクト。削除するエンドポイントを取得します。
EndpointRegistryClient
オブジェクトの getEndpoints
メソッドと PagingFilter
オブジェクトを指定します。 パス (PagingFilter)null
を使用して、すべてのエンドポイントを返します。 このメソッドは、 java.util.List
各要素が Endpoint
オブジェクト。java.util.List
オブジェクトを使用して、エンドポイントがあるかどうかを判断します。 エンドポイントが存在する場合、各要素は EndPoint
インスタンス。EndPoint
オブジェクトの getServiceId
メソッド。 このメソッドは、サービス名を指定する string 値を返します。EndPoint
オブジェクトの getConnectorId
メソッド。 このメソッドは、エンドポイントのタイプを指定する string 値を返します。 例えば、エンドポイントが EJB エンドポイントの場合、このメソッドはを返します EJB
.エンドポイントを削除します。
を呼び出してエンドポイントを削除する EndpointRegistryClient
オブジェクトの remove
メソッドおよび EndPoint
削除するエンドポイントを表すオブジェクト。
関連トピック
クイックスタート:Java API を使用したエンドポイントの削除
AEM Forms API を使用して、エンドポイントコネクタに関する情報をプログラムで取得できます。 コネクタは、様々な呼び出しメソッドを使用してエンドポイントからサービスを呼び出すことを可能にします。 例えば、監視フォルダーコネクタを使用すると、エンドポイントは監視フォルダーを使用してサービスを呼び出すことができます。 プログラムによってエンドポイントコネクタに関する情報を取得することで、必要な設定値や任意の設定値など、コネクタに関連付けられた設定値を取得できます。
この節では、エンドポイントコネクタに関する情報を取得する方法を示すために、監視フォルダーコネクタに関する情報を取得します。 ( 監視フォルダーエンドポイントの追加.)
Web サービスを使用してエンドポイントに関する情報を取得することはできません。
このトピックでは、 ConnectorRegistryClient
エンドポイントコネクタに関する情報を取得する API。 ( AEM Forms API リファレンス.)
エンドポイントコネクタ情報を取得するには、次のタスクを実行します。
ConnectorRegistryClient
オブジェクト。プロジェクトファイルを含める
必要なファイルを開発プロジェクトに含めます。 Java を使用してクライアントアプリケーションを作成する場合は、必要な JAR ファイルを含めます。 Web サービスを使用している場合は、必ずプロキシファイルを含めてください。
次の JAR ファイルをプロジェクトのクラスパスに追加する必要があります。
AEM Formsが JBoss 以外のサポート対象の J2EE アプリケーションサーバーにデプロイされている場合は、adobe-utilities.jar と jbossall-client.jar を、AEM Formsがデプロイされている J2EE アプリケーションサーバーに固有の JAR ファイルに置き換えます。 すべてのAEM Forms JAR ファイルの場所について詳しくは、 AEM Forms Java ライブラリファイルを含める.
ConnectorRegistry Client オブジェクトの作成
プログラムによってエンドポイントコネクタ情報を取得するには、 ConnectorRegistryClient
オブジェクト。
コネクタのタイプを指定
情報を取得するコネクタのタイプを指定します。 次のタイプのコネクタが存在します。
設定値の取得
コネクタタイプを指定した後、サポートされている設定値など、コネクタに関する情報を取得できます。 例えば、任意のコネクタの場合、必要な設定値とオプションの設定値を決定できます。
関連トピック
Java API を使用したエンドポイントコネクタ情報の取得
Java API を使用して、エンドポイントコネクタ情報を取得します。
プロジェクトファイルを含めます。.
Java プロジェクトのクラスパスに、adobe-livecycle-client.jar などのクライアント JAR ファイルを含めます。
ConnectorRegistry Client オブジェクトを作成します。
ServiceClientFactory
オブジェクトを作成します。ConnectorRegistryClient
オブジェクトを渡すことによって、ServiceClientFactory
オブジェクトを作成します。コネクタのタイプを指定します。
を呼び出して、コネクタのタイプを指定します。 ConnectorRegistryClient
オブジェクトの getEndpointDefinition
メソッドを使用して、コネクタの種類を指定する string 値を渡します。 例えば、監視フォルダーのコネクタタイプを指定するには、文字列値を渡します WatchedFolder
. このメソッドは、 Endpoint
コネクタの種類に対応するオブジェクト。
設定値を取得します。
Endpoint
オブジェクトの getConfigParameters
メソッド。 このメソッドは、 ConfigParameter
オブジェクト。ConfigParameter
オブジェクト。 例えば、設定値が必須かオプションかを、 ConfigParameter
オブジェクトの isRequired
メソッド。 設定値が必要な場合、このメソッドは true
.関連トピック