次の方法で共有


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 rowDelete a row 操作などの操作で複数の一致がある場合、最初の行のみが更新/削除されます。
  • Create a rowUpdate a rowDelete a row などの操作によってコミットされた変更は、対応する Power Automate、LogicApps または Power Apps のアクションからの応答が成功した直後に常に有効になるとは限りません。 基になるバックエンド サービスの制限により、最大 30 秒の遅延が予想されます。
  • コネクタは、PowerApps でテーブル インポート中に Insert auto generated id into Excel table オプションが選択された場合、64000 行まで自動的に入力できます。
  • 数値のみを含むテーブルの列ヘッダーは、基になるバックエンド サービスの制限により、Update a rowDelete 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 columnColumn 1 に、key value200 にする必要があります。

列 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 ワークブックでワークシートの一覧を取得します。

行を削除する

キー列を使用して行を削除します。

行を取得する

キー列を使用して行を取得します。 この操作を実行すると、列とキー列の指定した行のすべての値が取得されます。

行を更新する

キー列を使用して行を更新します。 入力値は指定されたセルを上書きし、空白のままにされた列は更新されません。 値を (上書きする代わりに) 追加するには、「行を取得」 アクションを使用して最初にコンテンツを取得します。

テーブルにキー列を追加する

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

ワークシートの可視性です。