Действия по созданию ссылок

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

Общие действия ссылок

Действие ссылки	Действие при выборе
Общие сведения	Показывает значения строк в представлении контекста сетки свойств.
Сведения о ячейке	Показывает значение ячейки в представлении контекста сетки свойств. Удобно, если ячейка содержит динамический тип с информацией (например, объект JSON с такими свойствами запроса, как расположение и экземпляр роли).
URL-адрес	Ожидается, что значение ячейки будет представлять собой допустимый URL-адрес HTTP. Ячейка — это ссылка, при щелчке по которой этот URL-адрес открывается в новой вкладке.

Application Insights

Действие ссылки	Действие при выборе
Данные настроенных событий	Открывает детали поиска в Application Insights с идентификатором пользовательского события ("itemId") в ячейке.
Сведения	Похоже на "Сведения о пользовательском событии", за исключением сведений о зависимостях, исключениях, просмотрах страниц, запросах и трассировках.
Потоки пользователей для пользовательских событий	Открывает представление "Маршруты пользователей" в Application Insights, основанное на имени пользовательского события в ячейке.
Маршруты пользователей	Похоже на пользовательские потоки событий, за исключением исключений, просмотров страниц и запросов.
Временная шкала пользователя	Открывает временную шкалу пользователя с идентификатором пользователя (user_Id) в ячейке.
Временная шкала сеанса	Открывает область поиска в Application Insights для значения в ячейке, например, для поиска текста абв, где "абв" — значение в ячейке.

Ресурс Azure

Действие ссылки	Действие при выборе
Развертывание ARM	Развертывает шаблон Azure Resource Manager (ARM). При выборе этого элемента отображаются дополнительные поля, с помощью которых можно выбрать, какой шаблон ARM будет открыт, и настроить его параметры. См. параметры ссылок для развертывания Azure Resource Manager.
Создание правила генерации оповещений	Создает правило генерации оповещений для ресурса.
Индивидуальный вид	Открывает пользовательское представление. При выборе этого элемента отображаются дополнительные поля, в которых можно настроить расширение представления, имя представления и все параметры, используемые для открытия представления. См. параметры ссылок на пользовательские представления.
Метрики	Открывает представление метрик.
Общие сведения о ресурсе	Открывает представление ресурса на портале с учетом значения идентификатора ресурса в ячейке. Можно также задать значение подменю, которое открывает определенный пункт меню в представлении ресурсов.
Рабочая тетрадь (шаблон)	Открывает шаблон рабочей книги. При выборе этого элемента отображаются дополнительные поля, в которых можно настроить открываемый шаблон. Смотрите параметры рабочей книги (шаблона).
Copilot в Azure	При вызове действия он форматирует и отправляет запрос в Microsoft Copilot в Azure. См. раздел "Copilot" в параметрах Azure.

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

При использовании отрисовщика ссылок доступны следующие параметры:

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

При использовании параметра Сделать этот элемент ссылкой доступны следующие параметры:

Настройки	Описание
Источник значения ссылки	Когда ячейка отображается как элемент отрисовки со ссылкой, это поле указывает, откуда берется значение «ссылки», используемое в ссылке. Можно выбрать из выпадающего списка, содержащего другие столбцы в сетке. Например, ячейка может содержать значение тепловой карты. Но, возможно, вы хотите, чтобы ссылка открывала раздел Общие сведения о ресурсе для идентификатора ресурса в строке. В этом случае нужно указать, что источником значения ссылки является поле Идентификатор ресурса.
Вид для открытия	То же, что выше.
Пункт меню	То же, что выше.
Откройте ссылку в панели контекста	То же, что выше.

Параметры действия ARM

Используйте этот параметр для вызова действия ARM, указав сведения об API ARM. Здесь приведена документация по REST API ARM. Во всех полях UX можно настроить параметры с помощью {paramName}. Вы также можете разрешить столбцы с помощью ["columnName"]. В приведенных ниже примерах изображений можно ссылаться на столбец id , написав ["id"]. Если столбец является идентификатором ресурса Azure, вы можете получить понятное имя ресурса с помощью форматтера label. См. форматирование параметров.

