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://officeapis.public.onecdn.static.microsoft/beta/office.js) とプレビューの種類の定義 @types/office-js-preview を使用するようにスニペットのライブラリを更新する必要があります。 さらに、一部のプレビュー API は、 Microsoft 365 Insider Program にサインアップし、Office の Insider ビルドを実行している場合にのみアクセスできます。

スニペットの保存と共有

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

スニペットを Script Lab にインポートするには、メニューから [インポート] を選択し、スニペットの完全な YAML を貼り付けます。 YAML を GitHub gist として保存している場合は、代わりに gist へのリンクを貼り付けることができます。

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

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

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

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

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

制限事項

Script Lab は、小さなコード サンプルで遊べるように設計されています。 通常、スニペットは最大で数百行、数千文字程度です。

スニペットではハードコードされたデータを使用できます。 少量のデータ (たとえば、数百文字) は Script Lab でハード コードしても問題ありません。 ただし、大きなデータの場合は、外部に保存してから、実行時に fetch などのコマンドで読み込むことをお勧めします。

複数の大きなスニペットを格納すると Script Lab のストレージを超え、Script Lab の読み込み時に問題が発生する可能性があるため、スニペットとハードコーディングされたデータは小さくしてください。

次の手順

Excel、PowerPoint、および Word 用の Script Lab を入手する

Outlook 用 Script Lab を取得する

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

問題

問題を発見したり、フィードバックがある場合は、お知らせください。

  • この記事に含まれている問題 この記事の最後にある「Office アドインのフィードバック」セクションを参照してください。
  • Script Lab コード サンプルに問題がありますか? office-js-snippets GitHub リポジトリで新しい問題を開きます。
  • Script Lab ツールに関するフィードバックまたは問題 office-js GitHub リポジトリで新しい問題を開きます。

関連項目

  • Last updated on