Script Lab を使用して Office JavaScript API を探索する
スクリプト ラボは、Office アドインを開発する方法を誰でも学ぶ無料のツールです。スクリプト ラボを使用すると、Excel、Outlook、PowerPoint、Word でドキュメントと共に Office JavaScript API をコーディングして実行できます。 この便利なツールを使用して、独自のアドインで必要な機能をプロトタイプ化して検証します。
この 1 分間の YouTube ビデオの「スクリプト ラボの動作」を参照してください。
Script Lab とは
スクリプト ラボは、アドインのプロトタイプ作成用のアドインです。Excel、Outlook、PowerPoint、Word で Office JavaScript API を使用し、ドキュメント、スプレッドシート、またはメール内の作業ウィンドウに配置されます。 Visual Studio Code で使用されるのと同じフレームワークに基づいて構築された IntelliSense 対応のコード エディターがあります。 スクリプト ラボを使用すると、サンプルのライブラリにアクセスできます。 機能をすばやく試すか、独自のコードの出発点としてこれらのサンプルを使用します。 プレビュー段階のスクリプト ラボで今後の API を試すことさえできます。
注:
スクリプト ラボ は 、Office スクリプトとは無関係です。 Office スクリプト は、Excel のエンド ユーザーオートメーション用のツールです。 Web サービスとの統合を必要としない、迅速で再利用可能なソリューションが必要な場合は、Office スクリプトを使用します。
主な機能
スクリプト ラボには、アドイン機能のプロトタイプ作成と 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 ビルドを実行している場合にのみアクセスできます。
スニペットの保存と共有
既定では、スクリプト ラボで開くスニペットは、ブラウザー のキャッシュまたはローカル ストレージに保存されます。 スニペットを完全に保存するには、[ コピー ] を選択し、結果のクリップボードコンテンツを新しい.yml ファイルに貼り付けます。 これは、同僚とスニペットを共有したり、Stack Overflow などのコミュニティ サイトのコードを提供したりするために使用します。
スクリプト ラボにスニペットをインポートするには、メニューから [インポート ] を選択し、スニペットの完全な 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
注:
Chrome や Edge などの Chromium ベースのブラウザーのバージョン 115 以降では、 ストレージパーティション分割 がテストされ、特定のサイドチャネルクロスサイト追跡を防ぎます ( 「Microsoft Edge ブラウザー ポリシー」も参照)。 この変更により、Outlook on the web でスクリプト ラボ スニペットが実行されなくなります。 これを回避するには、ブラウザー で [chrome://flags ] または [edge://flags ] に移動し、[ サード パーティの記憶域パーティション分割 (#third-party-storage-partitioning)] フラグを[無効] に設定します。
Outlook on Windows*
Outlook on Mac
重要
* スクリプト ラボは、Trident (Internet Explorer) Webview を使用してアドインをホストするプラットフォームと Office バージョンの組み合わせでは機能しなくなりました。これには、Office 2019 を通じた Office の永続的なバージョンが含まれます。 詳細については、「 Office アドインで使用されるブラウザーと Webview コントロール」を参照してください。
次の手順
スクリプト ラボでコードをプロトタイプ化したら、「スクリプト ラボ コードからスタンドアロン Office アドインを作成する」の手順に従って、実際のアドインに変換します。
関連項目
Office Add-ins
フィードバック
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「https://aka.ms/ContentUserFeedback」を参照してください。
フィードバックの送信と表示