Вкладка "Настройки действия ARM"

В этом разделе определяется API действий ARM.

Источник	Описание
Путь действий ARM	Путь действия ARM. Например: "/subscriptions/:subscription/resourceGroups/:resourceGroup/someAction?api-version=:apiversion".
Метод HTTP	Выберите метод HTTP. Доступны следующие варианты: POST, PUT, PATCHDELETE
Длинная операция	Long Operations опрашивает URI из Azure-AsyncOperation или Location заголовка ответа исходной операции. Дополнительные сведения об отслеживании асинхронных операций Azure.
Параметры	Сетка параметров URL-адреса с ключом и значением.
Заголовки	Сетка заголовков с ключом и значением.
Тело	Редактор полезных данных запроса в ФОРМАТЕ JSON.

Параметры пользовательского интерфейса действий ARM

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

Источник	Описание
Заголовок	Заголовок, используемый в режиме выполнения.
Настройка имени действия ARM	Авторы могут настроить действие ARM, отображаемое в уведомлении после активации действия.
Описание действия ARM	Текст на языке разметки markdown, используемый для предоставления полезного описания пользователям, когда они планируют выполнить действие ARM.
Источник текста кнопки запуска	Метка, используемая на кнопке запуска (выполнения), чтобы активировать действие ARM.

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

Ход выполнения и результат действия ARM отображаются в виде уведомления портала Azure.

Параметры ссылок для развертывания Azure Resource Manager

Если тип ссылки — ARM Deployment, необходимо указать дополнительные параметры, чтобы открыть развертывание с использованием Resource Manager. Существует две основные вкладки для параметров конфигурации: Параметры шаблона и Параметры пользовательского интерфейса.

Параметры шаблона

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

Источник	Описание
Идентификатор группы ресурсов поступает из	ИД ресурса используется для управления развернутыми ресурсами. Подписка используется для управления развернутыми ресурсами и затратами. Группы ресурсов используются как папки для упорядочения всех ресурсов и управления ими. Если это значение не указано, развертывание завершается ошибкой. Выберите один из вариантов: Ячейка, Столбец, Параметр или Статическое значение в разделе Источники ссылки.
Источник URI шаблона ARM	URI самого шаблона ARM. Универсальный код ресурса (URI) шаблона должен быть доступен пользователям, которые развертывают шаблон. Выберите один из вариантов: Ячейка, Столбец, Параметр или Статическое значение в разделе Источники ссылки. Дополнительные сведения см. в Шаблонах быстрого запуска Azure.
Параметры шаблона ARM	Определяют параметры шаблона, которые используются для заданного ранее URI шаблона. Эти параметры используются для развертывания шаблона на странице запуска. Сетка содержит кнопку Развернуть на панели инструментов. Эта кнопка позволяет заполнить параметры, используя имена, определенные в URI шаблона, и задать для них пустые статические значения. Этот параметр можно использовать только в том случае, если в сетке нет параметров, а URI шаблона задан. Нижний раздел представляет собой предварительный просмотр того, как выглядит вывод параметра. Чтобы обновить окно предварительного просмотра с учетом внесенных изменений, нажмите кнопку Обновить. Параметры обычно представляют собой значения. Ссылки могут указывать на секреты из хранилища ключей, к которым есть доступ у пользователя. Ограничение области просмотра шаблонов не отображает ссылочные параметры правильно и отображается как null/value. Следовательно, пользователи не смогут правильно использовать ссылочные параметры на вкладке Средство просмотра шаблонов.

Параметры интерфейса

В этом разделе описано, что вы видите перед запуском развертывания Resource Manager.

