エンドポイントのプログラムによる管理

エンドポイントレジストリサービスについて

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の開始プロセスページにプロセスカードとして表示されます。

Endpoint Registryサービスを使用して、次のタスクを実行できます。

EJBエンドポイントの追加

プログラムでEJBエンドポイントをサービスに追加するには、AEM FormsJava APIを使用します。 EJBエンドポイントをサービスに追加すると、クライアントアプリケーションでEJBモードを使用してサービスを呼び出せるようになります。 つまり、AEM Formsの呼び出しに必要な接続プロパティを設定する場合、EJBモードを選択できます。 （接続プロパティの設定を参照。）

メモ

Webサービスを使用してEJBエンドポイントを追加することはできません。

メモ

通常、EJBエンドポイントはデフォルトでサービスに追加されますが、EJBエンドポイントは、プログラム的にデプロイされたプロセスや、EJBエンドポイントが削除され、再度追加する必要があるプロセスに追加できます。

手順の概要

EJBエンドポイントをサービスに追加するには、次のタスクを実行します。

  1. プロジェクトファイルを含めます。
  2. EndpointRegistry Clientオブジェクトを作成します。
  3. EJBエンドポイント属性を設定します。
  4. EJBエンドポイントを作成します。
  5. エンドポイントを有効にします。

プロジェクトファイルを含める

開発プロジェクトに必要なファイルを含めます。 次のJARファイルをプロジェクトのクラスパスに追加する必要があります。

  • adobe-livecycle-client.jar
  • adobe-usermanager-client.jar
  • adobe-utilities.jar(AEM FormsがJBoss Application Serverにデプロイされている場合に必要)
  • jbossall-client.jar(AEM FormsがJBoss Application Serverにデプロイされている場合に必要)

これらのJARファイルの場所について詳しくは、「AEM FormsJavaライブラリファイルを含める」を参照してください。

EndpointRegistry Clientオブジェクトの作成

プログラムによってEJBエンドポイントを追加する前に、EndpointRegistryClientオブジェクトを作成する必要があります。

EJBエンドポイント属性の設定

サービス用のEJBエンドポイントを作成するには、次の値を指定します。

  • コネクタ識別子:作成するエンドポイントのタイプを指定します。EJBエンドポイントを作成するには、EJBを指定します。
  • 説明:エンドポイントの説明を指定します。
  • 名前:エンドポイントの名前を指定します。
  • サービス識別子:エンドポイントが属するサービスを指定します。
  • 操作名:エンドポイントを使用して呼び出される操作の名前を指定します。EJBエンドポイントを作成する場合は、ワイルドカード文字(*)を指定します。 ただし、すべてのサービス操作を呼び出すのではなく、特定の操作を指定する場合は、ワイルドカード文字(*)を使用するのではなく、操作の名前を指定します。

EJBエンドポイントの作成

EJBエンドポイント属性を設定した後、サービス用のEJBエンドポイントを作成できます。

エンドポイントの有効化

新しいエンドポイントを作成したら、そのエンドポイントを有効にする必要があります。 有効にしたエンドポイントは、サービスの呼び出しに使用できます。 エンドポイントを有効にした後、管理コンソール内で表示できます。

関連トピック

Java APIを使用したEJBエンドポイントの追加

AEM Forms Java ライブラリファイルを含める

接続プロパティの設定

Java APIを使用したEJBエンドポイントの追加

Java APIを追加使用したEJBエンドポイント：

  1. プロジェクトファイルを含めます。

    Javaプロジェクトのクラスパスに、adobe-livecycle-client.jarなどのクライアントJARファイルを含めます。 （

  2. EndpointRegistry Clientオブジェクトを作成します。

    • 接続プロパティを含む ServiceClientFactory オブジェクトを作成します。
    • コンストラクターを使用し、EndpointRegistryClientオブジェクトを渡して、ServiceClientFactoryオブジェクトを作成します。

  3. EJBエンドポイント属性を設定します。

    • コンストラクタを使用して CreateEndpointInfo オブジェクトを作成します。
    • CreateEndpointInfoオブジェクトのsetConnectorIdメソッドを呼び出し、文字列値EJBを渡して、コネクタ識別子の値を指定します。
    • CreateEndpointInfoオブジェクトのsetDescriptionメソッドを呼び出し、エンドポイントを説明する文字列値を渡して、エンドポイントの説明を指定します。
    • CreateEndpointInfoオブジェクトのsetNameメソッドを呼び出し、名前を指定する文字列値を渡して、エンドポイントの名前を指定します。
    • CreateEndpointInfoオブジェクトのsetServiceIdメソッドを呼び出し、サービス名を指定する文字列値を渡して、エンドポイントが属するサービスを指定します。
    • CreateEndpointInfoオブジェクトのsetOperationNameメソッドを呼び出して呼び出す操作を指定し、操作名を指定する文字列値を渡します。 SOAPおよびEJBエンドポイントの場合は、ワイルドカード文字(*)を指定します。これはすべての操作を意味します。

  4. EJBエンドポイントを作成します。

    EndpointRegistryClientオブジェクトのcreateEndpointメソッドを呼び出し、CreateEndpointInfoオブジェクトを渡して、エンドポイントを作成します。 このメソッドは、新しいEJBエンドポイントを表すEndpointオブジェクトを返します。

  5. エンドポイントを有効にします。

    EndpointRegistryClientオブジェクトのenableメソッドを呼び出し、createEndpointメソッドから返されたEndpointオブジェクトを渡して、エンドポイントを有効にします。

関連トピック

手順の概要

QuickStart:Java APIを使用したEJBエンドポイントの追加

AEM Forms Java ライブラリファイルを含める

接続プロパティの設定

SOAPエンドポイントの追加

AEM FormsJava APIを使用すると、プログラムによってSOAPエンドポイントをサービスに追加できます。 SOAPエンドポイントを追加すると、クライアントアプリケーションがSOAPモードを使用してサービスを呼び出せるようになります。 つまり、AEM Formsの呼び出しに必要な接続プロパティを設定する場合は、SOAPモードを選択できます。

メモ

Webサービスを使用してSOAPエンドポイントを追加することはできません。

メモ

通常、SOAPエンドポイントはデフォルトでサービスに追加されますが、SOAPエンドポイントは、プログラム的にデプロイされるプロセスや、SOAPエンドポイントが削除され、再度追加する必要があるプロセスに追加できます。

手順の概要

SOAPエンドポイントをサービスに追加するには、次のタスクを実行します。

  1. プロジェクトファイルを含めます。
  2. EndpointRegistryClientオブジェクトを作成します。
  3. SOAPエンドポイント属性を設定します。
  4. SOAPエンドポイントを作成します。
  5. エンドポイントを有効にします。

プロジェクトファイルを含める

必要なファイルを開発プロジェクトに含めます。 Javaを使用してクライアントアプリケーションを作成する場合は、必要なJARファイルを含めます。 Webサービスを使用している場合は、プロキシファイルを必ず含めます。

次のJARファイルをプロジェクトのクラスパスに追加する必要があります。

  • adobe-livecycle-client.jar
  • adobe-usermanager-client.jar
  • adobe-utilities.jar(AEM FormsがJBoss Application Serverにデプロイされている場合に必要)
  • jbossall-client.jar(AEM FormsがJBoss Application Serverにデプロイされている場合に必要)

これらのJARファイルは、SOAPエンドポイントを作成するために必要です。 ただし、SOAPエンドポイントを使用してサービスを呼び出す場合は、追加のJARファイルが必要です。 AEM FormsJARファイルについて詳しくは、AEM Forms Javaライブラリファイルを含めるを参照してください。

EndpointRegistry Clientオブジェクトの作成

プログラムによってSOAPエンドポイントをサービスに追加するには、EndpointRegistryClientオブジェクトを作成する必要があります。

SOAPエンドポイント属性の設定

SOAPエンドポイントをサービスに追加するには、次の値を指定します。

  • コネクタ識別子の値:作成するエンドポイントのタイプを指定します。SOAPエンドポイントを作成するには、SOAPを指定します。
  • 説明:エンドポイントの説明を指定します。
  • 名前:エンドポイント名を指定します。
  • サービス識別子の値:エンドポイントが属するサービスを指定します。
  • 操作名:エンドポイントを使用して呼び出される操作の名前を指定します。SOAPエンドポイントを作成する場合は、ワイルドカード文字(*)を指定します。 ただし、すべてのサービス操作を呼び出すのではなく、特定の操作を指定する場合は、ワイルドカード文字(*)を使用するのではなく、操作の名前を指定します。

SOAPエンドポイントの作成

SOAPエンドポイント属性を設定した後、SOAPエンドポイントを作成できます。

エンドポイントの有効化

新しいエンドポイントを作成したら、そのエンドポイントを有効にする必要があります。 エンドポイントが有効な場合は、サービスの呼び出しに使用できます。 エンドポイントを有効にすると、表示は管理コンソール内でエンドポイントを確認できます。

関連トピック

Java APIを追加使用したSOAPエンドポイント

AEM Forms Java ライブラリファイルを含める

接続プロパティの設定

Java API <a0追加/>を使用したSOAPエンドポイント

