Criar ou editar uma pasta de trabalho do Azure

Artigo
11/05/2024

Este artigo descreve como criar uma nova pasta de trabalho e como adicionar elementos à sua Pasta de Trabalho do Azure.

Este vídeo orienta você na criação de pastas de trabalho.

Criar uma nova pasta de trabalho do Azure

Para criar uma nova pasta de trabalho do Azure:

Na página Pastas de Trabalho do Azure, selecione um modelo vazio ou selecione Novo na barra de ferramentas superior.
Combine qualquer um destes elementos para adicionar à sua pasta de trabalho:
- Texto
- Parâmetros
- Consultas
- Gráficos de métricas
- Ligações
- Grupos
- Opções de configuração

Adicionar texto

As pastas de trabalho permitem que os autores incluam blocos de texto em suas pastas de trabalho. O texto pode ser uma análise humana dos dados, informações para ajudar os usuários a interpretar os dados, títulos de seção, etc.

O texto é adicionado através de um controle de marcação no qual um autor pode adicionar seu conteúdo. Um autor pode usar todos os recursos de formatação da marcação. Estes incluem diferentes estilos de título e fonte, hiperligações, tabelas, etc. O Markdown permite que os autores criem relatórios ou narrativas analíticas ricos semelhantes ao Word ou Portal. O texto pode conter valores de parâmetros no texto de markdown, e essas referências de parâmetros são atualizadas à medida que os parâmetros mudam.

Modo de edição:

Modo de pré-visualização:

Para adicionar texto a uma pasta de trabalho do Azure:

Certifique-se de que está no modo de Edição, selecionando Editar na barra de ferramentas. Adicione uma consulta seguindo uma destas etapas:
- Selecione Adicionar e Adicionar texto abaixo de um elemento existente ou na parte inferior da pasta de trabalho.
- Selecione as reticências (...) à direita do botão Editar ao lado de um dos elementos na pasta de trabalho e, em seguida, selecione Adicionar e, em seguida , Adicionar texto.
Insira o texto de marcação no campo do editor.
Use a opção Estilo de Texto para alternar entre marcação simples e marcação encapsulada com o estilo padrão de informações/aviso/sucesso/erro do portal do Azure.

Gorjeta

Use este cheat sheet de marcação para ver as diferentes opções de formatação.
Utilize o separador Pré-visualizar para ver o aspeto do seu conteúdo. A visualização mostra o conteúdo dentro de uma área rolável para limitar seu tamanho, mas quando exibido em tempo de execução, o conteúdo de marcação se expande para preencher o espaço necessário, sem uma barra de rolagem.
Selecione Edição Concluída.

Estilos de texto

Estes estilos de texto estão disponíveis:

Estilo	Description
simples	Nenhuma formatação é aplicada
informação	O estilo "info" do portal, com um `ℹ` ícone ou similar e fundo azul
error	O estilo "erro" do portal, com um `❌` ícone ou similar e fundo vermelho
exito	O estilo "sucesso" do portal, com um `✔` ícone ou semelhante e fundo verde
venda superior	O estilo "upsell" do portal, com um `🚀` ícone ou similar e fundo roxo
aviso	O estilo de "aviso" do portal, com um `⚠` ícone ou semelhante e fundo azul

Você também pode escolher um parâmetro de texto como a fonte do estilo. O valor do parâmetro deve ser um dos valores de texto acima. A ausência de um valor, ou qualquer valor não reconhecido será tratada como plain estilo.

Exemplos de estilo de texto

Exemplo de estilo de informação:

Exemplo de estilo de aviso:

Adicionar consultas

As Pastas de Trabalho do Azure permitem que você consulte qualquer uma das fontes de dados de pasta de trabalho com suporte.

Por exemplo, você pode consultar a Integridade dos Recursos do Azure para ajudá-lo a exibir quaisquer problemas de serviço que afetem seus recursos. Você também pode consultar métricas do Azure Monitor, que são dados numéricos coletados em intervalos regulares. As métricas do Azure Monitor fornecem informações sobre um aspeto de um sistema em um momento específico.

Para adicionar uma consulta a uma Pasta de Trabalho do Azure:

