Создание или изменение рабочей тетради Azure

В этой статье описано, как создать новую рабочую книгу и как добавить элементы в вашу рабочую книгу Azure.

В этом видео показано, как создавать рабочие книги.

Создайте новую рабочую книгу Azure

Чтобы создать новую рабочую книгу Azure:

1. На странице "Рабочие книги Azure" выберите пустой шаблон или нажмите Создать на верхней панели инструментов.
2. Добавьте любой из этих элементов в рабочую книгу:
   • Текст
   • Изображение
   • Видео
   • Параметры
   • Запросы
   • Диаграммы метрик
   • Ссылки
   • Группы
   • Варианты конфигурации

Добавить текст

Рабочие тетради позволяют авторам включать текстовые блоки в свои тетради. Текст может быть человеческим анализом данных, информацией, помогая пользователям интерпретировать данные, заголовки разделов и т. д.

Текст добавляется через элемент управления markdown, в который автор может добавить своё содержание. Автор может использовать все возможности форматирования Markdown. Эти возможности включают различные стили заголовков и шрифтов, гиперссылки, таблицы и т. д. Markdown позволяет авторам создавать богатые отчеты, похожие на Word или портал, или аналитические повествования. Текст может содержать значения параметров в тексте markdown, и эти ссылки на параметры обновляются при изменении параметров.

Режим редактирования:

Режим предварительного просмотра: снимок экрана:

Чтобы добавить текст в книгу Azure, выполните приведенные действия.

1. Добавьте текстовый шаг, выполнив одно из следующих действий:

   • Выберите Добавить и Добавить текст под существующим элементом или внизу рабочей книги.
   • Щелкните многоточие (...) справа от кнопки Изменить рядом с одним из элементов книги, а затем выберите Добавить и Добавить текст.

2. Введите текст Markdown в поле редактора.

3. Используйте параметр Стиль текста для переключения между обычным текстом Markdown и текстом Markdown с применением стандартного стиля портала Azure: "Информация", "Предупреждение", "Выполнено" или "Ошибка".

   Tip

   Чтобы узнать о различных вариантах форматирования, ознакомьтесь с этим кратким справочником по Markdown.

4. Перейдите на вкладку "Предварительный просмотр", чтобы узнать, как выглядит содержимое. ** Предварительный просмотр отображает контент внутри прокручиваемой области, чтобы ограничить его размер, но при запуске контент markdown расширяется, заполняя все необходимое пространство, без полосы прокрутки.

5. Нажмите Done Editing (Завершить правку).

Стили текста

Доступны следующие стили текста:

В качестве источника стиля можно также выбрать параметр текста. Параметр должен иметь одно из перечисленных выше текстовых значений. Отсутствие значения или любое нераспознанное значение рассматривается как plain стиль.

Примеры стилей текста

Пример информационного стиля:

Пример стиля предупреждения:

Добавление запросов

Книги Azure позволяют выполнять запросы к любым поддерживаемым источникам данных книги.

Например, вы можете запросить Состояние ресурсов Azure, чтобы помочь вам просмотреть любые проблемы со службой, влияющие на ваши ресурсы. Вы также можете запросить метрики Azure Monitor, которые представляют собой числовые данные, собираемые через регулярные интервалы. Метрики Azure Monitor предоставляют сведения о конкретных аспектах системы в определенное время.

Чтобы добавить запрос в рабочую книгу Azure, следуйте этим шагам.

1. Добавьте запрос, выполнив одно из следующих действий:

   • Выберите Добавить и Добавить запрос ниже существующего элемента или внизу рабочей книги.
   • Щелкните многоточие (...) справа от кнопки Изменить рядом с одним из элементов книги, а затем выберите Добавить и Добавить запрос.

2. Выберите источник данных для запроса. Другие поля определяются на основе выбранного источника.

3. Выберите другие необходимые значения в зависимости от выбранного источника данных.

   Примечание.

   При выборе типа ресурса следует учитывать разрешения пользователя. Например, если у вас есть разрешения на чтение ресурса, но не для рабочей области Log Analytics, в которую отправляются данные телеметрии, необходимо выбрать ресурс для типа ресурса, чтобы увидеть данные.

4. Select the visualization for your workbook.

5. В разделе запроса введите запрос либо щелкните Примеры и выберите запрос из списка примеров, а затем измените его требуемым образом.

6. Снова выберите Выполнение запроса.

