ヘルパーフローを使ったレコードのストリーミング一致

ストリーミング機能を使って検索またはリストカードからのデータをヘルパーフローに渡すには、次のステップを実行します。

  1. アクションカード（OktaコネクターのList Users with Filterアクションカードなど）のレコードのストリーミング一致（Stream Matching Records）を選択します。

  2. 必要なすべての入力フィールドを選択したら、保存（Save）をクリックします。

  3. フローを選択（Choose Flow）をクリックしてSelect flowダイアログを開きます。フォルダーから既存のヘルパーフローを選択するか、新規フロー（New Flow）をクリックしてヘルパーフローを作成します。

  4. 新しいヘルパーフローを作成した場合は、イベントを追加（Add event）をクリックしてヘルパーフロー（Helper Flow）を選択します。

  5. ヘルパーフローにRecordとStateの2つの入力エントリを作成します。両方のフィールドのタイプをオブジェクト（Object）に設定します。

    • Recordオブジェクトには、ヘルパーフローに送信されている現在のアイテムが含まれます。オブジェクトに含まれるすべてのプロパティにアクセスできます。

    • Stateオブジェクトには、親フローからヘルパーフローに送信させるすべての追加の入力が含まれます。

ストリーミングしたレコードの例

このシンプルな例では、Oktaフィルターによるユーザーの一覧表示（Okta List Users with Filter）カードがユーザーを検索し、そのレコードをヘルパーフローにストリーミングします。ヘルパーフローはユーザーのIDフィールドとEmailフィールドを抽出し、一人のマネージャーのメールアドレスをユーザーに割り当てます。

マネージャーからヘルパーフローへのメールを取得するには、Manager Emailというラベルのフィールドを親フローのストリーミング（Streaming）セクションに追加します。送信する値をフィールドに入力します。その上で、ヘルパーフロー内のStateセクションでそのManager Emailフィールドを参照します。

次の図は、この具体例のマッピングを示しています。ヘルパーフローカードには、RecordオブジェクトとStateオブジェクト、およびそれに続くAssignカードへのマッピングが表示されます。

Streaming example - parent and helper flows showing the record and state fields.

Oktaユーザーレコードからのストリーミングデータは、次の構造でヘルパーフローに渡されます。

{
    "Record": {
        "ID": "00u2unwcxjXHiqTES0g7",
        "Last Name": "Hendrix",
        "Activated": null,
        "First Name": "James",
        "Email": "jimihendrix@example.com",
        "Created": "2021-09-27T22:23:55.000Z",
        "Second Email": null,
        "Raw Output": {
            "id": "00u2unwcxjXHiqTES0g7",
            "status": "ACTIVE",
            "created": "2021-09-27T22:23:55.000Z",
            "activated": null,
            "statusChanged": "2021-09-27T22:25:36.000Z",
            "lastLogin": "2023-11-14T17:51:00.000Z",
            "lastUpdated": "2021-09-27T22:25:36.000Z",
            "passwordChanged": "2021-09-27T22:25:36.000Z",
            "type": {
                "id": "00u2unwcxjXHiqTES0g7"
            }
        }
    },
    "State": {
        "Manager email": "jessiedoe@example.com"
    }

結果として、このユーザーのヘルパーフロー内のAssignカードには次のフィールドが含まれます。

  • ID：00u2unwcxjXHiqTES0g7

  • メール（Email）：jimihendrix@example.com

  • マネージャー（Manager）：jessiedoe@example.com

関連項目

アクションカードによるデータのストリーミングについて

スケジュールされたフローとヘルパーフローについて