Ações de ligação

As ações de link podem ser acessadas por meio de componentes de link da pasta de trabalho ou por meio de configurações de coluna de grades, blocos ou gráficos.

Ações gerais de ligação

Ação de link	Ação ao selecionar
Detalhes Genéricos	Mostra os valores de linha em uma exibição de contexto de grade de propriedades.
Detalhes da célula	Mostra o valor da célula em uma exibição de contexto de grade de propriedades. Útil quando a célula contém um tipo dinâmico com informações, por exemplo, JSON com propriedades de solicitação como local e instância de função.
URL	Espera-se que o valor da célula seja um URL HTTP válido. A célula é um link que abre esse URL em uma nova guia.

Application Insights

Ação de link	Ação ao selecionar
Detalhes personalizados do evento	Abre os detalhes de pesquisa do Application Insights com a ID de evento personalizada ("itemId") na célula.
Detalhes	Semelhante a Detalhes de eventos personalizados, exceto para dependências, exceções, exibições de página, solicitações e rastreamentos.
Fluxos de usuário de eventos personalizados	Abre a experiência de Fluxos de Usuário do Application Insights pivotada no nome do evento personalizado na célula.
Fluxos do Utilizador	Semelhante aos Fluxos de Usuário de Eventos Personalizados, exceto exceções, exibições de página e solicitações.
Linha do tempo do usuário	Abre a linha do tempo do usuário com o ID do usuário ("user_Id") na célula.
Cronograma da sessão	Abre a experiência de pesquisa do Application Insights para o valor na célula, por exemplo, procure texto abc onde abc é o valor na célula.

Recurso do Azure

Ação de link	Ação ao selecionar
Implementação ARM	Implanta um modelo do Azure Resource Manager (ARM). Quando este item é selecionado, mais campos são exibidos para permitir que você configure qual modelo ARM abrir e parâmetros para o modelo. Consulte Configurações do link de implantação do Azure Resource Manager.
Criar regra de alerta	Cria uma regra de alerta para um recurso.
Modo de Exibição Personalizado	Abre uma vista personalizada. Quando esse item é selecionado, mais campos aparecem onde você pode configurar a extensão do modo de exibição, o nome do modo de exibição e quaisquer parâmetros usados para abrir o modo de exibição. Consulte as configurações de link de exibição personalizadas.
Métricas	Abre uma visualização de métricas.
Visão geral do recurso	Abre a vista do recurso no portal com base no valor do ID do recurso na célula. Opcionalmente, você também pode definir um valor de submenu que abra um item de menu específico na exibição de recursos.
Pasta de trabalho (modelo)	Abre um modelo de pasta de trabalho. Quando este item é selecionado, aparecem mais campos onde você pode configurar qual modelo abrir. Consulte Configurações da pasta de trabalho (modelo).
Copiloto no Azure (visualização)	Quando a ação é invocada, ela formata e envia um prompt para o Microsoft Copilot no Azure (visualização). Consulte Copilot nas configurações do Azure (visualização).

Configurações de link

Quando você usa o renderizador de link, as seguintes configurações estão disponíveis:

Definição	Descrição
Ver para abrir	Permite selecionar uma das ações.
Item do menu	Se a opção Visão Geral do Recurso estiver selecionada, esse item de menu estará na visão geral do recurso. Você pode usá-lo para abrir alertas ou registros de atividades em vez da "visão geral" do recurso. Os valores de item de menu são diferentes para cada tipo de recurso do Azure.
Etiqueta de ligação	Se especificado, esse valor aparece na coluna da grade. Se esse valor não for especificado, o valor da célula será exibido. Se quiser que outro valor apareça, como um mapa de calor ou ícone, não use o renderizador de link. Em vez disso, use o renderizador apropriado e selecione a opção Tornar este item um link .
Abrir link no painel Contexto	Se especificado, o link é aberto como uma visualização pop-up de "contexto" no lado direito da janela, em vez de abrir como uma visualização completa.

Quando você usa a opção Tornar este item um link , as seguintes configurações estão disponíveis:

Definição	Descrição
O valor do link vem de	Quando uma célula é exibida como um renderizador com um link, esse campo especifica de onde vem o valor "link" a ser usado no link. Você pode selecionar a partir de uma lista suspensa das outras colunas na grade. Por exemplo, a célula pode ser um valor de mapa de calor. Mas talvez você queira que o link abra a Visão Geral do Recurso para a ID do recurso na linha. Nesse caso, você definiria o valor do link como proveniente do campo ID do recurso.
Ver para abrir	Mesmo que acima.
Item do menu	Mesmo que acima.
Abrir link no painel Contexto	Mesmo que acima.

Configurações de ação ARM

