Azure ワークブックを作成または編集する

2025-04-30

この記事では、新しいブックを作成する方法と、Azure ブックに要素を追加する方法について説明します。

このビデオでは、ワークブックの作成を順を追って説明しています。

新しい Azure ワークブックを作成する

新しい Azure ワークブックを作成するには:

Azure Workbooks ページで、空のテンプレートを選択するか、上部のツールバーの [新規] を選択します。
任意の要素を組み合わせてワークブックに追加してください。
- テキスト
- イメージ
- ビデオ
- パラメーター
- クエリ
- メトリックグラフ
- リンク
- グループ
- 構成オプション

注

ブックに新しい要素を追加するには、ツールバーの [編集 ] を選択して編集モードになっていることを確認します。

テキストの追加

ブックでは、作成者が自分のブックにテキストブロックを含めることができます。テキストは、人間によるデータ分析、ユーザーがデータを解釈するのに役立つ情報、セクションの見出しなどです。

テキストは、作成者がコンテンツを追加できるマークダウンコントロールを通じて追加されます。作成者は、マークダウンの完全な書式設定機能を使用できます。これらの機能には、さまざまな見出しとフォントスタイル、ハイパーリンク、テーブルなどが含まれます。Markdown を使用すると、作成者は Word やポータルのような豊富なレポートや分析のストーリーを作成できます。テキストのマークダウンテキストにはパラメーター値を含めることができます。これらのパラメーター参照は、パラメーターの変更に応じて更新されます。

編集モード:

プレビューモード:

Azure ブックにテキストを追加するには、次の手順を実施します。

次のいずれかの手順を実行して、テキストステップを追加します。
- [追加] を選択し、既存の要素の下、またはブックの下部にある [テキストの追加] を選択します。
- ブック内のいずれかの要素の横にある [編集] ボタンの右側の省略記号 (...) を選択し、[追加] を選択して、[テキストの追加] を選択します。
エディターフィールドにマークダウンテキストを入力します。
[テキストのスタイル] オプションを使用して、プレーンマークダウンと、Azure portal 標準の情報/警告/成功/エラーのスタイル設定でラップされたマークダウンを切り替えます。

ヒント

さまざまな書式設定オプションについては、こちらの「マークダウンのチートシート」を参照してください。
[プレビュー] タブを使用して、コンテンツの表示を確認します。プレビューでは、コンテンツがスクロール可能な領域内に表示され、そのサイズが制限されます。しかし、実行時に表示する場合は、マークダウンコンテンツが必要な領域内全体に拡張され、スクロールバーなしで表示されます。
[編集完了] を選択します。

テキストスタイル

次のテキストスタイルを使用できます。

スタイル	説明
平地	書式は適用されません。
インフォ	ポータルの "情報" スタイル。`ℹ` または類似のアイコンと、青の背景
エラー	ポータルの "エラー" スタイル。`❌` または類似のアイコンと、赤の背景
success	ポータルの "成功" スタイル。`✔` または類似のアイコンと、緑の背景
アップセル	ポータルの「アップセル」スタイルは、`🚀` や類似のアイコンと、紫の背景で表現されます。
警告	ポータルの "警告" スタイル。`⚠` または類似のアイコンと、青の背景

テキストパラメーターをスタイルのソースとして選択することもできます。パラメーター値は、上記のテキスト値のいずれかである必要があります。値がない場合、または認識されない値は、 plain スタイルとして扱われます。

テキストスタイルの例

情報スタイルの例: 情報スタイルを示すプレビューモードでブックにテキストを追加する画面。

警告スタイルの例:

クエリを追加する

Azure Workbooks では、サポートされている任意のワークブックのデータソースをクエリできます。

たとえば、Azure Resource Health にクエリを実行して、リソースに影響を与えるサービスの問題の確認に役立てることができます。定期的に収集された数値データである Azure Monitor メトリックに対してクエリを実行することもできます。 Azure Monitor メトリックは、特定の時点でのシステムの側面に関する情報を提供します。