Certifique-se de que está no modo de Edição, selecionando Editar na barra de ferramentas. Adicione uma consulta seguindo uma destas etapas:
- Selecione Adicionar e Adicionar consulta abaixo de um elemento existente ou na parte inferior da pasta de trabalho.
- Selecione as reticências (...) à direita do botão Editar ao lado de um dos elementos na pasta de trabalho e, em seguida, selecione Adicionar e, em seguida , Adicionar consulta.
Selecione a fonte de dados para sua consulta. Os outros campos são determinados com base na fonte de dados escolhida.
Selecione quaisquer outros valores necessários com base na fonte de dados selecionada.
Selecione a visualização para sua pasta de trabalho.
Na seção de consulta, insira sua consulta ou selecione em uma lista de consultas de exemplo selecionando Exemplos e edite a consulta ao seu gosto.
Selecione Executar consulta.
Quando tiver certeza de que tem a consulta desejada na pasta de trabalho, selecione Edição concluída.

Práticas recomendadas para consultar logs

Use os menores intervalos de tempo possíveis. Quanto maiores os intervalos de tempo, mais lentas as consultas e mais dados retornados. Para intervalos de tempo mais longos, a consulta pode ter que ir para um armazenamento "frio" mais lento, tornando a consulta ainda mais lenta. O padrão é o menor intervalo de tempo útil, mas permite que o usuário escolha um intervalo de tempo maior que pode ser mais lento.
Use o valor especial "Todos" em listas suspensas. Você pode adicionar um item All special nas configurações de parâmetros suspensos. Você pode usar um valor especial. Usar um item All special corretamente pode simplificar drasticamente as consultas.
Proteja-se contra colunas ausentes. Se você estiver usando uma tabela ou colunas personalizadas, crie seu modelo para que ele funcione se a coluna estiver ausente em um espaço de trabalho. Consulte a função column_ifexists .
Proteja-se contra uma mesa em falta. Se o modelo estiver instalado como parte de uma solução, ou em outros casos em que as tabelas têm a garantia de existir, a verificação de colunas ausentes é desnecessária. Se você estiver criando modelos genéricos que podem ser visíveis em qualquer recurso ou espaço de trabalho, é uma boa ideia proteger para tabelas que não existem. A linguagem de consulta do log analytics não tem uma função table_ifexists como a função para testar colunas. No entanto, existem algumas maneiras de verificar se existe uma tabela. Por exemplo, você pode usar uma união difusa. Ao fazer uma união, você pode usar a configuração isfuzzy=true para permitir que a união continue se algumas das tabelas não existirem. Você pode adicionar uma consulta de parâmetro em sua pasta de trabalho que verifica a existência da tabela e oculta algum conteúdo se isso não acontecer. Os itens que não estão visíveis não são executados, portanto, você pode projetar seu modelo para que outras consultas na pasta de trabalho que falhariam se a tabela não existisse não sejam executadas até que o teste verifique se a tabela existe.

Por exemplo:
```
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
```
Essa consulta retorna um 1 se a tabela AzureDiagnostics não existir no espaço de trabalho. Se a tabela real não existir, a linha falsa da MissingTable será retornada. Se existirem colunas no esquema da tabela AzureDiagnostics , um 0 será retornado. Você pode usar isso como um valor de parâmetro e ocultar condicionalmente suas etapas de consulta, a menos que o valor do parâmetro seja 0. Você também pode usar a visibilidade condicional para mostrar o texto que diz que o espaço de trabalho atual não tem a tabela ausente e enviar o usuário para a documentação sobre como integrar.

Em vez de ocultar etapas, você pode apenas querer não ter linhas como resultado. Você pode alterar a MissingTable para ser uma tabela de dados vazia com o esquema de correspondência apropriado:
```
let MissingTable = datatable(ResourceId: string) [];
union isfuzzy=true MissingTable, (AzureDiagnostics
| extend ResourceId = column_ifexists('ResourceId', '')
```
Nesse caso, a consulta não retornará linhas se a tabela AzureDiagnostics estiver ausente ou se a coluna ResourceId estiver ausente da tabela.

