ユーザーデータ収集アクティビティ

  • リリースバージョン: Xanadu
  • 更新日 2024年08月01日
  • 所要時間：6分

    • プレイブックの実行中にユーザーからの入力を収集し、後でプレイブックで使用します。

    重要:
    26.1 リリースの時点で、[ユーザーデータの収集] アクティビティはアクティビティピッカーで使用できなくなりました。アクティビティはどこで使用されても引き続き機能しますが、新しいアクティビティの場合は、代わりに [アンケート] アクティビティを使用してください。[アンケート] アクティビティでは、データ定義を作成する必要はありません。[アンケート] アクティビティの詳細については、「アンケートアクティビティ」を参照してください。
    以下の場合に、ユーザーデータ収集アクティビティを使用します。
    • まだテーブルがない、
    • 収集したデータについてレポートを作成する必要がない、
    • および、プレイブックの外部でデータを使用する必要がない。
    収集したデータを保存するテーブルがすでにある場合は、ユーザーフォームアクティビティを使用します。

    このアクティビティの主な入力は、[入力] セクションの下にある [データコレクションのユーザーフォーム] フィールドです。この入力を提供するには、最初にデータ定義を作成する必要があります。

    ロールと可用性

    このアクティビティは共通アクティビティとして利用できます。admin、playbook.admin、pd_author、または pd_author を持つユーザーは、このアクティビティを プレイブック に追加できます。

    プレイブックの実行中に、データ定義を使用して次のことを行うことができます。
    • 出荷先を収集し、出荷ラベルを生成するときにその住所を参照する。
    • ユーザーに「はい」または「いいえ」の質問をし、ユーザーの応答に基づいてその後のアクティビティを決定する。

    一般的なプロパティ

    これらのプロパティは、プレイブック内のすべてのアクティビティに共通です。

    アクティビティのプロパティパネルを開き、次の入力の値を追加するようにアクティビティを設定します。入力値が異なる場合は、ピルピッカーを使用して値を取得する場所を示します。ピルピッカーの詳細については、「Dot-walking examples」を参照してください。
    入力 タイプ 説明
    ラベル 文字列 アクティビティおよびプレイブックカードとして表示するタイトル。
    説明 文字列 アクティビティの使用状況または結果について表示する情報。
    実行条件 条件ビルダー アクティビティまたはステージを実行するために満たす必要がある条件。前のアクティビティのデータを使用して、条件を作成できます。
    注:
    このフィールドを表示するには、[他のオプションを表示] を選択します。
    開始ルール 選択肢 アンダー スケジュール > Start Rule (開始ルール)で、ステージの実行を開始するタイミングの開始ルールを選択します。
    • プロセスの開始時期：プレイブックが開始されるとすぐにステージの実行が開始されます。
    • 特定のステージの後(After specific stages)：指定したステージの実行が終了した後にステージの実行が開始されます。
    [スケジュール] > [開始ルール] で、アクティビティの実行開始タイミングに関する開始ルールを選択します。
    • ステージ開始時 (When stage starts)：ステージの実行が開始されるとすぐにアクティビティの実行が開始されます。プレイブックがトリガーされるとステージの実行が開始されます。
    • 特定のアクティビティの後(After specific activities)：指定したアクティビティの実行が終了した後にアクティビティの実行が開始されます。
    遅延から開始 True/False アクティビティまたはステージを実行する前に一定時間待機するオプション。有効にすると、この入力には 遅延入力プロパティから開始 が表示されます。
    注:
    このフィールドを表示するには、[他のオプションを表示] を選択します。

    入力

    これらの入力の多くは、プレイブック内のアクティビティに共通です。このアクティビティの主な入力は、[データコレクションのユーザーフォーム] フィールドです。

    アクティビティの必要な入力を設定した後に、追加の入力を設定することもできます。サイドパネルで、[他のオプションを表示] を選択して、これらの詳細入力を表示します。詳細については、「アクティビティエクスペリエンス」を参照してください。
    入力 タイプ 説明
    このプロセスステップのアサイン先グループ Reference.Group [sys_user_group] このプレイブックアクティビティの実行を許可されたアサイン先グループ。[アサイン先グループ] または [アサイン先] の値を設定しない場合、すべてのユーザーが収集されたデータを読み取り、編集できます。[アサイン先グループ] および [アサイン先] フィールドにより、アクセスして実行できるユーザーが制限されます。個々のユーザーのみを指定するには、[アサイン先] フィールドを使用します。同じユーザーを両方のフィールドに指定する必要はありません。
    注:
    デフォルトでは、これらのフィールドはトリガーレコードの [アサイン先グループ] および [アサイン先] フィールドにマップされます。これは、親レコードで作業するようにアサインされたユーザーは、収集されたデータを送信、表示、編集するアクセス権をデフォルトで持っていることを意味します。
    このプロセスステップにアサインされました Reference.User [sys_user] このプレイブックアクティビティの実行を許可されたユーザー。[アサイン先グループ] または [アサイン先] の値を設定しない場合、すべてのユーザーが収集されたデータを読み取り、編集できます。[アサイン先グループ] および [アサイン先] フィールドにより、アクセスして実行できるユーザーが制限されます。個々のユーザーのみを指定するには、[アサイン先] フィールドを使用します。同じユーザーを両方のフィールドに指定する必要はありません。
    注:
    デフォルトでは、これらのフィールドはトリガーレコードの [アサイン先グループ] および [アサイン先] フィールドにマップされます。これは、親レコードで作業するようにアサインされたユーザーは、収集されたデータを送信、表示、編集するアクセス権をデフォルトで持っていることを意味します。
    データコレクションのユーザーフォーム 選択肢 データの収集に使用される入力フォームのタイプ。プレイブック作成者は、プレイブックの実行中にエージェントまたは履行者に収集してもらいたいデータを sys_flow_data_definition テーブルで定義します。情報が収集されると、情報はレコードテーブルではなく、sys_flow_data テーブルに保存され、後でプレイブックの実行時に使用できるようになります。エージェントまたは履行者に収集してもらうデータを定義するには、「データ定義を作成する」を参照してください。
    ユーザー入力待ち 選択肢 エンドユーザーが手動でアクティビティを完了するかスキップするまで、プレイブックを一時停止するオプション。このフィールドを編集できるのは、playbook.admin ロールを持つユーザーのみです。デフォルトでは、アクティビティは完了する前にユーザーのアクションまたはデータを待機します。

    出力

    これらの出力は、プレイブック内の他のアクティビティにデータを提供できます。アクティビティを設定するときに、アクティビティ入力としてこのデータにアクセスできます。
    出力 タイプ 説明
    レコード Reference.Flow データ 収集されたデータを含むレコードへの参照。ピルピッカーを使用してドット連結し、 出力 > レコード > 変数 収集されたすべてのデータを表示します。ピルピッカーの詳細については、「Dot-walking examples」を参照してください。

    UI レイアウト

    プレイブックの実行中にアクティビティがどのようにレンダリングされるかを指定するプロパティを設定します。