Azure ブックにクエリを追加するには、次の手順を実施します。

次のいずれかの手順を実行してクエリを追加します。
- [追加] を選択し、既存の要素の下、またはブックの下部にある [クエリの追加] を選択します。
- ブック内のいずれかの要素の横にある [編集] ボタンの右側の省略記号 (...) を選択し、[追加] を選択して、[クエリの追加] を選択します。
クエリのデータソースを選択します。その他のフィールドは、選択したソースに基づいて決定されます。
選択したデータソースに基づいて、必要なその他の値を選択します。

注

リソースの種類を選択するときは、ユーザーのアクセス許可を検討してください。たとえば、リソースの 読み取り アクセス許可を持っていて、リソースがテレメトリを送信している Log Analytics ワークスペースに対しては読み取りアクセス許可がない場合は、リソースの種類のリソースを選択してデータを表示する必要があります。
ブックの視覚化を選択します。
[クエリ] セクションで、クエリを入力するか、[サンプル] を選択してサンプルクエリの一覧からクエリを選択し、好みに合わせてクエリを編集します。
[クエリの実行] を選択します。
ブックに必要なクエリがあることを確認したら、[編集が完了しました] を選択します。

ログのクエリを実行するためのベストプラクティス

集計ルールを事前に定義して、視覚化するデータを集計します。 大規模なデータセットや長い時間範囲に対してクエリを実行する代わりに、集計ルールを作成して、データが Log Analytics ワークスペースに到着したら 1 つ以上のテーブルから必要なデータを集計します。集計データを 1 つ以上のテーブルから生データに対してクエリするのではなく、集計データをカスタムテーブルから直接視覚化すると、クエリのパフォーマンスが向上し、クエリエラーとタイムアウトが削減されます。
可能な限り最小の時間範囲を使用します。 時間範囲が長いほど、クエリの速度が低下し、返されるデータが多くなります。時間範囲が長い場合、クエリはより低速の "コールド" ストレージに移動する必要があり、クエリがさらに遅くなる可能性があります。有効な最短の時間範囲を既定値に設定しますが、遅くなる可能性があるより長い時間範囲をユーザーが選択できるようにします。
ドロップダウンで特殊値 "All" を使用します。 ドロップダウンパラメーター設定で特殊項目 All を追加できます。特殊値を使用できます。特殊項目 All を正しく使用すると、クエリが大幅に簡略化されます。
欠落している列から保護します。 カスタムテーブルまたはカスタム列を使用している場合は、ワークスペースに列が存在しない場合に機能するようにテンプレートを設計します。 column_ifexists 関数を参照してください。
欠落しているテーブルから保護します。 テンプレートがソリューションの一部としてインストールされている場合、またはテーブルが存在することが保証されている場合は、欠落している列をチェックする必要はありません。任意のリソースまたはワークスペースで表示できる汎用テンプレートを作成する場合は、存在しないテーブルを保護することをお勧めします。

ログ分析クエリ言語には、table_ifexists 関数のような、列をテストするための関数がありません。ただし、テーブルが存在するかどうかを確認する方法はいくつかあります。たとえば、あいまいな和集合を使用できます。和集合を実行する場合は、isfuzzy=true 設定を使用して、一部のテーブルが存在しない場合に和集合を継続させることができます。テーブルの存在をチェックするパラメータークエリをブックに追加し、存在しない場合は一部のコンテンツを非表示にすることができます。表示されない項目は実行されないため、テーブルが存在するかどうかを検証するテストがクリアされるまでは、テーブルがないと失敗する可能性のあるブック内の他のクエリが実行されないようにテンプレートを設計できます。