Java APIを追加使用したサービスへのSOAPエンドポイント：

  1. プロジェクトファイルを含めます。

    Javaプロジェクトのクラスパスに、adobe-livecycle-client.jarなどのクライアントJARファイルを含めます。

  2. EndpointRegistry Clientオブジェクトを作成します。

    • 接続プロパティを含む ServiceClientFactory オブジェクトを作成します。
    • コンストラクターを使用し、EndpointRegistryClientオブジェクトを渡して、ServiceClientFactoryオブジェクトを作成します。

  3. SOAPエンドポイント属性を設定します。

    • コンストラクタを使用して CreateEndpointInfo オブジェクトを作成します。
    • CreateEndpointInfoオブジェクトのsetConnectorIdメソッドを呼び出し、文字列値SOAPを渡して、コネクタ識別子の値を指定します。
    • CreateEndpointInfoオブジェクトのsetDescriptionメソッドを呼び出し、エンドポイントを説明する文字列値を渡して、エンドポイントの説明を指定します。
    • CreateEndpointInfoオブジェクトのsetNameメソッドを呼び出し、名前を指定する文字列値を渡して、エンドポイントの名前を指定します。
    • CreateEndpointInfoオブジェクトのsetServiceIdメソッドを呼び出し、サービス名を指定する文字列値を渡して、エンドポイントが属するサービスを指定します。
    • CreateEndpointInfoオブジェクトのsetOperationNameメソッドを呼び出し、操作名を指定する文字列値を渡して、呼び出す操作を指定します。 SOAPおよびEJBエンドポイントの場合は、ワイルドカード文字(*)を指定します。これはすべての操作を意味します。

  4. SOAPエンドポイントを作成します。

    EndpointRegistryClientオブジェクトのcreateEndpointメソッドを呼び出し、CreateEndpointInfoオブジェクトを渡して、エンドポイントを作成します。 このメソッドは、新しいSOAPエンドポイントを表すEndpointオブジェクトを返します。

  5. エンドポイントを有効にします。

    EndpointRegistryClientオブジェクトのenableメソッドを呼び出し、createEndpointメソッドから返されたEndpointオブジェクトを渡して、エンドポイントを有効にします。

関連トピック

手順の概要

QuickStart:Java APIを使用したSOAPエンドポイントの追加

AEM Forms Java ライブラリファイルを含める

接続プロパティの設定

監視フォルダーエンドポイントの追加

プログラムで監視フォルダーエンドポイントをサービスに追加するには、AEM FormsJava APIを使用します。 監視フォルダーエンドポイントを追加すると、ユーザーはファイル（PDFファイルなど）をフォルダーに配置できます。 ファイルがフォルダーに配置されると、設定済みのサービスが呼び出され、ファイルが操作されます。 サービスが指定の操作を実行した後に、変更されたファイルが指定の出力フォルダーに保存されます。監視フォルダーは、固定レートの間隔、または毎週月曜日、水曜日、金曜日の正午など、Cronスケジュールでスキャンされるように設定されています。

プログラムによって監視フォルダーエンドポイントをサービスに追加する場合は、次の​EncryptDocument​という短時間のみ有効なプロセスを検討してください。 (AEM Formsプロセスについてを参照)。

aw_aw_encryptdocumentprocess

このプロセスは、保護されていないPDFドキュメントを入力値として受け取り、保護されていないPDFドキュメントをEncryptionサービスのEncryptPDFUsingPassword操作に渡します。 PDFドキュメントはパスワードを使用して暗号化され、パスワードを使用して暗号化されたPDFドキュメントはこのプロセスの出力値です。 入力値の名前(保護されていないPDFドキュメント)はInDocで、データタイプはcom.adobe.idp.Documentです。 出力値の名前(パスワードで暗号化されたPDFドキュメント)はSecuredDocで、データタイプはcom.adobe.idp.Documentです。

メモ

Webサービスを使用して監視フォルダーエンドポイントを追加することはできません。

手順の概要

監視フォルダーエンドポイントをサービスに追加するには、次のタスクを実行します。

  1. プロジェクトファイルを含めます。
  2. EndpointRegistryClientオブジェクトを作成します。
  3. 監視フォルダーエンドポイントの属性を設定します。
  4. 設定値を指定します。
  5. 入力パラメーターの値を定義します。
  6. 出力パラメーターの値を定義します。
  7. 監視フォルダーエンドポイントの作成を参照してください。
  8. エンドポイントを有効にします。

プロジェクトファイルを含める

必要なファイルを開発プロジェクトに含めます。 Javaを使用してクライアントアプリケーションを作成する場合は、必要なJARファイルを含めます。 Webサービスを使用している場合は、プロキシファイルを必ず含めます。

次のJARファイルをプロジェクトのクラスパスに追加する必要があります。

  • adobe-livecycle-client.jar
  • adobe-usermanager-client.jar
  • adobe-utilities.jar(AEM FormsがJBoss Application Serverにデプロイされている場合に必要)
  • jbossall-client.jar(AEM FormsがJBoss Application Serverにデプロイされている場合に必要)

これらのJARファイルの場所について詳しくは、「AEM FormsJavaライブラリファイルを含める」を参照してください。

EndpointRegistry Clientオブジェクトの作成

プログラムによって監視フォルダーエンドポイントを追加するには、EndpointRegistryClientオブジェクトを作成する必要があります。

監視フォルダーエンドポイント属性の設定

サービスの監視フォルダーエンドポイントを作成するには、次の値を指定します。

  • コネクタ識別子:作成されるエンドポイントの種類を指定します。監視フォルダーエンドポイントを作成するには、WatchedFolderを指定します。
  • 説明:エンドポイントの説明を指定します。
  • 名前:エンドポイントの名前を指定します。
  • サービス識別子:エンドポイントが属するサービスを指定します。例えば、この節で紹介するプロセス（Workbenchを使用してアクティブ化するとプロセスがサービスになる）に監視フォルダーエンドポイントを追加するには、EncryptDocumentを指定します。
  • 操作名:エンドポイントを使用して呼び出される操作の名前を指定します。通常、Workbenchで作成されたプロセスから派生するサービスの監視フォルダーエンドポイントを作成する場合、操作の名前はinvokeです。

設定値の指定

監視フォルダーエンドポイントをサービスにプログラムで追加する場合は、監視フォルダーエンドポイントの設定値を指定する必要があります。 これらの設定値は、管理コンソールを使用して監視フォルダーエンドポイントを追加した場合に、管理者が指定します。

次のリストは、監視フォルダーエンドポイントをプログラムでサービスに追加した場合に設定される設定値を指定します。

  • url:監視フォルダーの場所を指定します。クラスター環境では、この値は、クラスター内のすべてのコンピューターからアクセス可能な共有ネットワークフォルダーを指す必要があります。
  • 非同期:呼び出しの種類を非同期型または同期型として指定します。一過性および同期型のプロセスは、同期型でのみ呼び出すことができます。デフォルト値は true です。非同期を推奨します。
  • cronExpression:Quartzで、入力ディレクトリのポーリングをスケジュールするために使用されます。cron式の設定について詳しくは、https://quartz.sourceforge.net/javadoc/org/quartz/CronTrigger.htmlを参照してください。
  • purgeDuration:これは必須の属性です。結果フォルダー内のファイルとフォルダーがこの値より古い場合、それらは削除されます。 この値の単位は日です。この属性は、結果フォルダーがいっぱいにならないようにするのに役立ちます。 -1 を指定すると、結果フォルダーの削除は行われません。デフォルト値は -1 です。
  • repeatInterval:監視フォルダーをスキャンして入力を確認する間隔（秒単位）です。ジョブ数の制限が有効になっていない限り、この値は平均的なジョブの処理時間より長くする必要があります。そうしないと、システムが過負荷の状態になる可能性があります。 デフォルト値は 5 です。
  • repeatCount:監視フォルダーがフォルダーまたはディレクトリをスキャンする回数です。-1 を指定すると、無限にスキャンされます。デフォルト値は -1 です。
  • throttleOn:任意の時点で処理できる監視フォルダーのジョブ数を制限します。ジョブの最大数は、batchSize値によって決まります。
  • userName:監視フォルダーからターゲットサービスを呼び出すときに使用されるユーザー名です。この値は必須です。デフォルト値は「SuperAdmin」です。
  • domainName:ユーザーのドメイン。この値は必須です。デフォルト値は「DefaultDom」です。
  • batchSize:1回のスキャンで取得されるファイルまたはフォルダーの数です。この値を使用して、システムの過負荷を防ぎます。一度にスキャンするファイル数が多すぎると、クラッシュする場合があります。 デフォルト値は 2 です。
  • waitTime:作成後にフォルダーまたはファイルをスキャンするまでの待機時間（ミリ秒）です。例えば、待機時間が36,000,000ミリ秒（1時間）で、1分前にファイルが作成された場合、このファイルは59分以上経過した後に取得されます。 この属性は、ファイルまたはフォルダーが入力フォルダーに完全にコピーされるようにする場合に役立ちます。 例えば、処理に大きなファイルがあり、そのファイルのダウンロードに10分かかる場合は、待機時間を10&ast;60&ast;1000ミリ秒に設定します。 この設定は、10分間待たないファイルは監視フォルダーでスキャンされないようにします。 デフォルト値は 0 です。
  • excludeFilePattern:スキャンおよび取得の対象とするファイルとフォルダーを決定するために監視フォルダーが使用するパターンです。このパターンを含むファイルまたはフォルダーは、スキャンの対象外となります。 この設定は、入力が複数のファイルを含むフォルダーである場合に役立ちます。 フォルダーの内容を、監視フォルダーの取得対象となる名前のフォルダーにコピーできます。 この手順により、フォルダーが入力フォルダーに完全にコピーされる前に監視フォルダーがフォルダーを取得しないようにすることができます。 例えば、excludeFilePattern値がdata*の場合、data*に一致するすべてのファイルおよびフォルダーは取得されません。 例えば、data1、data2という名前のファイルやフォルダーが含まれます。 また、パターンにワイルドカードパターンを追加して、ファイルパターンを指定することもできます。 監視フォルダーは、*.*や*.pdfなどのワイルドカードパターンをサポートするように正規式を変更します。 これらのワイルドカードパターンは、正規式ではサポートされていません。
  • includeFilePattern:スキャンおよび取得の対象とするフォルダーとファイルを決定するために監視フォルダーが使用するパターンです。例えば、この値が*の場合、input*に一致するすべてのファイルとフォルダーが取得されます。 例えば、input1、input2という名前のファイルやフォルダーが含まれます。 デフォルト値は * です。この値は、すべてのファイルとフォルダーを示します。 また、パターンにワイルドカードパターンを追加して、ファイルパターンを指定することもできます。 監視フォルダーは、*.*や*.pdfなどのワイルドカードパターンをサポートするように正規式を変更します。 これらのワイルドカードパターンは、正規式ではサポートされていません。 この値は必須です。
  • resultFolderName:保存した結果が保存されるフォルダーです。この場所は、絶対パスまたは相対ディレクトリパスにすることができます。 結果がこのフォルダーに表示されない場合は、失敗フォルダーを確認してください。読み取り専用ファイルは処理されず、失敗フォルダーに保存されます。デフォルト値は result/%Y/%M/%D/ です。監視フォルダー内の結果フォルダーです。
  • preserveFolderName:正常にスキャンおよび取得されたファイルが保存される場所です。絶対パス、相対パス、またはNULLのディレクトリパスを指定できます。 デフォルト値は preserve/%Y/%M/%D/ です。
  • failureFolderName:失敗ファイルが保存されるフォルダーです。この場所は、常に監視フォルダーからの相対パスで指定します。読み取り専用ファイルは処理されず、失敗フォルダーに保存されます。デフォルト値は failure/%Y/%M/%D/ です。
  • preserveOnFailure:サービスで操作の実行に失敗した場合に入力ファイルを保持します。デフォルト値は true です。
  • overwriteDuplicateFilename:trueに設定すると、結果フォルダーと保存用フォルダーにあるファイルが上書きされます。「false」に設定した場合、ファイル名とフォルダー名の末尾に数値のインデックスが付けられます。 デフォルト値は false です。

