機械翻訳について

チュートリアル: 2つ目の統合を最初から構築

2番目の統合をスクラッチから完全に作成、設計、アクティブ化、実行および監視する方法を説明します。 このチュートリアルでは、天候アプリケーションを起動して、指定した都市の天気予報レポートを返す統合を作成します。

このチュートリアルで学習する内容

このチュートリアルでは、次のタスクの実行について説明します:
  • すべての設計、管理およびモニタリング・タスクを実行するプロジェクトの作成。
  • ビジネス要件を設計する統合の作成。
  • OpenWeatherアプリケーション(市区町村、緯度、経度およびその他のコンテンツ)から受信する天気レポートのコンテンツを定義するトリガー接続を作成および構成します。
  • OpenWeatherアプリケーションから、指定された都市の緯度と経度の座標を取得するための呼出し接続を作成および構成します。
  • 2つ目の呼出し接続を作成して構成し、OpenWeatherアプリケーションから天気レポートを取得します。
  • 統合を開始し、その都市の天気予報をOpenWeatherアプリケーションから返す市区町村を指定します。
  • 統合実行の結果のモニタリング。

ステップ1. 前提条件の完了

この統合で使用する呼出し接続として「RESTアダプタ」を構成する場合は、APIキー・ベース認証セキュリティ・ポリシーを選択します。 このポリシーでは、APIキーを指定する必要があります。 OpenWeatherアプリケーションでアカウントを作成し、APIキーを取得します。

  1. 「OpenWeatherアプリケーション」に移動します。
  2. アプリケーションを使用するアカウントを作成します。
  3. Eメール・アドレスとパスワードを指定してサインインします。
  4. 「APIキー」をクリックするか、右上隅にあるプロファイル・リンクをクリックします。
  5. APIキー値をコピーして保存します。

(オプション)ステップ2. Oracle Integrationの外部のAPIキーのテスト

このチュートリアルの後半で「RESTアダプタ」構成をテストすると、APIキーがテストの一部として検証されていないことを示すメッセージが表示されます。 APIキーは個別に検証する必要があります。 APIキー値が無効であることを示すものはない場合がありますが、通常は、Oracle Integrationの外部で接続をテストしてAPIキーを完全に検証することをお薦めします。

Postmanなどのサードパーティ・ツールを使用して、Oracle Integrationの外部でAPIキー接続をテストできます。 このテストは、APIキーを完全に検証する方法を提供します。 たとえば:
https://api.openweathermap.org/?appid=API_key_value&units=imperial

ここで、API_key_valueは、OpenWeatherアプリケーションから取得したキーです。

たとえば、Postmanなどのサード・パーティ・ツールから、appidおよびunitsのURLおよび問合せパラメータ値を指定してテストします。 このチュートリアルでは華氏温度を度数で返すため、imperialが指定されています。 温度を摂氏度で戻すには、metricを指定することもできます。


「The GET」オプションが選択されています。 テストするURLが右側に指定されています。 右側に「送信」オプションが表示されます。 この下には、パラメータ(選択済)、認証、ヘッダー、本文、前提条件、テストおよび設定のタブがあります。 この下には、キー、値および一括編集の列がある表があります。 appidおよびunits問合せパラメータに値が指定されます。

ステップ3. プロジェクトの作成

統合のライフサイクル全体は、プロジェクト内から管理します。

  1. ナビゲーション・ペインで、「プロジェクト」をクリックします。
  2. 「追加」をクリックし、「作成」を選択します。
  3. 「名前」フィールドにMy Weather Projectと入力します。
  4. 残りのフィールドはすべてそのままにして、「作成」をクリックします。

    プロジェクトのページが表示されます。 プロジェクトには、統合リソース(統合、接続、参照およびJavaScriptライブラリ)を作成、設計、デプロイおよびモニタリングするためのセクションが含まれています。

ステップ4. 統合の作成

ここで、プロジェクト内に統合を作成します。

  1. 「統合」セクションで、「追加」をクリックします。

    統合の追加パネルが開きます。

  2. 「作成」をクリックし、「アプリケーション」を選択します。


    統合の作成パネルには、アプリケーションおよびスケジュールの選択肢が表示されます。

  3. 「名前」フィールドにWeather By Cityと入力します。
  4. 残りのフィールドはすべてそのままにして、「作成」をクリックします。

    統合キャンバスが開き、トリガー接続を作成するためのオプションが表示されます。 トリガー接続を使用すると、統合でアプリケーションからインバウンド・メッセージを受信できます。


    Weather By City統合キャンバスには、タイトルの下に7つのアイコンが表示されます。 右端には共有リストがあります。 開始アイコンと終了アイコンがキャンバスの中央に表示されます。 右側には接続セクションがあり、トリガーを追加ボタンがあります。