次に例を示します。
```
let MissingTable = view () { print isMissing=1 };
union isfuzzy=true MissingTable, (AzureDiagnostics | getschema | summarize c=count() | project isMissing=iff(c > 0, 0, 1))
| top 1 by isMissing asc
```
AzureDiagnostics テーブルがワークスペースに存在しない場合、このクエリは 1 を返します。実際のテーブルが存在しない場合は、 MissingTable の偽の行が返されます。 AzureDiagnostics テーブルのスキーマに列が存在する場合は、0 が返されます。これをパラメーター値として使用し、パラメーター値が 0 でない限り、条件付きでクエリステップを非表示にすることができます。条件付き可視性を使用して、現在のワークスペースに欠落しているテーブルがないことを示すテキストを表示し、オンボード方法に関するドキュメントにユーザーを送ることもできます。

ステップを非表示にする代わりに、結果として行を非表示にしたい場合があります。 MissingTable を、適切な一致するスキーマを持つ空のデータテーブルに変更できます。
```
let MissingTable = datatable(ResourceId: string) [];
union isfuzzy=true MissingTable, (AzureDiagnostics
| extend ResourceId = column_ifexists('ResourceId', '')
```
この場合、AzureDiagnostics テーブルが見つからない場合、またはテーブルに ResourceId 列がない場合、クエリは行を返しません。

チュートリアル - ワークブック内のリソース中心のログクエリ

このビデオでは、Azure Workbooks でリソースレベルのログクエリを使用する方法について説明します。また、高度なシナリオを有効にして、パフォーマンスを向上させる方法についてのヒントとテクニックも示します。

動的リソースタイプパラメーター

より効率的にクエリを実行するために動的スコープが使用されます。以下のスニペットでは、次のヒューリスティックが使用されています。

"個々のリソース": 選択したリソースの数が 5 以下の場合
"リソースグループ": リソースの数が 5 を超えている一方で、リソースが属するリソースグループの数が 3 以下の場合
"サブスクリプション": それ以外の場合

Resources
| take 1
| project x = dynamic(["microsoft.compute/virtualmachines", "microsoft.compute/virtualmachinescalesets", "microsoft.resources/resourcegroups", "microsoft.resources/subscriptions"])
| mvexpand x to typeof(string)
| extend jkey = 1
| join kind = inner (Resources
| where id in~ ({VirtualMachines})
| summarize Subs = dcount(subscriptionId), resourceGroups = dcount(resourceGroup), resourceCount = count()
| extend jkey = 1) on jkey
| project x, label = 'x',
    selected = case(
        x in ('microsoft.compute/virtualmachinescalesets', 'microsoft.compute/virtualmachines') and resourceCount <= 5, true,
        x == 'microsoft.resources/resourcegroups' and resourceGroups <= 3 and resourceCount > 5, true,
        x == 'microsoft.resources/subscriptions' and resourceGroups > 3 and resourceCount > 5, true,
        false)

複数のリソースタイプに対してクエリを実行するための静的リソーススコープ

[
    { "value":"microsoft.compute/virtualmachines", "label":"Virtual machine", "selected":true },
    { "value":"microsoft.compute/virtualmachinescaleset", "label":"Virtual machine scale set", "selected":true }
]

リソースタイプ別にグループ化されたリソースパラメーター

Resources
| where type =~ 'microsoft.compute/virtualmachines' or type =~ 'microsoft.compute/virtualmachinescalesets'
| where resourceGroup in~({ResourceGroups})
| project value = id, label = id, selected = false,
    group = iff(type =~ 'microsoft.compute/virtualmachines', 'Virtual machines', 'Virtual machine scale sets')

パラメーターを追加する

パラメーターを使用して、消費者からの入力を収集し、ワークブックの他の部分でそれを参照できます。結果セットのスコープを設定したり、適切なビジュアルを設定したりするためにパラメーターを使用します。パラメーターは、対話型のレポートとエクスペリエンスを構築するのに役立ちます。パラメーターの使用方法の詳細については、「ブックのパラメーター」を参照してください。

ブックを使用すると、パラメーターのコントロールがコンシューマーにどのように表示されるか (テキストボックスかドロップダウンか、単一選択か複数選択か、テキスト、JSON、KQL、Azure Resource Graph からの値など) を制御できます。

このビデオで Azure Workbooks でパラメーターとログデータを使用する方法について確認してください。

