API タスクを作成

オートメーション・エニウェア Control Room でサポートされているさまざまなパッケージで API タスク を作成できます。

前提条件

Bot Creator ライセンスが必要です。
このトピックでは、米国内の郵便番号を入力とし、場所と州の名前を出力として返すサンプル API を使用して API タスクを作成する方法について説明します。事例に特化したアクションで API タスク を作成することができます。

手順

  1. Bot Creator として、Automation Anywhere Control Room のインスタンスにログインします。
  2. 新規 API タスクを作成します。
    1. 左側のペインで [オートメーション] をクリックします。
    2. [新規作成] > [API タスク] をクリックします。
    3. [API タスクを作成] ウィンドウで、API タスク 名を入力します。
    4. 次のデフォルトのフォルダーの場所をそのまま使用します。\Bots\.
      API タスク の保管場所を変更するには、[選択] をクリックしてプロンプトに従います。
    5. [作成と編集] をクリックします。
  3. ZIP code URL で使用される入力として ZipCode 変数を作成します。
  4. [GET メソッド] アクションを使用して、郵便番号の場所と州を取得します。
    注: 最も一般的なエンタープライズ アプリケーションのビルド済みパッケージが利用可能です。サポートされているパッケージのリストについては、「API タスクのよくある質問 (.30 コンテンツ)」を参照してください。
    1. [REST Web サービス] > [GET メソッド] アクションをダブルクリックまたはドラッグします。
      REST Web サービス - GET メソッド
    2. 以下の URI を入力します。$ZipCode$ の URI は、 ステップ 3 で作成した入力変数です。 
      https://api.zippopotam.us/us/$ZipCode$
      注:

      1 つの API タスク内で複数の API を呼び出すことができます。これにより、オートメーションを簡素化し、複数の個別タスクの必要性を減らすことができます。たとえば、同じ API タスク内で API 1 を呼び出して商品データを取得し、API 2 を呼び出して価格データを取得し、次に API 3 を呼び出して見積書を作成できます。

    3. このエンドポイントでは認証が必要ないため、[認証モード] ドロップダウン リストで [認証なし] を選択します。
      注: 通常、エンドポイントでは、許可されたアプリケーションのみがデータにアクセスできるようにするための認証が必要です。アクセスしたいエンドポイントへのアクセスを許可するために、適切な認証メカニズムを選択します。
    4. [変数に出力を代入] フィールドに変数 pDictZipCodeApiResponse を作成します。変数作成の詳細については、「変数の作成」を参照してください。
      注:
      • このディクショナリ変数に割り当てられた API の JSON レスポンス全体: pDictZipCodeApiResponse。
      • 変数型、ファイル、ウィンドウ、フォームは、API タスクではサポートされません。
  5. [アクション] ペインで、[JSON] > [セッションの開始] アクションをドラッグし、[REST Web サービス] アクションの下のキャンバスにドロップします。
    1. [情報源] フィールドで、[テキスト] を選択し、「$pDictZipCodeApiResponse{Body}$」と入力します。
    2. [JSON オブジェクト セッション] フィールドで、[ローカル セッション] を選択し、「Default」と入力します。

      API タスク ディクショナリ
      これで、Body 全体を使用できるようになりました。次のタスクでは、本体から必須フィールドを抽出します。以下に、JSON Body のサンプルを示します。
      {
    "post code": "90210",
    "country": "United States",
    "country abbreviation": "US",
    "places": [
        {
            "place name": "Beverly Hills",
            "longitude": "-118.4065",
            "state": "California",
            "state abbreviation": "CA",
            "latitude": "34.0901"
        }
    ]
}
  6. JSON から place name を抽出します。
    1. [アクション] ペインで、[Json] > [ノード値を取得] アクションをドラッグし、[Json] > [セッションの開始] アクションの下のキャンバスにドロップします。
    2. 抽出するノードを指定します。たとえば、場所を抽出するには places[0].["place name"] を使用できます。
    3. 変数「Place」を作成し、この変数に出力を代入します。
  7. JSON から state を抽出します。
    1. [アクション] ペインで、[Json] > [ノード値を取得] アクションをドラッグし、[Json] > [セッションの開始] アクションの下のキャンバスにドロップします。
    2. 抽出するノードを指定します。たとえば、場所を抽出するには places[0].["state"] を使用できます。
    3. 変数「State」を作成し、この変数に出力を代入します。
  8. [保存] をクリックします。
    API タスク をテストするには、[デバッガー] をクリックします。デバッグ中は、ローカル デバイスを使用して、API タスク を実行します。このサンプルで作成した API タスク は、郵便番号入力に対応する場所と州を取得します。