ノート:

この統合を設計する際、ページの右側にエラー・アイコンが表示される場合があります。 マッパーまたはアダプタ・エンドポイント構成ウィザードで行ったミスが原因でエラーが発生することがあります。 表示されるその他のエラーは、この統合のあらゆる部分の設計が完了したときに解決されます。 エラー・アイコンをクリックして詳細を表示します。 エラーを解決するには、エラー・パネルの指示に従うか、完了した設計で問題が解決されるかどうかを待機します。 エラー・パネルの外側をクリックして閉じます。
エラー・アイコンの値は4です。

ステップ5. 市区町村パラメータおよび天気レポート・レスポンスの内容を定義するトリガー接続の作成

次に、統合キャンバス内にトリガー接続を作成します。 トリガー(ソース)接続を使用すると、市区町村パラメータと、OpenWeatherアプリケーション(市区町村、緯度、経度およびその他のコンテンツ)から戻される天気レポートのコンテンツを定義できます。

  1. 統合キャンバスの接続パネルで、「トリガーの追加」をクリックします。

    接続の作成パネルが開きます。

  2. 検索フィールドにRESTと入力します。
  3. 使用するアダプタ接続としてRESTを選択します。 このチュートリアルでは、「RESTアダプタ」Oracle Integrationに送信されたインバウンド・メッセージを処理します。


    接続の作成ダイアログに、RESTが選択されていることが表示されます。

  4. 「RESTアダプタ」を構成するためのページが開きます。
    1. 次の情報を入力します。
      フィールド 説明
      名前 Rest_Triggerと入力します。
      ロール 「トリガー」を選択します。

      ロールは次のタスクを実行します。

      • トリガー: インバウンド・アプリケーション(エンドポイント)が統合をトリガー(実行)できるようにします。
      • 起動: 統合でアウトバウンド・アプリケーション(エンドポイント)を呼び出すことができます。
      • トリガーと起動: トリガーと呼出しの両方として使用できる接続を作成できます。 たとえば、ある統合のトリガーとして、別の統合の呼出しとして接続を使用します。
    2. 残りのフィールドはすべてそのままにして、「作成」をクリックします。

      「RESTアダプタ」トリガー接続のセキュリティおよび配信メソッドを構成するためのページが表示されます。

    3. 次の情報を入力します。
      フィールド 説明
      セキュリティ 受信メッセージを保護するには、OAuth 2.0を選択します。
      アクセス・タイプ 「パブリック・ゲートウェイ」が選択されていることを確認します。 このアクセス・タイプでは、パブリック・インターネットを使用してメッセージを受信します。
    4. 「テスト」をクリックして、接続を正常に構成したことを確認します。 テストが完了すると、成功メッセージが表示されます。 構成の進捗が100%完了しました。


      「The Rest_Trigger」ページが表示されます。 構成済のステータスが表示され、トリガーのロールが表示され、識別子としてREST_TRIGGERが表示され、更新されたデータが表示され、接続を使用した統合の数が表示され、My Weather Projectのプロジェクトが表示されます。 セキュリティ・フィールドの値OAuth 2.0の下に表示され、構成の進行状況は100%で、アクセス・タイプ・フィールドにパブリック・ゲートウェイが選択されていることが示されます。

    5. 「保存」をクリックします。
    6. 「戻る」 「戻る」アイコンをクリックして、統合キャンバスに戻ります。 メニューには、新しく作成されたRest_Trigger接続が選択可能であることが表示されます。


      Weather By City統合キャンバスには、タイトルの下に7つのアイコンが表示されます。 開始アイコンと終了アイコンがキャンバスの中央に表示されます。 右側には、Rest_Trigger接続を含むトリガー・セクションを含むメニューがあります。

    次に、統合で「RESTアダプタ」トリガー接続を構成します。 構成時に、操作、相対リソースURI、問合せパラメータ、メッセージ・ペイロード・コンテンツなどの詳細を指定します。

  5. 統合キャンバスで、メニューに表示されるRest_Trigger接続をクリックします。

    アダプタ・エンドポイント構成ウィザードの「基本情報」ページが開きます。 このウィザードでは、統合で使用するRest_Trigger接続を構成できます。

  6. 「エンドポイントをコールする内容」フィールドにGetWeatherByCityと入力し、「続行」をクリックして「リソース構成」ページにアクセスします。
  7. 次の情報を入力します。
    フィールド 説明
    エンドポイントの相対リソースURIは何ですか 次のように入力します。
    /weather
    エンドポイントでどのアクションを実行しますか GETを選択します。
    構成するオプションを選択してください ページの下部までスクロールし、次のオプションを選択します:
    • このエンドポイントのパラメータの追加および確認
    • このエンドポイントを構成してレスポンスを受信
  8. 残りのフィールドはすべてそのままにします。

    完成した「リソース構成」ページは、次のようになります。


    このイメージは、そのすぐ上のテキストで説明されています。

  9. 続行」をクリックして「リクエスト・パラメータ」ページにアクセスします。
    1. 「問合せパラメータの指定」セクションで、「追加」をクリックします。
    2. 「名前」列の行をダブルクリックして、値を入力します。


      名前列とデータ型列が表示されます。 名前列ヘッダーの下の行がクリックされています。 データ型列の値は文字列です。

    3. cityと入力し、「データ型」リストからstringを選択します。


      名前列とデータ型列が表示されます。 市区町村の名前の行が表示されます。 この名前のデータ型の値は文字列です。

      実行時に、構成および実行ページで市区町村を指定して、天気予報レポートを受信します。

    4. city行の外側をクリックします。
    5. 「続行」をクリックして、「レスポンス」ページにアクセスします。
  10. 次の情報を入力します。
    フィールド 説明
    レスポンス・ペイロード書式を選択 「JSONサンプル」を選択します。
    <<< inline >>> このフィールドをクリックして次のコンテンツを入力し、OKをクリックします。
    {
      "city" : "Timbuktu",
      "longitude" : 1.1,
      "latitude" : 1.2,
      "country" : "AF",
      "description" : "clear sky",
      "temp" : 20.6
    }
    要素 response-wrapperが選択されていることを確認します。
    レスポンス本文のメディア・タイプとは何ですか JSONが選択されていることを確認します。

    完成したレスポンス・ページは次のようになります。


    このイメージは、そのすぐ上のテキストで説明されています。

  11. 「続行」をクリックして、「サマリー」ページにアクセスします。
  12. 選択内容を確認し、「終了」をクリックします。

    「RESTアダプタ」トリガー接続は、統合で使用するために完全に構成されるようになりました。 マップ・アクションは、トリガー接続と、次のセクションで作成した起動接続との間でデータをマッピングするために自動的に作成されます。


    トリガー・アイコンとマップ・アイコンが表示されます。