Tutorial - consultas de logs centradas em recursos em pastas de trabalho

Este vídeo mostra como usar consultas de logs de nível de recurso em Pastas de Trabalho do Azure. Ele também tem dicas e truques sobre como habilitar cenários avançados e melhorar o desempenho.

Parâmetro de tipo de recurso dinâmico

Usa escopos dinâmicos para consultas mais eficientes. O trecho abaixo usa essa heurística:

Recursos individuais: se a contagem do recurso selecionado for menor ou igual a 5
Grupos de recursos: se o número de recursos for superior a 5, mas o número de grupos de recursos a que os recursos pertencem for menor ou igual a 3
Subscrições: caso contrário

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)

Escopo de recurso estático para consultar vários tipos de recursos

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

Parâmetro de recurso agrupado por tipo de recurso

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

Adicionar parâmetros

Você pode coletar entradas de consumidores e fazer referência a elas em outras partes da pasta de trabalho usando parâmetros. Use parâmetros para definir o escopo do conjunto de resultados ou para definir o visual correto. Os parâmetros ajudam a criar relatórios e experiências interativas. Para obter mais informações sobre como os parâmetros podem ser usados, consulte Parâmetros da pasta de trabalho.

As pastas de trabalho permitem que você controle como seus controles de parâmetro são apresentados aos consumidores – caixa de texto versus lista suspensa, seleção única versus múltipla, valores de texto, JSON, KQL ou Azure Resource Graph, etc.

Assista a este vídeo para saber como usar parâmetros e dados de log em Pastas de Trabalho do Azure.

Para adicionar um parâmetro a uma Pasta de Trabalho do Azure:

Certifique-se de que está no modo de Edição, selecionando Editar na barra de ferramentas. Adicione um parâmetro seguindo uma destas etapas:
- Selecione Adicionar e Adicionar parâmetro abaixo de um elemento existente ou na parte inferior da pasta de trabalho.
- Selecione as reticências (...) à direita do botão Editar ao lado de um dos elementos na pasta de trabalho e, em seguida, selecione Adicionar e, em seguida , Adicionar parâmetro.
No novo painel de parâmetros que aparece, insira valores para estes campos:
- Nome do parâmetro: os nomes dos parâmetros não podem incluir espaços ou caracteres especiais
- Nome para exibição: Os nomes de exibição podem incluir espaços, caracteres especiais, emojis, etc.
- Tipo de parâmetro:
- Necessários:
Selecione Edição concluída.

Adicionar gráficos métricos

A maioria dos recursos do Azure emite dados métricos sobre estado e integridade, como utilização da CPU, disponibilidade de armazenamento, contagem de transações de banco de dados, solicitações de aplicativos com falha, etc. Usando pastas de trabalho, você pode criar visualizações dos dados métricos como gráficos de séries temporais.

O exemplo abaixo mostra o número de transações em uma conta de armazenamento na hora anterior. Isso permite que o proprietário do armazenamento veja a tendência da transação e procure anomalias no comportamento.

Para adicionar um gráfico métrico a uma Pasta de Trabalho do Azure:

Certifique-se de que está no modo de Edição, selecionando Editar na barra de ferramentas. Adicione um gráfico de métricas seguindo uma destas etapas:
- Selecione Adicionar e Adicionar métrica abaixo de um elemento existente ou na parte inferior da pasta de trabalho.
- Selecione as reticências (...) à direita do botão Editar ao lado de um dos elementos na pasta de trabalho e, em seguida, selecione Adicionar e, em seguida , Adicionar métrica.
Selecione um tipo de recurso, os recursos a serem direcionados, o namespace e o nome da métrica e a agregação a ser usada.
Defina outros parâmetros, se necessário, como intervalo de tempo, divisão por, visualização, tamanho e paleta de cores.
Selecione Edição Concluída.

Este é um gráfico métrico no modo de edição:

Parâmetros do gráfico métrico

