この演習では、IP アドレスを入力として渡すように [IP から地理データを取得] アクションを更新して、アクションをテストします。

IP アクション入力の作成

1. 前の演習でまだ開いていない場合は、編集する [IP から地理データを取得] アクションを開きます。

   a. Application Navigator を使用して [システムアプリケーション] > [Studio] を開きます。

   b. [IPInfoSpoke] をクリックして、編集するアプリケーションを開きます。

   c. アプリケーションエクスプローラーを使用して、[Flow Designer] > [アクション] > [IP から地理データを取得] を開きます。

2. [アクションアウトライン] で、[入力] アイテムをクリックします。

3. [入力の作成] ボタンをクリックします。

4. [詳細入力を切り替え] アイコンを () クリックします。

5. アクション入力を構成します。

   ラベル： IP アドレス (IP address)
   名前： (この値は自動的に入力されます)
   タイプ： IP アドレス
   必須： 選択済み
   ヒント： このパブリック IP アドレスの物理的な場所を検索します

6. [保存] ボタンをクリックします。

アクション入力を使用するようにリソースパスを更新

1. [アクションアウトライン] で REST ステップをクリックします。

2. ハードコードされた IP アドレスを IP アドレスのアクション入力変数に置き換えます。

   1. [リソースパス] フィールドで「8.8.8.8」を削除します。
   2. データパネルの [入力変数] セクションから、[IP アドレス] データピルを [リソースパス] フィールドにドラッグします。[IP アドレス] データピルは /json の前に置く必要があります。
      

3. [保存] ボタンをクリックします。

フローのテストと REST 応答の確認

1. テストに使用する現在の IP アドレスを取得します。
   1. IP Chicken のウェブサイトを開きます。
   2. 現在の IP アドレスをコピーします。
2. アクションをテストします。
   1. [テスト] ボタンをクリックします。
   2. <コピーした IP アドレス> を [IP アドレス] フィールドに貼り付けます。
   3. [テスト実行] ボタンをクリックします。
   4. [アクションのテスト] ダイアログで、[テストの実行が終了しました。アクション実行の詳細を表示します。] というリンクをクリックします。
   5. ステップの詳細を確認して、REST ステップがステータスコード 200 を返し、応答本文が JSON データを返すことを確認します。
3. [実行の詳細] タブを閉じます。
4. [アクションのテスト] ダイアログを閉じます。

REST API 呼び出しは、応答本文にデータを返します。応答本文データは通常、JSON または XML 形式で構造化されます。スクリプトステップを使用すると、構造化されたデータを変数に解析し、アクションまたはフローの他の場所で使用できます。

応答から抽出されたデータを取得する一般的な方法は次のとおりです。

• 応答本文を確認し、返すデータを選択します。
• スクリプトステップで入力変数と出力変数を作成します。
  • REST ステップから 応答本文 を渡す入力変数を作成します。
  • 応答からデータを返す出力変数を作成します。
• データを解析およびマッピングするスクリプトの作成
  • [スクリプト] ステップで JSON.parse() メソッドを使用して、JSON 応答本文を解析します。
  • 解析されたデータを出力変数にマッピングします。
• 出力変数のアクション出力を作成して、データをフローで使用できるようにします。

注意：IntegrationHub 標準パックには、XML 形式の応答本文を解析するために使用できる XML パーサーステップが含まれています。

応答本文の確認

LEGO のセットの詳細を取得する Rebrickable リソースは、応答本文に JSON を返します。応答本文のキーと値のペアは JSON 構造の最上位にあります。

{ "set_num":"10247-1", "name":"Ferris Wheel", "year":2015, "theme_id":22, "num_parts":2463, "set_img_url":"https://m.rebrickable.com/media/sets/10247-1.jpg", "set_url":"https://rebrickable.com/sets/10247-1/ferris-wheel/", "last_modified_dt":"2016-05-29T00:25:32.286418Z" }

入力変数と出力変数の作成

[スクリプト] ステップの入力変数を作成して、応答本文をスクリプトで使用できるようにします。

応答本文から各キーの出力変数を作成します。

データを解析およびマップするスクリプトの作成

JSON.parse() メソッドを使用して JSON 応答を解析します。キーを応答本文から出力変数にマップします。