ステップ6. OpenWeatherアプリケーションをコールするための呼出し接続の作成

次に、統合キャンバス内に起動接続を作成し、OpenWeatherアプリケーションをコールして気象情報を受信します。

  1. 右側のペインで、「起動」 使用可能な起動アイコンをクリックします。

    接続の作成パネルが開きます。

  2. 「接続の作成」 インストール・アイコンをクリックして、新しい接続を作成します。


    「接続」フィールドが表示されます。 追加(選択されている)およびリフレッシュ・アイコンが表示されます。 空のフィールドが表示されます。

  3. 使用するアダプタ接続としてRESTを選択します。 このチュートリアルでは、「RESTアダプタ」によってOpenWeatherアプリケーションが起動されます。
    1. 次の情報を入力します。
      フィールド 説明
      名前 Weatherと入力します。
      ロール 「起動」を選択します。 このロールにより、統合でOpenWeatherアプリケーションを起動できます。
    2. 残りのフィールドはすべてそのままにして、「作成」をクリックします。

      「RESTアダプタ」起動接続のセキュリティおよび配信メソッドを構成するためのページが表示されます。

    3. 次の情報を入力します。
      フィールド 説明
      接続タイプ メッセージを保護するには、「REST APIのベースURL」を選択します。
      接続URL 次のように入力します
      https://api.openweathermap.org/
      セキュリティ・ポリシー 「APIキー・ベースの認証」を選択します。 これは、OpenWeatherアプリケーションで使用される認証セキュリティです。
      APIキー 「ステップ1. 前提条件の完了」で取得したAPIキーを入力します。
      APIキーの用途 「オプションのセキュリティ」を展開し、次の主要な使用方法のいずれかを入力します。 これは、キーがOpenWeatherアプリケーションに渡される方法です。 imperialの値は、温度を華氏度で戻すことを示します。
      ?appid=${api-key}&units=imperial
      このチュートリアルでは、温度を華氏度で返す方法について説明します。 必要に応じて、次の値を指定して温度を摂氏度で返すことができます:
      ?appid=${api-key}&units=metric
      アクセス・タイプ 「パブリック・ゲートウェイ」が選択されていることを確認します。 このアクセス・タイプでは、パブリック・インターネットを使用してメッセージを送信します。


      「天気」ページが表示されます。 構成済のステータスが表示され、起動のロールが表示され、WEATHERの識別子が表示され、更新されたデータが表示され、接続を使用した統合の数が表示され、My Weather Projectのプロジェクトが表示されます。 Securityフィールドの値API Key Based Authenticationが表示されています。API Keyの値が表示されています。API Key Usageの値は?appid=${api-key}&units=imperial、Configuration progressは100%で、Access typeフィールドにはPublic gatewayが選択されています。

    4. 「テスト」をクリックして、接続を正常に構成したことを確認します。 テストが完了すると、次のメッセージが表示されます。
      Connection Weather was tested successfully.
         The API key is not validated as part of this test. You must validate
         the API key separately before using them with this security policy.

      APIキーは完全に有効である場合がありますが、Oracle Integration内から完全に検証することはできません。 「(オプション)ステップ2. Oracle Integrationの外部のAPIキーのテスト」のAPIキーを完全に検証するオプションがあります。

    5. 「保存」をクリックします。
    6. 「戻る」 「戻る」アイコンをクリックして、統合キャンバスに戻ります。