Use essa configuração para invocar uma ação ARM especificando os detalhes da API ARM. A documentação para APIs ARM REST pode ser encontrada aqui. Em todos os campos UX, você pode resolver parâmetros usando {paramName}. Você também pode resolver colunas usando ["columnName"]. Nas imagens de exemplo abaixo, podemos referenciar a coluna id escrevendo ["id"]. Se a coluna for uma ID de Recurso do Azure, você poderá obter um nome amigável do recurso usando o formatador label. Consulte a formatação de parâmetros.

Guia Configurações de ação ARM

Esta seção define a API de ação ARM.

Origem	Explicação
Caminho de ação ARM	O caminho de ação ARM. Por exemplo: "/subscriptions/:subscription/resourceGroups/:resourceGroup/someAction?api-version=:apiversion".
Método Http	Selecione um método HTTP. As opções disponíveis são: POST, PUT, PATCH, DELETE
Operação Longa	Operações longas sondam o URI do Azure-AsyncOperation cabeçalho ou o Location cabeçalho de resposta da operação original. Saiba mais sobre como controlar operações assíncronas do Azure.
Parâmetros	Grade de parâmetros de URL com a chave e o valor.
Cabeçalhos	Grelha de cabeçalhos com a chave e o valor.
Corpo	Editor para a carga útil da solicitação em JSON.

Configurações de UX de ação ARM

Esta seção configura o que os usuários veem antes de executar a ação ARM.

Origem	Explicação
Título	Título usado na visualização de execução.
Personalizar o nome da ação ARM	Os autores podem personalizar a ação ARM exibida na notificação depois que a ação é acionada.
Descrição da ação ARM	O texto de marcação usado para fornecer uma descrição útil aos usuários quando eles desejam executar a ação ARM.
Executar texto do botão a partir de	Rótulo usado no botão Executar (executar) para acionar a ação ARM.

Depois que essas configurações são definidas, quando o usuário seleciona o link, a visualização é aberta com a experiência do usuário descrita aqui. Se o usuário selecionar o botão especificado pelo texto do botão Executar, ele executará a ação ARM usando os valores configurados. Na parte inferior do painel de contexto, você pode selecionar Exibir detalhes da solicitação para inspecionar o método HTTP e o ponto de extremidade da API ARM usado para a ação ARM.

O progresso e o resultado da Ação ARM são mostrados como uma notificação do portal do Azure.

Configurações do link de implantação do Azure Resource Manager

Se o tipo de link for Implantação ARM, você deverá especificar mais configurações para abrir uma implantação do Gerenciador de Recursos. Há duas guias principais para configurações: Configurações do modelo e Configurações de UX.

Configurações do modelo

Esta seção define de onde o modelo deve vir e os parâmetros usados para executar a implantação do Resource Manager.

Origem	Description
O ID do grupo de recursos vem de	A ID do recurso é usada para gerenciar recursos implantados. A assinatura é usada para gerenciar recursos e custos implantados. Os grupos de recursos são usados como pastas para organizar e gerenciar todos os seus recursos. Se esse valor não for especificado, a implantação falhará. Selecione a partir de Célula, Coluna, Parâmetro e Valor estático em Fontes de ligação.
URI do modelo ARM de	O URI para o próprio modelo ARM. O URI do modelo precisa estar acessível aos usuários que implantam o modelo. Selecione a partir de Célula, Coluna, Parâmetro e Valor estático em Fontes de ligação. Para obter mais informações, consulte Modelos de início rápido do Azure.
Parâmetros do modelo ARM	Define os parâmetros de modelo usados para o URI do modelo definido anteriormente. Esses parâmetros são usados para implantar o modelo na página de execução. A grade contém um botão Expandir barra de ferramentas para ajudar a preencher os parâmetros usando os nomes definidos no URI do modelo e definidos como valores vazios estáticos. Essa opção só pode ser usada quando não há parâmetros na grade e o URI do modelo está definido. A seção inferior é uma prévia da aparência da saída do parâmetro. Selecione Atualizar para atualizar a visualização com as alterações atuais. Os parâmetros são tipicamente valores. As referências são algo que pode apontar para segredos de cofre chave aos quais o usuário tem acesso. A limitação do painel Visualizador de modelos não processa parâmetros de referência corretamente e é mostrada como um valor nulo. Como resultado, os usuários não poderão implantar corretamente os parâmetros de referência na guia Visualizador de modelos.

Configurações de UX

Esta seção configura o que você vê antes de executar a implantação do Gerenciador de Recursos.