Parâmetro	Explicação	Exemplo
Tipo de Recurso	O tipo de recurso a ser direcionado	Armazenamento ou máquina virtual.
Recursos	Um conjunto de recursos para obter o valor das métricas	MyStorage1
Espaço de Nomes	O namespace com a métrica	Blob de armazenamento >
Métrica	A métrica para visualizar	Transações de Blob > de Armazenamento >
Agregação	A função de agregação a ser aplicada à métrica	Soma, Contagem, Média, etc.
Intervalo de Tempo	A janela de tempo para visualizar a métrica em	Última hora, últimas 24 horas, etc.
Visualização	A visualização a ser usada	Área, Bar, Linha, Dispersão, Grade
Dividido por	Opcionalmente, dividir a métrica em uma dimensão	Transações por tipo geográfico
Tamanho	O tamanho vertical do controle	Pequeno, médio ou grande
Paleta de cores	A paleta de cores a ser usada no gráfico. Ignorado se o `Split by` parâmetro for usado	Azul, verde, vermelho, etc.

Exemplos de gráficos métricos

Transações divididas pelo nome da API como um gráfico de linhas

Transações divididas por tipo de resposta como um grande gráfico de barras

Latência média como um gráfico de dispersão

Adicionar links

Você pode usar links para criar links para outros modos de exibição, pastas de trabalho, outros itens dentro de uma pasta de trabalho ou para criar modos de exibição com guias dentro de uma pasta de trabalho. Os links podem ser estilizados como hiperlinks, botões e guias.

Assista a este vídeo para saber como usar guias, grupos e links contextuais nas Pastas de Trabalho do Azure:

Estilos de link

Você pode aplicar estilos ao próprio elemento link e a links individuais.

Estilos de elemento de link

Estilo	Exemplo	Notas
Lista de marcadores		O padrão, links, aparece como uma lista com marcadores de links, um em cada linha. Os campos Texto antes do link e Texto após o link podem ser usados para adicionar mais texto antes ou depois dos itens do link.
Listagem		Os links aparecem como uma lista de links, sem marcadores.
Parágrafo		Os links aparecem como um parágrafo de links, quebrado como um parágrafo de texto.
Navegação		Os links aparecem como links, com divisores verticais, ou tubos (`\|`) entre cada link.
Separadores		Os links aparecem como guias. Cada link aparece como uma guia, nenhuma opção de estilo de link se aplica a links individuais. Consulte a secção de separadores abaixo para saber como configurar separadores.
Barra de Ferramentas		Os links aparecem em uma barra de ferramentas com estilo de portal do Azure, com ícones e texto. Cada link aparece como um botão da barra de ferramentas. Consulte a seção da barra de ferramentas abaixo para saber como configurar as barras de ferramentas.

Estilos de link

Estilo	Description
Ligação	Por padrão, os links aparecem como um hiperlink. Os links de URL só podem ser estilo de link.
Botão (Principal)	O link aparece como um botão "primário" no portal, geralmente uma cor azul
Botão (Secundário)	Os links aparecem como um botão "secundário" no portal, geralmente uma cor "transparente", um botão branco em temas claros e um botão cinza escuro em temas escuros.

Se os parâmetros necessários forem usados em texto de botão, texto de dica de ferramenta ou campos de valor, e o parâmetro necessário não estiver definido ao usar botões, o botão será desativado. Você pode usar esse recurso, por exemplo, para desabilitar botões quando nenhum valor é selecionado em outro parâmetro ou controle.

Ações de ligação

Os links podem usar todas as ações de link disponíveis em ações de link e ter mais duas ações disponíveis:

Ação	Descrição
Definir um valor de parâmetro	Um parâmetro pode ser definido como um valor ao selecionar um link, botão ou guia. As guias geralmente são configuradas para definir um parâmetro como um valor, que oculta e mostra outras partes da pasta de trabalho com base nesse valor.
Deslocar-se para um passo	Ao selecionar um link, a pasta de trabalho moverá o foco e a rolagem para tornar outra etapa visível. Esta ação pode ser usada para criar um "sumário" ou uma experiência de estilo "voltar ao topo".

Separadores