ステップ7. 呼出し接続で市の緯度および経度座標を取得する方法を指定

統合で「RESTアダプタ」起動接続を構成して、統合の実行時に指定した都市の緯度と経度の座標を取得します。 構成時に、操作、相対リソースURI、問合せパラメータ、メッセージ・ペイロード・コンテンツなどの詳細を指定します。

  1. 「追加」 「追加」アイコンアイコンが表示されるまで、GetWeatherByCityトリガーの下の行に沿ってカーソルをドラッグします。
  2. 「起動」を選択し、「天気」接続を選択します。


    トリガー接続の下にある追加アイコンが選択されています。 この下にはマップがあります。 右側には、Search(検索)フィールド、Suggestions(提示)セクション、Invoke and Actions(起動および処理)タブを含むメニューが表示されます。 呼出しを選択すると、使用中の接続および使用可能な接続が表示されます。

    アダプタ・エンドポイント構成ウィザードが開きます。

  3. 次の情報を入力します。
    フィールド 説明
    エンドポイントを呼び出すもの 次のように入力します。
    GetCoord
    このエンドポイントの動作 次のように入力します。
    Get latitude and longitude for a city
    エンドポイントの相対リソースURIは何ですか 次のように入力します。
    /geo/1.0/direct
    エンドポイントでどのアクションを実行しますか GETを選択します。
    構成するオプションを選択してください ページの下部までスクロールし、次のオプションを選択します:
    • このエンドポイントのパラメータの追加および確認
    • このエンドポイントを構成してレスポンスを受信
  4. 残りのフィールドはすべてそのままにします。

    完成した「基本情報」ページは、次のようになります。


    このイメージは、そのすぐ上のテキストで説明されています。

  5. 続行」をクリックして「リクエスト・パラメータ」ページにアクセスします。
    1. 「問合せパラメータの指定」セクションで、「追加」をクリックします。
    2. 「名前」列の行をダブルクリックして、値を入力します。
    3. qと入力し、「データ型」リストからstringを選択します。


      名前列とデータ型列が表示されます。 qという名前の行が表示されます。 この名前のデータ型の値は文字列です。

    4. q行の外側をクリックします。
    5. 「続行」をクリックして、「レスポンス」ページにアクセスします。
  6. 次の情報を入力します。
    フィールド 説明
    レスポンス・ペイロード書式を選択 「JSONサンプル」を選択します。
    <<< inline >>> このフィールドをクリックして次のコンテンツを入力し、OKをクリックします。
    [ {
      "name" : "London",
      "local_names" : {
        "af" : "Londen",
        "ascii" : "London",
        "az" : "London",
        "ca" : "Londres",
        "da" : "London",
        "de" : "London",
        "en" : "London",
        "eu" : "Londres",
        "feature_name" : "London",
        "fi" : "Lontoo",
        "fr" : "Londres",
        "gl" : "Londres",
        "hr" : "London",
        "hu" : "London",
        "id" : "London",
        "it" : "Londra",
        "la" : "Londinium",
        "lt" : "Londonas",
        "nl" : "Londen",
        "no" : "London",
        "pl" : "Londyn",
        "pt" : "Londres",
        "ro" : "Londra",
        "sl" : "London",
        "tr" : "Londra",
        "zu" : "ILondon"
      },
      "lat" : 51.5085,
      "lon" : -0.1257,
      "country" : "GB"
    }, {
      "name" : "London",
      "local_names" : {
        "ascii" : "London",
        "de" : "London",
        "en" : "London",
        "feature_name" : "London",
        "fi" : "London",
        "fr" : "London",
        "lt" : "Londonas",
        "nl" : "London",
        "pl" : "London",
        "pt" : "London"
      },
      "lat" : 42.9834,
      "lon" : -81.233,
      "country" : "CA"
    }, {
      "name" : "London",
      "local_names" : {
        "ascii" : "London",
        "en" : "London",
        "feature_name" : "London"
      },
      "lat" : 39.8865,
      "lon" : -83.4483,
      "country" : "US",
      "state" : "OH"
    }, {
      "name" : "London",
      "local_names" : {
        "ascii" : "London",
        "en" : "London",
        "feature_name" : "London"
      },
      "lat" : 37.129,
      "lon" : -84.0833,
      "country" : "US",
      "state" : "KY"
    }, {
      "name" : "London",
      "local_names" : {
        "ascii" : "London",
        "ca" : "Londres",
        "en" : "London",
        "feature_name" : "London"
      },
      "lat" : 36.4761,
      "lon" : -119.4432,
      "country" : "US",
      "state" : "CA"
    } ]
    要素 response-wrapperが選択されていることを確認します。
    レスポンス本文のメディア・タイプとは何ですか JSONが選択されていることを確認します。

    完成したレスポンス・ページは次のようになります。


    このイメージは、そのすぐ上のテキストで説明されています。

  7. 「続行」をクリックして、「サマリー」ページにアクセスします。
  8. 選択内容を確認し、「終了」をクリックします。
  9. 統合の上で、「水平方向」 水平レイアウト・アイコンをクリックすると、統合の水平表示が表示されます。 統合でGetCoord起動接続を作成および構成した後、マップはその後に自動的に追加されたことに注意してください。


    トリガー接続、マップ、呼出しおよびマップが統合キャンバスに表示されます。