7. Когда вы уверены, что у вас есть нужный запрос в вашей книге, выберите Редактирование завершено.

Рекомендации по запросам к журналам

• Задайте предопределенные правила сводки для агрегирования данных, которые вы хотите визуализировать. Вместо выполнения запросов к большим наборам данных или длительным диапазонам создайте сводные правила для агрегирования данных, необходимых из одной или нескольких таблиц, при поступлении данных в рабочую область Log Analytics. Визуализация агрегированных данных непосредственно из пользовательской таблицы сводных данных вместо запроса необработанных данных из одной или нескольких таблиц, повышает производительность запросов и уменьшает ошибки запросов и время ожидания.

• Используйте наименьшие возможные диапазоны времени. Чем больше диапазоны времени, тем медленнее выполняются запросы и больше объем возвращаемых данных. Для более широких диапазонов времени запросу может потребоваться перейти к более медленному "холодному" хранилищу, что делает выполнение запроса еще медленнее. По умолчанию используется самый короткий полезный диапазон времени, но пользователь может выбрать более широкий диапазон, который, возможно, будет обрабатываться медленнее.

• Используйте специальное значение "Все" в раскрывающихся списках. Вы можете добавить специальный элемент Все в настройки параметров раскрывающегося списка. Можно использовать специальное значение. Правильное использование специального элемента Все может значительно упростить запросы.

• Защитите от отсутствующих столбцов. Если вы используете пользовательскую таблицу или настраиваемые столбцы, создайте шаблон таким образом, чтобы он работал, если столбец отсутствует в рабочей области. См. функцию column_ifexists.