入力パラメーター値の定義

監視フォルダーエンドポイントを作成する場合は、入力パラメーターの値を定義する必要があります。 つまり、監視フォルダーが呼び出す操作に渡す入力値を記述する必要があります。 例えば、このトピックで紹介したプロセスを考えてみましょう。 InDocという名前の1つの入力値があり、そのデータタイプはcom.adobe.idp.Documentです。 このプロセスの監視フォルダーエンドポイントを作成する場合（プロセスがアクティベートされると、サービスになります）、入力パラメーターの値を定義する必要があります。

監視フォルダーエンドポイントに必要な入力パラメーターの値を定義するには、次の値を指定します。

入力パラメーター名:入力パラメーターの名前。入力値の名前は、プロセスに対してWorkbenchで指定されます。 入力値がサービス操作（Workbenchで作成されたプロセスではないサービス）に属する場合、入力名はcomponent.xmlファイルで指定されます。 例えば、この節で紹介するプロセスの入力パラメーターの名前はInDocです。

マッピングの種類:サービス操作の呼び出しに必要な入力値を設定するために使用します。マッピングには次の2つのタイプがあります。

  • Literal:監視フォルダーエンドポイントでは、フィールドに入力された値が表示どおりに使用されます。すべての基本 Java 型がサポートされます。例えば、String、long、int、Booleanなどの入力を使用するAPIの場合、文字列は適切な型に変換され、サービスが呼び出されます。
  • Variable:入力された値は、監視フォルダーが入力の選択に使用するファイルパターンです。例えば、マッピングの種類として「Variable」を選択し、入力ドキュメントーをPDFファイルにする必要がある場合、マッピング値として*.pdfを指定できます。

マッピング値:マッピングタイプの値を指定します。例えば、Variableマッピングタイプを選択した場合は、ファイルパターンとして*.pdfを指定できます。

データタイプ:入力値のデータタイプを指定します。例えば、この節で紹介するプロセスの入力値のデータ型はcom.adobe.idp.Documentです。

出力パラメーター値の定義

監視フォルダーエンドポイントを作成する場合は、出力パラメーターの値を定義する必要があります。 つまり、監視フォルダーエンドポイントによって呼び出されるサービスから返される出力値を記述する必要があります。 例えば、このトピックで紹介したプロセスを考えてみましょう。 SecuredDocという出力値があり、そのデータタイプはcom.adobe.idp.Documentです。 このプロセスの監視フォルダーエンドポイントを作成する場合（プロセスがアクティブ化されると、サービスになります）、出力パラメーターの値を定義する必要があります。

監視フォルダーエンドポイントに必要な出力パラメーターの値を定義するには、次の値を指定します。

出力パラメーター名:出力パラメーターの名前。プロセス出力値の名前は、Workbenchで指定されます。 出力値がサービス操作（Workbenchで作成されたプロセスではないサービス）に属する場合、出力名はcomponent.xmlファイルで指定されます。 例えば、この節で紹介するプロセスの出力パラメーターの名前はSecuredDocです。

マッピングの種類:サービスと操作の出力を設定するために使用します。以下のオプションが利用できます。

  • サービスが1つのオブジェクト(1つのドキュメント)を返す場合、パターンは%F.pdfで、ソースの宛先はsourcefilename.pdfです。 例えば、この節で紹介したプロセスは、1つのドキュメントを返します。 その結果、マッピングの種類は%F.pdfと定義できます（%Fは指定したファイル名を使用することを意味します）。 パターン%Eは入力ドキュメントの拡張を指定します。
  • サービスがリストを返す場合、パターンはResult\%F\で、ソースの出力先はResult\sourcefilename\source1 (output 1)およびResult\sourcefilename\source2 (output 2)です。
  • サービスがマップを返す場合、パターンはResult\%F\で、ソースの宛先はResult\sourcefilename\file1 and Result\sourcefilename\file2です。 マップに複数のオブジェクトが含まれる場合、パターンはResult\%F.pdfで、ソースの宛先はResult\sourcefilename1.pdf（出力1）、Result\sourcefilename2.pdf（出力2）のようになります。

データタイプ:戻り値のデータ型を指定します。例えば、この節で紹介するプロセスの戻り値のデータ型はcom.adobe.idp.Documentです。

監視フォルダーエンドポイントの作成

エンドポイントの属性、設定値を設定し、入力パラメーターと出力パラメーターの値を定義したら、監視フォルダーエンドポイントを作成する必要があります。

エンドポイントの有効化

監視フォルダーエンドポイントを作成したら、そのエンドポイントを有効にする必要があります。 エンドポイントが有効な場合は、サービスの呼び出しに使用できます。 エンドポイントを有効にした後、管理コンソール内で表示できます。

関連トピック

Java APIを追加使用した監視フォルダーエンドポイント

AEM Forms Java ライブラリファイルを含める

接続プロパティの設定

Java API <a0追加/>を使用した監視フォルダーエンドポイント

AEM Forms追加 Java APIを使用した監視フォルダーエンドポイント：

  1. プロジェクトファイルを含めます。

    Javaプロジェクトのクラスパスに、adobe-livecycle-client.jarなどのクライアントJARファイルを含めます。

  2. EndpointRegistry Clientオブジェクトを作成します。

    • 接続プロパティを含む ServiceClientFactory オブジェクトを作成します。
    • コンストラクターを使用し、EndpointRegistryClientオブジェクトを渡して、ServiceClientFactoryオブジェクトを作成します。

  3. 監視フォルダーエンドポイントの属性を設定します。

    • コンストラクタを使用して CreateEndpointInfo オブジェクトを作成します。
    • CreateEndpointInfoオブジェクトのsetConnectorIdメソッドを呼び出し、文字列値WatchedFolderを渡して、コネクタ識別子の値を指定します。
    • CreateEndpointInfoオブジェクトのsetDescriptionメソッドを呼び出し、エンドポイントを説明する文字列値を渡して、エンドポイントの説明を指定します。
    • CreateEndpointInfoオブジェクトのsetNameメソッドを呼び出し、名前を指定する文字列値を渡して、エンドポイントの名前を指定します。
    • CreateEndpointInfoオブジェクトのsetServiceIdメソッドを呼び出し、サービス名を指定する文字列値を渡して、エンドポイントが属するサービスを指定します。
    • CreateEndpointInfoオブジェクトのsetOperationNameメソッドを呼び出し、操作名を指定する文字列値を渡して、呼び出す操作を指定します。 通常、Workbenchで作成されたプロセスから派生するサービスの監視フォルダーエンドポイントを作成する場合、操作の名前はinvokeです。

  4. 設定値を指定します。

    監視フォルダーエンドポイントに設定する設定値ごとに、CreateEndpointInfoオブジェクトのsetConfigParameterAsTextメソッドを呼び出す必要があります。 例えば、url設定値を設定するには、CreateEndpointInfoオブジェクトのsetConfigParameterAsTextメソッドを呼び出し、次の文字列値を渡します。

    • 設定値の名前を指定するstring値。 url設定値を設定する場合は、urlを指定します。
    • 設定値の値を指定するstring値。 url設定値を設定する場合は、監視フォルダーの場所を指定します。
    メモ

    EncryptDocumentサービスに設定されたすべての設定値を確認するには、QuickStartにあるJavaコードの例を参照してください。Java APIを使用した監視フォルダーエンドポイントの追加を参照してください。

  5. 入力パラメーターの値を定義します。

    CreateEndpointInfoオブジェクトのsetInputParameterMappingメソッドを呼び出し、次の値を渡して、入力パラメーターの値を定義します。

    • 入力パラメーターの名前を指定するstring値。 例えば、EncryptDocumentサービスの入力パラメーターの名前はInDocです。
    • 入力パラメーターのデータタイプを指定するstring値。 例えば、InDoc入力パラメーターのデータタイプはcom.adobe.idp.Documentです。
    • マッピングの種類を指定するstring値です。 例えば、variableを指定できます。
    • マッピングタイプの値を指定するstring値。 例えば、&ast;.pdfをファイルパターンとして指定できます。
    メモ

    定義する各入力パラメーター値に対してsetInputParameterMappingメソッドを呼び出します。 EncryptDocumentプロセスには1つの入力パラメーターしかないので、このメソッドを1回呼び出す必要があります。

  6. 出力パラメーターの値を定義します。

    CreateEndpointInfoオブジェクトのsetOutputParameterMappingメソッドを呼び出し、次の値を渡して、出力パラメーターの値を定義します。

    • 出力パラメーターの名前を指定するstring値。 例えば、EncryptDocumentサービスの出力パラメーターの名前はSecuredDocです。
    • 出力パラメーターのデータタイプを指定するstring値。 例えば、SecuredDoc出力パラメーターのデータタイプはcom.adobe.idp.Documentです。
    • マッピングの種類を指定するstring値です。 例えば、%F.pdfを指定できます。

  7. 監視フォルダーエンドポイントの作成を参照してください。

    EndpointRegistryClientオブジェクトのcreateEndpointメソッドを呼び出し、CreateEndpointInfoオブジェクトを渡して、エンドポイントを作成します。 このメソッドは、監視フォルダーエンドポイントを表すEndpointオブジェクトを返します。

  8. エンドポイントを有効にします。

    EndpointRegistryClientオブジェクトのenableメソッドを呼び出し、createEndpointメソッドから返されたEndpointオブジェクトを渡して、エンドポイントを有効にします。

