Okta WorkflowsコネクタービルダーでAPIコネクターの動的入力フィールドを設定する

このブログ記事では、Okta Workflows Connector Builder で API コネクタアクションに動的入力フィールドを設定する方法を説明します。カードは次のようになります:

動的な入力フィールドを持つアクションカード。

• API コネクタチュートリアルを作成します。
• APIコネクタの動的入力フィールドを設定します。
• リソース

APIコネクターのチュートリアルを作成する

これまでの2つのブログ記事では、静的な入力フィールドを持つコネクタを作成する方法を学びました:

• Okta Workflowsチュートリアル：OpenWeather APIのコネクターを構築する
• Okta Workflowsチュートリアル：Spotify APIのコネクターを構築する（OAuth 2.0を使用）

出力フィールドの設定方法も学びました：

• Okta WorkflowsコネクタービルダーでAPIコネクターの出力フィールドを設定する

API コネクタの動的入力フィールドの設定

アクションの動的入力フィールドを使用すると、別のフィールドの選択に基づいて入力値をロードできます。

動的な入力フィールドは、次の 2 つの方法で設定できます。

• オプションフィールドは別のオプションフィールドを制御します。
• オプションフィールドは入力フィールドを制御します。

オプションフィールドは別のオプションフィールドを制御します

コネクターアクションで [ Edit] (編集) をクリックして、アクションオプションの設定を開始します。

コネクターアクションのオプション

アクションには3つのオプション入力フィールドがあります:

• 部署。
• 部署。
• 地域。

3つのフィールドすべてで、フィールドタイプがドロップダウンに設定されています。

3つのオプションフィールドを持つアクション

[Division] フィールドを展開 (右側の [下矢印] をクリック) して、詳細を表示します。[Division] は、2 つのオプション ([Hardware] と [Software]) を持つ静的フィールドです。

Division optionsフィールド。

次に、[Department] オプションフィールドを展開します。[Department] フィールドの値は、ヘルパーフローから取得されます。

1. Departmentドロップダウンは、Department Listヘルパーフローから値を取得します。
2. 部署ドロップダウンは部門ドロップダウンの値に依存するため、部門の値はヘルパーフローにマッピングされ、JSON形式のリストを返します。
3. プレビュー出力は、ヘルパーフローのJSON出力を表示します。

[部署]オプションフィールドは、ヘルパーフローを使用してその値を取得します。

ハードウェア部門を選択すると、ヘルパーフローは次の3つの部門を含むJSONをロードします。

[
 {
   "value":"Systems",
   "key":"Systems"
 },
 {
   "value":"Embedded",
   "key":"Embedded"
 },
 {
   "value":"Supply Chain",
   "key":"Supply Chain"
 }
]

リストは次のようになります:

ハードウェア部門リスト

Software区分を選択すると、ヘルパーフローは3つの異なる区分を持つ次のJSONをロードします:

[
 {
   "value":"Engineering",
   "key":"Engineering"
 },
 {
   "value":"Quality Assurance",
   "key":"Quality Assurance"
 },
 {
   "value":"IT",
   "key":"IT"
 }
]

リストは次のようになります:

Software department list.

[ Department List] (部署リスト) ヘルパーフローは次のようになります。

Department List ヘルパーフロー。

Helper Input == ‘Hardware’ の if 条件は、ハードウェアリスト JSON を返します:

Hardware If リスト。

Softwareの値を返すと、ソフトウェアリストが返されます。

このセクションでは、アクションオプションで動的入力フィールドを作成する方法を説明しました。

• Hardware を選択すると、Department リストはヘルパーフローから Hardware 部門の値を取得します。
• Software を選択すると、Department リストはヘルパーフローから Software 部門の値を取得します。

次のセクションでは、[オプション]で値を選択し、[入力]にリストをロードする方法を学びます。

オプションフィールドは入力フィールドを制御する

このオプションも同様に機能します。[オプション]でリスト値を選択すると、その値に基づいて[入力]セクションにリストがロードされます。

地域を選択します (DE - ドイツの場合):

地域の設定

Peopleリストは、DEリージョンの名前をロードします。

People リスト。

設定は、前のセクションで見たものと似ています。

Optionsには、静的なRegionリスト（国リスト）があります。

地域リスト

地域フィールドからの選択は、その地域からの担当者をロードするために、ヘルパー（従業員リスト）フローへの入力として使用されます。

People リスト。

前のセクションでは、ヘルパーフローはif-elseロジックを使用して動的リストを作成しました。この例では、ヘルパーフローはAPIを呼び出してリストを取得します。

ヘルパーフローは次のようになります:

地域から人々を取得するフロー。

ヘルパーフローには、次のステップがあります。

• Helper FlowカードにはRegion inputがあります。
• ComposeはURLを設定します。この例では、Random User APIを使用しています。
• **Raw Request**カードは、APIを呼び出します。
• Getカードは、担当者リストを保持するresultsオブジェクトを取得します。
• ヘルパーフローは、リスト値を表すJSONオブジェクトを返す必要があります。Mapカードはリストを取得し、以下のJSONリストを返します。
• [Return] カードはリストを返します。

ドロップダウンリストを作成するためのJSON：

[
  {
    "value": "Sekleta Lesko",
    "key": "Sekleta Lesko"
  },
  {
    "value": "Sacha Thomas",
    "key": "Sacha Thomas"
  },
  {
    "value": "Jamie Price",
    "key": "Jamie Price"
  },
  {
    "value": "Terra Hamilton",
    "key": "Terra Hamilton"
  },
  {
    "value": "Gerald Küsters",
    "key": "Gerald Küsters"
  }
]

Mapカードは、次のフローを呼び出して、JSON形式でリスト値を設定します:

JSON形式でリスト値を設定します。

このセクションでは、アクション[ Inputs] (入力) で動的な入力フィールドを作成する方法を説明しました。

• OptionsでRegionを選択します。Inputsでは、選択したリージョンに基づいて、入力フィールドに名前がロードされます。

最後のカードは次のようになります:

動的な入力フィールドを持つアクションカード。

コネクターを使用する自動化ビルダーが選択を行った後、他のフローカードでフィールドを使用できます。

他のフローカードのフィールドを使用する。

リソース

📚 Okta Workflowsでカスタムコネクターを構築する、ビデオシリーズ

📖 Okta Workflows Connector Builder documentation.

🍫 毎週のコミュニティオフィスアワーでWorkflowsのスペシャリストからヘルプを得る

📺 Workflowsビデオから学ぶ

🛟 サポートからのヘルプ：Workflowsのトピックについて話し合う、または質問する。

🙋🏻‍♀️ コミュニティから支援を得るには、MacAdmins Slackの#okta-workflows channelに参加してください。