統合キャンバスでGetWeatherByCityトリガー接続を構成すると、マップが自動的に作成されました。 次に、最初のマップを構成します。

  1. GetWeatherByCityトリガー接続とGetCoord起動接続の間のマップをダブルクリックします。


    トリガー接続、マップおよび呼出し接続が統合キャンバスに表示されます。 マップを選択しています。

    マッパーが開きます。

  2. 「ソース」セクションで、「問合せパラメータ」を展開します。
  3. 「ターゲット」セクションで、「問合せパラメータ」を展開します。
  4. ソースの「市区町村」要素をターゲットのQ要素にドラッグします。 これにより、都市がその緯度と経度の座標にマップされます。 これらの問合せパラメータは、アダプタ・エンドポイント構成ウィザードでトリガーおよび呼出し接続を構成したときに、以前に作成しました。


    GetCoordへのマップには、ソース、マッピング・キャンバスおよびターゲット・セクションが表示されます。 ソースのCity要素がターゲットQ要素にドラッグされました。 右上に検証ボタンが表示されます。 このボタンの下には、Developer、XSLTおよびその他の6つのアイコンがあります。 ソース・ラベルの上には3つのアイコンがあります。

  5. 「検証」をクリックして、次のメッセージが表示されるまで待ちます。
    Map to GetCoord successfully validated.
  6. 「戻る」 「戻る」アイコンをクリックしてマッパーを終了し、統合キャンバスに戻ります。 マッピングは自動的に保存されます。

ステップ8. 呼出し接続で市の天気レポートを取得する方法を指定