Azure ブックにパラメーターを追加するには、次の手順を実施します。

次のいずれかの手順を実行してパラメーターを追加します。
- [追加] を選択し、既存の要素の下、またはブックの下部にある [パラメーターの追加] を選択します。
- ブック内のいずれかの要素の横にある [編集] ボタンの右側の省略記号 (...) を選択し、[追加] を選択して、[パラメーターの追加] を選択します。
ポップアップ表示される新しいパラメーターペインで、次のフィールドに値を入力します。
- パラメーター名: パラメーター名にスペースや特殊文字を含めることはできません
- 表示名: 表示名にはスペース、特殊文字、絵文字などを含めることができます
- パラメーターの種類
- 必須:
[編集完了] を選択します。

メトリックグラフを追加する

ほとんどの Azure リソースでは、状態と正常性に関するメトリックデータが生成されます (CPU 使用率、ストレージの可用性、データベーストランザクションの数、失敗したアプリ要求の数など)。ブックを使用すると、メトリックデータを時系列グラフとして視覚化できます。

次の例では、過去 1 時間におけるストレージアカウントでのトランザクション数が表示されます。これを使用して、ストレージ所有者はトランザクションの傾向を確認し、動作の異常を調べることができます。

ストレージトランザクションのメトリックエリアチャートをワークブックに表示するスクリーンショット。

Azure ブックにメトリックグラフを追加するには、次の手順を実施します。

次のいずれかの手順を実行して、メトリックグラフを追加します。
- [追加]を選択し、既存の要素の下またはブックの下部にある[メトリックの追加]を選択してください。
- ブック内のいずれかの要素の横にある [編集] ボタンの右側の省略記号 (...) を選択し、[追加] を選択して、[メトリックの追加] を選択します。
リソースの種類、ターゲットにするリソース、メトリックの名前空間と名前、および使用する集計を選択します。
必要に応じて他のパラメーターを設定します (時間範囲、分割基準、視覚化、サイズ、カラーパレットなど)。
[編集完了] を選択します。

これは、編集モードのメトリックグラフです。

メトリックチャートのパラメーター

パラメーター	説明	例
リソースの種類	ターゲットとするリソースの種類	ストレージまたは仮想マシン。
リソース	メトリック値の取得元となるリソースのセット	MyStorage1
名前空間	メトリックがある名前空間	[ストレージ] > [BLOB]
メトリック	視覚化するメトリック	[ストレージ] > [BLOB] > [トランザクション]
集約	メトリックに適用する集計関数	合計、カウント、平均など
時間の範囲	メトリックを表示する時間範囲	過去 1 時間、過去 24 時間など
視覚化	使用する視覚化	面、横棒、折れ線、散布図、グリッド
分割基準	必要に応じて、ディメンションのメトリックを分割します	Geo の種類別のトランザクション
サイズ	コントロールの垂直方向のサイズ	小、中、または大
[色パレット]	チャートで使用するカラーパレット。 `Split by` パラメーターが使用されている場合は無視されます	青、緑、赤など

メトリックグラフの例

折れ線グラフとして API 名で分割されたトランザクション

トランザクションは、大きな横棒グラフとして応答の種類によって分割されます

散布図としての平均待機時間

リンクを追加する

リンクを使用して、他のビュー、ブック、ブック内の他の項目へのリンクを作成したり、ブック内にタブ付きビューを作成したりできます。リンクには、ハイパーリンク、ボタン、およびタブというスタイルを設定できます。

このビデオで、Azure Workbooks でタブ、グループ、コンテキストリンクを使用する方法について確認してください。

リンクのスタイル

リンク要素自体と個々のリンクに、スタイルを適用できます。

リンク要素のスタイル

