Microsoft Excel コネクタ

Microsoft Excelコネクタ

Microsoft O365ワークシートV1.0 Apiとの統合

はじめに

Microsoft Excel Worksheets APIは、ユーザーがOffice365アカウントに設定された適切なアクセス権でMicrosoft Excelシートを作成、読み取り、編集できるようにします。このコネクタの目的は、HTTPコネクタを使用してMicrosoftのグラフAPI（v1.0）を使用してTulipとMicrosoftを統合し、インスタンスにインポートできるアウトオブボックスのコネクタをお客様に提供することです。

目的

このドキュメントでは、さまざまなユースケースに活用できるワークシート上のさまざまな読み取りと書き込みアクションを紹介するために、M365 Excelワークシートと対話するためにMicrosoftのGraph API（v1.0）へのHTTPコールを行うことによって構築することができるさまざまなコネクタ機能を強調します。

APIドキュメント

Microsoft Graph API ドキュメント

前提条件

1. Microsoft O365 でアカウントを作成し、Microsoft Entra ID で OAuth 2.0 認証情報を設定する。
2. Microsoft ポータルで、必要なスコープで API を登録する。Azure - Entra ID

コネクタのセットアップ動画

チューリップ接続の詳細

以下の情報を Tulip の

コネクタ

1. 実行中: クラウド・コネクタ・ホスト
2. ホスト：graph.microsoft.com
3. ポート:443
4. TLS: はい

OAuth 2: MicrosoftのGraph APIと通信するためのアクセストークンを取得する。

コネクタ機能

1) 1つのドライブの詳細を取得する

目的

このコネクタは、1つのドライブからすべてのアイテムを取得します。

エンドポイント

エンドポイントへのHTTP POSTコール-https://graph.micrsoft.com:443/v1.0/me/drive/root/children

必要な入力

入力不要

必要な出力エクストラクタ

1. SheetID: 他のタスクを実行するために使用されるワークブックの一意の識別子。
2. CreatedAt：ワークブックの作成日時。
3. LastModified: ワークブックの最終更新日時：ワークブックの最終更新日時。
4. SheetName: ワークブックの名前：ワークブックの名前。
5. SpreadSheetURL：ワークブックの URL。

2) ワークブック内のすべてのワークシートを取得する

目的

このコネクタは、workbookID を渡してワークブックのすべてのワークシートを取得します。

エンドポイント

エンドポイントへのHTTP GET-https://graph.microsoft.com:443/v1.0/me/drive/items/{workbookID}/workbook/worksheets

必須入力

渡される URL パラメータは以下のとおりです。

1. ワークブックID

必須出力 抽出子

1. sheetId：他のタスクを実行するために使用されるSpreadSheetの一意の識別子。
2. sheetName:ワークシートの表示名。
3. sheetPosition:ワークブック内のワークシートのゼロベースの位置。
4. sheetVisibility:ワークシートの可視性：ワークシートの可視性。指定できる値は、Visible、Hidden、VeryHidden です。

3) ワークシートのメタデータの取得

目的

このコネクタは、WorkbookID と Worksheet Name からデータをフェッチします。

エンドポイント

エンドポイントhttps://graph.microsoft.com:443/v1.0/me/drive/items/{workbookID}/workbook/worksheets/{worksheetName}/への HTTP GET コール。

必須入力

以下は、渡される URL パラメータです。

1. ワークブックID
2. ワークシート名

必須出力 抽出子

1. sheetId：他のタスクを実行するために使用されるSpreadSheetの一意の識別子。
2. sheetName:ワークシートの表示名。
3. sheetPosition:ワークブック内のワークシートのゼロベースの位置。
4. sheetVisibility:ワークシートの可視性：ワークシートの可視性。指定可能な値は以下のとおりです：Visible、Hidden、VeryHidden。

4) 新規ワークシートの作成

目的

1. ユーザーは、ワークブックIDとワークシート名を入力として渡すことができ、Tulipは指定されたシート名で新しいワークシートを作成します。APIのレスポンスは、ワークシートのメタデータとさまざまなプロパティになります。これを利用して、ワークシートからデータを取得したり更新したりすることができます。
2. Microsoft Graph V1.0 APIから引き出された情報は、Tulipアプリ、Tulipテーブル、または他のコネクター関数にパイプされるTulip変数内でさらに使用することができます。

エンドポイント

エンドポイントhttps://graph.microsoft.com:443/v1.0/me/drive/items/{workbookID}/workbook/worksheets/addへの HTTP POST コール。

必要な入力

リクエスト・ボディとして送信されるパラメータは次のとおりです。

1. ワークブック ID - ワークブック ID
2. ワークシート名 - ワークシートのタイトル

必須出力 Extractor

1. WorksheetId：他のタスクを実行するために使用される SpreadSheet の一意の識別子。
2. spreadsheetURL：新しく作成されたSpreadsheetのURL。
3. レスポンスとともに返される追加パラメータは、出力パラメータの一部として含めることができる。

5) ワークシートプロパティの更新

目的

ユーザーは、ワークブックID、旧ワークシート名、ワークシート位置、新ワークシート名を入力として渡すことができ、Tulipは提供されたシート名でワークシートを更新します。APIのレスポンスは、ワークシートのメタデータとさまざまなプロパティになります。これはさらに、スプレッドシートからデータを取得したり更新したりするために使用できます。

エンドポイント

https://graph.microsoft.com:443/v1.0/me/drive/items/{workbookID}/workbook/worksheets/{worksheetName}エンドポイントへのHTTP PATCHコール。

必要な入力

以下は、リクエスト・ボディとして送信されるパラメータです。

1. ワークブックID - ワークブックID
2. ワークシート名 - ワークシート・タイトル
3. ワークシート位置-ワークブック内のワークシートのゼロ・ベースの位置
4. 新しいワークシート名-新しいワークシート・タイトル