次に、統合で2つ目の「RESTアダプタ」起動接続を構成して、OpenWeatherアプリケーションから天気レポートを取得します。

  1. 「追加」 「追加」アイコンアイコンが表示されるまで、GetCoord起動接続の後の行に沿ってカーソルをドラッグします。


    トリガー接続、マップおよび呼出し接続が統合キャンバスに表示されます。 起動接続の右側には、選択されている追加アイコンがあります。 提案セクションと起動および処理アイコンを含むメニューが表示されます。 呼出しを選択すると、使用中の接続と使用可能な接続のセクションが表示されます。

  2. 「起動」を選択し、「天気」接続を再度選択します。

    アダプタ・エンドポイント構成ウィザードが開きます。

  3. 次の情報を入力します。
    フィールド 説明
    エンドポイントを呼び出すもの 次のように入力します。
    GetWeather
    このエンドポイントの動作 次のように入力します。
    Get the weather
    エンドポイントの相対リソースURIは何ですか 次のように入力します。
    /data/2.5/weather
    エンドポイントでどのアクションを実行しますか GETを選択します。
    構成するオプションを選択してください ページの下部までスクロールし、次のオプションを選択します:
    • このエンドポイントのパラメータの追加および確認
    • このエンドポイントを構成してレスポンスを受信
  4. 残りのフィールドはすべてそのままにします。

    完成した「基本情報」ページは、次のようになります。


    このイメージは、そのすぐ上のテキストで説明されています。

  5. 続行」をクリックして「リクエスト・パラメータ」ページにアクセスします。
    1. 「問合せパラメータの指定」セクションで、「追加」をクリックします。
    2. 「名前」列の行をダブルクリックして、値を入力します。
    3. latと入力し、「データ型」リストからfloatを選択します。
    4. 「追加」を再クリックします。
    5. 「名前」列の行をダブルクリックして、値を入力します。
    6. lonと入力し、「データ型」リストからfloatを選択します。


      名前列とデータ型列が表示されます。 latとlonの名前を持つ行が表示されます。 両方の名前のデータ型はfloatです。

    7. 「ライ・オン」行の外側をクリックします。
    8. 「続行」をクリックして、「レスポンス」ページにアクセスします。
  6. 次の情報を入力します。
    フィールド 説明
    レスポンス・ペイロード書式を選択 「JSONサンプル」を選択します。
    <<< inline >>> このフィールドをクリックして次のコンテンツを入力し、OKをクリックします。
    {
      "coord" : {
        "lon" : -122.08,
        "lat" : 37.39
      },
      "weather" : [ {
        "id" : 800,
        "main" : "Clear",
        "description" : "clear sky",
        "icon" : "01d"
      } ],
      "base" : "stations",
      "main" : {
        "temp" : 282.55,
        "feels_like" : 281.86,
        "temp_min" : 280.37,
        "temp_max" : 284.26,
        "pressure" : 1023,
        "humidity" : 100
      },
      "visibility" : 10000,
      "wind" : {
        "speed" : 1.5,
        "deg" : 350
      },
      "clouds" : {
        "all" : 1
      },
      "dt" : 1560350645,
      "sys" : {
        "type" : 1,
        "id" : 5122,
        "message" : 0.0139,
        "country" : "US",
        "sunrise" : 1560343627,
        "sunset" : 1560396563
      },
      "timezone" : -25200,
      "id" : 420006353,
      "name" : "Mountain View",
      "cod" : 200
    }
    要素 response-wrapperが選択されていることを確認します。
    レスポンス本文のメディア・タイプとは何ですか JSONが選択されていることを確認します。

    完成したレスポンス・ページは次のようになります。


    このイメージは、そのすぐ上のテキストで説明されています。

  7. 「続行」をクリックして、「サマリー」ページにアクセスします。
  8. 選択内容を確認し、「終了」をクリックします。

GetCoord呼出し接続を統合キャンバスで構成すると、マップ・アクションが自動的に作成されました。 次に、OpenWeatherアプリケーションから天気を取得するために、緯度と経度座標をコールにマップします。

  1. GetCoord起動接続とGetWeather起動接続の間のマップをダブルクリックします。


    呼出し接続、マップおよび呼出し接続は、統合キャンバスに表示されます。 マップを選択しています。

    マッパーが開きます。

  2. 「ソース」セクションで、GetCoord Response (REST)「レスポンスの実行」「レスポンス・ラッパー」「トップ・レベル配列」の順に展開します。
  3. 「ターゲット」セクションで、「GetWeatherリクエスト(REST)」「問合せパラメータ」の順に展開します。
  4. 次のマッピングを実行します:
    • ソースの「緯度」要素をターゲットの「緯度」要素にドラッグします。
    • ソースの「ロン」要素をターゲットの「ロン」要素にドラッグします。


    GetWeatherへのマップには、ソース、マッピング・キャンバスおよびターゲット・セクションが表示されます。 ソース・ラット要素およびLon要素がターゲット・ラット要素およびLon要素にドラッグされました。 右上に検証ボタンが表示されます。 このボタンの下には、Developer、XSLTおよびその他の6つのアイコンがあります。 ソース・ラベルの上には3つのアイコンがあります。

  5. 「検証」をクリックして、次のメッセージが表示されるまで待ちます。
    Map to GetWeather successfully validated.
  6. 「戻る」 「戻る」アイコンをクリックしてマッパーを終了し、統合キャンバスに戻ります。 マッピングは自動的に保存されます。