スタイル	サンプル	メモ
箇条書きリスト		既定では、リンクは、各行に 1 つずつ、リンクの箇条書きとして表示されます。 [リンクの前のテキスト] と [リンクの後のテキスト] のフィールドを使用して、リンク項目の前後にテキストをさらに追加できます。
一覧		リンクは、箇条書きなしでリンクの一覧として表示されます。
段落		リンクは、テキストの段落のように折り返されて、リンクの段落として表示されます。
「ナビゲーション」	スクリーンショット：ナビゲーションスタイルのワークブックリンク。	リンクはリンクとして表示され、各リンク間に垂直分割線またはパイプ (\|) が表示されます。
タブ		リンクはタブとして表示されます。各リンクはタブとして表示され、個々のリンクにはリンクのスタイル設定オプションが適用されません。タブを構成する方法については、以下の「タブ」セクションを参照してください。
ツールバー		リンクには、アイコンとテキストを含む Azure portal スタイルのツールバーが表示されます。各リンクはツールバーボタンとして表示されます。ツールバーを構成する方法については、以下の「ツールバー」セクションを参照してください。

リンクのスタイル

スタイル	説明
リンク	既定では、リンクはハイパーリンクとして表示されます。 URL リンクに設定できるのは Link スタイルのみです。
ボタン (プライマリ)	リンクはポータルの "プライマリ" ボタン (通常は青い色) として表示されます。
ボタン (サブ)	リンクはポータルの "セカンダリ" ボタン (通常は "透明な" 色でライトテーマでは白いボタン、ダークテーマでは濃い灰色のボタン) として表示されます。

必須パラメーターがボタンテキスト、ヒントテキスト、または値フィールドで使用され、かつボタンを使用するときに必須パラメーターが設定されていない場合、ボタンは無効になります。この機能を使用すると、たとえば、別のパラメーターまたはコントロールで値が選択されていないときにボタンを無効にできます。

リンクの操作

リンクは、リンクアクションで使用できるすべてのリンクアクションを使用でき、さらに 2 つのアクションを使用できます。

アクション	説明
パラメーター値の設定	ブックユーザーがリンク、ボタン、またはタブを選択するときに、パラメーターを値に設定できます。多くの場合、タブはパラメーターを値に設定するように構成され、その値に基づいてブックの他の部分が非表示になり、表示されます。
あるステップまでスクロールする	ワークブックのユーザーがリンクを選択すると、ワークブックはフォーカスを移動して、スクロールし、別のステップを見えるようにします。このアクションを使用して、"目次" や "トップに戻る" というスタイルの操作性を実現できます。

タブ

ほとんどの場合、タブリンクは [パラメーター値を設定します] アクションと組み合わせられます。

タブを作成する

Azure ブックにタブを追加するには:

[ 追加]>[リンク/タブの追加] を選択します。
スタイルをタブに設定します。
各 タブのタブ名 を入力します。
[ アクション ] 列で、[各タブ のパラメーター値の設定 ] を選択します。
[ 値 ] 列で、各タブ に同じパラメーター名 (たとえば、 selectedTab) を設定します。
[ 設定] 列に、タブごとに 異なる値を入力 します。

2 つのタブを作成するように構成された例を次に示します。ここで、いずれかのタブを選択すると selectedTab パラメーターが別の値に設定されます。

注

この例では、パラメーター名とパラメーター値のプレースホルダーを表示するために編集中の 3 番目のタブのみを示しています。

上記のタブがあるサンプルブックは、リンクを含む Azure ブックのサンプルで入手できます。

タブにコンテンツを追加する

特定のタブに追加したいワークブックの内容を編集します。
[ 詳細設定] で、[ この項目を条件付きで表示する] を選択します。
[ 条件の追加] を選択し、 パラメーター名 ( selectedTabなど) を入力し、[ 比較 ] を [等しい] に設定し、[ パラメーター] の値 をタブに割り当てた値 (たとえば、 1) に設定します。

既定では、最初のタブが選択され、最初に selectedTab が 1に設定され、そのステップが表示されます。 2 番目のタブを選択すると、パラメーターの値が 2に変更され、さまざまなコンテンツが表示されます。

タブの制限事項