Источник	Описание
Источник заголовка	Заголовок, используемый в режиме выполнения. Выберите один из вариантов: Ячейка, Столбец, Параметр или Статическое значение в разделе Источники ссылки.
Источник описания	Текст на языке Markdown содержит полезное описание для пользователей, которые хотят развернуть шаблон. Выберите один из вариантов: Ячейка, Столбец, Параметр или Статическое значение в разделе Источники ссылки. При выборе варианта Статическое значение отображается многострочное текстовое поле. В этом текстовом поле можно задать параметры с помощью "{paramName}". Кроме того, можно интерпретировать столбцы как параметры, добавляя "_column" после имени столбца, например, {columnName_column}. В примере на изображении ниже показано, что можно использовать конструкцию "VMName", чтобы сослаться на столбец "{VMName_column}". Значение после двоеточия — это форматировщик параметра. В данном случае это значение.
Источник текста кнопки запуска	Надпись на кнопке "Выполнить", используемая для развертывания шаблона ARM. Пользователи выбирают эту кнопку, чтобы начать развертывание шаблона ARM.

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

Параметры ссылки для пользовательского представления

Этот элемент можно использовать, чтобы открыть Пользовательские представления на портале Azure. Параметры можно настроить с помощью формы или URL-адреса.

Примечание.

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

Форма

Источник	Описание
Имя расширения	Название расширения, которое содержит имя представления.
Имя представления	Имя представления, которое нужно открыть.

Существует два типа входных данных: сетки и JSON. Используйте сетку для простого ввода ключей и значений. Используйте JSON для указания вложенных входных данных JSON.

Сетка

• Имя параметра: имя входного параметра представления.
• Параметр поставляется из: указывает, откуда должно поступать значение параметра View. Выберите один из вариантов: Ячейка, Столбец, Параметр или Статическое значение в разделе Источники ссылки.

  Примечание.

  Если выбран вариант Статическое значение, параметры можно разрешить, указав ссылку "{paramName}" в скобках в текстовом поле. Столбцы можно рассматривать как столбцы параметров, добавляя _column после имени столбца, например:"{columnName_column}".

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

JSON (JavaScript Object Notation)

• Укажите входные данные вкладки в формате JSON в редакторе. Как и в режиме Сетка, на параметры и столбцы можно ссылаться, используя {paramName} для параметров и {columnName_column} для столбцов. Если выбран вариант Показать пример JSON, будут показаны ожидаемые выходные данные всех разрешенных параметров и столбцов, которые использовались для входных данных представления.

URL-адрес

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

Параметры ссылки "Рабочая тетрадь (шаблон)"

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

Настройки	Описание
Идентификатор ресурса владельца рабочей книги поступает из	Это значение представляет собой идентификатор ресурса Azure, которому "принадлежит" книга. Обычно это ресурс Application Insights или рабочая область Log Analytics. Внутри Azure Monitor это также может быть строковый литерал "Azure Monitor". Именно к этому значению будет привязана книга при сохранении.
Ресурсы рабочей тетради поступают из	Массив идентификаторов ресурсов Azure, указывающих ресурсы по умолчанию, которые используются в рабочей книге. Например, если в открываемом шаблоне отображаются метрики виртуальных машин, то здесь значениями будут идентификаторы ресурсов виртуальных машин. Во многих случаях для владельца и ресурсов задаются одни и те же параметры.
Идентификатор шаблона исходит из	Укажите идентификатор шаблона, который нужно открыть. Шаблон сообщества из галереи является наиболее распространенным вариантом. Для пути к шаблону используйте Community- в качестве префикса, как Community-Workbooks/Performance/Apdex для шаблона Workbooks/Performance/Apdex. Если это ссылка на сохраненную книгу или шаблон, используйте полный путь к идентификатору ресурса Azure этого элемента, например "/subscriptions/12345678-a1b2-1234-a1b2-c3d4e5f6/resourceGroups/rgname/providers/microsoft.insights/workbooks/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e.
Тип рабочей тетради	Задайте тип шаблона книги, который нужно открыть. В наиболее распространенных случаях используется опция по умолчанию или опция книги, чтобы использовать значение в текущей книге.
Тип галереи получен из	Это значение определяет тип коллекции, которая будет отображаться в представлении Коллекция открываемого шаблона. В наиболее распространенных случаях используется опция по умолчанию или опция книги, чтобы использовать значение в текущей книге.
Источник расположения	Поле местоположения должно быть указано, если вы открываете конкретный ресурс рабочей книги. Если расположение не указано, поиск содержимого книги медленнее. Если расположение вам известно, укажите его. Если расположение неизвестно или вы открываете шаблон без определенного расположения, оставьте в этом поле значение Default.
Передача определенных параметров в шаблон	Установите этот флажок, чтобы передать в шаблон конкретные параметры. Если выбрать, то в шаблон передаются только указанные параметры, в противном случае в шаблон передаются все параметры из текущей рабочей книги. В этом случае параметр имена должен быть одинаковым в обеих книгах, чтобы это значение параметра работало.
Параметры шаблона рабочей книги	В этом разделе определяются параметры, которые передаются в целевой шаблон. Имя должно совпадать с именем параметра в целевом шаблоне. Выберите значение из следующих вариантов: Ячейка, Столбец, Параметр и Статическое значение. Чтобы параметр был передан в целевой шаблон, его имя и значение не должны быть пустыми.

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