(function execute(inputs, outputs) { var responseObject = JSON.parse(inputs.response_body); outputs.set_name = responseObject.name; outputs.release_year = responseObject.year; outputs.parts = responseObject.num_parts; })(inputs, outputs);

REST ステップからの応答が有効であったことを確認するには、ステータスコードの入力変数を追加します。ステータスコード 200 をチェックする if ステートメントに解析ロジックをラップします。

アクション出力の作成

スクリプト出力変数ごとにアクション出力変数を作成し、REST API から返されたデータをフローで使用します。アクション出力変数には、分かりやすいラベルを使用してください。

[編集モードを終了] ボタンをクリックして、アクション出力に値を割り当てます。

開発者向けのヒント：アクション入力変数用のアクション出力変数を作成すると、その入力値をフローで使用できます。

このモジュールでは、REST API を操作してパブリック IP アドレスから地理データを取得するアクションを作成しました。次に、IP アドレスをアクションに動的に渡すようにアクションを更新しました。この演習では、[IP から地理データを取得] アクションを更新して、IPInfo REST API によって返される JSON 文字列から、ホスト名、市区町村、地域、国、経度と緯度の座標を取得します。

応答本文を解析するスクリプトステップの作成

1. 前の演習でまだ開いていない場合は、編集する [IP から地理データを取得] アクションを開きます。

   a. Application Navigator を使用して [システムアプリケーション] > [Studio] を開きます。

   b. [IPInfoSpoke] をクリックして、編集するアプリケーションを開きます。

   c. アプリケーションエクスプローラーを使用して、[Flow Designer] > [アクション] > [IP から地理データを取得] を開きます。

2. [ステップ] パネルの REST ステップの後、[新しいステップを追加] ボタン () をクリックします。
   

   

3. [アクションに追加するステップを選択] ダイアログの [ユーティリティ] セクションで [スクリプト] ステップを選択します。

4. ステップの名前を「返されたデータの解析」に変更します。

5. response_body 入力変数を追加します。

   1. [スクリプト] ステップの [入力変数] セクションで、[変数の作成] リンクをクリックします。
   2. 変数を設定します。
      名前： response_body
      値： [IPInfo REST API の呼び出し] ステップから応答本文データピルをドラッグします

6. status_code 入力変数を追加します。

   1. [入力変数] セクションで、[変数の作成] リンクをクリックします。
   2. 変数を設定します。
      名前： status_code
      値： (ステップ ▸ IPInfo REST API の呼び出し ▸ ステータスコード)

7. hostname 出力変数を追加します。

   1. [出力変数] セクションで、[変数の作成] リンクをクリックします。
   2. 変数を設定します。
      ラベル： ホスト名 (hostname)
      名前： (この値は自動的に入力されます)
      タイプ： 文字列

8. 追加の文字列出力変数を作成します。

   city
   region
   country
   latitude
   longitude
   