URL リンクはタブではサポートされません。タブに URL リンクがあると、無効なタブとして表示されます。
タブでは項目のスタイル設定はサポートされていません。項目はタブとして表示され、タブ名 (リンクテキスト) フィールドのみが表示されます。タブスタイルで使用されていないフィールドは、編集モードでは非表示になります。
既定では、最初のタブが選択され、そのタブで指定されたアクションが呼び出されます。最初のタブのアクションが別のビューを開く場合、タブが作成されるとすぐにビューが表示されます。
タブを使用して別のビューを開くこともできますが、ほとんどのユーザーはタブを選択して移動することを想定していないため、この機能は慎重に使用する必要があります。他のタブでパラメーターが特定の値に設定されている場合、ビューを開くタブではその値は変更されないため、ブックの残りの内容には前のタブのビューまたはデータが引き続き表示されます。

ツールバー

ツールバースタイルを使用して、リンクをツールバーのスタイルで表示します。ツールバースタイルでは、作成者は次のフィールドに入力する必要があります。

ツールバーに表示するテキストであるボタンテキスト。このフィールドではパラメーターを使用できます。
アイコン: ツールバーに表示するアイコン。
ツールバーのボタンのツールチップに表示されるテキストです。このフィールドではパラメーターを使用できます。

必須パラメーターがボタンテキスト、ヒントテキスト、または値フィールドで使用され、かつ必須パラメーターが設定されていない場合、ツールバーのボタンは無効になります。これは、たとえば、別のパラメーター/コントロールで値が選択されていないときにツールバーのボタンを無効にするために使用できます。

ツールバー、グローバルパラメーター、ARM アクションを含むサンプルブックは、リンクを含む Azure ブックのサンプルで入手できます。

グループの追加

ブック内のグループ項目を使用すると、一連のステップを 1 つのブックに論理的にグループ化できます。

ブック内のグループは、次のようなことに役立ちます。

レイアウト: 項目を垂直方向に整理する必要があるとき、個々の項目すべてにパーセンテージで幅を設定するのではなく、項目をすべて積み重ねるグループを作成して、グループのスタイルがパーセンテージの幅になるように設定できます。
可視性: 複数の項目をまとめて表示または非表示にする必要があるとき、個々の項目に可視性設定を設定するのではなく、項目のグループ全体の可視性を設定できます。これは、タブの内容としてグループを使用でき、選択したタブで設定されたパラメーターに基づいてグループ全体を非表示または表示できるため、タブを使用するテンプレートで役に立ちます。
パフォーマンス: 多数のセクションやタブを含む非常に大きなテンプレートがあるとき、各セクションを独自のサブテンプレートに変換し、グループを使用して最上位のテンプレート内にすべてのサブテンプレートを読み込むことができます。サブテンプレートのコンテンツは、ユーザーがこれらのグループを表示するまで読み込まれたり実行されたりすることはありません。詳細については、「大規模なテンプレートを多数のテンプレートに分割する方法」を参照してください。

ブックにグループを追加するには:

次のいずれかの手順を実行してパラメーターを追加します。
- [追加] をクリックし、既存の要素の下、またはブックの下部にある [グループの追加] をクリックします。
- ブック内のいずれかの要素の横にある [編集] ボタンの右側の省略記号 (...) を選択し、[追加] を選択して、[グループの追加] を選択します。
あなたのグループ用の項目を選択します。
[編集が完了しました] を選択します。

これは、読み取りモードのグループで、中にはテキスト項目とクエリ項目の 2 つの項目があります。

編集モードでは、これらの 2 つの項目が実際にグループ項目内にあることを確認できます。以下のスクリーンショットでは、グループは編集モードです。このグループには、破線領域内に 2 つの項目が含まれています。各項目は、互いに独立して、編集モードまたは読み取りモードにできます。たとえば、テキストステップは編集モードで、クエリステップは読み取りモードにすることができます。

グループのスコープを設定する

グループは、ブック内の新しいスコープとして扱われます。グループ内に作成されたすべてのパラメーターは、そのグループ内でのみ表示されます。これは、マージにもあてはまります。グループ内または親レベルでのみデータを表示できます。

