例: ネストされたクライアント・サイド・ヒューマン・サービスの再使用

この例では、ネストされたクライアント・サイド・ヒューマン・サービスを作成して、それをルートのクライアント・サイド・ヒューマン・サービスで再使用する方法を示します。

このタスクについて

配送先住所を変更するステップで Order Confirmation ・タスクを拡張するとします。 開発者は、 Change Address ステップのネストされたクライアント・サイド・ヒューマン・サービスを定義することができます。これは、より複雑なオーダー・フォームの一部である他のタスクで再利用できます。

以下の例は、 Change Address ステップのネストされたクライアント・サイド・ヒューマン・サービスをビルドする方法と、ネストされたクライアント・サイド・ヒューマン・サービスを Order Confirmationのルート・クライアント・サイド・ヒューマン・サービスに挿入する方法を示しています。 簡単にするために、 Order Confirmation タスクのルート・クライアント・サイド・ヒューマン・サービスが既に存在するとします。

ネストされたクライアント・サイド・ヒューマン・サービスの作成

手順

ネストされたクライアント・サイド・ヒューマン・サービスをビルドするには、以下の手順を実行します。

  1. ルート・クライアント・サイド・ヒューマン・サービスを含むデザイナー・ビューで ワークフロー自動化 を開きます。
    この例では、 ワークフロー自動化 の名前は Order Confirmationです。
  2. 「ユーザー・インターフェース」の横にある正符号 (+) をクリックしてから、 「新規」 > クライアント・サイド・ヒューマン・サービス をクリックして、ウィザードを完了します。
    1. ネストされたクライアント・サイド・ヒューマン・サービスの名前を入力してください: Change Address。
    2. 新しいクライアント・サイド・ヒューマン・サービスを複数のデバイス・タイプで使用することを指定するには、 「複数のデバイスで使用」 を選択します。
      「複数のデバイスで使用」が選択されている場合、クライアント・サイド・ヒューマン・サービスに追加されるすべての新規ページとページ・コンテンツに、応答性ビューが使用されます。
  3. 他のクライアント・サイド・ヒューマン・サービスで再利用できるネストされたクライアント・サイド・ヒューマン・サービスであることを指定するには、 「ネストされたサービスとして使用」 を選択します。
    アドレス変更クライアント・サイド・ヒューマン・サービスの作成ウィザードに、「ネストされたサービスとして使用」と「複数のデバイスで使用」の両方が選択されていることが示されます。
  4. 「完了」をクリックします。 Web エディターにクライアント・サイド・ヒューマン・サービスが開きます。
    デフォルトのネストされたサービス・ダイアグラムは、ページにワイヤリングされた開始ノードで構成され、ページは終了ノードにワイヤリングされます。
    ダイアグラムのページには、ページをエンド・ノードにワイヤリングするために使用できる境界イベントを提供するボタンがあります。 このデフォルトのボタンを使用するか、またはこのボタンを置き換えることができます。
    1. 「概要」に切り替え、ネストされたサービスに対して 「使用法」 オプションが正しく設定されていることを確認します。
      • 「ネストされたサービス」 が選択されている
      • 「 として使用」および 「公開して開始」 が無効になっている
    2. ページ・コンテンツのクライアント・サイド検証を実行したり、条件変数を使用してボタンの有効化を制御したりするには、以下の例のような Data Change スクリプトを追加できます。
      「アドレスの変更」のネストされたクライアント・サイド・ヒューマン・サービスのスクリプト・エディターとダイアグラム・ビューを示す画面キャプチャー。
  5. 「データ」の横にある正符号 (+) をクリックし、 新規 > 「ビジネス・オブジェクト」 をクリックして、ウィザードを完了し、以下のパラメーターを使用して Address ビジネス・オブジェクトを作成します。
    Address ビジネス・オブジェクトには、Street (ストリング) と City (ストリング) の 2 つのパラメーターがあります。
  6. ネストされたサービス・ダイアグラムで、さらにページとエレメントを追加し、それらをワイヤリングして、ネストされたサービスのロジックを作成します。
    例えば、 Change Address ネスト・サービスのダイアグラムには、以下のステップを含めることができます。
    Change Address のネストされたクライアント・サイド・ヒューマン・サービスのダイアグラムには、開始ノード、「アドレスの変更」ページ、「アドレスの確認」サービス、および終了ノードを含めることができます。
  7. 「変数」 ビューで、ネストされたサービスをサポートするための入力変数を追加します。
    Inputの下にある変数リストには、addressとshipToSameが表示されています。
    ヒント: オプションで、クライアント・サイド・ヒューマン・サービスで使用する環境変数または公開プロセス値 (EPV) がある場合は、 「変数」 ビューでそれらをクライアント・サイド・ヒューマン・サービスにリンクします。
    ネストされたサービスのリスト上の市区町村環境変数。
  8. 「ページ」に切り替え、変数をキャンバスに追加してユーザー・インターフェースを作成します。
  9. 「保存」 または 「編集の終了」をクリックします。
    クライアント側のヒューマン・サービスの変数宣言の詳細については、「 変数の宣言 」を参照してください
  10. ウェブ・ブラウザでクライアント側の人間サービスを実行するには、 Run 実行 をクリックします。

