Office Scripts を使用したプラットフォームの制限と要件

  • [アーティクル]

Office Scripts を開発する際に注意する必要があるプラットフォームの制限がいくつかあります。 この記事では、Excel 用 Office スクリプトのブラウザーのサポートとデータ制限について詳しくは、こちらの記事をご覧ください。

プラットフォーム サポート

Office スクリプトを使用するには、以下が必要です。

  1. Excel on the web、Excel for Windows (バージョン 2210 以降)、またはExcel for Mac。
  2. OneDrive for Business。
  3. 次のいずれかの Microsoft 365 サブスクリプション ライセンス:
    • Office 365 Business
    • Office 365 Business Premium
    • Office 365 ProPlus
    • Office 365 ProPlus デバイス用
    • Office 365 A3
    • Office 365 A5
    • Office 365 Enterprise E1
    • Office 365 Enterprise E3
    • Office 365 Enterprise E5
    • Office 365 F3
  4. 接続されたエクスペリエンスが有効になっているインターネット接続。

注:

これらの条件を満たしているにもかかわらず [自動化] タブが表示されない場合は、管理者が機能を無効にしているか、ご利用の環境に何らかの問題がある可能性があります。 「Automate tab not appearing or Office Scripts unavailable (自動化タブが表示されない、または Office スクリプトを使用できない)」の手順に従い、Office スクリプトの使用を開始してください。

重要

Power Automate で Office スクリプトを使用するには、Microsoft 365 のビジネス ライセンスが必要です。 Office 365 Enterprise E1 ライセンスと Office 365 F3 ライセンスでは、Power Automate でスクリプトを使用できますが、Excel で Power Automate を直接統合することはできません。

データの上限

一度に転送できる Excel データの量と、実行できる個々の Power Automate トランザクションの数には制限があります。

Excel

Excel on the webスクリプトを使用してブックを呼び出す場合、次の制限があります。

  • 要求と応答は 5 MB に制限されています。
  • 範囲は500 万セルに制限されます。

いずれかの Excel データ制限を超えると、"応答ペイロード のサイズが制限を超えました" というエラー メッセージが表示されます。

大規模なデータセットを処理するときにエラーが発生する場合は、より大きな範囲ではなく、複数の小さい範囲を使用してみてください。 例としては、「大規模なデータセットの書き込み」のサンプルを参照してください。 Range.getSpecialCells などの API を使用して、大きな範囲ではなく特定のセルをターゲットにすることもできます。

Office スクリプトに固有ではない Excel の制限については、 Excel の仕様と制限に関する記事を参照してください。

Power Automate

Power Automate プラットフォームでは、次の制限事項が発生する可能性が最も高くなります。

Power Automate プラットフォームの使用に関するその他の制限事項については、次の記事を参照してください。

Power Automate の特定の制限

Excel アプリケーションでスクリプトを実行することと、Power Automate フローの一部としてスクリプトを実行する場合には、いくつかの重要な違いがあります。

スクリプトからの外部呼び出しなし

スクリプトが Power Automate を介して実行されると、外部 API 呼び出しは失敗します。 fetch呼び出しでは、"ランタイム エラー: 行 X: フェッチが定義されていません" というエラー メッセージが表示されます。 このような参照のスクリプトをフローに組み込む前に、必ずスクリプトをチェックしてください。

Azure AD またはその他の同等のアクション で HTTP を使用して、データを外部サービスからプルまたはプッシュする必要があります。

警告

Power Automate Excel Online コネクタ を介して行われた外部呼び出しは、既存のデータ損失防止ポリシーを維持するために失敗します。 ただし、Power Automate を介して実行されるスクリプトは、organizationの外部、およびorganizationのファイアウォールの外部で実行されます。 この外部環境の悪意のあるユーザーからの保護を強化するために、管理者は Office スクリプトの使用を制御できます。 管理者は、Power Automate で Excel Online コネクタを無効にするか、Office スクリプト管理者コントロールを使用して Office スクリプト for Excel をオフにすることができます。

API の動作の違い

Power Automate を使用して実行すると、一部の API の動作が異なります。 他のユーザーは、Excel UI に依存しているために失敗します。 完全な一覧については、「 Power Automate で実行されている Office スクリプトのトラブルシューティング」を参照してください。

ISO 厳密な Open XML ブックはサポートされていません

Excel Business (Online) コネクタの [スクリプトの実行] アクションでは、ISO 厳密なバージョンの Excel ブック ファイル形式のブックはサポートされていません。 この種類のブックを含むフローでは、スクリプトを実行しようとすると "BadGateway" エラーが返されます。 これは、共同編集の制限が原因です。 Power Automate で使用するために、ブックを標準の Excel ブック形式として保存してください。

Teams のサポート

重要

Teams で Excel を使用する場合、Office スクリプトは Teams on the web でのみサポートされます (Windows、Mac、iOS、Android 用の Teams ではサポートされません)。

政府機関向けクラウド サポート

GCC High 以上では、Office スクリプトはサポートされていません。 スクリプトからの外部呼び出しは、他の政府機関クラウドのファイアウォール設定の影響を受ける可能性があります。

Excel on the webのサードパーティ Cookie

Excel on the Web で [自動化] タブを表示するには、ブラウザーでサード パーティの Cookie が有効になっている必要があります。 タブが表示されていない場合は、ブラウザーの設定を確認します。 プライベート ブラウザー セッションを使用している場合は、毎回この設定を再度有効にする必要があります。

注:

一部のブラウザーでは、"サード パーティの Cookie" ではなく、この設定を "すべての Cookie" と呼んでいます。

条件付きアクセス

条件付きアクセス ポリシーは、 管理されていないデバイスの SharePoint と OneDrive へのアクセスを制限します。 デバイスがテナントによって管理されていない場合は、特定のスクリプトにアクセスできない場合や、ブラウザー経由でのみアクセスできる場合があります。

条件付きアクセス ポリシーによってスクリプトがブロックされている場合は、2 つのエラー メッセージのいずれかが表示されます。 これらのメッセージは、フローがアンマネージド デバイスから実行されている場合、Power Automate にも表示されます。

  • "組織のポリシーのため、この信頼されていないデバイスからこのリソースにアクセスすることはできません。
  • "このスクリプトは見つかりません。 別のユーザーによって削除された可能性があります。(お使いのバージョンの Excel が古い場合)。

重要

管理者は、管理されていないデバイスから Power Automate へのすべてのアクセスをブロックすることを検討する必要があります。 このプロセスの詳細については、ブログ記事「 Azure AD 条件付きアクセス ポリシーを使用した Power Apps と Power Automate へのアクセスの制御」を参照してください。

以前のバージョンの Excel での API サポート

一部の Office スクリプト API は、Excel for Windows または Excel for Mac (特に古いビルド) でサポートされていない場合があります。 これには、Web 専用機能用の新しい API と API が含まれます。 スクリプトにサポートされていない API が含まれている場合、コード エディターに警告が表示されます。 このようなスクリプトを実行しようとすると、実行されません。 代わりに、[スクリプトの実行状態] 作業ウィンドウに、"このスクリプトは現在、Excel for the webで実行する必要があります。 ブラウザーでブックを開き、もう一度やり直すか、スクリプト所有者に問い合わせてヘルプを確認してください。

古いバージョンの Excel を使用して、共有されているスクリプトを含むブックを開く場合、スクリプト自体には影響しません。

関連項目