Na maioria das vezes, os links de guia são combinados com a ação Definir um valor de parâmetro. Aqui está um exemplo mostrando a etapa de links configurada para criar 2 guias, onde selecionar uma guia define um parâmetro selectedTab para um valor diferente (o exemplo mostra uma terceira guia sendo editada para mostrar o nome do parâmetro e os espaços reservados para o valor do parâmetro):

Em seguida, você pode adicionar outros itens na pasta de trabalho que são condicionalmente visíveis se o valor do parâmetro selectedTab for "1" usando as configurações avançadas:

A primeira guia é selecionada por padrão, inicialmente definindo selectedTab como 1 e tornando essa etapa visível. Selecionar a segunda guia altera o valor do parâmetro para "2", e conteúdo diferente é exibido:

Uma pasta de trabalho de exemplo com as guias acima está disponível em Pastas de Trabalho do Azure de exemplo com links. g

Limitações de separadores

Os links de URL não são suportados em guias. Um link de URL em uma guia aparece como uma guia desabilitada.
Nenhum estilo de item é suportado nas guias. Os itens são exibidos como guias e somente o campo nome da guia (texto do link) é exibido. Os campos que não são usados no estilo de tabulação ficam ocultos durante o modo de edição.
A primeira guia é selecionada por padrão, invocando qualquer ação especificada pela guia. Se a ação do primeiro separador abrir outra vista, assim que os separadores forem criados, será apresentada uma vista.
Você pode usar guias para abrir outras exibições, mas essa funcionalidade deve ser usada com moderação, já que a maioria dos usuários não espera navegar selecionando uma guia. Se outras guias estiverem definindo um parâmetro para um valor específico, uma guia que abra um modo de exibição não alterará esse valor, portanto, o restante do conteúdo da pasta de trabalho continuará a mostrar o modo de exibição ou os dados da guia anterior.

Toolbars

Use o estilo da barra de ferramentas para que seus links apareçam estilizados como uma barra de ferramentas. No estilo da barra de ferramentas, o autor deve preencher campos para:

Texto do botão, o texto a ser exibido na barra de ferramentas. Neste domínio, podem ser utilizados parâmetros.
Ícone, o ícone a ser exibido na barra de ferramentas.
Texto da dica de ferramenta, texto a ser exibido no texto da dica de ferramenta do botão da barra de ferramentas. Neste domínio, podem ser utilizados parâmetros.

Se quaisquer parâmetros necessários forem usados em texto de botão, texto de dica de ferramenta ou campos de valor, e o parâmetro necessário for desdefinido, o botão da barra de ferramentas será desativado. Por exemplo, isso pode ser usado para desativar os botões da barra de ferramentas quando nenhum valor é selecionado em outro parâmetro/controle.

Uma pasta de trabalho de exemplo com barras de ferramentas, parâmetros globais e Ações ARM está disponível em Pastas de Trabalho do Azure de exemplo com links.

Adicionar grupos

Um item de grupo em uma pasta de trabalho permite que você agrupe logicamente um conjunto de etapas em uma pasta de trabalho.

Os grupos em pastas de trabalho são úteis para várias coisas:

Layout: Quando quiser que os itens sejam organizados verticalmente, você pode criar um grupo de itens que serão todos empilhados e definir o estilo do grupo como uma largura percentual em vez de definir a largura percentual em todos os itens individuais.
Visibilidade: Quando quiser que vários itens ocultem ou mostrem juntos, você pode definir a visibilidade de todo o grupo de itens, em vez de definir configurações de visibilidade em cada item individual. Isso pode ser útil em modelos que usam guias, pois você pode usar um grupo como o conteúdo da guia, e todo o grupo pode ser oculto/mostrado com base em um parâmetro definido pela guia selecionada.
Desempenho: Quando você tem um modelo grande com muitas seções ou guias, pode converter cada seção em seu próprio submodelo e usar grupos para carregar todos os submodelos dentro do modelo de nível superior. O conteúdo dos submodelos não será carregado ou executado até que um usuário torne esses grupos visíveis. Saiba mais sobre como dividir um modelo grande em muitos modelos.

Para adicionar um grupo à sua pasta de trabalho:

Certifique-se de que está no modo de Edição, selecionando Editar na barra de ferramentas. Adicione um parâmetro seguindo uma destas etapas:
- Selecione Adicionar e Adicionar grupo abaixo de um elemento existente ou na parte inferior da pasta de trabalho.
- Selecione as reticências (...) à direita do botão Editar ao lado de um dos elementos na pasta de trabalho e, em seguida, selecione Adicionar e, em seguida , Adicionar grupo.
Selecione itens para o seu grupo.
Selecione Edição concluída.

Este é um grupo em modo de leitura com dois itens dentro: um item de texto e um item de consulta.

No modo de edição, você pode ver que esses dois itens estão, na verdade, dentro de um item de grupo. Na imagem abaixo, o grupo está no modo de edição. O grupo contém dois itens dentro da área tracejada. Cada item pode estar em modo de edição ou leitura, independentemente uns dos outros. Por exemplo, a etapa de texto está no modo de edição enquanto a etapa de consulta está no modo de leitura.

Definição do âmbito de um grupo

Um grupo é tratado como um novo escopo na pasta de trabalho. Todos os parâmetros criados no grupo só são visíveis dentro do grupo. Isso também é verdade para mesclagem - você só pode ver dados dentro do grupo ou no nível pai.

Tipos de grupo

Você pode especificar qual tipo de grupo adicionar à sua pasta de trabalho. Existem dois tipos de grupos:

Editável: o grupo na pasta de trabalho permite adicionar, remover ou editar o conteúdo dos itens no grupo. Isso é mais comumente usado para fins de layout e visibilidade.
De um modelo: o grupo na pasta de trabalho é carregado do conteúdo de outra pasta de trabalho por sua ID. O conteúdo dessa pasta de trabalho é carregado e mesclado na pasta de trabalho em tempo de execução. No modo de edição, você não pode modificar nenhum dos conteúdos do grupo, pois eles serão carregados novamente a partir do modelo na próxima vez que o item for carregado. Ao carregar um grupo de um modelo, use a ID de Recurso do Azure completa de uma pasta de trabalho existente.

Tipos de carga

Você pode especificar como e quando o conteúdo de um grupo é carregado.

Carregamento preguiçoso

O carregamento lento é o padrão. No carregamento lento, o grupo só é carregado quando o item está visível. Isso permite que um grupo seja usado por itens de guia. Se a guia nunca for selecionada, o grupo nunca ficará visível e, portanto, o conteúdo não será carregado.

Para grupos criados a partir de um modelo, o conteúdo do modelo não é recuperado e os itens no grupo não são criados até que o grupo se torne visível. Os usuários veem spinners de progresso para todo o grupo enquanto o conteúdo é recuperado.

Carregamento explícito

Nesse modo, um botão é exibido onde o grupo estaria, e nenhum conteúdo é recuperado ou criado até que o usuário selecione explicitamente o botão para carregar o conteúdo. Isso é útil em cenários em que o conteúdo pode ser caro para calcular ou raramente usado. O autor pode especificar o texto a ser exibido no botão.

Esta captura de tela mostra configurações de carregamento explícitas com um botão "Carregar mais" configurado.

Este é o grupo antes de ser carregado na pasta de trabalho:

O grupo depois de ser carregado na pasta de trabalho:

Modo sempre

No modo Sempre , o conteúdo do grupo é sempre carregado e criado assim que a pasta de trabalho é carregada. Isso é usado com mais frequência quando você está usando um grupo apenas para fins de layout, onde o conteúdo sempre estará visível.

Usando modelos dentro de um grupo

Quando um grupo é configurado para carregar a partir de um modelo, por padrão, esse conteúdo é carregado no modo lento e só será carregado quando o grupo estiver visível.

Quando um modelo é carregado em um grupo, a pasta de trabalho tenta mesclar quaisquer parâmetros declarados no modelo com parâmetros que já existem no grupo. Todos os parâmetros que já existem na pasta de trabalho com nomes idênticos serão mesclados fora do modelo que está sendo carregado. Se todos os parâmetros em uma etapa de parâmetro forem mesclados, toda a etapa de parâmetros desaparecerá.

Exemplo 1: Todos os parâmetros têm nomes idênticos