グループの種類

ブックに追加するグループの種類を指定できます。次の 2 種類のグループがあります。

編集可能: ブックでグループを使用すると、グループ内の項目のコンテンツを追加、削除、または編集できます。これは、レイアウトと可視性の目的で最も一般的に使用されます。
テンプレートから: ブック内のグループは、その ID によって別のブックの内容から読み込まれます。実行時に、そのブックの内容が読み込まれ、ブックにマージされます。編集モードでも、グループのコンテンツを変更することはできません。これは、次回項目が読み込まれるときにテンプレートから再度読み込まれるためです。テンプレートからグループを読み込む場合は、既存のブックの完全な Azure リソース ID を使用します。

読み込みの種類

グループのコンテンツを読み込む方法とタイミングを指定できます。

遅延読み込み

遅延読み込みは既定です。遅延読み込みでは、項目が表示されているときにのみ、グループが読み込まれます。これにより、グループをタブ項目で使用できるようになります。タブが選択されていない場合、グループは表示されないため、コンテンツは読み込まれません。

テンプレートから作成されたグループの場合、テンプレートのコンテンツは取得されず、グループが表示されるまでグループ内の項目は作成されません。コンテンツの取得中、グループ全体の進行状況スピナーがユーザーに表示されます。

明示的な読み込み

このモードでは、グループが表示される場所にボタンが表示され、ユーザーが内容を読み込むためにボタンを明示的に選択するまで内容は取得または作成されません。これは、内容の計算に費用がかかる場合や使用頻度が低いシナリオに便利です。作成者は、ボタンに表示するテキストを指定できます。

このスクリーンショットは、構成済みの [さらに読み込む] ボタンを使用した明示的な読み込み設定を示しています。

これは、ブックに読み込まれる前のグループです。

ブックに読み込まれた後のグループ:

常時モード

[常時] モードでは、ブックが読み込まれるとすぐにグループの内容が読み込まれて、作成されます。これは、レイアウト目的でのみグループを使用し、コンテンツを常に表示するときに最もよく使用されます。

グループ内でのテンプレートの使用

グループがテンプレートから読み込まれるように構成されているとき、既定ではそのコンテンツは遅延モードで読み込まれ、グループが表示されたときにのみ読み込まれます。

テンプレートがグループに読み込まれると、ブックは、テンプレートで宣言されているすべてのパラメーターを、グループ内に既に存在するパラメーターとマージしようとします。同じ名前のワークブックに既に存在するパラメーターは、読み込まれるテンプレートからマージされます。パラメーターステップのすべてのパラメーターがマージされると、パラメーターステップ全体が表示されなくなります。

例 1: すべてのパラメーターの名前が同一

たとえば、上部に 2 つのパラメーター、時間範囲パラメーター、および "Filter" という名前のテキストパラメーターを持つテンプレートがあるとします。

次に、グループ項目は、独自の 2 つのパラメーターとテキストステップを持つ 2 つ目のテンプレートを読み込みます。パラメーターの名前は同じです。

2 番目のテンプレートがグループに読み込まれると、重複するパラメーターはマージによってなくなります。すべてのパラメーターがマージで消去されるため、内部パラメーターのステップもマージされてなくなり、その結果、テキストステップのみが含まれるグループになります。

例 2: 同一の名前を持つ 1 つのパラメーター

一番上に 2 つのパラメーター、 時間範囲 パラメーター、および "FilterB" () という名前のテキストパラメーターがあるテンプレートがあるとします。

グループの項目のテンプレートが読み込まれると、TimeRange パラメーターはマージされてグループからなくなります。ブックには TimeRange と Filter を含む初期パラメーターステップが含まれていて、グループのパラメーターには FilterB のみが含まれます。

読み込まれたテンプレートに TimeRange と (FilterB ではなく) Filter が含まれていた場合、結果のブックには、パラメーターステップと、テキストステップだけが残ったグループが含まれます。

大規模なテンプレートを多数のテンプレートに分割する