• Protect against a missing table. Если шаблон установлен как часть решения или в других случаях, когда таблицы гарантированно существуют, проверка отсутствующих столбцов не требуется. Если вы создаете универсальные шаблоны, которые могут быть видимы в любом ресурсе или рабочей области, рекомендуется защитить несуществующие таблицы.

  Язык запросов Log Analytics не имеет функции table_ifexists как функции для тестирования столбцов. Однако существует несколько способов проверить, существует ли таблица. Например, вы можете использовать fuzzy union. При объединении можно использовать параметр 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
  

  Этот запрос возвращает значение 1, если таблица AzureDiagnostics не существует в рабочей области. Если реальная таблица не существует, возвращается поддельная строка MissingTable . Если в схеме для таблицы AzureDiagnostics существуют какие-либо столбцы, возвращается значение 0. Его можно использовать в качестве значения параметра и условно скрыть шаги запроса, если значение параметра не равно 0. You could also use conditional visibility to show text that says that the current workspace doesn't have the missing table, and send the user to documentation on how to onboard.

  Вместо того чтобы скрывать шаги, вы можете просто не иметь строк в результате. MissingTable можно изменить на пустую таблицу данных с соответствующей схемой сопоставления:

  let MissingTable = datatable(ResourceId: string) [];
  union isfuzzy=true MissingTable, (AzureDiagnostics
  | extend ResourceId = column_ifexists('ResourceId', '')
  

  В этом случае запрос не возвращает строки, если таблица AzureDiagnostics отсутствует, или в таблице отсутствует столбец ResourceId.

Tutorial - resource centric logs queries in workbooks

В этом видео показано, как использовать запросы к журналам на уровне ресурсов в Рабочих тетрадях Azure. Он также содержит советы и рекомендации по включению сложных сценариев и повышению производительности.

Параметр типа динамического ресурса

Использует динамические области для более эффективного запроса. В приведенном ниже фрагменте используется следующая эвристика.

1. Отдельные ресурсы: если количество выбранных ресурсов меньше или равно 5.
2. Группы ресурсов: если количество ресурсов превышает 5, однако количество групп ресурсов, к которым относятся ресурсы, меньше или равно 3.
3. Subscriptions: иначе

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')

Добавление параметров

С помощью параметров можно собирать данные от потребителей и использовать их в других частях рабочей тетради. Используйте параметры для ограничения набора результатов или настройки правильного визуального отображения. Параметры помогают создавать интерактивные отчеты и впечатления. Для получения дополнительной информации о том, как можно использовать параметры, см. параметры рабочей тетради.

Workbooks allow you to control how your parameter controls are presented to consumers – text box vs. drop down, single- vs. multi-select, values from text, JSON, KQL, or Azure Resource Graph, etc.

Посмотрите это видео, чтобы узнать, как использовать параметры и данные журнала в рабочих книгах Azure.

Чтобы добавить параметр в рабочую книгу Azure, выполните следующие действия.

1. Добавьте параметр, выполнив одно из следующих действий:

   • Выберите Добавить и Добавить параметр под существующим элементом или внизу рабочей книги.
   • Щелкните многоточие (...) справа от кнопки Изменить рядом с одним из элементов книги, а затем выберите Добавить и Добавить параметр.

2. В новой области параметров, которая появляется на экране, введите значения для данных полей:

   • Имя параметра: имена параметров не должны содержать пробелы или специальные символы
   • Отображаемое имя: отображаемые имена могут содержать пробелы, специальные символы, эмодзи и т.п.
   • Тип параметра:
   • Обязательно:

3. Выберите Завершить редактирование.

   

Добавление диаграмм метрик

Большинство ресурсов Azure выдают данные метрик состояния и работоспособности, таких как загрузка ЦП, доступность хранилища, количество транзакций базы данных, неудачные запросы приложений и т.п. Использование книг позволяет создавать визуализации этих данных в виде диаграмм временных рядов.

В следующем примере показано количество транзакций в учетной записи хранения за предыдущий час. Это позволяет владельцу хранилища увидеть тенденцию транзакций и находить аномалии в поведении.

Чтобы добавить диаграмму метрик в книгу Azure, выполните приведенные ниже действия.

1. Добавьте диаграмму метрик, выполнив одно из следующих действий:

   • Выберите Добавить и Добавить метрику в нижней части рабочей книги или под существующим элементом.
   • Щелкните многоточие (...) справа от кнопки Изменить рядом с одним из элементов книги, а затем выберите Добавить и Добавить метрику.

2. Выберите тип ресурса, целевые ресурсы, пространство имен и имя метрики, а также используемое агрегирование.

3. При необходимости задайте другие параметры, например диапазон времени, разделение, визуализацию, размер и палитру цветов.

4. Нажмите Done Editing (Завершить правку).

Это диаграмма метрик в режиме правки:

Metric chart parameters

Примеры диаграмм метрик

Транзакции, разделенные по имени API в виде линейной диаграммы

Транзакции, разделенные по типу ответа, как большая линейчатая диаграмма

Средняя задержка в виде точечной диаграммы

Добавление ссылок

Ссылки можно использовать для создания ссылок на другие представления, книги, другие элементы в книге или для создания представлений с вкладками в книге. Ссылки можно стилизовать как гиперссылки, кнопки и вкладки.

Просмотрите это видео, чтобы узнать, как использовать вкладки, группы и контекстные ссылки в книгах Azure:

Стили ссылок

Стили можно применять к самому элементу ссылки и к отдельным ссылкам.

Стили элементов ссылки

Стиль	Пример	Примечания.
Bullet List		По умолчанию ссылки отображаются в виде маркированного списка ссылок, по одному на каждой строке. Поля Текст перед ссылкой и Текст после ссылки можно использовать для добавления дополнительного текста до или после элементов ссылки.
Список		Ссылки отображаются в виде списка ссылок без маркеров.
Абзац		Ссылки отображаются в виде абзаца ссылок, оформленного как абзац текста.
Навигация		Ссылки отображаются как ссылки, с вертикальными разделителями или каналами (|) между каждой ссылкой.
Вкладки		Ссылки отображаются в виде вкладок. Каждая ссылка отображается в виде вкладки, а к отдельным ссылкам параметры стиля ссылок не применяются. Сведения о настройке вкладок приведены в разделе Вкладки ниже.
Панель инструментов		Ссылки отображаются в виде панели инструментов портала Azure со значками и текстом. Каждая ссылка отображается в виде кнопки панели инструментов. Сведения о настройке панелей инструментов приведены в разделе Панель инструментов ниже.

Стили ссылок

Если обязательные параметры используются в тексте кнопки, тексте подсказки или в полях значения, и обязательный параметр не задан при использовании кнопки, кнопка отключается. Эту возможность можно использовать, например, для отключения кнопок при отсутствии выбранного значения в другом параметре или элементе управления.

Действия ссылки

Ссылки могут использовать все действия ссылок, доступные в действиях ссылок, и иметь еще два доступных действия:

Вкладки

В большинстве случаев ссылки на вкладки объединяются с действием Задание значения параметра.

Создание вкладок

Чтобы добавить вкладки в книгу Azure, следуйте следующим шагам.

1. Выберите "Добавить>ссылки/вкладки".

2. Установите стиль на вкладки.

3. Введите имя вкладки для каждой вкладки.

4. В столбце "Действие " выберите "Задать значение параметра" для каждой вкладки.

5. В столбце "Значение " задайте одно и то же имя параметра (например, selectedTab) для каждой вкладки.

6. В столбце "Параметры"введите другое значение для каждой вкладки.

   Ниже приведен пример, настроенный для создания двух вкладок, где выбор выбранной вкладки задает выбранный параметрTab другим значением.

   

   Примечание.

   В примере отображается только третья вкладка, редактируемая для отображения заполнителей имени параметра и значения параметра.

   Пример книги с описанными выше вкладками доступен в разделе Примеры книг Azure со ссылками.

Добавление содержимого на вкладки

1. Измените содержимое книги, которое нужно добавить на определенную вкладку.

2. В разделе "Дополнительные параметры" выберите "Сделать этот элемент условно видимым".

3. Выберите Добавить условие, введите имя параметра (например, selectedTab), установите сравнение на равно, и установите значение параметра в значение, которое вы присвоили вкладке (например, 1).

   

   Первая вкладка выбрана по умолчанию, изначально устанавливая как 1, что делает этот шаг видимым. При выборе второй вкладки значение параметра 2изменяется на и отображается другое содержимое.

   

Ограничения на использование вкладок

• URL-ссылки во вкладках не поддерживаются. Ссылка на URL-адрес на вкладке отображается как отключенная вкладка.
• Стили элементов во вкладках не поддерживаются. Элементы отображаются как вкладки с показом только поля имени вкладки (текст ссылки). Поля, которые не используются в стиле вкладок, скрыты в режиме правки.
• Первая вкладка выбрана по умолчанию, вызывая любое действие, указанное на этой вкладке. Если действие первой вкладки открывает другое представление, представление появится, как только будут созданы вкладки.
• Вы можете использовать вкладки для открытия других представлений, но эта функция должна использоваться смешно, так как большинство пользователей не ожидают перехода, выбрав вкладку. Если другие вкладки задают параметр определенному значению, вкладка, открывающая представление, не изменит это значение, поэтому остальная часть содержимого книги продолжает отображать представление или данные для предыдущей вкладки.

Панели инструментов

Используйте стиль панели инструментов, чтобы ссылки отображались в виде панели инструментов. В стиле панели инструментов автор должен заполнить следующие поля:

• Текст кнопки: текст, отображаемый на панели инструментов. Параметры могут использоваться в данном поле.
• Значок: значок, отображаемый на панели инструментов.
• Текст всплывающей подсказки, текст, который будет отображаться на кнопке панели инструментов в качестве подсказки. Параметры могут использоваться в данном поле.

Если все необходимые параметры используются в полях кнопки, подсказки или поля значений, а обязательный параметр не задан, кнопка панели инструментов отключена. Например, эту опцию можно использовать для отключения кнопок панели инструментов, если в другом параметре/элементе управления значение не выбрано.

Пример книги с панелями инструментов, глобальными параметрами и действиями ARM приведен в разделе Примеры книг Azure со ссылками.

Добавить группы

Элемент "группа" в книге позволяет логически сгруппировать набор шагов в книге.

Группы в рабочих книгах могут быть полезны в следующих случаях.

• Макет: Когда нужно упорядочить элементы по вертикали, вы можете создать группу элементов, которые будут располагаться один над другим, и установить для всей группы процентную ширину, вместо того чтобы задавать ширину для каждого отдельного элемента.
• Видимость: когда требуется скрыть или показать несколько элементов, можно задать видимость для всей группы элементов, а не задавать параметры видимости для каждого отдельного элемента. Это полезно использовать в шаблонах со вкладками, так как в качестве содержимого вкладки вы можете использовать группу, а вся группа может скрываться или отображаться в соответствии с параметром, задаваемым на выбранной вкладке.
• Производительность: когда у вас имеется крупный шаблон со множеством разделов или вкладок, вы можете преобразовать каждый раздел в собственный подшаблон и использовать группы для загрузки всех подшаблонов в рамках шаблона более высокого уровня. Содержимое подшаблонов не будет загружаться и выполняться до тех пор, пока пользователь не сделает эти группы видимыми. См. подробнее о разделении большого шаблона на ряд подшаблонов.

Чтобы добавить группу в свою книгу:

1. Добавьте параметр, выполнив одно из следующих действий:

   • Select Add, and Add group below an existing element, or at the bottom of the workbook.
   • Щелкните многоточие (...) справа от кнопки Изменить рядом с одним из элементов книги, а затем выберите Добавить и Добавить группу.

   

2. Выберите элементы для группы.

3. Выберите Завершить редактирование.

   Это группа в режиме чтения с двумя элементами — текстовым элементом и элементом запроса.

   

   В режиме правки вы можете увидеть, что эти два элемента действительно находятся внутри элемента группы. На снимке экрана ниже группа находится в режиме правки. Группа содержит два элемента внутри штриховой области. Каждый элемент может находиться в режиме правки или чтения независимо друг от друга. Например, текстовый шаг находится в режиме редактирования, а шаг запроса — в режиме чтения.

   

Определение границ группы

A group is treated as a new scope in the workbook. Все параметры, создаваемые в группе, видимы только внутри этой группы. Это также справедливо и для слияния: данные можно просматривать только внутри их группы или на родительском уровне.

Типы группы

Вы можете указать, какой тип группы добавить в вашу рабочую книгу. Существует два типа групп:

• Редактируемая: Группа в книге позволяет вам добавлять, удалять или изменять содержимое элементов в группе. Чаще всего это используется для организации макета и обеспечения видимости.
• From a template: The group in the workbook loads from the contents of another workbook by its ID. Содержимое этой рабочей книги загружается и объединяется с рабочей книгой во время выполнения. В режиме редактирования невозможно изменить содержимое группы, так как они просто загружаются из шаблона при следующей загрузке элемента. При загрузке группы из шаблона используйте полный идентификатор ресурса Azure существующей рабочей книги.

Типы загрузки

Вы можете указать, как и когда будет загружаться содержимое группы.

Ленивая загрузка

Отложенная загрузка установлена по умолчанию. При отложенной загрузке группа загружается только тогда, когда элемент становится видимым. This allows a group to be used by tab items. Если вкладка никогда не выбирается, то группа, соответственно, никогда не становится видимой, поэтому ее содержимое не загружается.

Для групп, создаваемых из шаблона, содержимое шаблона не извлекается, а элементы в группе не создаются, пока группа не станет видимой. Пользователи видят индикаторы прогресса для всей группы, пока осуществляется загрузка контента.

Явная загрузка

В этом режиме кнопка отображается, где будет находиться группа, и содержимое не извлекается или не создается, пока пользователь явно не выберет кнопку для загрузки содержимого. Это полезно использовать в тех случаях, когда содержимое требует много вычислительных ресурсов или редко используется. Автор может указать текст, который будет отображаться на кнопке.

This screenshot shows explicit load settings with a configured "Load more" button.

Это группа перед загрузкой в рабочую книгу:

The group after being loaded in the workbook:

Always mode

В режиме Always содержимое группы всегда загружается и создаётся сразу после загрузки рабочей книги. Этот режим чаще всего применяется в тех случаях, когда группа используется только для организации макета, содержимое которого всегда будет видимым.

Использование шаблонов внутри группы

Если группа настроена для загрузки из шаблона по умолчанию, содержимое загружается в отложенном режиме и загружается только в том случае, если группа отображается.

При загрузке шаблона в группу книга пытается объединить все параметры, объявленные в загружаемом шаблоне, с параметрами, уже существующими в группе. Все параметры, которые уже существуют в книге, будут объединены с параметрами из загружаемого шаблона, имеющими идентичные имена. If all parameters in a parameter step are merged out, the entire parameters step disappears.

Пример 1. Все параметры имеют идентичные имена

Предположим, у вас есть шаблон с двумя параметрами в верхней части, параметром диапазона времени и текстовым параметром с именем Filter:

Затем элемент группы загружает второй шаблон с собственными двумя параметрами и текстовым шагом, где параметры называются одинаковыми:

Когда второй шаблон загружается в группу, дублирующиеся параметры объединяются. Поскольку все параметры объединены, этап внутренних параметров также исключается, в результате чего группа содержит только этап текста.

Пример 2. Идентичное имя только у одного параметра

Предположим, у вас есть шаблон с двумя параметрами в верхней части, параметром диапазона времени и текстовым параметром с именем FilterB ():

После загрузки шаблона элемента группы параметр TimeRange будет извлечен из группы. Рабочая книга содержит начальный шаг с параметрами TimeRange и Filter, и параметр группы включает только FilterB.

Если загруженный шаблон содержал параметры TimeRange и Filter (а не FilterB), то результирующая книга будет содержать шаг параметров и группу, в которой остался только текстовый шаг.

Разбиение большого шаблона на несколько подшаблонов

Для повышения производительности целесообразно разбить большой шаблон на несколько небольших шаблонов, которые загружают содержимое в отложенном режиме или по запросу со стороны пользователя. Это ускоряет начальную загрузку, так как шаблон верхнего уровня может быть меньше.

При разбиении шаблона на части вы фактически разделяете шаблон на несколько подшаблонов, каждый из которых будет работать по отдельности. Если в шаблоне верхнего уровня есть параметр TimeRange, который используется другими элементами, подшаблону также необходимо иметь элемент параметров, определяющий параметр с точно таким же именем. Подшаблоны будут работать независимо и могут загружаться внутри больших шаблонов в группах.

Чтобы преобразовать шаблон большого размера в несколько подшаблонов, сделайте следующее:

1. Создайте новую пустую группу ближе к началу книги, после общих параметров. В дальнейшем эта новая группа станет подшаблоном.

2. Создайте копию шага общих параметров, а затем используйте команду Переместить в группу, чтобы переместить копию в группу, созданную на шаге 1. Этот параметр позволяет подшаблону работать независимо от внешнего шаблона и будет объединен при загрузке внутри внешнего шаблона.

   Примечание.

   Subtemplates don't technically need to have the parameters that get merged out if you never plan on the subtemplates being visible by themselves. Тем не менее, если подтемы не имеют параметров, это сделает их очень трудно редактировать или отлаживать, если это необходимо сделать позже.

3. Переместите каждый элемент рабочей книги, который вы хотите поместить в подшаблон, в группу, созданную на первом шаге.

4. If the individual steps moved in step 3 had conditional visibilities, that becomes the visibility of the outer group (like used in tabs). Удалите их из элементов внутри группы и добавьте параметр видимости непосредственно в саму группу. Выполните здесь сохранение, чтобы избежать потери изменений, и (или) экспортируйте и сохраните копию JSON-содержимого.

5. Если необходимо загрузить группу из шаблона, можно нажать кнопку Изменить на панели инструментов в группе. В новом окне откроется только содержимое этой группы в виде рабочей книги. Затем это содержимое можно сохранить соответствующим образом и закрыть это представление книги (не закрывайте браузер, закройте только представление книги, чтобы вернуться к предыдущей рабочей книге, которую вы редактировали).

6. You can then change the group step to load from template and set the template ID field to the workbook/template you created in step 5. Чтобы работать с идентификаторами книг, источником должен быть полный идентификатор ресурса Azure для общей книги. Нажмите кнопку Загрузить, и содержимое этой группы будет загружено из этого подшаблона вместо сохранения внутри этой внешней книги.

Добавление изображения

Книги позволяют авторам включать изображения в их содержимое. Используйте элемент изображения для предоставления визуальных средств, таких как схемы, снимки экрана и другие визуальные сведения.

Чтобы добавить изображение в книгу, выполните приведенные ниже действия.

1. Добавьте изображение, выполнив одно из следующих действий:

   • Select Add, and Add image below an existing element, or at the bottom of the workbook.
   • Щелкните многоточие (...) справа от кнопки "Изменить " рядом с одним из элементов книги, а затем нажмите кнопку "Добавить " и "Добавить изображение".

2. Введите URL-адрес изображения в предоставленном поле.

3. Укажите дополнительные параметры, такие как название изображения, размер и замещающий текст. Установка размера изображения на полный размер задает для изображения исходный размер.

Добавление видео

Рабочие книги позволяют авторам внедрять видеоконтент в ваши рабочие книги.

Чтобы добавить видео в книгу, выполните приведенные далее действия.

1. Добавьте видео, выполнив одно из следующих действий:

   • Выберите: Добавить и Добавить видео ниже существующего элемента или в нижней части рабочей книги.
   • Щелкните многоточие (...) справа от кнопки "Изменить " рядом с одним из элементов книги, а затем нажмите кнопку "Добавить " и "Добавить видео".

2. Введите URL-адрес видео в предоставленном поле.

3. Укажите дополнительные параметры, такие как название видео, размер и альтернативный текст.