Origem	Description
Título de	Título usado na visualização de execução. Selecione a partir de Célula, Coluna, Parâmetro e Valor estático em Fontes de ligação.
Descrição de	O texto Markdown usado para fornecer uma descrição útil aos usuários quando eles desejam implantar o modelo. Selecione a partir de Célula, Coluna, Parâmetro e Valor estático em Fontes de ligação. Se você selecionar Valor estático, uma caixa de texto de várias linhas será exibida. Nesta caixa de texto, você pode resolver parâmetros usando "{paramName}". Além disso, você pode tratar colunas como parâmetros anexando "_column" após o nome da coluna como {columnName_column}. Na imagem de exemplo a seguir, você pode fazer referência à coluna "VMName" escrevendo "{VMName_column}". O valor após os dois pontos é o formatador de parâmetro. Neste caso, é valor.
Executar texto do botão a partir de	Rótulo usado no botão Executar (executar) para implantar o modelo ARM. Os usuários selecionam esse botão para começar a implantar o modelo ARM.

Depois que essas configurações são definidas, quando você seleciona o link, a exibição é aberta com a experiência do usuário descrita nas configurações de UX. Se você selecionar o texto do botão Executar, um modelo ARM será implantado usando os valores de Configurações do modelo. Exibir modelo abre a guia Visualizador de modelos para que você possa examinar o modelo e os parâmetros antes de implantar.

Configurações de link de exibição personalizada

Use essa configuração para abrir Modos de Exibição Personalizados no portal do Azure. Você pode definir as configurações usando o formulário ou URL.

Nota

As vistas com um menu não podem ser abertas num separador de contexto. Se um modo de exibição com um menu estiver configurado para abrir em uma guia de contexto, nenhuma guia de contexto será mostrada quando o link for selecionado.

Formulário

Origem	Description
Nome da extensão	O nome da extensão que hospeda o nome do modo de exibição.
View name	O nome do modo de exibição a ser aberto.

Existem dois tipos de entradas: grids e JSON. Use uma grade para entradas simples de chaves e guias de valor. Use JSON para especificar uma entrada JSON aninhada.

Grelha

• Nome do parâmetro: O nome do parâmetro de entrada View.
• Parameter Comes From: Indica de onde o valor do parâmetro View deve vir. Selecione a partir de Célula, Coluna, Parâmetro e Valor estático em Fontes de ligação.

  Nota

  Se você selecionar Valor estático, os parâmetros podem ser resolvidos usando colchetes para vincular "{paramName}" na caixa de texto. As colunas podem ser tratadas como colunas de parâmetros anexando _column após o nome da coluna como "{columnName_column}".

• Valor do parâmetro: Dependendo do valor em Parameter Comes From, esta lista suspensa contém parâmetros disponíveis, colunas ou um valor estático.

JSON

• Especifique sua entrada de guia em um formato JSON no editor. Como o modo de grade , parâmetros e colunas podem ser referenciados usando {paramName} para parâmetros e {columnName_column} para colunas. Selecionar Mostrar exemplo JSON mostra a saída esperada de todos os parâmetros e colunas resolvidos usados para a entrada de exibição.

URL

Cole um URL do portal que contenha a extensão, o nome do modo de exibição e todas as entradas necessárias para abri-lo. Depois de selecionar Inicializar configurações, o formulário é preenchido para que você possa adicionar, modificar ou remover qualquer uma das entradas de exibição.

Configurações de link da pasta de trabalho (modelo)

Se o tipo de link selecionado for Pasta de Trabalho (Modelo), especifique mais configurações para abrir o modelo de pasta de trabalho correto. As configurações a seguir têm opções de como a grade encontra o valor apropriado para cada uma das configurações.

