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

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

天気 – 現在のカード。

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

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

Connector BuilderでAPIコネクタを構築する方法に関する2つのチュートリアルを作成しました。

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

API Connector の出力フィールドを設定します

このブログ記事では、OpenWeather API コネクターを使用します。

次のフローは、都市の現在の天気情報を返す [**Weather – Current**] カードです。

Weather – Currentカードのフロー。

フローの最後にズームすると、フローが生のレスポンス（bodyフィールド）を出力に渡していることがわかります。

天気 – 現在のフロー出力。

フローでカードを使用すると、同じ生のレスポンスが得られます。

Weather – Currentカードの生データ出力。

未加工のレスポンスを返すことは、カスタムAPIアクションカードに適しています。特定のAPIエンドポイントのカードを作成する場合、APIエンドポイントのJSONレスポンスフィールドに従ってカードの出力を定義できます。

カードの出力は、生のレスポンスを返す代わりに、このようになります。

天気 – 定義された出力を持つ現在のカード。

フローをコピーする

元のフローとアクションをそのままにしておきたい場合は、Currentフローを複製してください。

カードの出力フィールドを設定します

1. フローを開きます。
2. Return Outputs カードで、 Editsをクリックします。
3. 現在の出力フィールドを削除します。
4. グループ名 に Weather と入力します。
5. APIエンドポイントのJSONレスポンスフィールドに対応する出力を定義します。

Current weather エンドポイントには、次の JSON 形式の API 応答フィールドがあります。

JSON 形式の API レスポンスフィールド (ソース)。

JSONの例も確認するには、Okta WorkflowsまたはOpenWeatherのJSON形式APIレスポンスの例で生のレスポンスを使用してください。

JSON レスポンス。

上部にあるcoordオブジェクトには、2つのキーがあります。

{
  "coord": {
    "lon": 12.4839,
    "lat": 41.8947
  },
  "weather": [
    {
      "id": 802,
      "main": "Clouds",
      "description": "scattered clouds",
      "icon": "03n"
    }
  ]
  ...
}

同じ出力をを作成するには、 Object 型の coord キーと lon および lat プロパティ ( Number 型) を作成します。カードのプレビューが右側に表示されます。

カードの出力を設定します。

次に、オブジェクトの配列であるweatherオブジェクトを定義します（weatherは、雨+霧のように複数のオブジェクトになる可能性があります）。

カードの出力を設定します。

JSONレスポンス全体が含まれるまで、出力フィールドの定義を続行します。

接続アクションの出力フィールド。

カードのプレビューが右側に表示されます。

4. Applyをクリックして出力を保存し、フローに戻ります。

生のレスポンスから出力フィールドにデータを接続する

このセクションでは、未加工のレスポンスからデータを接続し、出力フィールドを設定する方法について説明します。

1. Call FlowカードとReturn Outputsカードの間に、Object – Get Multipleカードを追加します。
2. Get Multipleカードを使用して、生のレスポンスからデータを抽出し、出力フィールドに接続します。

出力フィールドの設定。

3. すべての出力フィールドの接続を完了します。

変更をデプロイ

すべての変更を保存し、[Deployment]ページから新しいコネクタバージョンを展開します。

新しいカードを使用する

フローで新しいWeather – Currentカードを使用します。カードに、他のカードに直接接続できる新しい出力フィールドが追加されました。

新しい出力を含む Weather – Current カード。

リソース

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

📖 Okta Workflows Connector Builder のドキュメント。

🍫 毎週のコミュニティオフィスアワー中にWorkflowsスペシャリストから支援を受けてください。

📺 Workflowsビデオから学びましょう。

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

🙋🏻‍♀️ コミュニティからサポートを得る：MacAdmins Slackの#okta-workflows channelに参加してください。