Script Lab を使用して Office JavaScript API を探索する

  • [アーティクル]

Script Labは、Office アドインを開発する方法を誰でも学ぶ無料のツールです。Script Labを使用すると、Excel、Outlook、PowerPoint、およびWordでドキュメントと共に Office JavaScript API をコーディングして実行できます。 この便利なツールを使用して、独自のアドインで必要な機能をプロトタイプ化して検証します。

Excel、PowerPoint、WordのScript Labを取得する

Outlook 用 Script Lab を取得する

この 1 分間の YouTube ビデオでは、Script Labの動作をご覧ください。 Excel、Word、PowerPoint で実行されているScript Labを示すプレビュー ビデオ。

Script Lab とは

Script Labは、アドインのプロトタイプ作成用のアドインです。Excel、Outlook、PowerPoint、Wordの Office JavaScript API を使用し、ドキュメント、スプレッドシート、または電子メール内の作業ウィンドウに配置されます。 Visual Studio Code で使用されるのと同じフレームワークに基づいて構築された IntelliSense 対応のコード エディターがあります。 Script Labを使用すると、サンプルのライブラリにアクセスできます。 機能をすばやく試すか、独自のコードの出発点としてこれらのサンプルを使用します。 プレビュー段階のScript Labで今後の API を試すことさえできます。

注:

Script Labは Office スクリプトとは無関係です。 Office スクリプト は、Excel のエンド ユーザーオートメーション用のツールです。 Web サービスとの統合を必要としない、迅速で再利用可能なソリューションが必要な場合は、Office スクリプトを使用します。

主な機能

Script Labには、アドイン機能のプロトタイプ作成や Office JavaScript API の探索に役立つさまざまな機能が用意されています。

サンプルの確認

API を使用してタスクを完了する方法を示す組み込みのサンプル スニペットのコレクションを使用してすぐに開始できます。 サンプルを実行して作業ウィンドウまたはドキュメントの結果をすぐに確認し、サンプルを調べて API のしくみを確認し、サンプルを使用して独自のアドインをプロトタイプ化することもできます。

サンプル。

コードとスタイル

Office JS API を呼び出す JavaScript または TypeScript コードに加えて、各スニペットには、作業ウィンドウのコンテンツを定義する HTML マークアップと、作業ウィンドウの外観を定義する CSS も含まれています。 HTML マークアップと CSS をカスタマイズして、独自のアドインの作業ウィンドウデザインをプロトタイプ化するときに、要素の配置とスタイルを試します。

プレビュー API

スニペット内でプレビュー API を呼び出すには、ベータ コンテンツ配信ネットワーク (CDN) (https://appsforoffice.microsoft.com/lib/beta/hosted/office.js) とプレビューの種類の定義 を使用するようにスニペットのライブラリを更新する必要があります @types/office-js-preview。 さらに、一部のプレビュー API には、 Microsoft 365 Insider プログラム にサインアップし、Office の Insider ビルドを実行している場合にのみアクセスできます。

スニペットの保存と共有

既定では、Script Labで開くスニペットは、ブラウザー のキャッシュまたはローカル ストレージに保存されます。 スニペットを完全に保存するには、[ コピー ] を選択し、結果のクリップボードコンテンツを新しい.yml ファイルに貼り付けます。 これは、同僚とスニペットを共有したり、Stack Overflow などのコミュニティ サイトのコードを提供したりするために使用します。

スニペットをScript Labにインポートするには、メニューから [インポート] を選択し、スニペットの完全な YAML を貼り付けます。

サポートされるクライアント

Script Lab は、次のクライアント上の Excel、Word、PowerPoint でサポートされています。

  • Office on Windows*
  • Office on Mac
  • Office on the web

Outlook 用 Script Lab は、次のクライアントで使用できます。

  • Outlook on Windows*

  • Outlook on Mac

  • Chrome、Microsoft Edge、または Safari ブラウザーを使用している場合の Outlook on the web

    注:

    Chrome や Edge などの Chromium ベースのブラウザーのバージョン 115 以降では、ストレージのパーティション分割がテストされ、特定のサイド チャネルクロスサイト追跡を防ぎます (「Microsoft Edge ブラウザー ポリシー」も参照)。 この変更により、Script Lab スニペットがOutlook on the webで実行されなくなります。 これを回避するには、ブラウザー で [chrome://flags ] または [edge://flags ] に移動し、[ サード パーティの記憶域パーティション分割 (#third-party-storage-partitioning)] フラグを[無効] に設定します。

重要

* Script Labは、Trident (インターネット エクスプローラー) Webview を使用してアドインをホストするプラットフォームと Office バージョンの組み合わせでは機能しなくなりました。これには、Office 2019 を通じた Office の永続的なバージョンが含まれます。 詳細については、「 Office アドインで使用されるブラウザーと Webview コントロール」を参照してください。

次の手順

Excel、PowerPoint、WordのScript Labを取得する

Outlook 用 Script Lab を取得する

Script Labでコードをプロトタイプ化したら、「Script Lab コードからスタンドアロン Office アドインを作成する」の手順で実際のアドインに変換します。

関連項目