ステップ9. OpenWeatherアプリケーションから返された天気レポート・レスポンスのマップ

GetWeather呼出し接続を統合キャンバスで構成すると、マップ・アクションが自動的に作成されました。 ここで、OpenWeatherアプリケーションから受信したレスポンス情報をマップします。

  1. GetWeather呼出し接続の後にマップをダブルクリックします。


    呼び出し接続とマップが表示されます。 マップを選択しています。

    マッパーが開きます。

  2. 「ソース」セクションで、GetCoord Response (REST)「レスポンスの実行」「レスポンス・ラッパー」「トップ・レベル配列」の順に展開します。
  3. 「ターゲット」セクションで、GetWeatherByCity Response (REST」「レスポンス・ラッパー」の順に展開します。
  4. 次のマッピングを実行します:
    • ソースの「緯度」要素をターゲットの「緯度」要素にドラッグします。
    • ソースの「ロン」要素をターゲットの「経度」要素にドラッグします。
    • ソースの「国」要素をターゲットの「国」要素にドラッグします。


      GetWeatherByCityへのマップには、ソース、マッピング・キャンバスおよびターゲット・セクションが表示されます。 ソースのLat、LonおよびCountry要素が、ターゲットのLatitude、LongitudeおよびCountry要素にドラッグされています。 右上に検証ボタンが表示されます。 このボタンの下には、Developer、XSLTおよびその他の6つのアイコンがあります。 ソース・ラベルの上には3つのアイコンがあります。

  5. 「ソース」セクションを下にスクロールし、GetWeather Response (REST)「レスポンスの実行」「レスポンス・ラッパー」「天気」の順に展開します。
  6. ソースの「説明」要素をターゲットの「説明」要素にドラッグします。


    ソース摘要要素がターゲット摘要要素にドラッグされました。 右上に検証ボタンが表示されます。 このボタンの下には、Developer、XSLTおよびその他の6つのアイコンがあります。 ソース・ラベルの上には3つのアイコンがあります。

  7. 「ソース」セクションのソース「天気」要素を縮小します。
  8. 「ソース」セクションを下にスクロールし、「メイン」要素を展開します。
  9. ソースの「一時」要素をターゲットの「一時」要素にドラッグします。


    ソースの一時要素がターゲットの一時要素にドラッグされました。

  10. 「ソース」セクションのソース「メイン」要素を縮小します。
  11. 「ソース」セクションを下にスクロールし、ソースの「名前」要素をターゲットの「市区町村」要素にドラッグします。


    ソース名要素をターゲットのCity要素にドラッグしました。

  12. 「検証」をクリックして、次のメッセージを待ちます。
    Map to GetWeatherByCity successfully validated.
    
  13. 「戻る」 「戻る」アイコンをクリックしてマッパーを終了し、統合キャンバスに戻ります。 マッピングは自動的に保存されます。

ステップ10. ビジネス識別子の定義

次に、統合のプライマリ・ビジネス識別子を定義します。 ビジネス識別子を使用すると、実行時にメッセージ内のペイロード・フィールドを追跡できます。 各統合には、プライマリ・ビジネス識別子が必要です。

  1. 統合の上で、「ビジネス識別子」 ビジネス識別子アイコンをクリックします。
    1. QueryParametersを展開し、city「ビジネス識別子」フィールドにドラッグします。


      「ソース」セクションには、展開されたTemplateParametersが表示されます。 市区町村要素をビジネス識別子名フィールドにドラッグしました。 このフィールドの上には、値としてtracking_var_1を持つビジネス識別子変数フィールドがあります。 この上には、市区町村の値を持つビジネス識別子フィールドがあります。 このフィールドの右側に2つのアイコンが表示されます。 これらすべてのフィールドは、プライマリ・ビジネス識別子パネルにあります。

    2. 「保存」をクリックし、ビジネス識別子パネルの外側をクリックして閉じます。 ここで指定したビジネス識別子は、完了した統合インスタンスを「ステップ12. 統合のモニター」「観測」タブでモニターすると表示されます。
  2. 赤色のエラー・アイコンを確認します。 表示される場合は、アイコンをクリックして詳細を確認し、それらのエラーを解決します。

    完全な統合設計は次のようになります。


    完成した統合には、トリガー接続、マップ、起動接続、マップ、起動接続およびマップが表示されます。

  3. 「戻る」 「戻る」アイコンをクリックして統合キャンバスを終了し、プロジェクト・ページに戻ります。

ステップ11 統合のアクティブ化および実行

これで、ランタイム環境への統合をアクティブ化する準備ができました。 アクティブ化すると、統合を実行できます。

  1. 「統合」セクションで、「アクション」 「アクション」アイコンをクリックし、「アクティブ化」を選択します。


    「統合」セクションには、バージョンが1.0.0で状態が構成済の市区町村別天気が表示されます。 右側にはアクティブ化オプションが選択されたメニューがあります。

  2. 「Activate」をクリックします。 トレース・レベルは「本番」に設定したままにします。 ランタイム・エラーを受け取った場合は、「デバッグ(非推奨)」の選択によってアクティビティ・ストリームの詳細情報が提供され、ランタイム・エラーのテストおよびトラブルシューティングに役立ちます。
  3. 「リフレッシュ」 「リフレッシュ」アイコン定期的にクリックします。

    統合ステータスが「アクティブ」に変わります。

    これで、統合を実行してメッセージを送信する準備ができました。

  4. 「統合」セクションで、「アクション」 「アクション」アイコンをクリックし、「実行」を選択します。


    「統合」セクションには、Weather By City統合、バージョン1.0.0およびアクティブのステータスが表示されます。 アクション(…)メニューが選択され、選択されている実行オプションが表示されます。

    構成および実行ページでは、「RESTアダプタ」トリガー・ベースの統合を実行およびテストできます。 このページは、統合へのインバウンド・メッセージの配信をテストする方法を提供します。

  5. 「リクエスト」セクションで、市区町村を指定し、「実行」をクリックしてインバウンド・メッセージを統合に送信します。


    Configure and runページにGET URLが表示されます。 「リクエスト」セクションには、URIパラメータ(選択済)、ヘッダー、本文、cURLおよび統合プロパティ・タブが表示されます。 市区町村の値を入力するためのフィールドが表示されます。

    アクティビティ・ストリーム・パネルが開き、設計したアクション(トリガー、起動およびマップ)を介したメッセージの移動が表示されます。 この統合実行用に作成された一意のインスタンスIDが上部に表示されます。 このアクティビティ・ストリームのすべてのマイルストンは緑色で、この統合インスタンスが正常に実行されたことを示します。


    アクティビティ・ストリーム・パネルが表示されます。 インスタンスIDの値が表示されます。 トレース・レベルは本番に設定されています。 この下には、メッセージが渡された統合のセクションがあります。 それぞれが緑色で、成功を示す。

    .
  6. 構成して実行ページの下部にあるレスポンス・メッセージを表示します。 指定した都市の温度が、経度および緯度の座標、国および現在の気象の説明とともに表示されます(この例では、シカゴ)。


    「レスポンス」セクションには、200 IKのステータス、インスタンスIDおよび本文とヘッダーのタブが表示されます。 本文を選択すると、市区町村(シカゴ)、経度、緯度、国、説明および一時の値が表示されます。

    OpenWeatherアプリケーションから返されたレスポンス情報は、「ステップ9. OpenWeatherアプリケーションから返された天気レポート・レスポンスのマップ」GetWeatherByCityマップで実行したターゲットからソースへの要素マッピングに基づいています。

ステップ12 統合のモニター

  1. アクティビティ蒸気パネルを閉じ、「インスタンスのトラッキング」をクリックします。

    プロジェクトの「観測」タブが開きます。 このタブでは、統合インスタンスのステータスをモニターできます。 インスタンスのステータスは、「成功」と表示されます。 「ステップ10. ビジネス識別子の定義」で定義したプライマリ・ビジネス識別子(city)は、「プライマリ識別子」列に表示されることに注意してください。


    特定のプロジェクトのページには、設計、デプロイおよび観測タブが表示されます。 下には、最新のフィルタ設定を示すフィールドがあります。 上部には検索アイコンとフィルタ・アイコンがあります。 左端にはInstances、Future runおよびAuditタブがあります。 右端にはタイム・スタンプとリフレッシュ・ボタンがあります。 これらのすべてのボタンおよびアイコンの下に、プライマリ識別子、インスタンスID、ビジネス識別子、ステータスおよび期間の列がある表があります。 表にインスタンスの詳細が移入されます。 左端には、インスタンスの状態を示すグラフがあります: 成功、中止、キュー待ち、ブロック、エラー、進行中、一時停止および再送信済。

成功しました。 2番目の統合を正常に作成、設計、アクティブ化、実行および監視しました。 このチュートリアルで使用する機能の詳細は、次のセクションを参照してください。