必要な出力エクストラクタ

1. sheetID: 他のタスクを実行するために使用されるワークブックの一意識別子
2. sheetName：ワークシートの表示名。
3. sheetPosition: ワークブック内のワークシートのゼロベースの位置。

6) 特定のセルデータの取得

目的

このコネクタは、入力として提供されたWorkbookID、Worksheet Name、Row Index、Column Indexに基づいて、ワークブックのワークシートからデータをフェッチします。APIの応答は、提供されたセル値のデータとなります。

エンドポイント

エンドポイントへのHTTP GETコール-https://graph.microsoft.com:443/v1.0/me/drive/items/{workbookID}/workbook/worksheets/{worksheetName}/cell(row={row index},column={column index})

必須入力

以下は、渡されるURLパラメータです。

1. ワークブックID-ワークブックID
2. ワークシート名-ワークシート・タイトル
3. 行インデックス- 取得するセルの行番号
4. 列インデックス- 取得するセルの列番号。

必須出力抽出子

このコネクタは、指定された行と列インデックスのセル値を返す。

7) ワークシート範囲データの取得

目的

このコネクタは、入力として提供されたWorkbookID、Worksheet Name、Start Range、End Rangeに基づいて、ワークブックのワークシートからデータをフェッチします。APIのレスポンスは、提供された範囲のデータとなります。

エンドポイント

エンドポイントへのHTTP GETコール-https://graph.microsoft.com:443/v1.0/me/drive/items/{workbookID}/workbook/worksheets/{worksheetName}/range(address='{start range}:{end range}')

必須入力

以下は、渡される URL パラメータです。

1. ワークブックID-ワークブックID
2. ワークシート名-ワークシート・タイトル
3. 開始範囲- 開始範囲
4. 終了範囲- 終了範囲

必須出力エクストラクタ

このコネクタは、指定された範囲内のすべてのセル値を返します。

8) 範囲による値の更新

目的

ユーザーは、ワークブックID、ワークシート名、開始範囲、終了範囲、更新する値を入力として渡すことができます。APIのレスポンスは更新された範囲値となります。

エンドポイント

エンドポイントへのHTTP PATCHコール-https://graph.microsoft.com:443/v1.0/me/drive/items/{workbookID}/workbook/worksheets/{worksheetName}/range(address='{start range}:{end range}')

必須入力

以下は、渡される URL パラメータです。

1. ワークブックID-ワークブックID
2. ワークシート名-ワークシート・タイトル
3. 開始範囲- 開始範囲
4. End range- 終了範囲
5. 提供された範囲内の各セルの値

必要な出力抽出器

出力抽出器は必要ありません。

9) ワークシートに表を作成する。

目的

1. ユーザーは、ワークブックID、ワークシート名、ワークシートアドレス、ヘッダーを入力として渡すことができ、Tulipはテーブル名で新しいテーブルを作成します。APIのレスポンスは、テーブルのメタデータとさまざまなプロパティになります。
2. これを使用して、スプレッドシートからデータを取得したり更新したりすることができます。
3. Microsoft Graph V1.0 APIから引き出された情報は、Tulipアプリ、Tulipテーブル、または他のコネクター関数にパイプされるTulip変数の中で、さらに使用することができます。

エンドポイント

エンドポイントhttps://graph.microsoft.com:443/v1.0/me/drive/items/{itemID}/workbook/worksheets/addへの HTTP POST コール。

必要な入力

リクエスト・ボディとして送信されるパラメータは次のとおりです。

1. ワークブック ID - ワークブック ID
2. ワークシート名 - ワークシートのタイトル
3. Address - データ・ソースを表す範囲オブジェクトのアドレスまたは名前。アドレスにシート名が含まれていない場合は、現在アクティブなシートが使用されます。
4. hasHeaders-インポートされるデータに列ラベルがあるかどうかを示すブール値。ソースにヘッダが含まれていない場合 (つまり、このプロパティが False に設定されている場合)、Excel は自動的にヘッダを生成し、データを 1 行下にシフトします。

必須出力エクストラクタ

これは、新しく作成された表のメタデータ値を返します。

10) 表に新規行を追加する

目的

ユーザーは、ワークブックID、テーブル名、および行の値を入力として渡すことができ、Tulipは提供された行の値で新しい行を作成します。APIのレスポンスは、テーブルに作成された行の値となります。

エンドポイント

エンドポイントhttps://graph.microsoft.com:443/v1.0/me/drive/items/{workbookID}/workbook/tables/{tablename}/rows/addへの HTTP POST コール。

必須入力

以下は、リクエスト・ボディとして送信されるパラメータです。

1. ワークブックID - ワークブックID
2. ワークシート名 - ワークシートタイトル
3. 行の値

必須 出力 Extractor

新しく作成された行の行値を返します。

11)ワークシート・データのクリア

目的

ユーザーは、ワークブックID、ワークシート名、開始範囲、終了範囲を入力として渡すことができ、Tulipは与えられた範囲に基づいてセルの値をクリアします。

エンドポイント

エンドポイントhttps://graph.microsoft.com:443/v1.0/me/drive/items/{workbookID}/workbook/worksheet/{worksheetName}/range(address='{start range}:{end range}')/clearへのHTTP POSTコール。

必須入力

リクエストボディとして送信されるパラメータは以下のとおりです。

1. ワークブックID - ワークブックID
2. ワークシート名 - ワークシートタイトル
3. 開始範囲
4. 終了範囲

その他の情報

Microsoft Connectorに関する詳細情報をご覧ください。

• Microsoft Calendarコネクタ
• Microsoft Outlookコネクタ
• Microsoft Teamsコネクタ