Definição	Descrição
A ID do recurso do proprietário da pasta de trabalho vem de	Esse valor é a ID do Recurso do Azure que "possui" a pasta de trabalho. Geralmente, é um recurso do Application Insights ou um espaço de trabalho do Log Analytics. Dentro do Azure Monitor, esse valor também pode ser a cadeia de caracteres "Azure Monitor"literal . Quando a pasta de trabalho é salva, esse valor é o que a pasta de trabalho está vinculada.
Os recursos da pasta de trabalho vêm de	Uma matriz de IDs de Recursos do Azure que especifica o recurso padrão usado na pasta de trabalho. Por exemplo, se o modelo que está sendo aberto mostrar métricas de máquina virtual, os valores aqui seriam IDs de recursos de máquina virtual. Muitas vezes, o proprietário e os recursos são definidos para as mesmas configurações.
O ID do modelo vem de	Especifique a ID do modelo a ser aberto. Um modelo de comunidade da galeria é o caso mais comum. Prefira o caminho para o modelo com Community-, como Community-Workbooks/Performance/Apdex para o Workbooks/Performance/Apdex modelo. Se for um link para uma pasta de trabalho ou modelo salvo, use o caminho completo para a ID de recurso do Azure desse item, por exemplo, "/subscriptions/12345678-a1b2-1234-a1b2-c3d4e5f6/resourceGroups/rgname/providers/microsoft.insights/workbooks/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e4e.
Tipo de pasta de trabalho vem de	Especifique o tipo de modelo de pasta de trabalho a ser aberto. Os casos mais comuns usam a opção padrão ou pasta de trabalho para usar o valor na pasta de trabalho atual.
O tipo de galeria vem de	Esse valor especifica o tipo de galeria exibido no modo de exibição Galeria do modelo que é aberto. Os casos mais comuns usam a opção padrão ou pasta de trabalho para usar o valor na pasta de trabalho atual.
A localização vem de	O campo de local deve ser especificado se você estiver abrindo um recurso de pasta de trabalho específico. Se o local não for especificado, a localização do conteúdo da pasta de trabalho será mais lenta. Se souber a localização, especifique-a. Se você não souber o local ou estiver abrindo um modelo sem local específico, deixe este campo como Default.
Passar parâmetros específicos para o modelo	Selecione esta opção para passar parâmetros específicos para o modelo. Se selecionado, apenas os parâmetros especificados são passados para o modelo ou então todos os parâmetros na pasta de trabalho atual são passados para o modelo. Nesse caso, os nomes dos parâmetros devem ser os mesmos em ambas as pastas de trabalho para que esse valor de parâmetro funcione.
Parâmetros do modelo de pasta de trabalho	Esta seção define os parâmetros que são passados para o modelo de destino. O nome deve corresponder ao nome do parâmetro no modelo de destino. Selecione em Célula, Coluna, Parâmetro e Valor estático. O nome e o valor não devem estar vazios para passar esse parâmetro para o modelo de destino.

Para cada uma das configurações anteriores, você deve escolher de onde vem o valor na pasta de trabalho vinculada. Consulte Fontes de link.

Quando o link da pasta de trabalho é aberto, a nova exibição da pasta de trabalho é passada para todos os valores configurados nas configurações anteriores.

Fontes de links

Origem	Description
Cell	Use o valor nessa célula na grade como o valor do link.
Column	Quando selecionado, aparece um campo onde você pode selecionar outra coluna na grade. O valor dessa coluna para a linha é usado no valor do link. Esse valor de link é comumente usado para permitir que cada linha de uma grade abra um modelo diferente, definindo o campo ID do modelo como coluna. Ou é usado para abrir o mesmo modelo de pasta de trabalho para recursos diferentes, se o campo Recursos da pasta de trabalho estiver definido como uma coluna que contém uma ID de recurso do Azure.
Parâmetro	Quando selecionado, aparece um campo onde você pode selecionar um parâmetro. O valor desse parâmetro é usado para o valor quando o link é selecionado.
Valor estático	Quando selecionado, aparece um campo onde você pode inserir um valor estático usado na pasta de trabalho vinculada. Esse valor é comumente usado quando todas as linhas na grade usam o mesmo valor para um campo.
Componente	Use o valor definido no componente atual da pasta de trabalho. É comum nos componentes de consulta e métricas definir os recursos da pasta de trabalho na pasta de trabalho vinculada para os recursos usados no componente consulta/métricas, não para a pasta de trabalho atual.
Livro	Use o valor definido na pasta de trabalho atual.
Predefinido	Use o valor padrão que seria usado se nenhum valor fosse especificado. Essa situação é comum para o Tipo de Galeria vem de, onde a galeria padrão seria definida pelo tipo do recurso proprietário.

Copiloto nas configurações do Azure (visualização)

Quando um link Copilot no Azure (visualização) é invocado, ele formata o link configurado e o envia como um prompt para o Microsoft Copilot no Azure (visualização). Em seguida, o Microsoft Copilot no Azure responde ao prompt para explicar mais sobre conceitos, serviços ou ofertas do Azure. A ação de link pode ser configurada para inserir valores de parâmetro ou conteúdo de grade no texto do prompt.

Nota

Se o Microsoft Copilot no Azure (visualização) não estiver habilitado em seu ambiente, em vez de enviar o prompt para o Microsoft Copilot no Azure, o prompt formatado será exibido no painel lateral Detalhes da Célula.

Selecione o botão Configurar... para abrir o Copilot no painel de configurações de prompt do Azure (visualização). As configurações de prompt do Copilot no Azure (visualização) mostram uma área de texto, onde você pode configurar o texto do prompt e inserir marcadores de parâmetro com a sintaxe padrão {parameter} ou referenciar colunas de grade por meio da sintaxe padrão ["column name"] . No momento, o conteúdo do prompt é limitado a 500 caracteres após a formatação. Qualquer conteúdo restante é truncado.