Когда открывается ссылка на книгу, в новое представление книги передаются все значения, заданные на основе указанных выше параметров.

Источники ссылок

Источник	Описание
Ячейка	В качестве значения ссылки используется значение в этой ячейке сетки.
Колонка	При выборе этой ячейки появится поле, в котором можно выбрать другой столбец в сетке. Значение этого столбца для строки используется в качестве значения ссылки. Это значение ссылки обычно используется для того, чтобы при щелчке по каждой строке в сетке можно было открывать различные шаблоны. Для этого в качестве Идентификатора шаблона задается столбец. Либо он используется для открытия того же шаблона книги для других ресурсов, если в поле Ресурсы книги установлен столбец, содержащий идентификатор ресурса Azure.
Параметр	При выборе этой ячейки появится поле, в котором можно выбрать параметр. Значение этого параметра будет использоваться в качестве значения при щелчке по ссылке.
Статическое значение	Если выбрать, появится поле, в котором можно ввести статическое значение, используемое в связанной рабочей книге. Это значение обычно используется, когда все строки в сетке используют одно и то же значение для поля.
Компонент	Используется значение, заданное в текущем компоненте книги. Этот вариант часто применяется в компонентах запроса и метрик, чтобы задать в качестве ресурсов в связанной книге те ресурсы, которые используются в компоненте запроса или метрик, а не в текущей книге.
Рабочая тетрадь	Используйте значение, заданное в текущей книге.
По умолчанию.	Используется значение по умолчанию в тех случаях, когда значение не задано. Это распространенная ситуация для параметра Источник типа коллекции, для которого коллекция по умолчанию определяется типом ресурса-владельца.

Copilot в параметрах Azure

При вызове ссылки Copilot в Azure она форматирует настроенную ссылку и отправляет ее в виде запроса в Microsoft Copilot в Azure. Затем Microsoft Copilot в Azure отвечает на запрос, чтобы объяснить больше о концепциях, службах или предложениях Azure. Действие ссылки можно настроить для вставки значений параметров или содержимого сетки в текст запроса.

Примечание.

Если Microsoft Copilot в Azure не включена в вашей среде, вместо отправки запроса в Microsoft Copilot в Azure будет отображаться форматированный запрос на боковой панели "Сведения о ячейках".

Нажмите кнопку "Настройка...", чтобы открыть окно настроек Copilot в Azure. В настройках подсказок Copilot в Azure отображается текстовая область, в которой можно настроить текст подсказки и вставить маркеры параметров, используя стандартный синтаксис {parameter}, или сослаться на столбцы сетки через стандартный синтаксис ["column name"]. В настоящее время содержимое запроса ограничено 500 символами после форматирования. Любое оставшееся содержимое усечено.