Excel Online (OneDrive)
Excel Online (OneDrive) 接続プロバイダーを使用すると、OneDrive に保存されている Excel ファイルを操作できます。 この接続プロバイダーは、個人 (MSA) アカウントのみをサポートします。
このコネクタは、次の製品および地域で利用可能です。
| サービス | クラス | リージョン |
|---|---|---|
| Logic Apps | 標準 | すべての Logic Apps 地域 |
| Power Automate | 標準 | 以下を除くすべての Power Automate 地域 : - 21 Vianet が運用する中国のクラウド |
| Power Apps | 標準 | 以下を除くすべての Power Apps 地域 : - 21 Vianet が運用する中国のクラウド |
| コネクタ メタデータ | |
|---|---|
| 発行元 | Microsoft |
既知の問題と制限事項
- Excel Online (OneDrive) コネクタでサポートされる Excel ファイルの最大サイズは 5 MB です。
List rows present in a tableアクションでフィルター処理または並べ替えが使用されている場合は、データが最新ではない可能性があります (遅延が発生する可能性があります)。List rows present in a tableアクションは、基本的なフィルター処理と並べ替えをサポートしています。- 次のフィルター関数をサポートします: eq、ne、contains、startswith、endswith。
- 1 つの列に適用できるフィルター関数は 1 つだけです。
- 並べ替えに使用できる列は 1 つだけです。
List rows present in a tableアクションは既定で最大 256 行を返します。 すべての行を取得するには、ページ割り をオンにしてください。- Excel ファイルは、コネクタを最後に使用してから最大 12 分間、更新または削除のために OneDrive にロックされることがあります。
- 他のコネクタによるファイルの同時変更や手動での編集はサポートされていません。 ユーザーは、複数のクライアントから 1 つの Excel ファイルに同時にデータを書き込むのを避けてください (Excel デスクトップ、Excel Web、Power Automate、LogicApps または PowerApps)。 これにより、統合の競合やデータの不整合が発生する可能性があります。
- コネクタは、Microsoft Excel Open XML スプレッドシート (*.xlsx) と Microsoft Excel Binary Workbook (.xlxb) フォーマットのファイルをサポートします。
- コネクタは、
List rows present in a tableアクションで最大 500 列の行を取得します。 既定では、最初の 500 列の行が返されます。 特定の列のコンマ区切りのリストを指定して、Select Queryパラメーターで取得できます。 - このコネクタでは、非表示の列を含むテーブルに OData パラメーターを使用できません。
- 複雑な数式があったり、ワークシート内の行数が多すぎるので、再計算によって発生したコネクタ タイムアウトが発生する可能性があります。 どちらの場合も、再試行ポリシーにより、データを複数回挿入できます。 回避策として、数式を簡略化または削減できるかどうかを確認してください。 それ以外の場合は、このワークブックの計算モードを手動に設定できます。 詳細については、ここを参照してください
- すべてのアクションにはファイルへの書き込みアクセスが必要です。アクセスがない場合、Graph API は
403 Forbiddenエラーを返します。 また、コネクタは、スプレッドシートが読み取り専用モードの場合は502 BadGatewayエラーを返します。 読み取り専用モードを無効にするには、詳細を こちら でご覧ください。 Filter Query/Order By/Select Query操作パラメーターは、英数字の列名のみをサポートします。- Graph API の制限により、ピボット テーブルはサポートされていません。
- ユーザーが短期間にあまりにも多くの要求を行うと、429 応答を受け取る可能性があります。 スロットリング制限は各要求に固有であり、リクエスト数、使用メモリ、およびその他の重要な要素によって異なります。
Delete a rowのような操作で、key columnフィールドはcase-sensitiveになります。Update a row、Delete a row操作などの操作で複数の一致がある場合、最初の行のみが更新/削除されます。Create a row、Update a row、Delete a rowなどの操作によってコミットされた変更は、対応する Power Automate、LogicApps または Power Apps のアクションからの応答が成功した直後に常に有効になるとは限りません。 基になるバックエンド サービスの制限により、最大 30 秒の遅延が予想されます。- コネクタは、PowerApps でテーブル インポート中に
Insert auto generated id into Excel tableオプションが選択された場合、64000 行まで自動的に入力できます。 - 数値のみを含むテーブルの列ヘッダーは、基になるバックエンド サービスの制限により、
Update a row、Delete a rowなどの操作で予期しない動作を引き起こす可能性があります。 回避策として、そのような列の名前を変更して、他の文字も含むようにしてください。 - Excel ファイルが変更され、"読み取り専用" アクションが実行された場合でも、新しいバージョンがファイルの バージョン履歴 に表示される場合があります。 この動作は、コネクタのバックエンド サービスの内部保存メカニズムによる設計によるものです。
- シートが暗号化されているか、保護されたシートとしてマークされている場合は、ファイルを手動で開くことができる場合でも、ファイル破損エラーが発生します。
列名の取り扱い
OData 形式との互換性を保つために、アクションの応答結果の列名が変換される場合があることに注意してください。
| 文字 | エンコードされた値 |
|---|---|
| . | _x002e_ |
| @ | _x0040_ |
| : | _x003a_ |
| # | _x0023_ |
E.g. Column [one]#1 -> Column [one]_x0023_1
概念と例
Key column: 値の検索に使用されるテーブルの列 (key value)Key value:key columnでの値で、特定の行を識別するために使用されます。
例として、次のテーブルを使用します。 テーブルの 2 番目の行で行操作を実行するには、key column を Column 1 に、key value を 200 にする必要があります。
| 列 1 | 列 2 | 列 3 |
|---|---|---|
| 100 | A-2 | A-3 |
| 200 | B-2 | B-3 |
| 300 | C-2 | C-3 |
一般的な制限
| 件名 | 値 |
|---|---|
| 単一の Excel テーブルから行を取得/挿入/更新/削除するために使用できる ID 列のバリアントの最大数です。 現在の値は 2 に設定されており、これは、1 つの特定のテーブルのワークフロー全体で最大 2 つの列名バリアントを使用する必要があることを意味します。 | 2 |
| PowerApps でテーブルのインポート中に「自動生成された ID を Exce lテーブルに挿入するオプション」 が選択された場合に、コネクタが自動的に入力できる最大行数。 | 64000 |
調整制限
| 名前 | 呼び出し | 更新期間 |
|---|---|---|
| 接続ごとの API 呼び出し | 100 | 60 秒 |
アクション
| テーブルにキー列を追加する |
Excel テーブルにキー列を追加します。 新しい列が右側に追加されます。 新しいキー列は、テーブル内で一意である必要があります。 |
| テーブルに行を追加する |
Excel テーブルに新しい行を追加します。 |
| テーブルに行を追加する [非推奨] |
このアクションは非推奨になりました。 代わりにテーブルに行を追加する を使用します。
|
| テーブルの作成 |
Excel ワークブックに新しいテーブルを作成します。 |
| テーブルを取得する |
Excel ワークブックでテーブルの一覧を取得します。 |
| テーブル内に存在する行を一覧表示する |
テーブル内に存在する行を一覧表示します。 |
| ワークシートの作成 |
Excel ワークブックに新しいワークシートを作成します。 |
| ワークシートの取得 |
Excel ワークブックでワークシートの一覧を取得します。 |
| 行を削除する |
キー列を使用して行を削除します。 |
| 行を取得する |
キー列を使用して行を取得します。 この操作を実行すると、列とキー列の指定した行のすべての値が取得されます。 |
| 行を更新する |
キー列を使用して行を更新します。 入力値は指定されたセルを上書きし、空白のままにされた列は更新されません。 値を (上書きする代わりに) 追加するには、「行を取得」 アクションを使用して最初にコンテンツを取得します。 |
テーブルにキー列を追加する
Excel テーブルにキー列を追加します。 新しい列が右側に追加されます。 新しいキー列は、テーブル内で一意である必要があります。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
ファイル
|
file | True | string |
ファイルの参照で Excel ファイルを選択します。 |
|
テーブル
|
table | True | string |
ドロップダウンからテーブルを選択します。 |
|
キー列
|
idColumn | string |
キー列名を入力します。 |
テーブルに行を追加する
Excel テーブルに新しい行を追加します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
ファイル
|
file | True | string |
ファイルの参照で Excel ファイルを選択します。 |
|
テーブル
|
table | True | string |
ドロップダウンからテーブルを選択します。 |
|
行
|
item | True | dynamic |
指定された Excel テーブルに追加する行です。 |
|
DateTime 形式
|
dateTimeFormat | string |
DateTime 形式です。 |
戻り値
テーブルに行を追加する [非推奨]
このアクションは非推奨になりました。 代わりにテーブルに行を追加する を使用します。
Excel テーブルに新しい行を追加します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
ファイル
|
file | True | string |
ファイルの参照で Excel ファイルを選択します。 |
|
テーブル
|
table | True | string |
ドロップダウンからテーブルを選択します。 |
|
行
|
item | True | dynamic |
指定された Excel テーブルに挿入する行です。 |
戻り値
テーブルの作成
Excel ワークブックに新しいテーブルを作成します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
ファイル
|
file | True | string |
ファイルの参照で Excel ファイルを選択します。 |
|
テーブル名
|
TableName | string |
Excel テーブル名を入力します。 |
|
|
テーブル範囲
|
Range | True | string |
A1 表記を使用してテーブル アドレスを入力します。 |
|
列名
|
ColumnsNames | string |
「;」 または 「,」 で区切って列名を入力します。 |
戻り値
テーブル メタデータ
- 本文
- TableMetadata
テーブルを取得する
Excel ワークブックでテーブルの一覧を取得します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
ファイル
|
file | True | string |
ファイルの参照で Excel ファイルを選択します。 |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
値
|
value | array of object | |
|
ID
|
value.id | string |
テーブル ID です。 |
|
件名
|
value.name | string |
テーブル名です。 |
|
帯状の列を表示する
|
value.showBandedColumns | boolean |
帯状の列を表示します。 |
|
最初の列を強調する
|
value.highlightFirstColumn | boolean |
最初の列を強調します。 |
|
最後の列を強調する
|
value.highlightLastColumn | boolean |
最後の列を強調します。 |
|
帯状の行を表示する
|
value.showBandedRows | boolean |
帯状の行を表示します。 |
|
フィルター ボタンを表示する
|
value.showFilterButton | boolean |
フィルター ボタンを表示します。 |
|
ヘッダーの表示
|
value.showHeaders | boolean |
ヘッダーの表示です。 |
|
合計の表示
|
value.showTotals | boolean |
合計を表示します。 |
|
スタイル
|
value.style | string |
テーブルのスタイルです。 |
テーブル内に存在する行を一覧表示する
テーブル内に存在する行を一覧表示します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
ファイル
|
file | True | string |
ファイルの参照で Excel ファイルを選択します。 |
|
テーブル
|
table | True | string |
ドロップダウンからテーブルを選択します。 |
|
フィルター クエリ
|
$filter | string |
返されるエントリを制限するための ODATA フィルター クエリです。 |
|
|
並べ替え順
|
$orderby | string |
エントリの順序を指定するための ODATA orderBy クエリです。 |
|
|
上から順に取得
|
$top | integer |
取得するエントリの合計数です (既定値 = すべて)。 |
|
|
スキップ数
|
$skip | integer |
スキップするエントリ数です (既定値 = 0)。 |
|
|
クエリを選択する
|
$select | string |
取得する列のコンマ区切りリストです (既定では最初の 500)。 |
|
|
DateTime 形式
|
dateTimeFormat | string |
DateTime 形式です。 |
戻り値
ワークシートの作成
Excel ワークブックに新しいワークシートを作成します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
ファイル
|
file | True | string |
ファイルの参照で Excel ファイルを選択します。 |
|
件名
|
name | string |
ワークシート名です。 |
戻り値
- 本文
- WorksheetMetadata
ワークシートの取得
Excel ワークブックでワークシートの一覧を取得します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
ファイル
|
file | True | string |
ファイルの参照で Excel ファイルを選択します。 |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
値
|
value | array of WorksheetMetadata |
行を削除する
キー列を使用して行を削除します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
ファイル
|
file | True | string |
ファイルの参照で Excel ファイルを選択します。 |
|
テーブル
|
table | True | string |
ドロップダウンからテーブルを選択します。 |
|
キー列
|
idColumn | True | string |
ドロップダウンから列を選択します。 |
|
キー値
|
id | True | string |
キー値を入力します。 |
行を取得する
キー列を使用して行を取得します。 この操作を実行すると、列とキー列の指定した行のすべての値が取得されます。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
ファイル
|
file | True | string |
ファイルの参照で Excel ファイルを選択します。 |
|
テーブル
|
table | True | string |
ドロップダウンからテーブルを選択します。 |
|
キー列
|
idColumn | True | string |
ドロップダウンから列を選択します。 |
|
キー値
|
id | True | string |
キー値を入力します。 |
|
DateTime 形式
|
dateTimeFormat | string |
DateTime 形式です。 |
戻り値
行を更新する
キー列を使用して行を更新します。 入力値は指定されたセルを上書きし、空白のままにされた列は更新されません。 値を (上書きする代わりに) 追加するには、「行を取得」 アクションを使用して最初にコンテンツを取得します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
ファイル
|
file | True | string |
ファイルの参照で Excel ファイルを選択します。 |
|
テーブル
|
table | True | string |
ドロップダウンからテーブルを選択します。 |
|
キー列
|
idColumn | True | string |
ドロップダウンから列を選択します。 |
|
キー値
|
id | True | string |
キー値を入力します。 |
|
項目のプロパティを指定する
|
item | True | dynamic |
項目のプロパティを指定します。 |
|
DateTime 形式
|
dateTimeFormat | string |
DateTime 形式です。 |
戻り値
定義
TableMetadata
テーブル メタデータ
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
名前
|
name | string |
テーブル名 |
|
タイトル
|
title | string |
テーブルのタイトル |
|
x-ms-permission
|
x-ms-permission | string |
テーブルのアクセス許可 |
|
x-ms-capabilities
|
x-ms-capabilities | TableCapabilitiesMetadata |
テーブルのメタデータ (機能) |
|
スキーマ
|
schema | Object | |
|
referencedEntities
|
referencedEntities | Object | |
|
webUrl
|
webUrl | string |
URL のリンク |
TableCapabilitiesMetadata
テーブルのメタデータ (機能)
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
sortRestrictions
|
sortRestrictions | TableSortRestrictionsMetadata |
テーブルのメタデータ (並べ替えの制限) |
|
filterRestrictions
|
filterRestrictions | TableFilterRestrictionsMetadata |
テーブルのメタデータ (フィルターの制限) |
|
selectRestrictions
|
selectRestrictions | TableSelectRestrictionsMetadata |
テーブルのメタデータ (選択の制限) |
|
isOnlyServerPagable
|
isOnlyServerPagable | boolean |
サーバーのページング制限 |
|
filterFunctionSupport
|
filterFunctionSupport | array of string |
サポートされているフィルター機能の一覧 |
|
serverPagingOptions
|
serverPagingOptions | array of string |
サポートされているサーバー駆動型ページング機能の一覧 |
オブジェクト
TableSortRestrictionsMetadata
テーブルのメタデータ (並べ替えの制限)
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
sortable
|
sortable | boolean |
このテーブルに並べ替え可能な列があるかどうかを示します |
|
unsortableProperties
|
unsortableProperties | array of string |
並べ替え不可能なプロパティの一覧 |
|
ascendingOnlyProperties
|
ascendingOnlyProperties | array of string |
昇順のみをサポートするプロパティの一覧 |
TableFilterRestrictionsMetadata
テーブルのメタデータ (フィルターの制限)
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
filterable
|
filterable | boolean |
このテーブルにフィルター処理可能な列があるかどうかを示す |
|
nonFilterableProperties
|
nonFilterableProperties | array of string |
フィルター処理不可能なプロパティの一覧 |
|
requiredProperties
|
requiredProperties | array of string |
すべての必須プロパティの一覧 |
TableSelectRestrictionsMetadata
テーブルのメタデータ (選択の制限)
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
selectable
|
selectable | boolean |
このテーブルに選択可能な列があるかどうかを示す |
WorksheetMetadata
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
ID
|
id | string |
ワークシート IDです。 |
|
件名
|
name | string |
ワークシート名です。 |
|
位置
|
position | integer |
ワークシートの位置です。 |
|
可視性
|
visibility | string |
ワークシートの可視性です。 |