Excel Online (Business)
Excel Online (Business) コネクタを使用すると、Microsoft Graph (OneDrive for Business、SharePoint サイト、Office 365 グループ) でサポートされているドキュメント ライブラリ内の Excel ファイルを操作できます。
このコネクタは、次の製品とリージョンで使用できます。
| サービス | クラス | リージョン |
|---|---|---|
| コピロット スタジオ | Standard | 次を除くすべての Power Automate リージョン : - 21Vianet が運営する China Cloud |
| ロジック アプリ | Standard | 次を除くすべての Logic Apps リージョン : - Azure China リージョン |
| Power Apps | Standard | 次を除くすべての Power Apps リージョン : - 21Vianet が運営する China Cloud |
| Power Automate | Standard | 次を除くすべての Power Automate リージョン : - 21Vianet が運営する China Cloud |
| お問い合わせ | |
|---|---|
| 名前 | Excel Online (Business) |
| URL | https://learn.microsoft.com/en-us/connectors/excelonlinebusiness/ |
| idcknowledgeeco@microsoft.com |
| コネクタ メタデータ | |
|---|---|
| Publisher | Microsoft |
| Website | https://products.office.com/excel |
| プライバシー ポリシー | https://privacy.microsoft.com/ |
| カテゴリ | 人工知能;ビジネス インテリジェンス |
アクションに関する既知の問題と制限事項
| 簡単な説明 | オペレーション | 長い説明 |
|---|---|---|
| 古いデータ | テーブルに存在する行を一覧表示する | テーブル アクションに 存在するリスト行 でフィルター処理または並べ替えが使用されている場合、データが最新ではない可能性があります (多少の遅延が発生する可能性があります)。 |
| フィルター処理機能 | テーブルに存在する行を一覧表示する |
テーブル アクションに存在するリスト行は、基本的なフィルター処理と並べ替えをサポートします。 - eq、 ne、 contains、 startswith、 endswithのフィルター関数をサポートします。- 列に適用できるフィルター関数は 1 つだけです。 - 並べ替えに使用できる列は 1 つだけです。 |
| 積み上げフィルター | テーブルに存在する行を一覧表示する | テーブルに存在するアクション リスト行を使用してフィルターを適用すると、既存のフィルターの上に追加されます。 |
| 非積み上げフィルター | テーブルに存在する行を一覧表示する | テーブル アクションに 存在するリスト行 を使用してフィルターを適用しない場合、Excel ファイルに既に設定されているフィルターは無視されます。 このアクションは、Excel の既存のフィルターに関係なく、すべての行を取得します。 |
| 改ページ | テーブルに存在する行を一覧表示する | テーブル アクションに存在するリスト行は、既定で最大 256 行を返します。 すべての行を取得するには、 改ページ位置をオンにします。 |
| 非必要な行を選択する | テーブルに存在する行を一覧表示する | コネクタは、テーブル アクションに存在するリスト行の最大 500 列の行を 取得します。 既定では、最初の 500 列の行が返されます。
Select Query パラメーターで取得する特定の列のコンマ区切りの一覧を指定できます。 |
| キー列フィールド名 |
テーブルにキー列を追加する 行を削除する 行を取得する 行を更新する |
キー列フィールドでは大文字と小文字が区別されます。 |
| 複数の行を更新または削除する |
行を削除する 行を更新する |
[ 行の更新 ] や [行の 削除] などの操作で複数の一致が発生した場合、最初の行のみが更新または削除されます。 |
| Microsoft Excel Macro-Enabled スプレッドシートのサポート | スクリプトの実行 | スクリプト の実行 アクションでは、Microsoft Excel Macro-Enabled スプレッドシート (*.xlsm) 形式もサポートされます。 詳細については、「 Power Automate フローでマクロ ファイルを使用する方法」を参照してください。 |
| テーブル列ヘッダーの制限 |
行を追加する 行を更新する 行を削除する |
行の追加、行の更新、行の削除などの操作によってコミットされた変更は、対応する Power Automate、LogicApps、または Power Apps アクションからの応答が成功した直後に常に影響を受けるわけではありません。 基になるバックエンド サービスの制限により、最大 30 秒の遅延が予想されます。 |
| スクリプト操作の実行に関する制限事項 | スクリプトの実行 | スクリプトの実行 操作では、10 秒あたり最大 3 回の呼び出しと、1 日あたり最大 1600 回の呼び出しが可能です。 |
| スクリプト操作ソブリン クラウドの実行のサポート | スクリプトの実行 | スクリプトの実行 操作は、ソブリン クラウド (Gcc、GccHigh、DoD、その他の上位のクラウドを含む) では使用できません。 |
一般的なエラー
| エラー | 解決策 |
|---|---|
| 403 許可されていません | ファイルに書き込みアクセス権があることを確認します。 |
| 502 BadGateway | スプレッドシートが読み取り専用モードの場合、これらのエラーが表示されます。 読み取り専用モードを無効にする方法については、「 Excel スプレッドシートを読み取り専用から変更する」を参照してください。 |
| 429 要求が多すぎます | これは、ユーザーが短期間に要求を多くする場合に発生します。 調整の制限は各要求に固有であり、要求数、使用されるメモリ、およびその他の重要な要因によって異なります。 調整が発生している場合は、コネクタ アクションに明示的な遅延を追加することをお勧めします。 Graph API の調整制限のため、これは複数の理由によって発生する可能性もあります。 1. フローからのグローバル要求数が制限を超えると、一部の要求が調整されます。 どの要求が調整され、Azure 調整ソリューションによってランダムに選択されない要求。 2. #1 の制限に達しなかった場合でも、さまざまな理由で調整される可能性があります。 調整の最も一般的な理由を次に示します。 a. SharePoint サービスの調整ポリシーにヒットします。 b。 たとえば、要求が多すぎるために操作キューがいっぱいになったなど、Excel Online サービス ポリシーにヒットします。 c. 要求は、予想よりも長い時間キューで保留中です。 たとえば、30 秒を超える要求は 504 を返し、504 を継続すると調整が発生する可能性があります。 d. ブック セッションで連続するエラーが多すぎます。 e. 操作 ID "RunScriptProd" で OfficeScripting に要求が行われ、それらの要求が 10 秒以内に 3 を超える場合は調整されます。 |
一般的な既知の問題と制限事項
- Excel Online (Business) コネクタでサポートされている Excel ファイルの最大サイズは 25 MB です。
- Excel ファイルは、最後にコネクタを使用してから最大 6 分間、更新または削除のためにロックされている場合があります。
- 他のコネクタによって同時にファイルを変更したり、手動で編集したりすることはできません。 ユーザーは、複数のクライアント (Excel Desktop、Excel Web、Power Automate、LogicApps、Power Apps) から 1 つの Excel ファイルに同時にデータを書き込むのを避ける必要があります。 これにより、マージの競合やデータの不整合が発生する可能性があります。
- このコネクタは、Microsoft Excel Open XML スプレッドシート (*.xlsx) および Microsoft Excel バイナリ ブック (*.xlxb) 形式のファイルをサポートします。
- コネクタのアクションで予期される
Fileプロパティは、次のいずれかのオプションを使用して入力する必要があります。- ファイル ピッカーからファイルを選択します。
- OneDrive for Business コネクタのトリガー/アクション (特定の OneDrive for Business のアクションまたはトリガーに存在するファイルの
IdまたはFile identifierプロパティ) からの出力を使用します。 - SharePoint コネクタのトリガー/アクション (特定の SharePoint のアクションまたはトリガーに存在するファイルの
IdまたはIdentifierプロパティ) からの出力を使用します。 - ドライブから始まるファイルへのパスを入力 します。 例:
- ファイルが OneDrive の下にあり、完全なパスが OneDrive/file.xlsx で 、Drive パラメーターが
OneDriveされている場合は、file.xlsxを入力 します 。 - ファイルが O365 グループ の下にあり、完全なパスが Documents/Inner Documents/file.xlsx で 、Drive パラメーターが
Documentsの場合は、 内部ドキュメント/file.xlsxを入力します。
- ファイルが OneDrive の下にあり、完全なパスが OneDrive/file.xlsx で 、Drive パラメーターが
- コネクタでは、非表示の列を含むテーブルに対する OData パラメーターの使用はサポートされていません。
- 複雑な数式がある場合、またはワークシートに行が多すぎる場合は、再計算によって発生するコネクタのタイムアウトが発生する可能性があります。 どちらの場合も、再試行ポリシーのためにデータを複数回挿入できます。 回避策として、数式を簡略化または縮小できるかどうかを確認してください。 それ以外の場合は、このブックの計算モードを [手動] に設定できます。 詳しくはこちらをご覧 ください。
-
Filter Query/Order By/Select Query操作パラメーターでは、英数字の列名のみがサポートされます。 - Graph API の制限により、ピボット テーブルはサポートされていません。
- コネクタは常に、[ドキュメント ライブラリ] ドロップダウン コントロールで使用できるすべてのドキュメント ライブラリを返します。 ほとんどのユーザーの場合、1 つのドキュメント ライブラリのみが返されますが、複数のドキュメント ライブラリが使用可能な場合は、それらのすべてが一覧表示されます。 ドキュメント ライブラリ (ドライブ リソースなど) とユーザー、グループ、サイトに対する予期される動作の詳細については、「 ドライブの一覧表示 - 解説」を参照してください。
- Power Apps でのテーブルのインポート中に [ 自動生成された ID を Excel テーブルに挿入 ] オプションが選択されている場合、コネクタは最大 64,000 行を自動的に設定できます。
- テーブルの列ヘッダーに数値のみが含まれていると、基になるバックエンド サービスの制限により 、行の更新、 行の削除 などの操作で予期しない動作が発生する可能性があります。 回避策として、他の文字も含まれるように、このような列の名前を変更します。
- "読み取り専用" アクションが実行された場合でも、Excel ファイルが変更され、新しいバージョンがファイルの バージョン履歴 に表示される場合があります。 この動作は、コネクタのバックエンド サービスの内部保存メカニズムが原因で設計されています。
- ゲスト ユーザーは、メイン ユーザーとは異なるテナントからドキュメントにアクセスできません。 この場合、ユーザーは HTTP 404 (見つかりません) エラーを受け取ります。
- Fairfax Logic Apps では、このコネクタは商用 (.com) アカウントを使用した接続のみをサポートします。
- SharePoint ファイルを使用できない場合があります。 Graph API は、ユーザーの IP アドレスを SharePoint に渡しません。 そのため、 場所ベースのポリシーが有効になっている場合、SharePoint はユーザーが信頼できる境界内にあるかどうかを判断できません。 このため、SharePoint ライブラリにアクセスすると、"組織のポリシーにより、このネットワークの場所からこれらのリソースにアクセスできません" というエラーが表示されることがあります。 詳しくはこちらをご覧 ください。
- ファイル ピッカーには、フォルダーあたり最大 200 個のアイテムのみが表示されます。 フォルダー内に 200 個を超えるアイテムがある場合、ユーザーはアイテムの検索に問題がある可能性があります。
- 504 エラーが継続的に発生する場合、Graph API の制限が異なるために調整が発生する可能性があります。 実行時間の長い操作で 504 を減らすための推奨事項を次に示します。
- 数式と依存関係を少なくして、テーブルをできるだけ単純に更新します。
- 行数が大きい場合は、同じテーブル形式の別の空のワークシート/ブックを使用します。
- ファイルへの書き込みアクセスはすべてのアクションに必要です。それ以外の場合、Graph API はエラー
403 Forbidden返します。 また、スプレッドシートが読み取り専用モードの場合、コネクタは502 BadGatewayエラーを返します。 読み取り専用モードを無効にするには、 こちらをご覧ください。 - 各コネクタ要求でサポートされる最大サイズは 5 MB です。
列名の処理
アクションの応答結果の列名は、OData 形式と互換性を持つために変換できます。
| Character | エンコードされた値 |
|---|---|
| . | _x002e_ |
| @ | _x0040_ |
| : | _x003a_ |
| # | _x0023_ |
たとえば、 Column [one]#1 ->Column [one]_x0023_1
全般的な制限
| 名前 | 価値 |
|---|---|
| 1 つの Excel テーブルから行を取得、挿入、更新、削除するために使用できる ID 列バリアントの最大数。 現在の値は 2 に設定されています。つまり、1 つの特定のテーブルのワークフロー間で最大 2 つの列名バリアントを使用する必要があります。 | 2 |
概念と例
- キー列: 値 (キー値) の検索に使用されるテーブル内の列。
- キー値: 特定の行を識別するために使用されるキー列の値。
次の表に例を示します。 テーブルの 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 |
調整制限
| 名前 | 呼び出し | 更新期間 |
|---|---|---|
| 接続ごとの API 呼び出し | 100 | 60 秒 |
アクション
|
Share |
Excel ブックに対して Office スクリプトを実行します。 スクリプトが既定の場所の外部に保存されている場合は、このアクションを使用します。 |
| スクリプトの実行 |
Excel ブックに対して Office スクリプトを実行します。 スクリプトが既定の場所に保存されている場合は、このアクションを使用します。 |
| テーブルにキー列を追加する |
Excel テーブルにキー列を追加します。 新しい列が右側に追加されます。 |
| テーブルに存在する行を一覧表示する |
テーブルに存在する行を一覧表示します。 |
| テーブルに行を追加する |
Excel テーブルに新しい行を追加します。 |
| テーブルに行を追加する [非推奨] |
このアクションは非推奨になりました。 代わりに 、テーブルに行を追加するを 使用してください。
|
| テーブルの作成 |
Excel ブックに新しいテーブルを作成します。 |
| テーブルを取得する |
Excel ブック内のテーブルの一覧を取得します。 |
| ワークシートを作成する |
Excel ブックに新しいワークシートを作成します。 |
| ワークシートを取得する |
Excel ブック内のワークシートの一覧を取得します。 |
| 行を削除する |
キー列を使用して行を削除します。 |
| 行を取得する |
キー列を使用して行を取得します。 |
| 行を更新する |
キー列を使用して行を更新します。 入力値によって指定されたセルが上書きされ、空白の列は更新されません。 値を (上書きではなく) 追加するには、"行の取得" アクションを使用してコンテンツを最初に取得します。 |
SharePoint ライブラリからスクリプトを実行する
Excel ブックに対して Office スクリプトを実行します。 スクリプトが既定の場所の外部に保存されている場合は、このアクションを使用します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
ブックの場所
|
source | True | string |
ドロップダウンから選択するか、"me" - "SharePoint Site URL" - "users/someone's UPN" - "groups/group ID" - "sites/SharePoint Site URL:/teams/team name:" のいずれかを指定します (コロンが必要です)。 |
|
ブック ライブラリ
|
drive | True | string |
ドロップダウンからドキュメント ライブラリを選択します。 |
|
ブック
|
file | True | string |
[ファイルの参照] を使用して Excel ブックを選択します。 |
|
スクリプトの場所
|
scriptSource | True | string |
ドロップダウンから選択するか、"me" - "SharePoint Site URL" - "users/someone's UPN" - "groups/group ID" - "sites/SharePoint Site URL:/teams/team name:" のいずれかを指定します (コロンが必要です)。 |
|
スクリプト ライブラリ
|
scriptDrive | True | string |
ドロップダウンから Office スクリプト ファイル (.osts) の SharePoint ライブラリを選択します。 |
|
スクリプト
|
scriptId | True | string |
ドロップダウンから SharePoint ライブラリの Office スクリプト ファイル (.osts) を選択します。 |
|
ScriptParameters
|
ScriptParameters | True | dynamic |
Office スクリプトのパラメーターを指定します。 |
戻り値
スクリプトの実行
Excel ブックに対して Office スクリプトを実行します。 スクリプトが既定の場所に保存されている場合は、このアクションを使用します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
ロケーション
|
source | True | string |
ドロップダウンから選択するか、"me" - "SharePoint Site URL" - "users/someone's UPN" - "groups/group ID" - "sites/SharePoint Site URL:/teams/team name:" のいずれかを指定します (コロンが必要です)。 |
|
ドキュメント ライブラリ
|
drive | True | string |
ドロップダウンからドキュメント ライブラリを選択します。 |
|
File
|
file | True | string |
[ファイルの参照] で Excel ファイルを選択します。 |
|
スクリプト
|
scriptId | True | string |
ドロップダウンから実行する Office スクリプトを選択します。 |
|
ScriptParameters
|
ScriptParameters | True | dynamic |
Office スクリプトのパラメーターを指定します。 |
戻り値
テーブルにキー列を追加する
Excel テーブルにキー列を追加します。 新しい列が右側に追加されます。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
ロケーション
|
source | True | string |
ドロップダウンから選択するか、"me" - "SharePoint Site URL" - "users/someone's UPN" - "groups/group ID" - "sites/SharePoint Site URL:/teams/team name:" のいずれかを指定します (コロンが必要です)。 |
|
ドキュメント ライブラリ
|
drive | True | string |
ドロップダウンからドキュメント ライブラリを選択します。 |
|
File
|
file | True | string |
[ファイルの参照] で Excel ファイルを選択します。 |
|
表
|
table | True | string |
ドロップダウンからテーブルを選択します。 |
|
キー列
|
idColumn | string |
キーの列名を指定します。 |
テーブルに存在する行を一覧表示する
テーブルに存在する行を一覧表示します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
ロケーション
|
source | True | string |
ドロップダウンから選択するか、"me" - "SharePoint Site URL" - "users/someone's UPN" - "groups/group Id" - "sites/SharePoint Site URL:/teams/team name:" のいずれかを指定します (コロンが必要です) |
|
ドキュメント ライブラリ
|
drive | True | 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 形式。 |
|
|
秘密度ラベルの抽出
|
extractSensitivityLabel | boolean |
関連付けられたアーティファクトの秘密度ラベル ID を抽出するかどうかを示すブール値。 |
|
|
秘密度ラベルのメタデータ
|
fetchSensitivityLabelMetadata | boolean |
関連付けられている LabelId の機密ラベル メタデータをフェッチするかどうかを示すブール値。 |
戻り値
テーブルに行を追加する
Excel テーブルに新しい行を追加します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
ロケーション
|
source | True | string |
ドロップダウンから選択するか、"me" - "SharePoint Site URL" - "users/someone's UPN" - "groups/group ID" - "sites/SharePoint Site URL:/teams/team name:" のいずれかを指定します (コロンが必要です)。 |
|
ドキュメント ライブラリ
|
drive | True | string |
ドロップダウンからドキュメント ライブラリを選択します。 |
|
File
|
file | True | string |
[ファイルの参照] で Excel ファイルを選択します。 |
|
表
|
table | True | string |
ドロップダウンからテーブルを選択します。 |
|
Row
|
item | True | dynamic |
指定した Excel テーブルに追加する行。 |
|
DateTime 形式
|
dateTimeFormat | string |
DateTime 形式。 |
戻り値
テーブルに行を追加する [非推奨]
このアクションは非推奨になりました。 代わりに 、テーブルに行を追加するを 使用してください。
Excel テーブルに新しい行を追加します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
ロケーション
|
source | True | string |
ドロップダウンから選択するか、"me" - "SharePoint Site URL" - "users/someone's UPN" - "groups/group ID" - "sites/SharePoint Site URL:/teams/team name:" のいずれかを指定します (コロンが必要です)。 |
|
ドキュメント ライブラリ
|
drive | True | string |
ドロップダウンからドキュメント ライブラリを選択します。 |
|
File
|
file | True | string |
[ファイルの参照] で Excel ファイルを選択します。 |
|
表
|
table | True | string |
ドロップダウンからテーブルを選択します。 |
|
Row
|
item | True | dynamic |
指定した Excel テーブルに挿入する行。 |
テーブルの作成
Excel ブックに新しいテーブルを作成します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
ロケーション
|
source | True | string |
ドロップダウンから選択するか、"me" - "SharePoint Site URL" - "users/someone's UPN" - "groups/group ID" - "sites/SharePoint Site URL:/teams/team name:" のいずれかを指定します (コロンが必要です)。 |
|
ドキュメント ライブラリ
|
drive | True | string |
ドロップダウンからドキュメント ライブラリを選択します。 |
|
File
|
file | True | string |
[ファイルの参照] で Excel ファイルを選択します。 |
|
テーブル名
|
TableName | string |
Excel テーブル名を入力します。 |
|
|
テーブル範囲
|
Range | True | string |
A1 表記を使用してテーブル アドレスを入力します。 |
|
列名
|
ColumnsNames | string |
';' または ',' で区切られた列名を入力します。 |
戻り値
テーブル メタデータ
- Body
- TableMetadata
テーブルを取得する
Excel ブック内のテーブルの一覧を取得します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
ロケーション
|
source | True | string |
ドロップダウンから選択するか、"me" - "SharePoint Site URL" - "users/someone's UPN" - "groups/group ID" - "sites/SharePoint Site URL:/teams/team name:" のいずれかを指定します (コロンが必要です)。 |
|
ドキュメント ライブラリ
|
drive | True | string |
ドロップダウンからドキュメント ライブラリを選択します。 |
|
File
|
file | True | string |
[ファイルの参照] で Excel ファイルを選択します。 |
|
秘密度ラベルの抽出
|
extractSensitivityLabel | boolean |
関連付けられたアーティファクトの秘密度ラベル ID を抽出するかどうかを示すブール値。 |
|
|
秘密度ラベルのメタデータ
|
fetchSensitivityLabelMetadata | boolean |
関連付けられている LabelId の機密ラベル メタデータをフェッチするかどうかを示すブール値。 |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
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 |
テーブル スタイル。 |
|
sensitivityLabelInfo
|
sensitivityLabelInfo | array of SensitivityLabelMetadata |
ワークシートを作成する
Excel ブックに新しいワークシートを作成します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
ロケーション
|
source | True | string |
ドロップダウンから選択するか、"me" - "SharePoint Site URL" - "users/someone's UPN" - "groups/group ID" - "sites/SharePoint Site URL:/teams/team name:" のいずれかを指定します (コロンが必要です)。 |
|
ドキュメント ライブラリ
|
drive | True | string |
ドロップダウンからドキュメント ライブラリを選択します。 |
|
File
|
file | True | string |
[ファイルの参照] で Excel ファイルを選択します。 |
|
名前
|
name | string |
ワークシート名。 |
戻り値
- Body
- WorksheetMetadata
ワークシートを取得する
Excel ブック内のワークシートの一覧を取得します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
ロケーション
|
source | True | string |
ドロップダウンから選択するか、"me" - "SharePoint Site URL" - "users/someone's UPN" - "groups/group ID" - "sites/SharePoint Site URL:/teams/team name:" のいずれかを指定します (コロンが必要です)。 |
|
ドキュメント ライブラリ
|
drive | True | string |
ドロップダウンからドキュメント ライブラリを選択します。 |
|
File
|
file | True | string |
[ファイルの参照] で Excel ファイルを選択します。 |
|
秘密度ラベルの抽出
|
extractSensitivityLabel | boolean |
関連付けられたアーティファクトの秘密度ラベル ID を抽出するかどうかを示すブール値。 |
|
|
秘密度ラベルのメタデータ
|
fetchSensitivityLabelMetadata | boolean |
関連付けられている LabelId の機密ラベル メタデータをフェッチするかどうかを示すブール値。 |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
value
|
value | array of WorksheetMetadata | |
|
sensitivityLabelInfo
|
sensitivityLabelInfo | array of SensitivityLabelMetadata |
行を削除する
キー列を使用して行を削除します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
ロケーション
|
source | True | string |
ドロップダウンから選択するか、"me" - "SharePoint Site URL" - "users/someone's UPN" - "groups/group Id" - "sites/SharePoint Site URL:/teams/team name:" のいずれかを指定します (コロンが必要です) |
|
ドキュメント ライブラリ
|
drive | True | string |
ドロップダウンからドキュメント ライブラリを選択します。 |
|
File
|
file | True | string |
[ファイルの参照] で Excel ファイルを選択します。 |
|
表
|
table | True | string |
ドロップダウンからテーブルを選択します。 |
|
キー列
|
idColumn | True | string |
ドロップダウンから列を選択します。 |
|
キー値
|
id | True | string |
キー値を入力します。 |
行を取得する
キー列を使用して行を取得します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
ロケーション
|
source | True | string |
ドロップダウンから選択するか、"me" - "SharePoint Site URL" - "users/someone's UPN" - "groups/group Id" - "sites/SharePoint Site URL:/teams/team name:" のいずれかを指定します (コロンが必要です) |
|
ドキュメント ライブラリ
|
drive | True | string |
ドロップダウンからドキュメント ライブラリを選択します。 |
|
File
|
file | True | string |
[ファイルの参照] で Excel ファイルを選択します。 |
|
表
|
table | True | string |
ドロップダウンからテーブルを選択します。 |
|
キー列
|
idColumn | True | string |
ドロップダウンから列を選択します。 |
|
キー値
|
id | True | string |
キー値を入力します。 |
|
DateTime 形式
|
dateTimeFormat | string |
DateTime 形式。 |
|
|
秘密度ラベルの抽出
|
extractSensitivityLabel | boolean |
関連付けられたアーティファクトの秘密度ラベル ID を抽出するかどうかを示すブール値。 |
|
|
秘密度ラベルのメタデータ
|
fetchSensitivityLabelMetadata | boolean |
関連付けられている LabelId の機密ラベル メタデータをフェッチするかどうかを示すブール値。 |
戻り値
行を更新する
キー列を使用して行を更新します。 入力値によって指定されたセルが上書きされ、空白の列は更新されません。 値を (上書きではなく) 追加するには、"行の取得" アクションを使用してコンテンツを最初に取得します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
ロケーション
|
source | True | string |
ドロップダウンから選択するか、"me" - "SharePoint Site URL" - "users/someone's UPN" - "groups/group Id" - "sites/SharePoint Site URL:/teams/team name:" のいずれかを指定します (コロンが必要です) |
|
ドキュメント ライブラリ
|
drive | True | string |
ドロップダウンからドキュメント ライブラリを選択します。 |
|
File
|
file | True | string |
[ファイルの参照] で Excel ファイルを選択します。 |
|
表
|
table | True | string |
ドロップダウンからテーブルを選択します。 |
|
キー列
|
idColumn | True | string |
ドロップダウンから列を選択します。 |
|
キー値
|
id | True | string |
キー値を入力します。 |
|
項目のプロパティを指定する
|
item | True | dynamic |
項目のプロパティを指定します。 |
|
DateTime 形式
|
dateTimeFormat | string |
DateTime 形式。 |
戻り値
トリガー
| 選択した行の場合 |
Excel テーブル内の選択した行のフローをトリガーします。 (Power Automate でのみ使用できます)。) |
選択した行の場合
Excel テーブル内の選択した行のフローをトリガーします。 (Power Automate でのみ使用できます)。)
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
operationId
|
operationId | True | string | |
|
ホスティング
|
host | object | ||
|
parameters
|
parameters | True | object | |
|
スキーマ
|
schema | True | object | |
|
headersSchema
|
headersSchema | object |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
行
|
body.rows | array of object | |
|
items
|
body.rows | object | |
|
ユーザー ID
|
headers.x-ms-user-id-encoded | guid |
AAD でフローをトリガーしたユーザーを表す一意識別子です。 |
|
ユーザーの電子メール
|
headers.x-ms-user-email-encoded | byte |
フローをトリガーしたユーザーの電子メール アドレス。 |
|
ユーザー名
|
headers.x-ms-user-name-encoded | byte |
フローをトリガーしたユーザーの表示名。 |
|
タイムスタンプ
|
headers.x-ms-user-timestamp | string |
フローがトリガーされた時刻。 |
定義
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 |
ワークシートの表示設定。 |
SensitivityLabelMetadata
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
sensitivityLabelId
|
sensitivityLabelId | string |
SensitivityLabel ID。 |
|
名前
|
name | string |
SensitivityLabel 名。 |
|
ディスプレイ名
|
displayName | string |
SensitivityLabel displayName info |
|
ヒント
|
tooltip | string |
ヒントの SensitivityLabel の詳細。 |
|
priority
|
priority | integer |
SensitivityLabel の優先度。 |
|
color
|
color | string |
SensitivityLabel の色。 |
|
暗号化されている
|
isEncrypted | boolean |
は SensitivityLabel Encrypted です。 |
|
有効化されている
|
isEnabled | boolean |
SensitivityLabel が有効かどうか。 |
|
isParent
|
isParent | boolean |
SensitivityLabel が親かどうか。 |
|
parentSensitivityLabelId
|
parentSensitivityLabelId | string |
親 SensitivityLabel ID。 |