関連トピック

手順の概要

QuickStart:Java APIを使用した監視フォルダーエンドポイントの追加

AEM Forms Java ライブラリファイルを含める

接続プロパティの設定

監視フォルダー設定値の定数ファイル

QuickStart: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 FormsJava APIを使用して、プログラムで電子メールエンドポイントをサービスに追加できます。 電子メールエンドポイントを追加すると、1つ以上の添付ファイルが含まれた電子メールメッセージを、指定した電子メールアカウントに送信できます。 次に、configureサービス操作が呼び出され、ファイルが操作されます。 サービスが指定の操作を実行すると、送信者に電子メールメッセージが送信され、変更されたファイルが添付ファイルとして送信されます。

プログラムによって電子メールエンドポイントをサービスに追加する場合は、次の​MyApplication\EncryptDocument​という短時間のみ有効なプロセスを考慮してください。 短時間のみ有効なプロセスについて詳しくは、AEM Formsプロセスについてを参照してください。

ae_ae_encryptdocumentprocess

このプロセスは、保護されていないPDFドキュメントを入力値として受け取り、保護されていないPDFドキュメントをEncryptionサービスのEncryptPDFUsingPassword操作に渡します。 このプロセスでは、PDFドキュメントをパスワードで暗号化し、パスワードで暗号化されたPDFドキュメントを出力値として返します。 入力値の名前(保護されていないPDFドキュメント)はInDocで、データタイプはcom.adobe.idp.Documentです。 出力値の名前(パスワードで暗号化されたPDFドキュメント)はSecuredDocで、データタイプはcom.adobe.idp.Documentです。

メモ

Webサービスを使用して電子メールエンドポイントを追加することはできません。

手順の概要

電子メールエンドポイントをサービスに追加するには、次のタスクを実行します。

  1. プロジェクトファイルを含めます。
  2. EndpointRegistryClientオブジェクトを作成します。
  3. 電子メールエンドポイント属性を設定します。
  4. 設定値を指定します。
  5. 入力パラメーターの値を定義します。
  6. 出力パラメーターの値を定義します。
  7. 電子メールエンドポイントを作成します。
  8. エンドポイントを有効にします。

プロジェクトファイルを含める

必要なファイルを開発プロジェクトに含めます。 Javaを使用してクライアントアプリケーションを作成する場合は、必要なJARファイルを含めます。 Webサービスを使用している場合は、プロキシファイルを必ず含めます。

次のJARファイルをプロジェクトのクラスパスに追加する必要があります。

  • adobe-livecycle-client.jar
  • adobe-usermanager-client.jar
  • adobe-utilities.jar(AEM FormsがJBoss Application Serverにデプロイされている場合に必要)
  • jbossall-client.jar(AEM FormsがJBoss Application Serverにデプロイされている場合に必要)

これらのJARファイルの場所について詳しくは、「AEM FormsJavaライブラリファイルを含める」を参照してください。

EndpointRegistry Clientオブジェクトの作成

プログラムで電子メールエンドポイントを追加する前に、EndpointRegistryClientオブジェクトを作成する必要があります。

電子メールエンドポイント属性の設定

サービスの電子メールエンドポイントを作成するには、次の値を指定します。

  • コネクタ識別子の値:作成されるエンドポイントの種類を指定します。電子メールエンドポイントを作成するには、Emailを指定します。
  • 説明:エンドポイントの説明を指定します。
  • 名前:エンドポイントの名前を指定します。
  • サービス識別子の値:エンドポイントが属するサービスを指定します。例えば、この節で紹介するプロセスに電子メールエンドポイントを追加する（Workbenchを使用してアクティブ化するとプロセスがサービスになる）には、EncryptDocumentを指定します。
  • 操作名:エンドポイントを使用して呼び出される操作の名前を指定します。通常、Workbenchで作成されたプロセスから派生するサービスの電子メールエンドポイントを作成する場合、操作の名前はinvokeです。

設定値の指定

電子メールエンドポイントをサービスにプログラム的に追加する場合は、電子メールエンドポイントの設定値を指定する必要があります。 これらの設定値は、管理コンソールを使用して電子メールエンドポイントを追加した場合に、管理者が指定します。

メモ

監視される電子メールアカウントは、電子メールエンドポイントにのみ使用される特別なアカウントです。 このアカウントは、通常のユーザーの電子メールアカウントではありません。 通常のユーザーの電子メールアカウントは、電子メールプロバイダーが使用するアカウントとして設定する必要はありません。電子メールプロバイダーは、メッセージの処理が完了した後でインボックスから電子メールメッセージを削除します。

電子メールエンドポイントをプログラムでサービスに追加する場合、次の設定値が設定されます。

  • cronExpression:Cron式。Cron式を使用して電子メールをスケジュールする必要がある場合に使用します。
  • repeatCount:電子メールエンドポイントがフォルダーまたはディレクトリをスキャンする回数です。-1 を指定すると、無限にスキャンされます。デフォルト値は -1 です。
  • repeatInterval:受信メールの確認に使用するスキャン速度（秒）です。デフォルト値は 10 です。
  • startDelay:スケジューラーの開始後にスキャンを実行するまで待機する時間です。デフォルトの時間は0です。
  • batchSize:受信者が1回のスキャンで処理する電子メールメッセージの数で、最適なパフォーマンスを得るために必要なものです。-1 を指定すると、すべての電子メールが処理されます。デフォルト値は 2 です。
  • userName:電子メールからターゲットサービスを呼び出すときに使用されるユーザー名です。デフォルト値は SuperAdmin です。
  • domainName:必須の設定値です。デフォルト値は DefaultDom です。
  • domainPattern:受信時にプロバイダーが受け付ける電子メールのドメインパターンを指定します。例えば、adobe.comを使用すると、adobe.comからの電子メールのみが処理され、他のドメインからの電子メールは無視されます。
  • filePattern:受信時にプロバイダーが受け付ける添付ファイルのパターンを指定します。特定のファイル名拡張子(&ast;.dat, &ast;.xml)を持つファイル、特定の名前(data)を持つファイル、名前と拡張子が複合式ーを持つファイル(&ast;)などが含まれます。[dD][aA]'port')。デフォルト値は * です。
  • recipientSuccessfulJob:ジョブの成功を示すメッセージの送信先の電子メールアドレスです。デフォルトでは、ジョブの正常終了メッセージは常に送信者に送信されます。sender と入力すると、電子メールの結果は送信者に送信されます。最大 100 人の受信者を指定できます。追加の受信者を電子メールアドレスと共に指定し、それぞれをコンマで区切ります。 このオプションをオフにするには、この値を空白のままにします。 場合によっては、プロセスをトリガーし、結果の電子メール通知を送信しないことが必要になります。 デフォルト値は sender です。
  • recipientFailedJob:ジョブの失敗を示すメッセージの送信先の電子メールアドレスです。デフォルトでは、ジョブ失敗メッセージは常に送信者に送信されます。 sender と入力すると、電子メールの結果は送信者に送信されます。最大 100 人の受信者を指定できます。追加の受信者を電子メールアドレスと共に指定し、それぞれをコンマで区切ります。 このオプションをオフにするには、この値を空白のままにします。 デフォルト値は sender です。
  • inboxHost:電子メールプロバイダーがスキャンを実行するインボックスのホスト名またはIPアドレスです。
  • inboxPort:電子メールサーバーが使用するポートです。POP3 のデフォルト値は「110」で、IMAP のデフォルト値は「143」です。SSL が有効になっている場合は、POP3 のデフォルト値は「995」で、IMAP のデフォルト値は「993」です。
  • inboxProtocol:電子メールエンドポイントがインボックスのスキャンに使用する電子メールプロトコルです。オプションはIMAPまたはPOP3です。 指定のプロトコルはインボックスホストメールサーバーでサポートされている必要があります。
  • inboxTimeOut:電子メールプロバイダーがインボックスの応答を待機する時間（秒）です。デフォルト値は 60 です。
  • inboxUser:電子メールアカウントにログインするために必要なユーザー名です。電子メールサーバーと設定によっては、電子メールのユーザー名の部分のみを指定する場合と、完全な電子メールアドレスを指定する場合があります。
  • inboxPassword:インボックスユーザーのパスワードです。
  • inboxSSLEnabled:この値を設定すると、電子メールプロバイダーは、結果またはエラーの通知メッセージを送信する際にSSLを使用するように強制されます。IMAPまたはPOP3ホストでSSLがサポートされていることを確認します。
  • smtpHost:電子メールプロバイダーが結果およびエラーメッセージを送信するメールサーバーのホスト名です。
  • smtpPort:SMTPポートのデフォルト値は25です。
  • smtpUser:電子メールプロバイダーが結果およびエラーの電子メール通知を送信するときに使用するユーザーアカウントです。
  • smtpPassword:SMTPアカウントのパスワードです。SMTP パスワードが不要なメールサーバーもあります。
  • charSet:電子メールプロバイダーが使用する文字セットです。デフォルト値は UTF-8 です。
  • smtpSSLEnabled:この値を設定すると、電子メールプロバイダーは、結果またはエラーの通知メッセージを送信する際にSSLを使用するように強制されます。SMTPホストでSSLがサポートされていることを確認します。
  • failedJobFolder:SMTPメールサーバーが動作していない場合に結果を保存するディレクトリを指定します。
  • 非同期:「同期」に設定すると、すべての入力ドキュメントが処理され、単一の応答が返されます。「asynchronous」に設定すると、処理される入力ドキュメントごとに応答が送信されます。 例えば、このトピックで紹介されるプロセス用に電子メールエンドポイントが作成され、保護されていない複数のPDFドキュメントが含まれる電子メールメッセージがエンドポイントのインボックスに送信されます。 すべてのPDFドキュメントがパスワードを使用して暗号化され、エンドポイントが同期に設定されている場合は、保護されたすべてのPDFドキュメントが添付された単一の応答電子メールメッセージが送信されます。 エンドポイントが非同期として設定されている場合は、保護されたPDFドキュメントごとに個別の応答電子メールメッセージが送信されます。 各電子メールメッセージには、添付ファイルとして1つのPDFドキュメントが含まれています。 デフォルト値は「asynchronous」です。

