でカスタムアクティビティをプレイブックで利用できるようにする クリエータースタジオ

  • リリースバージョン: Yokohama
  • 更新日 2025年01月30日
  • 所要時間：4分

    • カスタムアクティビティは、ユーザーがアプリをビルドするときにプレイブックに追加する前に、 クリエータースタジオ アクティビティテーブル [sn_creatorstudio_activity] に追加する必要があります。

    このタスクについて

    複雑なワークフローや会社固有のワークフロー用にカスタムアクティビティを作成できます。例：
    • 標準の [承認要求] アクティビティには [要求者のマネージャー ] オプションがありますが、代わりに 部門マネージャー が必要な場合があります。
    • クリエータースタジオ自動化で簡単にビルドできるよりも複雑な意思決定ロジックを含む承認またはフローが必要になる場合があります。ワークフロースタジオを使用してそのフローをビルドし、それを呼び出すカスタムアクションを作成することができます。
    • 標準のメール通知アクティビティよりも多くの通知タイプが必要な場合があります。MS Teams 統合に通知を送信するフローを作成し、そのフローを呼び出すアクティビティを作成できます。

    始める前に

    カスタムアクティビティを クリエータースタジオ で利用できるようにするには、次のステップを完了する必要があります。
    1. フロー、サブフロー、またはアクションを作成する:アドミンまたは適切なロールを持つユーザーが、最初にフロー、サブフロー、またはアクションを ワークフロースタジオで作成する必要があります。詳細については、「General guidelines for Workflow Studio flows, subflows, and actions」を参照してください。
    2. アクティビティを定義する:次に、アドミニストレーターはアクティビティを [アクティビティ定義] テーブルに追加し、フロー/サブフロー/アクションをプレイブックアクティビティに割り当てることによってアクティビティを定義します。このステップは、 クリエータースタジオ プレイブックのアクティビティ設定でフィールドとして利用できる入力をアドミンが指定する場合でもあります。詳細については、「Activity definitions」と「Create an activity definition」を参照してください。
      注:
      必要なアクティビティのアクティビティ定義が既に存在する場合は、この手順をスキップできます。

    必要なロール：admin または app_engine_admin

    手順

    1. 次のように移動する。 All (すべて) > App Engine > 要求アプリアドミニストレーション > クリエータースタジオ アクティビティ.
      カスタムアクティビティだけでなく、すべての標準 クリエータースタジオ アクティビティがリストに表示されます。
      [ クリエータースタジオ アクティビティ] テーブルが表示されます。
      図 : 1. クリエータースタジオ アクティビティテーブル
      クリエータースタジオプレイブックに定義されているすべてのアクティビティを示すテーブル
    2. 新しいアクティビティの基礎を作成します。
      1. [New (新規)] ボタンをクリックします。
      2. レコードのフィールドに入力します。
        フィールド 説明
        アクティビティ カスタムアクティビティの基礎となるアクティビティのタイプを検索して選択します。

        たとえば、[ マルチレベル承認を要求] を選択して複雑な承認アクティビティを作成します。

        注:
        アクティビティを選択したら、情報アイコン () を選択して、そのアクティビティ定義レコードをプレビューできます。
        順序 アクティビティが クリエータースタジオ アクティビティピッカーリストに表示される順番。

        たとえば、順序番号が 400 のアクティビティは、順序番号が 500 のアクティビティの前に表示されます。
        簡単な説明 アクティビティピッカーに表示されるカスタムアクティビティの簡単な説明。
        利用可能なすべてのアクティビティのリストを表示するには、以下を追加できます。
        • すべての標準アクションについては、「 Workflow Studio actions 」を参照してください。
        • すべてのフローのリストについては、「 Workflow Studio flow logic 」を参照してください。
        • ワークフロースタジオで利用可能なすべてのサブフローのリストを表示します。
      3. アクティビティが クリエータースタジオ に表示されるように [アクティブ] オプションが選択されていることを確認します。
      4. [Submit (送信)] を選択します。
    3. プレイブックアクティビティのプロパティパネルに表示するフィールドを指定します。
      注:
      表示されるフィールドは、アクティビティを定義するプロセスで既に設定されている可能性があります。その場合は、次の手順に従って、使用可能なフィールドが正しいことを確認します。
      1. [クリエータースタジオアクティビティ] テーブルの [アクティビティ] 列から、新しく作成されたアクティビティの定義を開きます。
      2. [ 自動化プラン ] タブが選択されていることを確認します。
      3. [常に表示] を選択して、アクティビティのプロパティのフィールドをクリエータースタジオに表示するようにします。
        たとえば、[アサイン先] フィールドを クリエータースタジオ でプレイブックをビルドするユーザーに常に表示に設定します。
        図 : 2. アクティビティの入力
        フィールドを表示するには、[常に表示] を選択します

        詳細については、「Add dynamic inputs to an activity」を参照してください。

      4. オプション: プロパティを [アドミンのみの追加プロパティとして表示] に設定して、フィールドを非表示にします。
      5. プロパティパネルに表示するすべてのフィールドについて、これらの手順を繰り返します。
      6. レコードを保存します
    4. [ クリエータースタジオ アクティビティ] テーブルに戻ります。
    5. [簡単な説明] フィールドを選択して、クリエータースタジオアクティビティレコードを確認します。
    6. [アクティブ] オプションが選択されており、他のすべてが正しいことを確認します。
    7. オプション: [ 更新 ] ボタンを選択して追加の変更を加えた場合は、レコードを保存します。

    タスクの結果

    新しいアクティビティが クリエータースタジオ のアクティビティピッカーに表示されます。

    図 : 3. 新しいアクティビティがアクティビティピッカーに表示されます
    追加したアクティビティは、アクティビティピッカーの最後に表示されます