Excel Online (OneDrive)
Excel Online (OneDrive) 接続プロバイダーを使用すると、OneDrive に格納されている Excel ファイルを操作できます。 この接続プロバイダーは、個人用 (MSA) アカウントのみをサポートします。
このコネクタは、次の製品とリージョンで使用できます。
| サービス | クラス | リージョン |
|---|---|---|
| コピロット スタジオ | Standard | 次を除くすべての Power Automate リージョン : - 21Vianet が運営する China Cloud |
| ロジック アプリ | Standard | すべての Logic Apps リージョン |
| Power Apps | - | 利用できません |
| Power Automate | Standard | 次を除くすべての Power Automate リージョン : - 21Vianet が運営する China Cloud |
| コネクタ メタデータ | |
|---|---|
| Publisher | 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 つだけです。
-
List rows present in a tableアクションは、既定で最大 256 行を返します。 すべての行を取得するには、 改ページ位置をオンにしてください。 - OneDrive で Excel ファイルをロックして更新するか、コネクタを最後に使用してから最大 12 分を削除できます。
- 他のコネクタによって同時にファイルを変更したり、手動で編集したりすることはできません。 ユーザーは、複数のクライアント (Excel Desktop、Excel Web、Power Automate、LogicApps、または PowerApps) から 1 つの Excel ファイルに同時にデータを書き込むのを避ける必要があります。 これにより、マージの競合やデータの不整合が発生する可能性があります。
- コネクタは、Microsoft Excel Open XML スプレッドシート (*.xlsx) および Microsoft Excel バイナリ ブック (.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オプションが選択されている場合、コネクタは最大 6,4000 行を自動的に設定できます。 - テーブルの列ヘッダーに数が含まれていると、基になるバックエンド サービスの制限により、
Update a row、Delete a rowなどの操作で予期しない動作が発生する可能性があります。 回避策として、他の文字も含まれるように、このような列の名前を変更してください。 - "読み取り専用" アクションが実行された場合でも、Excel ファイルが変更され、新しいバージョンがファイルの バージョン履歴 に表示される場合があります。 この動作は、コネクタのバックエンド サービスの内部保存メカニズムが原因で設計されています。
- ファイルを手動で開くことができる場合でも、削除または保護されたシートとしてマークされると、破損したファイル エラーがスローされます。
列名の処理
OData 形式と互換性を持つために、アクションの応答結果の列名が変換される場合があることに注意してください。
| Character | エンコードされた値 |
|---|---|
| . | _x002e_ |
| @ | _x0040_ |
| : | _x003a_ |
| # | _x0023_ |
例: 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 |
一般的な制限
| 名前 | 価値 |
|---|---|
| 1 つの Excel テーブルから行を取得、挿入、更新、削除するために使用できる ID 列バリアントの最大数。 現在の値は 2 に設定されています。つまり、1 つの特定のテーブルのワークフロー間で最大 2 つの列名バリアントを使用する必要があります。 | 2 |
| PowerApps でのテーブルのインポート中に [Excel テーブルに自動生成された ID を挿入する] オプションが選択されている場合に、コネクタが自動的に設定できる行の最大数。 | 64000 |
調整制限
| 名前 | 呼び出し | 更新期間 |
|---|---|---|
| 接続ごとの API 呼び出し | 100 | 60 秒 |
アクション
| テーブルにキー列を追加する |
Excel テーブルにキー列を追加します。 新しい列が右側に追加されます。 新しいキー列は、テーブル内で一意である必要があります。 |
| テーブルに存在する行を一覧表示する |
テーブルに存在する行を一覧表示します。 |
| テーブルに行を追加する |
Excel テーブルに新しい行を追加します。 |
| テーブルに行を追加する [非推奨] |
このアクションは非推奨になりました。 代わりに 、テーブルに行を追加するを 使用してください。
|
| テーブルの作成 |
Excel ブックに新しいテーブルを作成します。 |
| テーブルを取得する |
Excel ブック内のテーブルの一覧を取得します。 |
| ワークシートを作成する |
Excel ブックに新しいワークシートを作成します。 |
| ワークシートを取得する |
Excel ブック内のワークシートの一覧を取得します。 |
| 行を削除する |
キー列を使用して行を削除します。 |
| 行を取得する |
キー列を使用して行を取得します。 このアクションでは、列とキー列を指定すると、指定した行のすべての値が取得されます。 |
| 行を更新する |
キー列を使用して行を更新します。 入力値によって指定されたセルが上書きされ、空白の列は更新されません。 値を (上書きではなく) 追加するには、"行の取得" アクションを使用してコンテンツを最初に取得します。 |
テーブルにキー列を追加する
Excel テーブルにキー列を追加します。 新しい列が右側に追加されます。 新しいキー列は、テーブル内で一意である必要があります。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
File
|
file | True | string |
[ファイルの参照] で Excel ファイルを選択します。 |
|
表
|
table | True | string |
ドロップダウンからテーブルを選択します。 |
|
キー列
|
idColumn | string |
キーの列名を指定します。 |
テーブルに存在する行を一覧表示する
テーブルに存在する行を一覧表示します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
File
|
file | True | string |
[ファイルの参照] で Excel ファイルを選択します。 |
|
表
|
table | True | string |
ドロップダウンからテーブルを選択します。 |
|
フィルター クエリ
|
$filter | string |
返されるエントリを制限する ODATA フィルター クエリ。 |
|
|
並べ替え
|
$orderby | string |
エントリの順序を指定するための ODATA orderBy クエリ。 |
|
|
上位カウント
|
$top | integer |
取得するエントリの合計数 (既定値 = すべて)。 |
|
|
Skip Count
|
$skip | integer |
スキップするエントリの数 (既定値は 0)。 |
|
|
クエリの選択
|
$select | string |
取得する列のコンマ区切りのリスト (既定では最初の 500)。 |
|
|
DateTime 形式
|
dateTimeFormat | string |
DateTime 形式。 |
戻り値
テーブルに行を追加する
Excel テーブルに新しい行を追加します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
File
|
file | True | string |
[ファイルの参照] で Excel ファイルを選択します。 |
|
表
|
table | True | string |
ドロップダウンからテーブルを選択します。 |
|
Row
|
item | True | dynamic |
指定した Excel テーブルに追加する行。 |
|
DateTime 形式
|
dateTimeFormat | string |
DateTime 形式。 |
戻り値
テーブルに行を追加する [非推奨]
このアクションは非推奨になりました。 代わりに 、テーブルに行を追加するを 使用してください。
Excel テーブルに新しい行を追加します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
File
|
file | True | string |
[ファイルの参照] で Excel ファイルを選択します。 |
|
表
|
table | True | string |
ドロップダウンからテーブルを選択します。 |
|
Row
|
item | True | dynamic |
指定した Excel テーブルに挿入する行。 |
テーブルの作成
Excel ブックに新しいテーブルを作成します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
File
|
file | True | string |
[ファイルの参照] で Excel ファイルを選択します。 |
|
テーブル名
|
TableName | string |
Excel テーブル名を入力します。 |
|
|
テーブル範囲
|
Range | True | string |
A1 表記を使用してテーブル アドレスを入力します。 |
|
列名
|
ColumnsNames | string |
';' または ',' で区切られた列名を入力します。 |
戻り値
テーブル メタデータ
- Body
- TableMetadata
テーブルを取得する
Excel ブック内のテーブルの一覧を取得します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
File
|
file | True | string |
[ファイルの参照] で Excel ファイルを選択します。 |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
value
|
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 |
合計を表示します。 |
|
Style
|
value.style | string |
テーブル スタイル。 |
ワークシートを作成する
Excel ブックに新しいワークシートを作成します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
File
|
file | True | string |
[ファイルの参照] で Excel ファイルを選択します。 |
|
名前
|
name | string |
ワークシート名。 |
戻り値
- Body
- WorksheetMetadata
ワークシートを取得する
Excel ブック内のワークシートの一覧を取得します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
File
|
file | True | string |
[ファイルの参照] で Excel ファイルを選択します。 |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
value
|
value | array of WorksheetMetadata |
行を削除する
キー列を使用して行を削除します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
File
|
file | True | string |
[ファイルの参照] で Excel ファイルを選択します。 |
|
表
|
table | True | string |
ドロップダウンからテーブルを選択します。 |
|
キー列
|
idColumn | True | string |
ドロップダウンから列を選択します。 |
|
キー値
|
id | True | string |
キー値を入力します。 |
行を取得する
キー列を使用して行を取得します。 このアクションでは、列とキー列を指定すると、指定した行のすべての値が取得されます。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
File
|
file | True | string |
[ファイルの参照] で Excel ファイルを選択します。 |
|
表
|
table | True | string |
ドロップダウンからテーブルを選択します。 |
|
キー列
|
idColumn | True | string |
ドロップダウンから列を選択します。 |
|
キー値
|
id | True | string |
キー値を入力します。 |
|
DateTime 形式
|
dateTimeFormat | string |
DateTime 形式。 |
戻り値
行を更新する
キー列を使用して行を更新します。 入力値によって指定されたセルが上書きされ、空白の列は更新されません。 値を (上書きではなく) 追加するには、"行の取得" アクションを使用してコンテンツを最初に取得します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
File
|
file | True | string |
[ファイルの参照] で Excel ファイルを選択します。 |
|
表
|
table | True | string |
ドロップダウンからテーブルを選択します。 |
|
キー列
|
idColumn | True | string |
ドロップダウンから列を選択します。 |
|
キー値
|
id | True | string |
キー値を入力します。 |
|
項目のプロパティを指定する
|
item | True | dynamic |
項目のプロパティを指定します。 |
|
DateTime 形式
|
dateTimeFormat | string |
DateTime 形式。 |
戻り値
定義
TableMetadata
テーブル メタデータ
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
名前
|
name | string |
テーブル名 |
|
title
|
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 |
サポートされているサーバー駆動型ページング機能の一覧 |
Object
TableSortRestrictionsMetadata
テーブルのメタデータ (並べ替えの制限)
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
ソート可能
|
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 | boolean |
このテーブルに選択可能な列があるかどうかを示します |
WorksheetMetadata
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
ID (アイディー)
|
id | string |
ワークシート ID。 |
|
名前
|
name | string |
ワークシート名。 |
|
位置
|
position | integer |
ワークシートの位置。 |
|
可視性
|
visibility | string |
ワークシートの表示設定。 |