リスト コントロールでコネクションを使用する

注:

利用可能な機能は、使用するクラウド プラットフォームによって異なります。詳しくは、「 利用可能な Apps 機能 」をご覧ください。

This tutorial assumes you already have created a connection in Integration Service, and added it to your app. If you have not done so, go to Adding a connection to your app.

注:

クエリ ビルダーは、応答データが List 型の API のみを表示します。

コネクションを使用して外部 API を呼び出すことで、アプリに機能を追加できます。それには、クエリ ビルダーを使用します。リスト コントロールにコネクションを追加するには、以下の手順に従ってください。

このチュートリアルでは、例として Integration Service の Jira コネクションとその課題のリスト表示機能を使用します。このクエリは、テーブル内の現在未解決の Jira の課題といくつかの主要な属性 (優先度やステータスなど) をリストし、作成日の順に並べ替えます。

1. 使用するコネクションが含まれているアプリに移動します。
2. [コントロールを追加] を選択します。
3. [表示コントロール] で [表] コントロールを選択し、アプリに追加します。
4. [表] コントロールをアプリに追加したら、それを中央の [デザイナー] パネルから選択します。
5. [表] コントロールの [全般] プロパティで、[データ ソース] フィールドに移動します。[ リソースを開く] を選択します。
6. [クエリ ビルダー] オプションを選択します。
7. [ ソースを選択 ] フィールドで、関連するコネクションを選択します。この場合は、[Jira] を選択します。
8. 2 番目の [ソースを選択] フィールドを選択します。選択範囲を絞り込むには、「List: Issues」と入力し、[List: Issues] オプションを選択します。
9. [JQL クエリ] フィールドに、引用符を含めて以下を入力します。

   "project = ""DEV"" AND assignee IN (currentuser()) AND statusCategory in (""To Do"", ""In Progress"") ORDER BY created DESC"
   

10. 手順 3 で作成した [表] コントロールを選択します。
11. [ 全般] プロパティ パネルで、最初の列を選択します。[名前] エントリをクリックします。
12. 最初の列の名前を「優先度*」に変更します。
13. [ソース] の下の [リソースを開く] ボタンをクリックします。
14. [式エディター] を選択します。
15. "MainPage.Table.SelectedItem.fields.priority.name" と入力します (引用符で囲む)。
16. [表] の [全般] プロパティ タブに戻ります。
17. 2 番目の列を選択します。名前を「ステータス」に変更します。
18. データ ソースを変更するには、2 番目の列で手順 13 から 15 を繰り返します。
19. 式エディターに、「MainPage.Table.SelectedItem.fields.status.name」と入力します (引用符で囲む)。
20. 再び [表] の [全般] プロパティ タブに戻ります。
21. 3 番目の列を選択します。名前を「summary」に変更します。
22. 3 番目の列で手順 12 から 14 を繰り返して、データ ソースを変更します。
23. 式エディターに「"MainPage.Table.SelectedItem.fields.summary"」と入力します (引用符を含む)。

実行時には、アプリに Jira の課題の概要、ステータス、優先度がリスト表示されます。