入力パラメーター値の定義

電子メールエンドポイントを作成する場合は、入力パラメーターの値を定義する必要があります。 つまり、電子メールエンドポイントによって呼び出される操作に渡される入力値を記述する必要があります。 例えば、このトピックで紹介したプロセスを考えてみましょう。 InDocという名前の1つの入力値があり、そのデータタイプはcom.adobe.idp.Documentです。 このプロセスの電子メールエンドポイントを作成する場合（プロセスがアクティベートされると、サービスになります）、入力パラメーターの値を定義する必要があります。

電子メールエンドポイントに必要な入力パラメーターの値を定義するには、次の値を指定します。

入力パラメーター名:入力パラメーターの名前。入力値の名前は、プロセスに対してWorkbenchで指定されます。 入力値がサービス操作(Workbenchで作成されたプロセスではないFormsサービス)に属する場合、入力名はcomponent.xmlファイルで指定されます。 例えば、この節で紹介するプロセスの入力パラメーターの名前はInDocです。

マッピングの種類:サービス操作の呼び出しに必要な入力値を設定するために使用します。次に、2種類のマッピングタイプを示します。

  • Literal:電子メールエンドポイントでは、フィールドに入力された値が表示どおりに使用されます。すべての基本 Java 型がサポートされます。例えば、String、long、int および Boolean などの入力が使用される API の場合、文字列は適切な型に変換され、サービスが呼び出されます。
  • Variable:入力された値は、電子メールエンドポイントが入力の選択に使用するファイルパターンです。例えば、マッピングの種類として「Variable」を選択し、入力ドキュメントーをPDFファイルにする必要がある場合、マッピング値として*.pdfを指定できます。

マッピング値:マッピングタイプの値を指定します。例えば、変数のマッピングの種類を選択した場合、ファイルパターンとして*.pdfを指定できます。

データタイプ:入力値のデータタイプを指定します。例えば、この節で紹介するプロセスの入力値のデータタイプはcom.adobe.idp.ドキュメントです。

出力パラメーター値の定義

電子メールエンドポイントを作成する場合は、出力パラメーターの値を定義する必要があります。 つまり、電子メールエンドポイントによって呼び出されるサービスから返される出力値を記述する必要があります。 例えば、このトピックで紹介したプロセスを考えてみましょう。 SecuredDocという出力値があり、そのデータタイプはcom.adobe.idp.Documentです。 このプロセスの電子メールエンドポイントを作成する場合（プロセスがアクティブ化されると、サービスになります）、出力パラメーターの値を定義する必要があります。

電子メールエンドポイントに必要な出力パラメーターの値を定義するには、次の値を指定します。

出力パラメーター名:出力パラメーターの名前。プロセス出力値の名前は、Workbenchで指定されます。 出力値がサービス操作（Workbenchで作成されたプロセスではないサービス）に属する場合、出力名はcomponent.xmlファイルで指定されます。 例えば、この節で紹介するプロセスの出力パラメーターの名前はSecuredDocです。

マッピングの種類:サービスと操作の出力を設定するために使用します。以下のオプションが利用できます。

  • サービスが1つのオブジェクト(1つのドキュメント)を返す場合、パターンは%F.pdfで、ソースの宛先はsourcefilename.pdfです。 例えば、この節で紹介したプロセスは、1つのドキュメントを返します。 その結果、マッピングの種類は%F.pdfと定義できます（%Fは指定したファイル名を使用することを意味します）。 パターン%Eは入力ドキュメントの拡張を指定します。
  • サービスがリストを返す場合、パターンはResult\%F\で、ソースの出力先はResult\sourcefilename\source1 (output 1)およびResult\sourcefilename\source2 (output 2)です。
  • サービスがマップを返す場合、パターンはResult\%F\で、ソースの宛先はResult\sourcefilename\file1 and Result\sourcefilename\file2です。 マップに複数のオブジェクトが含まれる場合、パターンはResult\%F.pdfで、ソースの宛先はResult\sourcefilename1.pdf（出力1）、Result\sourcefilename2.pdf（出力2）のようになります。

データタイプ:戻り値のデータ型を指定します。例えば、この節で紹介するプロセスの戻り値のデータ型はcom.adobe.idp.Documentです。

電子メールエンドポイントの作成

電子メールエンドポイントの属性と設定値を設定し、入力パラメーターと出力パラメーターの値を定義した後、電子メールエンドポイントを作成する必要があります。

エンドポイントの有効化

電子メールエンドポイントを作成したら、そのエンドポイントを有効にする必要があります。 エンドポイントが有効な場合は、サービスの呼び出しに使用できます。 エンドポイントを有効にした後、管理コンソール内で表示できます。

関連トピック

Java APIを追加使用する電子メールエンドポイント

AEM Forms Java ライブラリファイルを含める

接続プロパティの設定

Java API <a0追加/>を使用した電子メールエンドポイント

Java APIを追加使用した電子メールエンドポイント：

  1. プロジェクトファイルを含めます。

    Javaプロジェクトのクラスパスに、adobe-livecycle-client.jarなどのクライアントJARファイルを含めます。

  2. EndpointRegistry Clientオブジェクトを作成します。

    • 接続プロパティを含む ServiceClientFactory オブジェクトを作成します。
    • コンストラクターを使用し、EndpointRegistryClientオブジェクトを渡して、ServiceClientFactoryオブジェクトを作成します。

  3. 電子メールエンドポイント属性を設定します。

    • コンストラクタを使用して CreateEndpointInfo オブジェクトを作成します。
    • CreateEndpointInfoオブジェクトのsetConnectorIdメソッドを呼び出し、文字列値Emailを渡して、コネクタ識別子の値を指定します。
    • CreateEndpointInfoオブジェクトのsetDescriptionメソッドを呼び出し、エンドポイントを説明する文字列値を渡して、エンドポイントの説明を指定します。
    • CreateEndpointInfoオブジェクトのsetNameメソッドを呼び出し、名前を指定する文字列値を渡して、エンドポイントの名前を指定します。
    • CreateEndpointInfoオブジェクトのsetServiceIdメソッドを呼び出し、サービス名を指定する文字列値を渡して、エンドポイントが属するサービスを指定します。
    • CreateEndpointInfoオブジェクトのsetOperationNameメソッドを呼び出し、操作名を指定する文字列値を渡して、呼び出す操作を指定します。 通常、Workbenchで作成されたプロセスから派生するサービスの電子メールエンドポイントを作成する場合、操作の名前はinvokeです。

  4. 設定値を指定します。

    電子メールエンドポイントに設定する設定値ごとに、CreateEndpointInfoオブジェクトのsetConfigParameterAsTextメソッドを呼び出す必要があります。 例えば、smtpHost設定値を設定するには、CreateEndpointInfoオブジェクトのsetConfigParameterAsTextメソッドを呼び出し、次の値を渡します。

    • 設定値の名前を指定するstring値。 smtpHost設定値を設定する場合は、smtpHostを指定します。
    • 設定値の値を指定するstring値。 smtpHost設定値を設定する場合は、SMTPサーバーの名前を指定するstring値を指定します。
    メモ

    この節で紹介するEncryptDocumentサービスの設定値をすべて確認するには、QuickStartにあるJavaコードの例を参照してください。Java APIを使用した電子メールエンドポイントの追加を参照してください。

  5. 入力パラメーターの値を定義します。

    CreateEndpointInfoオブジェクトのsetInputParameterMappingメソッドを呼び出し、次の値を渡して、入力パラメーターの値を定義します。

    • 入力パラメーターの名前を指定するstring値。 例えば、EncryptDocumentサービスの入力パラメーターの名前はInDocです。
    • 入力パラメーターのデータタイプを指定するstring値。 例えば、InDoc入力パラメーターのデータタイプはcom.adobe.idp.Documentです。
    • マッピングの種類を指定するstring値です。 例えば、variableを指定できます。
    • マッピングタイプの値を指定するstring値。 例えば、&ast;.pdfをファイルパターンとして指定できます。
    メモ

    定義する各入力パラメーター値に対してsetInputParameterMappingメソッドを呼び出します。 EncryptDocumentプロセスには1つの入力パラメーターしかないので、このメソッドを1回呼び出す必要があります。

  6. 出力パラメーターの値を定義します。

    CreateEndpointInfoオブジェクトのsetOutputParameterMappingメソッドを呼び出し、次の値を渡して、出力パラメーターの値を定義します。

    • 出力パラメーターの名前を指定するstring値。 例えば、EncryptDocumentサービスの出力パラメーターの名前はSecuredDocです。
    • 出力パラメーターのデータタイプを指定するstring値。 例えば、SecuredDoc出力パラメーターのデータタイプはcom.adobe.idp.Documentです。
    • マッピングの種類を指定するstring値です。 例えば、%F.pdfを指定できます。

  7. 電子メールエンドポイントを作成します。

    EndpointRegistryClientオブジェクトのcreateEndpointメソッドを呼び出し、CreateEndpointInfoオブジェクトを渡して、エンドポイントを作成します。 このメソッドは、電子メールエンドポイントを表すEndpointオブジェクトを返します。

  8. エンドポイントを有効にします。

    EndpointRegistryClientオブジェクトのenableメソッドを呼び出し、createEndpointメソッドから返されたEndpointオブジェクトを渡して、エンドポイントを有効にします。