パフォーマンスを向上させるには、大規模なテンプレートを複数の小さなテンプレートに分割して、一部のコンテンツを遅延モードまたはユーザーによる要求で読み込むことが役立ちます。これにより、最上位のテンプレートが小さくなるため、初期読み込みが高速になります。

テンプレートを複数のパーツに分割するときは、基本的に、テンプレートをすべてが個別に機能する多数のテンプレート (サブテンプレート) に分割する必要があります。最上位のテンプレートに他の項目で使用する TimeRange パラメーターがある場合、サブテンプレートにも厳密に同じ名前を持つパラメーターを定義するパラメーター項目が必要になります。サブテンプレートは個別に機能し、グループ内の大規模なテンプレート内で読み込むことができます。

より大きいテンプレートを複数のサブテンプレートに変換するには:

共有パラメーターの後に、ワークブックの上の方に新しい空のグループを作成します。この新しいグループは最終的にサブテンプレートになります。
共有パラメーターステップのコピーを作成し、"グループに移動" を使用して、手順 1 で作成したグループにコピーを移動します。このパラメーターにより、サブテンプレートは外部テンプレートから独立して動作し、外部テンプレート内に読み込まれる際には結合されます。

注

サブテンプレートを単独で表示する予定がない場合は、サブテンプレートでマージされるパラメーターを技術的に必要としません。ただし、サブテンプレートにパラメーターがない場合、後で編集またはデバッグする必要がある場合は、編集やデバッグが非常に困難になります。
サブテンプレートに含めるブック内の各項目を、手順 1 で作成したグループに移動します。
手順 3 で移動した個々のステップに条件付きの可視性があった場合は、(タブで使用されているような) 外部グループの可視性になります。グループ内の項目からそれらを削除し、その可視性の設定をグループ自体に追加します。ここで保存して、変更が失われるのを防ぐか、json コンテンツのコピーをエクスポートして保存します。
そのグループをテンプレートから読み込む場合は、グループの [編集] ツールバーボタンを使用できます。これにより、そのグループのコンテンツだけが新しいウィンドウにブックとして表示されます。その後、必要に応じて保存して、このブックビューを閉じることができます (ブラウザーを閉じないでください。そのビューだけが編集していた前のブックに戻ります)。
次に、グループステップをテンプレートから読み込むように変更し、手順 5 で作成したブックまたはテンプレートに [テンプレート ID] フィールドを設定します。ワークブック ID を使用するには、ソースが共有ワークブックの完全な Azure リソース ID である必要があります。 [読み込み] を押すと、そのグループのコンテンツが外部のワークブックではなく、そのサブテンプレートから読み込まれるようになります。

画像を追加する

ワークブックで作成者はコンテンツに画像を含めることができます。画像要素を使用して、図、スクリーンショット、その他の視覚的な情報などの視覚補助機能を提供します。

ワークブックに画像を追加するには:

次のいずれかの手順を実行して、イメージを追加します。
- [追加] を選択し、既存の要素の下またはワークブックの下部にある [画像を追加] を選択します。
- ブック内のいずれかの要素の横にある [編集] ボタンの右側にある省略記号 (...) を選択し、[ 追加] を選択し、[ イメージの追加] を選択します。
指定されたフィールドに画像の URL を入力します。
画像のタイトル、サイズ、代替テキストなどの追加の設定を指定します。イメージサイズをフルサイズに設定すると、イメージは元のサイズに設定されます。

ビデオを追加する

ワークブックを使用すると、作成者はその中にビデオコンテンツを埋め込むことができます。

ワークブックにビデオを追加するには:

次のいずれかの手順を実行してビデオを追加します。
- [追加] を選択し、既存の要素の下またはブックの下部にある [ビデオの追加] を選択します。
- ブック内のいずれかの要素の横にある [編集] ボタンの右側にある省略記号 (...) を選択し、[ 追加] を選択し、[ ビデオの追加] を選択します。
指定されたフィールドにビデオ URL を入力します。
ビデオタイトル、サイズ、代替テキストなどの追加の設定を指定します。