9. [スクリプト] フィールドの内容を次のスクリプトに置き換えます。

   (function execute(inputs, outputs) { // Only parse the response body if the status code is 200 if (inputs.status_code == '200'){ // Parse the response_body input variable and save parsed object as responseBody var responseBody = JSON.parse(inputs.response_body); // Map the parsed responseBody values to output variables outputs.hostname = responseBody.hostname; outputs.city = responseBody.city; outputs.region = responseBody.region; outputs.country = responseBody.country; // split the returned location into separate latitude and longitude values var locArray = responseBody.loc.split(","); outputs.latitude = locArray[0]; outputs.longitude = locArray[1]; } })(inputs, outputs);

10. スクリプトの内容を確認して、スクリプトの動作を確認します。

    質問：REST API は、個々の緯度と経度の値を返しません。これらの値はどのように決定されますか？
    
    回答：REST API は、緯度と経度を場所の値と結合して返します。このスクリプトは、場所の値をカンマでアレイに分割し、緯度と経度を別々の変数に書き込みます。開発者は、出力値を設定する前に、スクリプトステップを使用して応答データを操作できます。
    

11. [保存] ボタンをクリックします。

アクションの出力の追加

1. [アクションアウトライン] で、[出力] アイテムをクリックします。

2. アクションへの IP アドレス入力用のアクション出力を作成します。

   1. [出力を作成] リンクをクリックします。
   2. 次のようにアクション出力を構成します。
      ラベル： IP アドレス (IP address)
      名前： ip_address
      タイプ： IP アドレス

3. REST 応答から解析されたホスト名のアクション出力を作成します。

   1. [出力の作成] ボタンをクリックします。
   2. 次のようにアクション出力を構成します。
      ラベル： ホスト名 (Hostname)
      名前： hostname
      タイプ： 文字列

4. [返されたデータの解析] ステップから残りのデータピルのアクション出力を作成します。各出力の [名前] の値は [ラベル] と同じですが、小文字にする必要があります。各出力の [タイプ] を [文字列]に設定します。

   city
   region
   country
   latitude
   longitude
   

5. [編集モードを終了] ボタンをクリックします。

6. 各アクション出力に値を割り当てます。

   1. [IP アドレス (IP address)] データピルを、データパネルの [入力変数] セクションから [IP アドレス] アクション出力の [値] にドラッグします。
   2. [ホスト名 (hostname)] データピルを、データパネルの [返されたデータの解析] ステップから [ホスト名] アクション出力の [値] にドラッグします。
   3. 残りのデータピルを、データパネルの [返されたデータの解析] ステップから対応するアクション出力の [値] にドラッグします。
      
      

7. [保存] ボタンをクリックします。

アクションのテストと解析済みデータの表示

1. テストに使用する現在の IP アドレスを取得します。

   a.IP Chicken のウェブサイトを開きます。

   b. 現在の IP アドレスをコピーします。

2. アクションをテストします。

   a.[テスト] ボタンをクリックします。

   b. [アクションのテスト (Test Action)] ダイアログに現在の IP アドレスを貼り付けます。

   c.[テスト実行] ボタンをクリックします。

   [テストの実行が終了しました。アクション実行の詳細を表示します。] というリンクをクリックします。

3. [IP から地理データを取得] アクションの [出力データ] を表示します。すべてのアクション出力にランタイム値があることを確認します。
   

   

   注意：すべての IP アドレスが各変数の値を返すわけではありません。必要に応じて、REST ステップで戻り値を応答本文と比較できます。

4. [実行の詳細] タブを閉じます。

5. [アクションのテスト] ダイアログを閉じます。

サードパーティプラットフォームにアクセスするには、REST API にアクセスするためのエンドポイントなどの接続の詳細が必要です。以前このモジュールで使用したインライン接続は、直接 REST ステップで接続を作成しました。接続および資格情報エイリアスと接続を使用すると、接続を 1 回だけ定義した後、任意のカスタムアクションでその接続を使用できます。

接続および資格情報エイリアスは接続に対するポインターです。接続は、サードパーティプラットフォームに接続するための URL またはホスト名を定義します。

接続および資格情報エイリアスと接続を使用すると、次の処理を実行できます。

• 接続の詳細を、その接続にアクセスする必要があるすべてのアクションに対して 1 回だけ構成する。すべてのアクションを再構成することなく、接続の詳細を更新できます。
• 複数の接続ホストを一元管理する。

すべてのアクションに対して接続を 1 回だけ構成

開発者は、データ連携アクションで接続および資格情報エイリアスを使用して、データ連携によって実行される処理から接続構成を分離しておくことができます。データ連携アクションは、データ連携の接続および資格情報エイリアスにアクセスします。すべてのアクションに対して接続を 1 回だけ構成します。

たとえば、Microsoft AD Spoke のアクションは、AD の接続および資格情報エイリアスをポイントするように構成されています。Active Directory フローを構築する開発者とプロセスオーナーは、Active Directory ドメインコントローラー接続を 1 度だけ構成します。接続の詳細が変更された場合、開発者は Active Directory に接続するすべてのアクションではなく、接続レコードの接続構成を変更するだけで済みます。

接続および資格情報エイリアスをポイントするようにスポークで REST アクションを構成し、エンドポイントのベース URL を 1 回だけ構成します。アクションの REST ステップで REST API のリソースをポイントするようにリソースパスを構成します。たとえば、Rebrickable_Alias の接続および資格情報エイリアスを作成します。接続および資格情報エイリアスをポイントする REST リソースのアクションを作成します。接続レコードで接続 URL を構成します。

開発者向けのヒント：すべてのリソースに共通するドメインとエンドポイントの要素を使用して、接続レコードの接続 URL を構成します。たとえば、REST API のすべての Rebrickable リソースは /api/v3 で始まります。接続 URL は https://rebrickable.com/api/v3 です。

複数の接続ホストの管理

接続および資格情報エイリアスには複数の関連する接続レコードを含めることができ、これによって開発者はホストを簡単に切り替えることができます。

たとえば、AD の接続および資格情報エイリアスには、本番および非本番の Active Directory ドメインコントローラーに関連する接続レコードを含めることができます。開発者は、アクティブにする必要がある接続にアクティブフラグを設定することで、接続を切り替えることができます。

REST API の接続および資格情報エイリアスは、REST API に複数の URL でアクセスできる場合、複数の関連する接続を持つことができます。REST API が異なるバージョンをサポートしている場合は、API の異なるバージョンに対して複数の関連する接続を使用できます。たとえば、Rebrickable API にさまざまなバージョンの接続を構成できます。アクションの実行時には、アクティブな接続のみが使用されます。

connection_admin ロールまたは admin ロールを持つユーザーは、接続および資格情報エイリアスを作成して保存できます。

Studio で接続および資格情報エイリアスを作成するには：

1. [アプリケーションファイルを作成] リンクをクリックします。
2. [Flow Designer] カテゴリを選択します。
3. [接続および資格情報エイリアス] オプションを選択します。
4. [作成] ボタンをクリックします。
5. 接続および資格情報エイリアスプロパティの構成：
   
   

• 名前：接続および資格情報エイリアスの一意の名前。名前には、文字、数字、アンダースコアのみを使用できます。
• ID：接続および資格情報エイリアスに対して自動的に生成される識別子。ID は、スコープ名と接続および資格情報エイリアスの名前の組み合わせです。
• アプリケーション：接続および資格情報エイリアスのアプリケーションスコープ。
• タイプ：接続および資格情報エイリアスのタイプ。オプションは、[接続および資格情報] または [資格情報] です。
• 接続タイプ：接続のタイプ。オプションは、[基本]、[HTTP]、[JDBC]、[JMS] です。REST 接続は [HTTP] です。
• デフォルトの再試行ポリシー：ステップでネットワーク障害や要求レート制限などの問題が発生した場合の再試行要求の処理方法を指定します。

[送信] ボタンをクリックして、接続および資格情報エイリアスを保存します。[接続] 関連リストを使用して、接続および資格情報エイリアスに関連付けられた接続を作成します。

connection_admin ロールまたは admin ロールを持つユーザーは、接続を作成して保存できます。

接続および資格情報エイリアスレコードの [接続] 関連リストで [新規] ボタンをクリックします。接続を構成します。

• 名前：接続の一意の名前。
• 資格情報：接続に使用する認証の詳細。資格情報については、別途このモジュールで説明します。
• 接続エイリアス：接続を使用する接続および資格情報エイリアス。この値は、接続および資格情報エイリアスの [接続] 関連リストから接続が作成されるときに自動的に設定されます。
• 接続 URL：接続を使用するすべてのアクションに使用するベース URL。
• MID Server を使用：MID Server を使用して通信するオプション。

接続レコードは、アプリケーションファイルではなくデータとみなされます。開発者が内部コンピューターまたは REST API に接続の詳細を含めないようにするには、接続をアプリケーションに手動で追加する必要があります。接続は、パブリック REST API のアプリケーションにのみ追加する必要があります。

パブリック REST API の接続をアプリケーションに追加するには、[接続] 関連リストで [接続] チェックボックスをオンにします。次に、[選択した行のアクション...] メニューをクリックし、[アプリケーションファイルを作成] を選択します。

[レコードからアプリケーションファイルを作成] ダイアログで詳細を確認し、[OK] ボタンをクリックします。

Studio でアプリケーションのファイルを検証し、[ファイル] メニューをクリックして、[設定] メニューアイテムを選択します。[アプリケーションファイル] 関連リストで、[クラス] が [メタデータスナップショット] のアイテムを検索します。フィルター済みリストに、該当する接続が含まれているはずです。

接続および資格情報エイリアスを使用する REST アクションを作成するには、アクションを作成してから [REST] ステップを追加して構成します。[接続] に [接続エイリアスを使用] を選択し、[接続エイリアス] を選択します。

[要求の詳細] セクションの [リソースパス]、[HTTP メソッド]、[クエリパラメーター] を構成します。

この演習では、IPInfo REST API の接続および資格情報エイリアスと接続を作成します。続けて、[IP から地理データを取得] アクションを更新して、接続および資格情報エイリアスを使用し、更新されたアクションをテストします。

接続および資格情報エイリアスの作成

1. 前の演習で IPInfoSpoke アプリケーションを Studio で開いていない場合は、 ここで開きます。

   a. Application Navigator を使用して [システムアプリケーション] > [Studio] を開きます。

   b. [IPInfoSpoke] をクリックして、編集するアプリケーションを開きます。

2. 接続および資格情報エイリアスを作成します。

   1. Studio で [アプリケーションファイルを作成] リンクをクリックします。
   2. [フィルター...] フィールドに「接続」というテキストを入力するか、左ペインのカテゴリから [Flow Designer] を選択します。
   3. 中央ペインからファイルタイプとして [接続および資格情報エイリアス] を選択し、[作成] ボタンをクリックします。

3. 接続および資格情報エイリアスの構成

   名前： IPInfo エイリアス
   接続タイプ： HTTP

4. [送信] ボタンをクリックして、接続および資格情報エイリアスを保存します。

接続の作成

1. [接続] 関連リストまでスクロールし、[新規] ボタンをクリックします。

   質問：接続は HTTP(s) 接続です。接続のタイプはどこで選択されていますか？
   
   回答：接続のタイプは接続および資格情報エイリアスレコードで選択されます。新しい接続は、接続および資格情報エイリアスの接続タイプに設定されます。
   

2. HTTP(s) 接続を構成します。

   名前： IPInfo
   接続 URL： https://ipinfo.io

3. [送信] ボタンをクリックします。

[IP から地理データを取得 (Get Geographic Data from IP)] アクションの更新

1. アプリケーションエクスプローラーを使用して、[Flow Designer] > [アクション] > [IP から地理データを取得] を開きます。
2. [アクションアウトライン] で [IPInfo REST API の呼び出し] ステップをクリックします。
3. REST ステップを構成します。
   接続： 接続エイリアスを使用します。
   接続エイリアス： x_<your_company_code>_ipinfo_spoke.IPInfo_Alias (会社コードの長さによっては、アプリケーションスコープが異なる場合があります)
4. [保存] ボタンをクリックします。

更新アクションをテストする

1. テストに使用する現在の IP アドレスを取得します。

   a.IP Chicken のウェブサイトを開きます。

   b. 現在の IP アドレスをコピーします。

2. アクションをテストします。

   a.[IP から地理データを取得] アクションで、[テスト] ボタンをクリックします。

   b. [アクションのテスト (Test Action)] ダイアログに現在の IP アドレスを貼り付けます。

   c.[テスト実行] ボタンをクリックします。

   [テストの実行が終了しました。アクション実行の詳細を表示します。] というリンクをクリックします。

3. [IP から地理データを取得] アクションの [出力データ] を表示します。アクション出力のランタイム値が前の演習と同じであることを確認します。値が不足している場合は、データピルを確認してください。

4. [実行の詳細] タブを閉じます。

5. [アクションのテスト] ダイアログを閉じます。

一部の REST API は、REST API によって提供されるリソースにアクセスするために認証を必要とします。資格情報レコードは、REST API にアクセスするために使用される認証データです。ServiceNow は、暗号化されたフィールドに資格情報を保存します。資格情報を入力した後は、その資格情報を表示することはできません。REST API は、次の 3 つの資格情報タイプを使用します。

• API キー：呼び出し元アプリケーションまたはユーザーを識別するために REST API によって提供される一意のコード。
• 基本認証：REST API に対する認証に使用されるユーザー名とパスワードの組み合わせ。
• OAuth 2.0：認証プロバイダーはシークレットを提供し、その情報を使用してリソースへのアクセスを許可します。OAuth については、このトレーニングモジュールでは扱いません。

開発者向けのヒント：利用可能な認証方法については、REST API のドキュメントを参照してください。REST API で複数の認証方法が許可されている場合は、利用可能な方法の中で最も安全な方法を選択してください。

admin ロールを持つユーザーは、資格情報を作成して保存できます。

ServiceNow のメインウィンドウで資格情報を作成するには、Application Navigator を使用して、[接続および資格情報] > [資格情報] を開きます。[新規] ボタンをクリックします。作成する資格情報のタイプを選択します。

API キー資格情報

資格情報タイプのリストで [API キー資格情報] リンクをクリックします。資格情報の名前と API キーを構成します。

• 名前：資格情報の名前。API を明確に識別する説明的な名前を使用します。
• API キー：REST API によって提供されるアクセストークンまたは API キー。この値は、認証ヘッダーに渡す文書化された値と一致する必要があります。

Rebrickable は、API リソースにアクセスするための 2 つの認証方法を文書化しています。2 番目の Rebrickable 認証方法では、API キーをクエリパラメーターとして渡します。資格情報レコードに API キーを保存すると、API キーがクリアテキストで公開されなくなります。

最初の認証方法では「key」という単語の後に API キーを続けたものを Authorization ヘッダーに渡します。資格情報レコードの [API キー] フィールド値として使用する値は key b4e0697ce3d5cf21af1088e9bd238dd です。

開発者向けのヒント：[API キー] フィールドでは値がマスクされます。タイプミスを防ぐには、フィールドの外で完全なキーを作成してから、その値をフィールドに貼り付けます。

基本認証資格情報

資格情報タイプのリストで [基本認証資格情報] リンクをクリックします。資格情報の [名前]、[ユーザー名]、[パスワード] を構成します。

• 名前：資格情報の名前。API を明確に識別する説明的な名前を使用します。
• ユーザー名：REST API にアクセスするためのアカウントのユーザー名。
• パスワード：REST API にアクセスするためのアカウントのパスワード。

基本認証資格情報が使用されると、ServiceNow はユーザー名とパスワードからエンコード文字列を生成し、これが基本エンコード文字列として Authorization ヘッダーに渡されます。

資格情報を使用するには、接続レコードで資格情報を選択します。

connection_admin ロールまたは admin ロールを持つユーザーは、接続に資格情報を割り当てることができます。

ステップの実行の詳細に、REST エンドポイントへのアクセスに使用された資格情報と接続が示されています。

開発者は、GitHub のようなソースコントロールアプリケーションを使用して、個人開発者インスタンス (PDI) の外部で変更をコミット (完了した作業を保存) できます。アプリケーションに加えられた変更をコミットして、作業をソースコントロールに保存します。

この演習では、GitHub に新しい IPInfo Spoke リポジトリを作成し、IPInfo Spoke アプリケーションを新しいリポジトリに接続して、このモジュールで完了した作業内容を保存します。

IPInfo Spoke のリポジトリを作成

1. GitHub を開き、サインインします。

2. [リポジトリ] セクションで、[新規リポジトリ] ボタンをクリックします。
   

   

3. 新しいリポジトリを構成します。

   リポジトリ名： ipinfo-spoke
   説明： IntegrationHub モジュール IPInfo Spoke リポジトリの REST

4. [リポジトリを作成 (Create repository)] ボタンをクリックします。

IPInfo Spoke アプリケーションをソースコントロールにリンクする

演習のこのセクションでは、新しい IPInfo Spoke リポジトリを表示して、IPInfo Spoke アプリケーションを新しいリポジトリにリンクし、コミットされたファイルを含むリポジトリを表示します。

1. リポジトリページの [コード] タブを確認します。GitHub にはリポジトリをセットアップするための指示が含まれていることに注意してください。現在、リポジトリにファイルは存在しません。

2. [クイックセットアップ] セクションで、[URL のコピー] ボタンをクリックします。
   

   

3. GitHub 接続の資格情報レコードを作成します。

   重要：資格情報レコードを作成する必要があるのは 1 回だけです。別の演習で資格情報レコードを既に作成している場合は、この手順をスキップしてください。

   1. Application Navigator を使用して、[接続および資格情報] > [資格情報] を開きます。

   2. [新規] ボタンをクリックします。

   3. [作成する資格情報のタイプは？] リストで、[基本認証資格情報] リンクをクリックします。

   4. 資格情報レコードを設定します。

      1. 名前：GitHub 資格情報 (GitHub Credentials) - <お使いの github.com ユーザー名>

      2. ユーザー名：<お使いの github.com ユーザー名>

      3. パスワード：<お使いの github.com 個人アクセストークン>

         

   5. [送信] ボタンをクリックします。

4. IPInfo Spoke アプリケーションを、ipinfo-spoke リポジトリにリンクします。

   1. Studio で、IPInfo Spoke アプリケーションが現在のアプリケーションであることを確認します。IPInfo Spoke が、Studio フッターに表示されているアプリケーション名であるはずです。

      

   2. [ソースコントロール] メニューをクリックし、[ソースコントロールにリンク] メニューアイテムを選択します。

   3. [ソースコントロールへのリンク] ダイアログで、ソースコントロールへのリンクを構成します。

      1. URL：<ipinfo-spoke リポジトリの作成後にコピーした URL>

      2. 分岐：マスター (master)

      3. 資格情報：GitHub 資格情報 (GitHub Credentials) - <お使いの github.com ユーザー名>

      4. コミットコメント：初期 IPInfo Spoke コミット

         注意：前の演習で資格情報レコードを作成していない場合、資格情報レコードを作成する手順については、『GitHub Guide (GitHub ガイド)』の「ServiceNow が提供するアプリケーションリポジトリの使用 (Using ServiceNow-provided Application Repositories)」セクションを参照してください。

         

   4. [ソースコントロールへのリンク] ボタンをクリックします。

   5. [ソースコントロールへのリンク] ダイアログが成功を報告したら、[閉じる] ボタンをクリックします。

      

ここでは、IntegrationHub での REST Web サービスへのアクセスについての理解度を確認できます。自分の進行状況を評価するには、次の質問が役立ちます。質問ごとに回答を決定し、質問の任意の場所をクリックして回答を表示します。

質問：次のうち、IntegrationHub サブスクリプションレベルでないものはどれですか？

1. スターター
2. 基本
3. 標準
4. プロフェッショナル
5. エンタープライズ

回答：正解は 2. 基本です。

---

質問：次の機能とスポークのうち、IntegrationHub を使用しているものはどれですか？複数の回答が正解の場合があります。

1. Slack スポーク
2. Customer Service スポーク
3. PowerShell ステップ
4. Make a decision フローロジック
5. XML パーサー

回答：正解は 1. Slack スポーク、3. PowerShell ステップ 、5. XML パーサーです。Customer Service スポークには Customer Service Management のサブスクリプションが必要です。Make a decision フローロジックは Flow Designer に含まれています。

---

質問：正誤問題？インライン接続は、テスト用の REST ステップでのみ使用する必要があります。
回答：正解は正しいです。代わりに接続および資格情報エイリアスを使用する必要があります。これにより、アクションを使用するためにアクション自体を直接変更する必要がなくなります。

---

質問：REST ステップを動的にする方法を説明しているのは次のうちどれですか？複数の回答が正解の場合があります。

1. エンドポイントを構築するスクリプトを作成します。
2. HTTP メソッドを POST に設定すると、API に必要な値の入力を求められます。
3. 外部 API のドキュメントに記載されている変数情報については、リソースパスのデータピルを使用します。
4. 外部 API のドキュメントに記載されているクエリパラメーターについては、クエリパラメーターの値のデータピルを使用します。

回答：正解は 3 と 4 です。リソースパスの値とクエリパラメーターの値のデータピルを使用すると、REST ステップで使用するアクションに値を渡すことができます。

スクリプトはエンドポイントのコンポーネントを構築するために使用できますが、エンドポイント全体を構築するために使用することはできません。HTTP メソッドを POST に設定しても値の入力を求められず、API で動作しない可能性があります。

---

質問：REST ステップのテスト方法を説明する文は次のどれですか？複数の回答が正解の場合があります。

1. アクションの [テスト] ボタンをクリックし、入力値を入力して、[テストを実行] ボタンをクリックします。
2. アクションを公開し、action#singleQuotes トリガーの条件を満たします。
3. [ドラフトアクションの表示] に構成されたフローにアクションを追加し、フローの [テスト] ボタンをクリックします。
4. アクションを公開し、テストするフローにアクションを追加します。
5. ステップの [テスト] ボタンをクリックし、入力値を入力して、[テストを実行] ボタンをクリックします。

回答：正解は 1 と 3 です。アクションから直接テストするのが、アクションの動作を検証する最も簡単な方法です。アクションはフローでテストすることもできますが、未公開のアクションをフローに追加する前に、フローに [ドラフトアクションを表示] 構成を設定する必要があります。

アクションにはトリガーがありません。アクションは公開してフローで使用することも、テストする前にアクションを公開してはいけません。ステップには [テスト] ボタンがありません。

---

質問：REST API 呼び出しからの応答本文を解析する方法を説明しているのは次のうちどれですか？複数の回答が正解の場合があります。

1. XML パーサーステップを使用して、応答本文からデータを抽出します。
2. JSON パーサーステップを使用して、応答本文からデータを抽出します。
3. REST ステップで [応答を解析] オプションを使用して、応答の結果を出力変数に書き込みます。
4. 応答本文を解析し、結果を出力変数に書き込むスクリプトステップを作成します。
5. OpenAPI 仕様を使用して、応答本文から出力変数を生成します。

回答：正解は 1 と 4 です。XML パーサーステップには、IntegrationHub 標準パックのサブスクリプションが必要です。現時点では、JSON を解析する唯一の方法はスクリプトステップを使用することです。

現在利用可能な JSON パーサーステップはありません。REST ステップには応答を解析するオプションがありません。OpenAPI 仕様のサポートは REST ステップを構成するだけで、API からの出力の処理には役立ちません。

---

質問：接続および資格情報エイリアスを使用するメリットは次のうちどれか？複数の回答が正解の場合があります。

1. 接続の詳細は、アクションとは別に REST メッセージレコードで構成できます。
2. 接続の詳細はフローから分離されているため、接続が変更されてもフローを更新する必要はありません。
3. 接続の詳細はアクションから分離されているため、接続が変更されてもアクションを更新する必要はありません。
4. 複数の接続を接続および資格情報エイリアスに関連付けると、接続を簡単に切り替えることができます。
5. 複数のアクションが単一の構成をポイントする場合があります。

回答：正解は 3、4、5 です。接続の詳細は、フローではなくアクションから分離されます。REST メッセージレコードは IntegrationHub から完全に分離されています。

---

質問：資格情報レコードを選択して REST ステップを使用する方法を説明する文は次のどれですか？

1. REST ステップで資格情報を選択します。
2. 接続および資格情報エイリアスの資格情報を選択します。
3. REST ステップは、有効なものが見つかるまで利用可能なすべての資格情報を試行します。
4. 接続レコードで資格情報を選択します。

回答：正解は 4 です。接続レコードの [資格情報] フィールドを、その接続の正しい資格情報レコードで構成します。

---

質問：次のうち、REST APIs で使用される資格情報のタイプではないものはどれですか？複数の回答が正解の場合があります。

1. API キー
2. 基本認証
3. CIM
4. OAuth 2.0
5. JDBC

回答：正解は 3. CIM と 5. JDBC です。

---

コアコンセプト：

• IntegrationHub を使用して、サードパーティプラットフォームとの再利用可能なインタラクションを作成します
• IntegrationHub プラグインを有効化します。
  • 会社インスタンスの ServiceNow カスタマーサポートを通じて
  • 個人開発者インスタンスの開発者サイトから
• 各 REST API に、スコープ対象のアプリケーションであるスポークを構築または使用します
• インライン接続での REST API の使用はテスト専用です
• 本番アクションの接続および資格情報エイリアスを使用して API 構成を一元化します
• アクションのスクリプトステップを使用して、REST API から返された応答を解析します
• アクションの出力を使用して、解析されたデータをフローで使用できるようにします
• 接続および資格情報エイリアスを使用して、アクション構成を接続の詳細から分離し、次のことを行います。
  • REST API にアクセスするアクションの接続を 1 回設定します
  • 複数のホスト接続を集中的に管理します
• 資格情報レコードの認証情報の安全性を確保します

お疲れさまでした。「IntegrationHub の REST」モジュールはこれで完了です。IntegrationHub への関心に基づいて、さらに次のことも学んでいただけます。

• 受信 REST データ連携：この開発者サイト学習モジュールでは、REST API Explorer を使用して ServiceNow API への要求を構築し、テストします。
• Scripted REST APIs：この開発者サイト学習モジュールでは、Scripted REST API を作成します。続けて、REST API Explorer を使用してその API をテストします。
• Flow Designer の使用：この開発者サイト学習モジュールでは、Flow Designer を使用して NeedIt の実行プロセスを管理するフローを作成、テスト、デバッグする方法を学習します。「Flow Designer の使用」は、Flow Designer を使用してアプリケーションを自動化する方法について説明する Flow Designer コースの 4 つのモジュールのうち、最初のモジュールです。