関連トピック

手順の概要

QuickStart:Java APIを使用した監視フォルダーエンドポイントの追加

AEM Forms Java ライブラリファイルを含める

接続プロパティの設定

電子メール構成値定数ファイル

QuickStart: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 FormsJava APIを使用すると、プログラムによってリモートエンドポイントをサービスに追加できます。 リモートエンドポイントを追加すると、Flexアプリケーションがリモート処理を使用してサービスを呼び出せるようになります。 (「AEM Formsの呼び出し(AEM formsでは廃止)」を参照)。AEM Formsリモート

プログラムによってリモートエンドポイントをサービスに追加する場合は、次の​EncryptDocument​という短時間のみ有効なプロセスを検討してください。

ar_ar_encryptdocumentprocess

このプロセスは、保護されていないPDFドキュメントを入力値として受け取り、保護されていないPDFドキュメントをEncryptionサービスのEncryptPDFUsingPassword操作に渡します。 PDFドキュメントはパスワードを使用して暗号化され、パスワードを使用して暗号化されたPDFドキュメントはこのプロセスの出力値です。 入力値の名前(保護されていないPDFドキュメント)はInDocで、データタイプはcom.adobe.idp.Documentです。 出力値の名前(パスワードで暗号化されたPDFドキュメント)はSecuredDocで、データタイプはcom.adobe.idp.Documentです。

この節では、Remotingエンドポイントをサービスに追加する方法を示すために、EncryptDocumentという名前のサービスにリモートエンドポイントを追加します。

メモ

Webサービスを使用してリモートエンドポイントを追加することはできません。

手順の概要

エンドポイントをサービスから削除するには、次のタスクを実行します。

  1. プロジェクトファイルを含めます。
  2. EndpointRegistryClientオブジェクトを作成します。
  3. リモートエンドポイントの属性を設定します。
  4. リモートエンドポイントを作成します。
  5. エンドポイントを有効にします。

プロジェクトファイルを含める

必要なファイルを開発プロジェクトに含めます。 Javaを使用してクライアントアプリケーションを作成する場合は、必要なJARファイルを含めます。 Webサービスを使用している場合は、プロキシファイルを必ず含めます。

次のJARファイルをプロジェクトのクラスパスに追加する必要があります。

  • adobe-livecycle-client.jar
  • adobe-usermanager-client.jar
  • adobe-utilities.jar(AEM FormsがJBoss Application Serverにデプロイされている場合に必要)
  • jbossall-client.jar(AEM FormsがJBoss Application Serverにデプロイされている場合に必要)

これらのJARファイルの場所について詳しくは、「AEM FormsJavaライブラリファイルを含める」を参照してください。

EndpointRegistry Clientオブジェクトの作成

プログラムによってリモートエンドポイントを追加するには、EndpointRegistryClientオブジェクトを作成する必要があります。

リモートエンドポイント属性の設定

サービスのリモートエンドポイントを作成するには、次の値を指定します。

  • コネクタ識別子の値:作成されるエンドポイントの種類を指定します。リモートエンドポイントを作成するには、Remotingを指定します。
  • 説明:エンドポイントの説明を指定します。
  • 名前:エンドポイントの名前を指定します。
  • サービス識別子の値:エンドポイントが属するサービスを指定します。例えば、この節で紹介するプロセス（Workbench内でアクティブ化されるとプロセスがサービスになる）にリモートエンドポイントを追加するには、EncryptDocumentを指定します。
  • 操作名:エンドポイントを使用して呼び出される操作の名前を指定します。リモートエンドポイントを作成する場合は、ワイルドカード文字(&ast;)を指定します。

リモートエンドポイントの作成

リモートエンドポイント属性を設定した後、サービスのリモートエンドポイントを作成できます。

エンドポイントの有効化

新しいエンドポイントを作成したら、そのエンドポイントを有効にする必要があります。 リモートエンドポイントが有効な場合、Flexクライアントがサービスを呼び出せるようにします。

関連トピック

Java APIを追加使用するリモートエンドポイント

AEM Forms Java ライブラリファイルを含める

接続プロパティの設定

Java API <a0追加/>を使用したリモートエンドポイント

Java APIを追加使用したリモートエンドポイント：

  1. プロジェクトファイルを含めます。

    Javaプロジェクトのクラスパスに、adobe-livecycle-client.jarなどのクライアントJARファイルを含めます。

  2. EndpointRegistry Clientオブジェクトを作成します。

    • 接続プロパティを含む ServiceClientFactory オブジェクトを作成します。
    • コンストラクターを使用し、EndpointRegistryClientオブジェクトを渡して、ServiceClientFactoryオブジェクトを作成します。

  3. リモートエンドポイントの属性を設定します。

    • コンストラクタを使用して CreateEndpointInfo オブジェクトを作成します。
    • CreateEndpointInfoオブジェクトのsetConnectorIdメソッドを呼び出し、文字列値Remotingを渡して、コネクタ識別子の値を指定します。
    • CreateEndpointInfoオブジェクトのsetDescriptionメソッドを呼び出し、エンドポイントを説明する文字列値を渡して、エンドポイントの説明を指定します。
    • CreateEndpointInfoオブジェクトのsetNameメソッドを呼び出し、名前を指定する文字列値を渡して、エンドポイントの名前を指定します。
    • CreateEndpointInfoオブジェクトのsetServiceIdメソッドを呼び出し、サービス名を指定する文字列値を渡して、エンドポイントが属するサービスを指定します。
    • CreateEndpointInfoオブジェクトのsetOperationNameメソッドによって呼び出される操作を指定し、操作名を指定する文字列値を渡します。 リモートエンドポイントには、ワイルドカード文字(&ast;)を指定します。

  4. リモートエンドポイントを作成します。

    EndpointRegistryClientオブジェクトのcreateEndpointメソッドを呼び出し、CreateEndpointInfoオブジェクトを渡して、エンドポイントを作成します。 このメソッドは、新しいリモートエンドポイントを表すEndpointオブジェクトを返します。

  5. エンドポイントを有効にします。

    EndpointRegistryClientオブジェクトのenableメソッドを呼び出し、createEndpointメソッドから返されたEndpointオブジェクトを渡して、エンドポイントを有効にします。

関連トピック

手順の概要

QuickStart:Java APIを使用したリモートエンドポイントの追加

AEM Forms Java ライブラリファイルを含める

接続プロパティの設定

TaskManagerエンドポイントの追加

プログラムでTaskManagerエンドポイントをサービスに追加するには、AEM FormsJava APIを使用します。 TaskManagerエンドポイントをサービスに追加することで、Workspaceユーザーがサービスを呼び出せるようにします。 つまり、Workspaceで作業しているユーザーは、対応するTaskManagerエンドポイントを持つプロセスを呼び出すことができます。

メモ

Webサービスを使用してTaskManagerエンドポイントを追加することはできません。

手順の概要

TaskManagerエンドポイントをサービスに追加するには、次のタスクを実行します。

  1. プロジェクトファイルを含めます。
  2. EndpointRegistryClientオブジェクトを作成します。
  3. エンドポイントのカテゴリを作成します。
  4. TaskManagerエンドポイント属性を設定します。
  5. TaskManagerエンドポイントを作成します。
  6. エンドポイントを有効にします。

プロジェクトファイルを含める

必要なファイルを開発プロジェクトに含めます。 Javaを使用してクライアントアプリケーションを作成する場合は、必要なJARファイルを含めます。 Webサービスを使用している場合は、プロキシファイルを必ず含めます。

次のJARファイルをプロジェクトのクラスパスに追加する必要があります。

  • adobe-livecycle-client.jar
  • adobe-usermanager-client.jar
  • adobe-utilities.jar(AEM FormsがJBoss Application Serverにデプロイされている場合に必要)
  • jbossall-client.jar(AEM FormsがJBoss Application Serverにデプロイされている場合に必要)

これらのJARファイルの場所について詳しくは、「AEM FormsJavaライブラリファイルを含める」を参照してください。

EndpointRegistry Clientオブジェクトの作成

プログラムによってTaskManagerエンドポイントを追加する前に、EndpointRegistryClientオブジェクトを作成する必要があります。

エンドポイントのカテゴリの作成

カテゴリは、Workspace内のサービスを整理するために使用されます。 つまり、Workspaceユーザーは、Workspace内でカテゴリを選択することで、TaskManagerエンドポイントを持つサービスを呼び出すことができます。 TaskManagerエンドポイントを作成する場合、既存のカテゴリを参照するか、新しいカテゴリをプログラムで作成することができます。

メモ

この節では、TaskManagerエンドポイントをサービスに追加する際に、新しいカテゴリを作成します。

TaskManagerエンドポイント属性の設定

サービスのTaskManagerエンドポイントを作成するには、次の値を指定します。

  • コネクタ識別子:作成されるエンドポイントの種類を指定します。TaskManagerエンドポイントを作成するには、TaskManagerConnectorを指定します。
  • 説明:エンドポイントの説明を指定します。
  • 名前:エンドポイントの名前を指定します。
  • サービス識別子:エンドポイントが属するサービスを指定します。
  • カテゴリ:TaskManagerエンドポイントに関連付けられるカテゴリ識別子の値を指定します。
  • 操作名:通常、Workbenchで作成されたプロセスから派生するサービスのTaskManagerエンドポイントを作成する場合、操作の名前はで invokeす。

TaskManagerエンドポイントの作成

TaskManagerエンドポイント属性を設定した後、サービス用のTaskManagerエンドポイントを作成できます。

エンドポイントの有効化

