機械翻訳について

ページ区切りを設定して、一度に返される電子メール・メッセージの数を制御

ページ区切りを使用して、「Microsoft Office 365 Outlookアダプタ」によって一度に返される電子メール・メッセージの数を制御できます。

ページ区切りを実行するために、Microsoftはレスポンス・メッセージの一部としてodata.nextLinkプロパティを提供します。 「Microsoft Office 365 Outlookアダプタ」構成時に定義した場合、このプロパティは、結果の次のページにリンクするURLに設定されます。 この機能を使用すると、制御された方法で結果を返すことができます。 「問合せパラメータを使用したレスポンスのカスタマイズ」を参照してください。

この項では、ページ区切りを使用して「Microsoft Office 365 Outlookアダプタ」によって一度に返される電子メール・メッセージの数を制御する統合の設計および実行の概要を示します。

  1. 「RESTアダプタ」トリガー接続と「Microsoft Office 365 Outlookアダプタ」呼出し接続を作成します。
  2. アプリケーション統合を作成します。
  3. RESTアダプタを統合キャンバスにドラッグし、次の問合せパラメータを作成します:

    「編集リクエスト・パラメータ」ページには、操作名、リソースURIおよびHTTPメソッドのフィールドが表示されます。 この下には「追加」および「削除」ボタンを含む「問合せパラメータの指定」セクションがあります。 その下には、名前およびデータ型の列を含む表があります。 6つの問合せパラメータがリストされます。 これらはすべて文字列値です。

  4. 「Microsoft Office 365 Outlookアダプタ」を統合キャンバスにドラッグし、次のように構成します。
    1. 「基本情報」ページで、名前を入力します。
    2. 「操作」ページで、「メッセージの取得」を選択して、メール・ボックスから電子メールのコレクションを返します。
    3. 「リクエスト・パラメータ」ページで、「Microsoft Office 365 Outlookアダプタ」によって返される電子メール・メッセージのコンテンツをフィルタするために使用する問合せパラメータを選択します。

      「編集リクエスト・パラメータ」ページには、フィルタする「名前を入力」というラベルを含む「問合せパラメータ」フィールドが表示されます。 この下には、「使用可能な問合せパラメータ」セクションと「選択した問合せパラメータ」セクションがあります。 7つのパラメータが選択されています。

  5. マッパーを開き、ソースの「RESTアダプタ」問合せパラメータをターゲットの「Microsoft Office 365 Outlookアダプタ」問合せパラメータにマップします。

    マッパーには、ソース、マッピング・キャンバスおよびターゲット・セクションが表示されます。 7つの問合せパラメータがソース・セクションからターゲット・セクションにマップされます。

  6. 「Microsoft Office 365 Outlookアダプタ」の下にデータ・ステッチ・アクションをドラッグして、「Microsoft Office 365 Outlookアダプタ」操作の結果の最初のセットを変数に保存します。

    「ステッチを構成」セクションには、ステッチ名と値セットが表示されます。 編集アイコンが右上に表示されます。

  7. assignアクションで変数を作成し、Microsoft Office 365 Outlookレスポンスで返されたodata.nextLinkを保存します。

    割り当ての構成パネルが表示されます。 左側には、「入力ソース」(選択されている)タブと「関数」タブがあります。 「ソース」ツリーが展開され、選択したodata.nextLink要素が表示されます。 右側には、「割当てタイトルの構成」が表示されます。 右側に編集アイコンがあります。 この下では、odata.nextLink要素がパラメータcurrentNextPageの値として設定されます。

    統合は次のようになります。


    統合には、トリガー、マップ・アクション、呼出し、ステッチ・アクションおよび割当てアクションが表示されます。

  8. 次のEメール結果セットを取得するには、割当て処理の下にしばらく処理を作成します。 currentNextPage変数のURLが空でないかぎり、whileアクションはMicrosoftからの電子メール・メッセージをさらに繰り返し続けます。 問合せパラメータを使用すると、最大1000件のEメール・メッセージを受信できます。 ただし、whileループを使用すると、currentNextPageを使用して、制御された方法でより多くの電子メール・メッセージを反復処理できます。

    「Configure while」パネルには、currentNextPage != ''が設定されたループが表示されます。

    1. 2番目の「Microsoft Office 365 Outlookアダプタ」呼出し接続を作成します。
    2. 「操作」ページで、「メッセージの取得」を選択します。
    3. 「リクエスト」の構成ページで、_nextLink問合せパラメータのみを選択します。 このパラメータは、割当てアクションで作成されたcurrentNextPage変数を渡します。

      最初の「Microsoft Office 365 Outlookアダプタ」で定義された問合せパラメータでは、2番目のアダプタでの再選択は必要ありません。 これらの定義済問合せパラメータは、_nextLink問合せパラメータの最後に自動的に追加されます。


      ソース、マッピング・キャンバスおよびターゲット・セクションが表示されます。currentNextPageはNewLinkにマップされます。

    4. ページ結果を収集する2番目のデータ・ステッチ・アクションを作成します。

      「ステッチを構成」パネルが表示されます。 「入力ソース」タブが左側に表示されます。 GetOutlookEmailsの下に値が表示されるように拡張されています。 これらの値の1つである0x617472_odata.nextLinkは、currentNextPageという名前のパラメータに設定されています。

    完了すると、統合のwhileアクション部分は次のようになります。


    統合には、マップ・アクション、起動およびステッチ・アクションで構成されるwhileアクションが表示されます。

  9. 統合をアクティブ化します。
  10. 「アクション」 「アクション」アイコンメニューをクリックし、「実行」を選択します。
  11. 問合せパラメータの値を指定し、実行をクリックします:
    URIパラメータ 値 設定結果
    trigger_query_param_for_top 2 2通のEメールを返します。
    trigger_query_param_for_filter isRead eq true 既読の電子メールを返します。
    trigger_query_param_for_select subject, isRead, createdDateTime これらのオブジェクト・プロパティを含むEメールを返します。
    trigger_query_param_for_orderby createdDateTime 作成日時で結果をオーダーします。
    処理が完了すると、「レスポンス」セクションにページ区切りによる多くの結果が表示されます。 返される結果はすべて、次のとおりです:
    • subject、isReadおよびcreatedDateTimeオブジェクト・プロパティ
    • trueに設定されたisReadオブジェクト・プロパティ
    • Microsoft APIによって返されるodata.etagおよびid内部パラメータ


    「レスポンス」セクションは、ステータスおよびインスタンスIDのラベルとともに表示されます。 この下には、「本文」列と「ヘッダー」列が表示されます。 ヘッダーの内容については、このイメージの上で説明します。

  12. アクティビティ・ストリームを表示します。 whileループは、すべての電子メール・メッセージを同時に返すのではなく、12ページの「Microsoft Office 365 Outlookアダプタ」への電子メール・メッセージの配信を制御するために12回繰り返しました。

    アクティビティ・ストリームが表示されます。 whileループは、すべての電子メール・メッセージを同時に返すのではなく、12ページのMicrosoft Office 365 Outlookアダプタへの電子メール・メッセージの配信を制御するために12回繰り返しました。