Suponha que você tenha um modelo que tenha dois parâmetros na parte superior, um parâmetro de intervalo de tempo e um parâmetro de texto chamado "Filtro":

Em seguida, um item de grupo carrega um segundo modelo que tem seus próprios dois parâmetros e uma etapa de texto, onde os parâmetros são nomeados da mesma forma:

Quando o segundo modelo é carregado no grupo, os parâmetros duplicados são mesclados. Como todos os parâmetros são mesclados, a etapa de parâmetros internos também é mesclada, resultando no grupo contendo apenas a etapa de texto.

Exemplo 2: Um parâmetro tem um nome idêntico

Suponha que você tenha um modelo que tenha dois parâmetros na parte superior, um parâmetro de intervalo de tempo e um parâmetro de texto chamado "FilterB" ():

Quando o modelo do item do grupo é carregado, o parâmetro TimeRange é mesclado fora do grupo. A pasta de trabalho contém a etapa inicial de parâmetros com TimeRange e Filter, e o parâmetro do grupo inclui apenas FilterB.

Se o modelo carregado contivesse TimeRange e Filter (em vez de FilterB), a pasta de trabalho resultante teria uma etapa de parâmetros e um grupo com apenas a etapa de texto restante.

Dividir um modelo grande em muitos modelos

Para melhorar o desempenho, é útil dividir um modelo grande em vários modelos menores que carregam algum conteúdo no modo preguiçoso ou sob demanda do usuário. Isso torna a carga inicial mais rápida, já que o modelo de nível superior pode ser menor.

Ao dividir um modelo em partes, você basicamente precisará dividir o modelo em muitos modelos (submodelos) que funcionam individualmente. Se o modelo de nível superior tiver um parâmetro TimeRange que outros itens usam, o submodelo também precisará ter um item de parâmetros que defina um parâmetro com o mesmo nome exato. Os submodelos funcionarão de forma independente e podem ser carregados dentro de modelos maiores em grupos.

Para transformar um modelo maior em vários submodelos:

Crie um novo grupo vazio perto da parte superior da pasta de trabalho, após os parâmetros compartilhados. Este novo grupo acabará por se tornar um submodelo.
Crie uma cópia da etapa de parâmetros compartilhados e use mover para o grupo para mover a cópia para o grupo criado na etapa 1. Esse parâmetro permite que o submodelo funcione independentemente do modelo externo e será mesclado quando carregado dentro do modelo externo.

Nota

Tecnicamente, os submodelos não precisam ter os parâmetros que são mesclados se você nunca planeja que os submodelos sejam visíveis por si mesmos. No entanto, se os submodelos não tiverem os parâmetros, isso os tornará muito difíceis de editar ou depurar se você precisar fazê-lo mais tarde.
Mova cada item na pasta de trabalho que você deseja que esteja no submodelo para o grupo criado na etapa 1.
Se as etapas individuais movidas na etapa 3 tinham visibilidades condicionais, isso se torna a visibilidade do grupo externo (como usado em guias). Remova-os dos itens dentro do grupo e adicione essa configuração de visibilidade ao próprio grupo. Salve aqui para evitar perder alterações e/ou exportar e salvar uma cópia do conteúdo json.
Se pretender que esse grupo seja carregado a partir de um modelo, pode utilizar o botão Editar barra de ferramentas no grupo. Isso abre apenas o conteúdo desse grupo como uma pasta de trabalho em uma nova janela. Em seguida, você pode salvá-lo conforme apropriado e fechar esta exibição de pasta de trabalho (não feche o navegador, apenas essa exibição para voltar à pasta de trabalho anterior que você estava editando).
Em seguida, você pode alterar a etapa de grupo para carregar do modelo e definir o campo ID do modelo para a pasta de trabalho/modelo que você criou na etapa 5. Para trabalhar com IDs de pastas de trabalho, a fonte precisa ser a ID de Recursos do Azure completa de uma pasta de trabalho compartilhada. Pressione Carregar e o conteúdo desse grupo será carregado a partir desse submodelo em vez de ser salvo dentro dessa pasta de trabalho externa.

Partilhar via