新しいエンドポイントを作成したら、そのエンドポイントを有効にする必要があります。 エンドポイントが有効な場合、Workspace内からサービスを呼び出すために使用できます。 エンドポイントを有効にした後、管理コンソール内で表示できます。

関連トピック

Java APIを追加使用するTaskManagerエンドポイント

AEM Forms Java ライブラリファイルを含める

接続プロパティの設定

追加Java APIを使用するTaskManagerエンドポイント

Java APIを追加使用したTaskManagerエンドポイント：

  1. プロジェクトファイルを含めます。

    Javaプロジェクトのクラスパスに、adobe-livecycle-client.jarなどのクライアントJARファイルを含めます。

  2. EndpointRegistry Clientオブジェクトを作成します。

    • 接続プロパティを含む ServiceClientFactory オブジェクトを作成します。
    • コンストラクターを使用し、EndpointRegistryClientオブジェクトを渡して、ServiceClientFactoryオブジェクトを作成します。

  3. エンドポイントのカテゴリを作成します。

    • コンストラクターを使用し、次の値を渡して、CreateEndpointCategoryInfoオブジェクトを作成します。

      • カテゴリの識別子の値を指定するstring値
      • カテゴリの説明を指定するstring値です

    • EndpointRegistryClientオブジェクトのcreateEndpointCategoryメソッドを呼び出し、CreateEndpointCategoryInfoオブジェクトを渡して、カテゴリを作成します。 このメソッドは、新しいカテゴリを表すEndpointCategoryオブジェクトを返します。

  4. TaskManagerエンドポイント属性を設定します。

    • コンストラクタを使用して CreateEndpointInfo オブジェクトを作成します。
    • CreateEndpointInfoオブジェクトのsetConnectorIdメソッドを呼び出し、文字列値TaskManagerConnectorを渡して、コネクタ識別子の値を指定します。
    • CreateEndpointInfoオブジェクトのsetDescriptionメソッドを呼び出し、エンドポイントを説明する文字列値を渡して、エンドポイントの説明を指定します。
    • CreateEndpointInfoオブジェクトのsetNameメソッドを呼び出し、名前を指定する文字列値を渡して、エンドポイントの名前を指定します。
    • CreateEndpointInfoオブジェクトのsetServiceIdメソッドを呼び出し、サービス名を指定する文字列値を渡して、エンドポイントが属するサービスを指定します。
    • CreateEndpointInfoオブジェクトのsetCategoryIdメソッドを呼び出し、カテゴリ識別子の値を指定する文字列値を渡して、エンドポイントが属するカテゴリを指定します。 EndpointCategoryオブジェクトのgetIdメソッドを呼び出して、このカテゴリの識別子の値を取得できます。
    • CreateEndpointInfoオブジェクトのsetOperationNameメソッドを呼び出し、操作名を指定する文字列値を渡して、呼び出す操作を指定します。 通常、Workbenchで作成されたプロセスから派生するサービスのTaskManagerエンドポイントを作成する場合、操作の名前はinvokeです。

  5. TaskManagerエンドポイントを作成します。

    EndpointRegistryClientオブジェクトのcreateEndpointメソッドを呼び出し、CreateEndpointInfoオブジェクトを渡して、エンドポイントを作成します。 このメソッドは、新しいTaskManagerエンドポイントを表すEndpointオブジェクトを返します。

  6. エンドポイントを有効にします。

    EndpointRegistryClientオブジェクトのenableメソッドを呼び出し、createEndpointメソッドから返されたEndpointオブジェクトを渡して、エンドポイントを有効にします。

関連トピック

手順の概要

QuickStart:Java APIを使用したTaskManagerエンドポイントの追加

AEM Forms Java ライブラリファイルを含める

接続プロパティの設定

エンドポイントの変更

AEM FormsJava APIを使用して、既存のエンドポイントをプログラムで変更できます。 エンドポイントを変更すると、エンドポイントの動作を変更できます。 例えば、監視フォルダーとして使用されるフォルダーを指定する監視フォルダーエンドポイントがあるとします。 監視フォルダーエンドポイントに属する設定値をプログラムで変更すると、別のフォルダーが監視フォルダーとして機能するようになります。 監視フォルダーエンドポイントに属する設定値について詳しくは、「監視フォルダーエンドポイントの追加」を参照してください。

エンドポイントの変更方法を示すために、この節では、監視フォルダーとして動作するフォルダーを変更して監視フォルダーエンドポイントを変更します。

メモ

Webサービスを使用してエンドポイントを変更することはできません。

手順の概要

エンドポイントを変更するには、次のタスクを実行します。

  1. プロジェクトファイルを含めます。
  2. EndpointRegistryClientオブジェクトを作成します。
  3. エンドポイントを取得します。
  4. 新しい設定値を指定します。

プロジェクトファイルを含める

必要なファイルを開発プロジェクトに含めます。 Javaを使用してクライアントアプリケーションを作成する場合は、必要なJARファイルを含めます。 Webサービスを使用している場合は、プロキシファイルを必ず含めます。

次のJARファイルをプロジェクトのクラスパスに追加する必要があります。

  • adobe-livecycle-client.jar
  • adobe-usermanager-client.jar
  • adobe-utilities.jar(AEM FormsがJBoss Application Serverにデプロイされている場合に必要)
  • jbossall-client.jar(AEM FormsがJBoss Application Serverにデプロイされている場合に必要)

これらのJARファイルの場所について詳しくは、「AEM FormsJavaライブラリファイルを含める」を参照してください。

EndpointRegistry Clientオブジェクトの作成

エンドポイントをプログラムで変更するには、EndpointRegistryClientオブジェクトを作成する必要があります。

変更するエンドポイントの取得

エンドポイントを変更する前に、エンドポイントを取得する必要があります。 エンドポイントを取得するには、エンドポイントにアクセスできるユーザーとして接続する必要があります。 管理者として接続することをお勧めします。 （接続プロパティの設定を参照）。

エンドポイントのリストを取得するには、エンドポイントを取得します。 その後、削除する特定のエンドポイントを検索し、リストを繰り返し実行できます。 例えば、エンドポイントに対応するサービスとエンドポイントの種類を決定することで、エンドポイントを特定できます。 エンドポイントを見つけたら、そのエンドポイントを変更できます。

新しい設定値を指定する

エンドポイントを変更する場合は、新しい設定値を指定します。 例えば、監視フォルダーエンドポイントを変更するには、変更する値だけでなく、すべての監視フォルダーエンドポイントの設定値をリセットします。 監視フォルダーエンドポイントに属する設定値について詳しくは、「監視フォルダーエンドポイントの追加」を参照してください。

メモ

電子メールエンドポイントに属する設定値について詳しくは、電子メールエンドポイントの追加を参照してください。

メモ

エンドポイントによって呼び出されるサービスは変更できません。 サービスを変更しようとすると、例外が発生します。 特定のエンドポイントに関連付けられたサービスを変更するには、エンドポイントを削除し、新しいエンドポイントを作成します。 （「エンドポイントの削除」を参照）。

関連トピック

Java APIを使用したエンドポイントの変更

AEM Forms Java ライブラリファイルを含める

接続プロパティの設定

Java APIを使用したエンドポイントの変更

Java APIを使用してエンドポイントを変更します。

  1. プロジェクトファイルを含めます。

    Javaプロジェクトのクラスパスに、adobe-livecycle-client.jarなどのクライアントJARファイルを含めます。

  2. EndpointRegistry Clientオブジェクトを作成します。

    • 接続プロパティを含む ServiceClientFactory オブジェクトを作成します。
    • コンストラクターを使用し、EndpointRegistryClientオブジェクトを渡して、ServiceClientFactoryオブジェクトを作成します。

  3. 変更するエンドポイントを取得します。

    • 現在のユーザー（接続プロパティで指定）がアクセスできるすべてのエンドポイントのリストを取得するには、EndpointRegistryClientオブジェクトのgetEndpointsメソッドを呼び出し、フィルターとして機能するPagingFilterオブジェクトを渡します。 (PagingFilter)null値を渡すと、すべてのエンドポイントを返すことができます。 このメソッドは、java.util.Listオブジェクトを返します。各要素はEndpointオブジェクトです。 PagingFilterオブジェクトについて詳しくは、AEM FormsAPIリファレンスを参照してください。
    • java.util.Listオブジェクトを繰り返し処理して、エンドポイントがあるかどうかを判断します。 エンドポイントが存在する場合、各要素はEndPointインスタンスになります。
    • EndPointオブジェクトのgetServiceIdメソッドを呼び出して、エンドポイントに対応するサービスを特定します。 このメソッドは、サービス名を指定するstring値を返します。
    • EndPointオブジェクトのgetConnectorIdメソッドを呼び出して、エンドポイントの種類を判断します。 このメソッドは、エンドポイントのタイプを指定するstring値を返します。 例えば、エンドポイントが監視フォルダーエンドポイントの場合、このメソッドはWatchedFolderを返します。

  4. 新しい設定値を指定します。

    • コンストラクターを呼び出して、ModifyEndpointInfoオブジェクトを作成します。

    • 設定する各設定値に対して、ModifyEndpointInfoオブジェクトのsetConfigParameterAsTextメソッドを呼び出します。 例えば、url設定値を設定するには、ModifyEndpointInfoオブジェクトのsetConfigParameterAsTextメソッドを呼び出し、次の値を渡します。

      • 設定値の名前を指定するstring値。 例えば、url設定値を設定するには、urlを指定します。
      • 設定値の値を指定するstring値。 url設定値の値を定義するには、監視フォルダーの場所を指定します。

    • EndpointRegistryClientオブジェクトのmodifyEndpointメソッドを呼び出し、ModifyEndpointInfoオブジェクトを渡します。

関連トピック

手順の概要

QuickStart:Java APIを使用したエンドポイントの変更

AEM Forms Java ライブラリファイルを含める

接続プロパティの設定

エンドポイントの削除