結果

Change Address サービスが、ネストに使用可能なクライアント・サイド・ヒューマン・サービスのリストに追加されます。

再使用可能なクライアント・サイド・ヒューマン・サービスのネスト

手順

ネストされたクライアント・サイド・ヒューマン・サービスを再使用のためにルートのクライアント・サイド・ヒューマン・サービスに挿入するには、以下のステップを実行します。

  1. ルート・クライアント・サイド・ヒューマン・サービスを含むデザイナー・ビューで ワークフロー自動化 を開きます。
  2. 「ユーザー・インターフェース」 をクリックし、 Order Confirmation ルート・クライアント・サイド・ヒューマン・サービスを開きます。
  3. 「概要」に切り替え、以下の使用法オプションを設定します。
    • 「ネストされたサービス」がクリアされていることを確認します。
    • 「使用例」リストから、ルートサービスの使用タイプを指定します。利用可能なオプションから1つを選択します。 タスク（プロセスに含まれるサービス ）、 起動可能なサービス （ワークプレイスから起動 ）、 ダッシュボード （ワークプレイスで利用可能 ）、 URL URLから利用可能 ）、またはプロセス用のインスタンス詳細UI。 「用途」オプションは、ネストされたクライアント・サイド・ヒューマン・サービスには無効であることに注意してください。
  4. ダイアグラム・ビューで、入れ子になったクライアント側のヒューマン・サービス ネストされたクライアント・サイド・ヒューマン・サービス・ツール をキャンバスに追加し、ダイアグラム内で配線します。
  5. ネストされたサービス・ノード・プロパティーを開きます。 「実装」の下の 「動作」で、 「クライアント・サイド・ヒューマン・サービスのネスト」 の横にある 「選択」 をクリックし、クライアント・サイド・ヒューマン・サービスのリストから Change Addressを選択します。
    この図は、Order Confirmation というルートのクライアント・サイド・ヒューマン・サービスを示しています。このサービスには、Change Address というネストされたクライアント・サイド・ヒューマン・サービスが含まれています。 ルート・サービスには、開始イベント、「オーダーの作成」ページ、ネストされたクライアント・サイド・ヒューマン・サービス「アドレスの変更」、および終了イベントが含まれています。 ダイアグラムでは、ネストされたサービスがページと終了イベントの間に挿入されます。
  6. ルート・サービスの変数ビューに切り替え、データ・マッピングを使用して、ネストされたサービスのshipToSame変数を初期化する：
    1. ネストされたサービスのアクティビティーを選択し、その 「データ・マッピング」 プロパティーを開きます。
    2. 入力マッピングの下で、ピッカーを使って、ネストしたサービスのshipToSame変数にマッピングされるshipToAddressルート変数を選択します。
    3. サブステップ b を繰り返して、 address ルート変数を、ネストされたサービスの address 変数にマップします。
      Input Mapping]で、ネストしたサービスのshipToSame変数にマッピングするshipToAddressルート変数を選択します。
    4. オプション： データマッピングを自動的に行いたい場合は、自動マッピングアイコン（ 自動マップ・アイコン ）をクリックして、ルートサービス内の同じ名前とデータ型の入力変数にマッピングされていないすべての入力または出力ネスト変数を自動的にマッピングします。 既存のマッピングは置き換えられません。
      ヒント: 変数名の前にある入力アイコンと出力アイコンに注意してください。 これらのアイコンは、開始時に値を持つと予期されている変数 (入力変数)、および、終了時に意味のある値を持つと予期されている変数 (出力変数) を視覚的に示します。
  7. オプション: 「オーダーの作成」ページの一部として顧客の配送先住所と請求先住所を同期する場合は、実行後スクリプトをページに追加します。このスクリプトは、以下の例の JavaScript コードのようになります。 この実行後スクリプトは、ページの完了直後に実行され、該当の 2 つの住所を同期します。
    ダイアグラム・ビューに「オーダーの作成」ページを表示する画面キャプチャー、および実行前スクリプトの横に「実行後スクリプト」を表示する画面キャプチャー。

    ページに実行後スクリプトを割り当てると、ダイアグラム・ビュー内のページ・ノードの右側 (実行後) に、丸いインジケーターが表示されます。

  8. 「保存」 または 「編集の終了」をクリックします。
    クライアント側のヒューマン・サービスの変数宣言の詳細については、「 変数の宣言 」を参照してください
  9. ルート・クライアント側人間サービスを実行するには、 Run 実行 をクリックします。
    ネストされたサービスがルートのサービスの一部として実行されます。