AEM FormsJava APIを使用すると、プログラムによってエンドポイントをサービスから削除できます。 エンドポイントを削除すると、エンドポイントで有効になっている呼び出し方法を使用してサービスを呼び出すことはできません。 例えば、サービスからSOAPエンドポイントを削除する場合、SOAPモードを使用してサービスを呼び出すことはできません。

この節では、サービスからエンドポイントを削除する方法を示すために、EncryptDocument​という名前のサービスからEJBエンドポイントを削除します。

メモ

Webサービスを使用してエンドポイントを削除することはできません。

手順の概要

エンドポイントをサービスから削除するには、次のタスクを実行します。

  1. プロジェクトファイルを含めます。
  2. EndpointRegistryClientオブジェクトを作成します。
  3. エンドポイントを取得します。
  4. エンドポイントを削除します。

プロジェクトファイルを含める

必要なファイルを開発プロジェクトに含めます。 Javaを使用してクライアントアプリケーションを作成する場合は、必要なJARファイルを含めます。 Webサービスを使用している場合は、プロキシファイルを必ず含めます。

次のJARファイルをプロジェクトのクラスパスに追加する必要があります。

  • adobe-livecycle-client.jar
  • adobe-usermanager-client.jar
  • adobe-utilities.jar(AEM FormsがJBoss Application Serverにデプロイされている場合に必要)
  • jbossall-client.jar(AEM FormsがJBoss Application Serverにデプロイされている場合に必要)

これらのJARファイルの場所について詳しくは、「AEM FormsJavaライブラリファイルを含める」を参照してください。

EndpointRegistry Clientオブジェクトの作成

プログラムによってエンドポイントを削除するには、EndpointRegistryClientオブジェクトを作成する必要があります。

削除するエンドポイントを取得します

エンドポイントを削除する前に、エンドポイントを取得する必要があります。 エンドポイントを取得するには、エンドポイントにアクセスできるユーザーとして接続する必要があります。 管理者として接続することをお勧めします。 （接続プロパティの設定を参照）。

エンドポイントのリストを取得するには、エンドポイントを取得します。 その後、削除する特定のエンドポイントを検索し、リストを繰り返し実行できます。 例えば、エンドポイントに対応するサービスとエンドポイントの種類を決定することで、エンドポイントを特定できます。 エンドポイントが見つかったら、削除できます。

エンドポイントの削除

新しいエンドポイントを作成したら、そのエンドポイントを有効にする必要があります。 エンドポイントが有効な場合は、サービスの呼び出しに使用できます。 エンドポイントを有効にした後、管理コンソール内で表示できます。

関連トピック

Java APIを使用したエンドポイントの削除

AEM Forms Java ライブラリファイルを含める

接続プロパティの設定

Java APIを使用したエンドポイントの削除

Java APIを使用したエンドポイントの削除：

  1. プロジェクトファイルを含めます。

    Javaプロジェクトのクラスパスに、adobe-livecycle-client.jarなどのクライアントJARファイルを含めます。

  2. EndpointRegistry Clientオブジェクトを作成します。

    • 接続プロパティを含む ServiceClientFactory オブジェクトを作成します。
    • コンストラクターを使用し、EndpointRegistryClientオブジェクトを渡して、ServiceClientFactoryオブジェクトを作成します。

  3. 削除するエンドポイントを取得します。

    • EndpointRegistryClientオブジェクトのgetEndpointsメソッドを呼び出し、フィルターとして機能するPagingFilterオブジェクトを渡すことで、現在のユーザー（接続プロパティで指定）がアクセスできるすべてのエンドポイントのリストを取得します。 (PagingFilter)nullを渡すと、すべてのエンドポイントを返すことができます。 このメソッドは、java.util.Listオブジェクトを返します。各要素はEndpointオブジェクトです。
    • java.util.Listオブジェクトを繰り返し処理して、エンドポイントがあるかどうかを判断します。 エンドポイントが存在する場合、各要素はEndPointインスタンスになります。
    • EndPointオブジェクトのgetServiceIdメソッドを呼び出して、エンドポイントに対応するサービスを特定します。 このメソッドは、サービス名を指定するstring値を返します。
    • EndPointオブジェクトのgetConnectorIdメソッドを呼び出して、エンドポイントの種類を判断します。 このメソッドは、エンドポイントのタイプを指定するstring値を返します。 例えば、エンドポイントがEJBエンドポイントの場合、このメソッドはEJBを返します。

  4. エンドポイントを削除します。

    EndpointRegistryClientオブジェクトのremoveメソッドを呼び出し、削除するエンドポイントを表すEndPointオブジェクトを渡して、エンドポイントを削除します。

関連トピック

手順の概要

QuickStart:Java APIを使用したエンドポイントの削除

AEM Forms Java ライブラリファイルを含める

接続プロパティの設定

エンドポイントコネクタ情報を取得中

AEM FormsAPIを使用して、エンドポイントコネクタに関する情報をプログラムで取得できます。 コネクタは、エンドポイントが様々な呼び出し方法を使用してサービスを呼び出せるようにします。 例えば、監視フォルダーコネクターを使用すると、エンドポイントで監視フォルダーを使用したサービスの呼び出しが可能になります。 プログラムによってエンドポイントコネクタに関する情報を取得することで、必要な設定値や任意の設定値など、コネクタに関連付けられた設定値を取得できます。

エンドポイントコネクターに関する情報を取得する方法を説明するために、この節では監視フォルダーコネクターに関する情報を取得します。 （「監視フォルダーエンドポイントの追加」を参照）。

メモ

エンドポイントに関する情報は、Webサービスを使用して取得できません。

メモ

このトピックでは、ConnectorRegistryClient APIを使用してエンドポイントコネクタに関する情報を取得します。 (「AEM FormsAPIリファレンス」を参照)。

手順の概要

エンドポイントコネクタ情報を取得するには、次のタスクを実行します。

  1. プロジェクトファイルを含めます。
  2. ConnectorRegistryClientオブジェクトを作成します。
  3. コネクタタイプを指定します。
  4. 設定値を取得します。

プロジェクトファイルを含める

必要なファイルを開発プロジェクトに含めます。 Javaを使用してクライアントアプリケーションを作成する場合は、必要なJARファイルを含めます。 Webサービスを使用している場合は、プロキシファイルを必ず含めます。

次のJARファイルをプロジェクトのクラスパスに追加する必要があります。

  • adobe-livecycle-client.jar
  • adobe-usermanager-client.jar
  • adobe-utilities.jar(AEM FormsがJBoss Application Serverにデプロイされている場合に必要)
  • jbossall-client.jar(AEM FormsがJBoss Application Serverにデプロイされている場合に必要)

AEM FormsがJBoss以外のサポート対象のJ2EEアプリケーションサーバーにデプロイされている場合は、adobe-utilities.jarおよびjbossall-client.jarを、AEM FormsがデプロイされているJ2EEアプリケーションサーバーに固有のJARファイルに置き換えます。 すべてのAEM FormsJARファイルの場所については、「AEM FormsJavaライブラリファイルを含める」を参照してください。

ConnectorRegistry Clientオブジェクトの作成

プログラムによってエンドポイントコネクタ情報を取得するには、ConnectorRegistryClientオブジェクトを作成します。

コネクタタイプを指定

情報を取得するコネクタの種類を指定します。 次のタイプのコネクタが存在します。

  • EJB:クライアントアプリケーションがEJBモードを使用してサービスを呼び出せるようにします。
  • SOAP:クライアントアプリケーションがSOAPモードを使用してサービスを呼び出せるようにします。
  • 監視フォルダー:監視フォルダーからサービスを呼び出せるようにします。
  • 電子メール:電子メールメッセージでサービスを呼び出せるようにします。
  • Remoting:Flexクライアントアプリケーションがサービスを呼び出せるようにします。
  • TaskManagerConnector:WorkspaceユーザーがWorkspace内からサービスを呼び出せるようにします。

設定値の取得

コネクタの種類を指定すると、サポートされている設定値など、コネクタに関する情報を取得できます。 例えば、どのコネクタの設定値が必須でどの設定値がオプションかを指定できます。

関連トピック

Java APIを使用したエンドポイントコネクタ情報の取得

AEM Forms Java ライブラリファイルを含める

接続プロパティの設定

Java APIを使用してエンドポイントコネクタ情報を取得する

Java APIを使用して、エンドポイントコネクタ情報を取得します。

  1. プロジェクトファイルを含めます。.

    Javaプロジェクトのクラスパスに、adobe-livecycle-client.jarなどのクライアントJARファイルを含めます。

  2. ConnectorRegistry Clientオブジェクトを作成します。

    • 接続プロパティを含む ServiceClientFactory オブジェクトを作成します。
    • コンストラクタを使用して ConnectorRegistryClient オブジェクトを渡すことによって、ServiceClientFactory オブジェクトを作成します。

  3. コネクタタイプを指定します。

    ConnectorRegistryClientオブジェクトのgetEndpointDefinitionメソッドを呼び出し、コネクタの種類を指定する文字列値を渡して、コネクタの種類を指定します。 例えば、監視フォルダーのコネクタタイプを指定するには、文字列値WatchedFolderを渡します。 このメソッドは、コネクタの種類に対応するEndpointオブジェクトを返します。

  4. 設定値を取得します。

    • EndpointオブジェクトのgetConfigParametersメソッドを呼び出して、このエンドポイント内に関連付けられている設定値を取得します。 このメソッドは、ConfigParameterオブジェクトの配列を返します。
    • 配列内の各要素を取得して、各設定値に関する情報を取得します。 各要素はConfigParameterオブジェクトです。 例えば、ConfigParameterオブジェクトのisRequiredメソッドを呼び出すことで、設定値が必須か任意かを判断できます。 設定値が必要な場合、このメソッドはtrueを返します。

関連トピック

手順の概要

QuickStart:Java APIを使用したエンドポイントコネクタ情報の取得

AEM Forms Java ライブラリファイルを含める

接続プロパティの設定

このページ