Usar o Azure Digital Twins Explorer (visualização)
O Azure Digital Twins Explorer (pré-visualização) é uma ferramenta para visualizar e trabalhar com os Azure Digital Twins. Este artigo descreve os recursos do Azure Digital Twins Explorer e como usá-los para gerenciar os dados em sua instância do Azure Digital Twins. Você pode interagir com o Azure Digital Twins Explorer usando cliques ou atalhos de teclado.
Como aceder
A principal maneira de acessar o Azure Digital Twins Explorer é por meio do portal do Azure.
Para abrir o Azure Digital Twins Explorer para uma instância do Azure Digital Twins, primeiro navegue até a instância no portal, pesquisando seu nome na barra de pesquisa do portal.
Em seguida, selecione o botão Abrir o Azure Digital Twins Explorer (visualização).
Isso abrirá o Azure Digital Twins Explorer em uma nova guia. Se esta for a sua primeira vez usando o Explorer, você verá um modal de boas-vindas resumindo seus principais recursos.
O Azure Digital Twins Explorer pode se conectar automaticamente à sua instância. Caso contrário, você verá a tela a seguir solicitando que você especifique uma URL do Azure Digital Twins. (Se não vir esta caixa no ecrã, o Azure Digital Twins Explorer já concluiu este passo automaticamente.)
Se você vir essa caixa, digite https:// no campo, seguido pelo nome do host da sua instância (isso pode ser encontrado novamente na página Visão geral da instância no portal). Esses valores juntos compõem a URL da instância. Selecione Salvar para se conectar à sua instância.
Nota
O Azure Digital Twins Explorer hospedado só pode acessar instâncias do Azure Digital Twins com acesso público habilitado. Se você estiver usando o Private Link para restringir o acesso à sua instância por meio de um ponto de extremidade privado, poderá usar as funções do Azure para implantar a base de código do Azure Digital Twins Explorer de forma privada na nuvem. Para obter instruções sobre como fazer isso, consulte Azure Digital Twins Explorer: Running in the cloud.
Alternar contextos dentro do aplicativo
Uma vez no aplicativo, você também pode alterar qual instância está atualmente conectada ao explorador, selecionando o nome da instância na barra de ferramentas superior.
Isso exibirá o modal de URL dos Gêmeos Digitais do Azure, onde você poderá inserir o nome do host de outra instância dos Gêmeos Digitais do Azure após o prefixo https:// para se conectar a essa instância.
Nota
No momento, a capacidade de alternar contextos dentro do aplicativo não está disponível para contas pessoais da Microsoft (MSA). Os usuários do MSA precisarão acessar o explorador da instância escolhida no portal do Azure ou podem se conectar a uma determinada instância por meio de um link direto para o ambiente.
Consultar o seu gráfico de gémeos digitais
Você pode usar o painel Explorador de Consultas para executar consultas no gráfico.
Introduza a consulta que pretende executar. Se pretender introduzir uma consulta em várias linhas, pode utilizar SHIFT + ENTER para adicionar uma nova linha à caixa de consulta.
Selecione o botão Executar consulta para exibir os resultados da consulta no painel Gráfico gêmeo.
Nota
Os resultados da consulta que contêm relações só podem ser renderizados no painel Gráfico gêmeo se os resultados incluírem pelo menos um gêmeo também. Embora as consultas que retornam apenas relações sejam possíveis nos Gêmeos Digitais do Azure, você só pode exibi-las no Gerenciador de Gêmeos Digitais do Azure usando o painel Saída.
Sobrepor resultados da consulta
Você pode marcar a caixa Resultados da sobreposição antes de executar a consulta se quiser que os resultados sejam destacados do que está sendo mostrado atualmente no painel Gráfico gêmeo, em vez de substituir completamente o conteúdo do painel pelos novos resultados da consulta.
Se o resultado da consulta incluir algo que não está sendo mostrado no momento no painel Gráfico gêmeo, o elemento será adicionado à exibição existente.
Salvar e executar consultas novamente
As consultas podem ser salvas no armazenamento local em seu navegador, facilitando sua seleção e execução.
Nota
O armazenamento local do navegador significa que as consultas salvas não estarão disponíveis em outros navegadores além daquele em que você as salvou, e permanecerão no armazenamento do navegador indefinidamente até que o armazenamento local seja limpo.
Para guardar uma consulta, introduza-a na caixa de consulta e selecione o ícone Guardar à direita do painel. Insira um nome para a consulta salva quando solicitado.
Depois que a consulta for salva, ela estará disponível para ser selecionada no menu suspenso Consultas salvas para executá-la facilmente novamente.
Para excluir uma consulta salva, selecione o ícone X ao lado do nome da consulta quando o menu suspenso Consultas salvas estiver aberto.
Gorjeta
Para gráficos grandes, sugere-se consultar apenas um subconjunto limitado e, em seguida, carregar o restante do gráfico conforme necessário. Você pode clicar duas vezes em um gêmeo no painel Gráfico gêmeo para recuperar nós relacionados adicionais.
Explore o gráfico gêmeo
O painel Twin Graph permite que você explore os gêmeos e relacionamentos em sua instância.
Você pode usar este painel para explorar dados gêmeos.
O painel Twin Graph também oferece várias habilidades para personalizar sua experiência de visualização de gráficos:
- Alterar propriedade de exibição dupla
- Editar layout de gráfico gêmeo
- Controle a expansão do gráfico duplo
- Mostrar e ocultar elementos de gráficos gêmeos
- Filtrar e realçar elementos de gráficos gêmeos
Explore dados gêmeos
Execute uma consulta usando o Gerenciador de Consultas para ver os gêmeos e relacionamentos no resultado da consulta exibido no painel Gráfico de gêmeos.
Gorjeta
A consulta para exibir todos os gêmeos e relacionamentos é SELECT * FROM digitaltwins.
Exibir propriedades de gêmeos e relacionamentos
Para exibir os valores de propriedade de um gêmeo ou de um relacionamento, selecione o gêmeo ou relacionamento no Gráfico de gêmeos e use o botão Alternar inspetor de propriedades para expandir o painel Propriedades gêmeas ou Propriedades de relacionamento, respectivamente. Este painel exibirá todas as propriedades associadas ao elemento, juntamente com seus valores. Ele também inclui valores padrão para propriedades que ainda não foram definidas.
Ícones de tipo de dados
As propriedades mostradas nos painéis Propriedades gêmeas e Propriedades de relacionamento são exibidas com um ícone, indicando o tipo de campo do modelo DTDL. Você pode passar o mouse sobre um ícone para exibir o tipo associado.
A tabela abaixo mostra os possíveis tipos de dados e seus ícones correspondentes. A tabela também contém links de cada tipo de dados para sua descrição de esquema na Descrição da Linguagem DTDL v3.
| Icon | Tipo de dados |
|---|---|
 |
Booleano |
 |
componente |
 |
data |
 |
dateTime |
 |
Duração |
 |
enum |
 |
mapa |
 |
Tipos numéricos, incluindo duplo, flutuante, inteiro e longo |
 |
objeto |
 |
string |
 |
Hora |
Erros
O painel Propriedades gêmeas exibirá mensagens de erro se o gêmeo ou algumas de suas propriedades não corresponderem mais ao modelo.
Há dois cenários de erro possíveis que cada um dá sua própria mensagem de erro:
- Faltam um ou vários modelos usados pelo gêmeo. Como resultado, todas as propriedades associadas a esse modelo serão sinalizadas como "ausentes" no painel Propriedades gêmeas. Este erro pode acontecer se o modelo tiver sido excluído desde que o gêmeo foi criado.
- Algumas propriedades do gêmeo não fazem parte do modelo do gêmeo. Somente essas propriedades serão sinalizadas como "ausentes" no painel Propriedades gêmeas. Esse erro pode acontecer se o modelo do gêmeo tiver sido substituído ou alterado desde que as propriedades foram definidas e as propriedades não existirem mais na versão mais recente do modelo.
Ambas as mensagens de erro são mostradas na captura de tela abaixo:
Valide e explore propriedades históricas
Se sua instância do Azure Digital Twins tiver o histórico de dados habilitado, você poderá validar e explorar seus dados históricos no Azure Digital Twins Explorer. Siga as etapas abaixo para visualizar dados históricos em um gráfico ou exibir valores brutos em uma tabela.
No visualizador Twin Graph, selecione um gêmeo cujas propriedades históricas você deseja exibir para abri-lo no painel Twin Properties. No canto superior direito do painel, selecione o ícone Série temporal para abrir o explorador do histórico de dados.
Selecione o nome do gêmeo à esquerda para exibir as opções para escolher quais propriedades históricas do gêmeo visualizar. O campo Twin ID será pré-preenchido com a seleção de gémeos. Ao lado deste campo, você pode selecionar o ícone Inspecionar propriedades para exibir os dados de gêmeos ou o ícone Pesquisa avançada de gêmeos para localizar outros gêmeos consultando valores de propriedade.
No campo Propriedade, selecione a propriedade cujos dados históricos você deseja visualizar. Se a propriedade não for numérica, mas consistir em valores numéricos, use a opção Cast property value to number para tentar converter esses dados em números para que possam ser visualizados no gráfico.
Nota
Se você não conseguir selecionar uma propriedade na lista suspensa porque a lista não está respondendo, isso pode significar que há um erro em algum modelo em sua instância. Por exemplo, ter valores de enum não exclusivos nos atributos de um modelo quebrará esse recurso. Se isso acontecer, revise as definições do modelo e verifique se todas as propriedades são válidas.
Escolha um Rótulo para a série temporal e selecione Atualizar.
Isso carregará a exibição de gráfico dos valores históricos para a propriedade escolhida. Você pode usar as guias acima do gráfico para alternar entre o modo de exibição de gráfico e o modo de exibição de tabela.
Para adicionar mais propriedades à visualização, use o botão Adicionar série temporal à esquerda.
Para sair do explorador do histórico de dados e regressar ao Explorador de Gêmeos Digitais do Azure principal, selecione Fechar.
Ver histórico no gráfico
A visualização Gráfico de propriedades historizadas mostra valores de propriedade como pontos em um gráfico de linhas ao longo do tempo.
Você pode usar os ícones acima do gráfico para controlar as configurações do gráfico, incluindo...
- alterar o intervalo de tempo dos dados incluídos no gráfico.
- Selecionar se várias séries temporais são mostradas independentemente ou em um eixo y compartilhado. Selecionar Independente para os eixos significa que cada série temporal será dimensionada para o gráfico e manterá seu próprio eixo para escala. Selecionar Eixos compartilhados significa que todos os dados de séries temporais serão dimensionados para o mesmo eixo.
- escolher a lógica de agregação para o gráfico. Quando a propriedade tem mais pontos de dados do que pode ser mostrado no gráfico, os dados serão agregados em um número finito de pontos de dados usando funções médias, mínimas ou máximas.
Há também um botão para Abrir consulta no Azure Data Explorer, onde você pode exibir e modificar a consulta atual para explorar ainda mais os dados de séries temporais.
Ver histórico na tabela
O modo de exibição Tabela de propriedades historizadas mostra valores de propriedade e seus carimbos de data/hora em uma tabela.
Você pode usar os ícones acima da tabela para controlar as configurações da tabela, incluindo...
- alterar o intervalo de tempo dos dados incluídos na tabela.
- Download dos dados da tabela para análise independente.
Ver as relações de um gémeo
Você também pode visualizar rapidamente o código de todos os relacionamentos que envolvem um determinado gêmeo (incluindo relacionamentos de entrada e saída).
Clique com o botão direito do mouse em um gêmeo no gráfico e escolha Obter relacionamentos. Isso gera um modal de Informações de Relacionamento exibindo a representação JSON de todos os relacionamentos de entrada e saída.
Alterar propriedade de exibição dupla
Você pode configurar qual propriedade gostaria de exibir para identificar gêmeos em seu gráfico de gêmeos. O padrão é o $dtId valor, mas você pode escolher entre quaisquer propriedades que existam em seu conjunto de modelos (mesmo aquelas que não estão presentes em todos os gêmeos).
Para alterar a propriedade de exibição, use o menu suspenso Select Twin Display Name Property . O menu suspenso é ordenado pelo número de modelos que contêm a propriedade.
Se você escolher uma propriedade que não esteja presente em todos os gêmeos, todos os gêmeos no gráfico que não tiverem essa propriedade serão exibidos com um asterisco (*) seguido de seu $dtId valor.
Editar layout de gráfico gêmeo
Você pode reorganizar os gêmeos em diferentes configurações clicando e arrastando-os pela tela Twin Graph.
Você também pode aplicar um dos vários algoritmos de layout ao gráfico a partir das opções no menu Escolher layout .
Controle a expansão do gráfico duplo
Ao visualizar um resultado de consulta no painel Gráfico gêmeo, você pode clicar duas vezes em um gêmeo para que o gráfico busque seus relacionamentos e gêmeos relacionados e os exiba se eles ainda não estiverem presentes na exibição. Você pode personalizar essa expansão definindo um tamanho e uma direção para determinar quantos gêmeos buscar.
Para definir o número de camadas a serem expandidas, use a opção Nível de expansão . Esse número indica quantas camadas de relacionamentos buscar do gêmeo selecionado.
Para indicar quais tipos de relações devem ser seguidas ao expandir, use o botão Direção de expansão . Isso permite que você selecione entre relacionamentos de entrada, saída ou entrada e saída.
Mostrar e ocultar elementos de gráficos gêmeos
Você pode alternar a opção para ocultar gêmeos ou relacionamentos da visualização de gráfico.
Para ocultar um gêmeo ou relacionamento, clique com o botão direito do mouse nele na janela Twin Graph . Isso abrirá um menu com opções para ocultar o elemento ou outros elementos relacionados.
Você também pode ocultar vários gêmeos ou relacionamentos ao mesmo tempo usando as teclas CTRL/CMD ou SHIFT para selecionar vários elementos do mesmo tipo no gráfico. A partir daqui, siga o mesmo processo de clique com o botão direito do rato para ver as opções de ocultação.
Para voltar a mostrar todos os gémeos depois de alguns terem estado escondidos, utilize o botão Mostrar Tudo . Para voltar a mostrar todas as relações, use o botão Mostrar todas as relações .
Filtrar e realçar elementos de gráficos gêmeos
Você pode filtrar os gêmeos e relacionamentos que aparecem no gráfico por texto, selecionando este ícone Filtro :
Você também pode destacar os gêmeos e relacionamentos que aparecem no gráfico por texto, selecionando este ícone Realce :
Gerenciar gêmeos e gráfico
O Azure Digital Twins Explorer fornece várias maneiras de gerenciar os gêmeos e relacionamentos em sua instância.
Esta seção descreve como executar as seguintes atividades de gerenciamento:
- Ver lista plana de gémeos e relacionamentos
- Crie gémeos, com ou sem propriedades iniciais
- Criar relações entre gémeos
- Editar propriedades de gêmeos e relacionamentos
- Excluir gêmeos e relacionamentos
Para obter informações sobre a experiência de visualização de gémeos e relações, consulte Explorar gémeos e o gráfico de gémeos.
Ver lista plana de gémeos e relacionamentos
O painel Gêmeos mostra uma lista simples de seus gêmeos e seus relacionamentos associados. Você pode pesquisar gêmeos pelo nome e expandi-los para obter detalhes sobre seus relacionamentos de entrada e saída.
Criar gémeos
Você pode criar um novo gêmeo digital a partir de sua definição de modelo no painel Modelos .
Para criar um gêmeo a partir de um modelo, localize esse modelo na lista e escolha os pontos de menu ao lado do nome do modelo. Em seguida, selecione Criar um gêmeo. Ser-lhe-á pedido que introduza um nome para o novo gémeo, que deve ser único. Em seguida, salve o gêmeo, que irá adicioná-lo ao seu gráfico.
Para adicionar valores de propriedade ao seu gêmeo, consulte Editar propriedades de gêmeo e relacionamento.
Criar relações
Para criar uma relação entre dois gémeos, comece por selecionar o gémeo de origem para a relação na janela Twin Graph . Em seguida, mantenha pressionada uma tecla CTRL/CMD ou SHIFT enquanto seleciona um segundo gêmeo para ser o alvo da relação.
Quando os dois gêmeos forem selecionados simultaneamente, clique com o botão direito do mouse no gêmeo de destino para abrir um menu com uma opção para Adicionar relações entre eles.
Isso abrirá a caixa de diálogo Criar relacionamento, preenchida com o gêmeo de origem e o gêmeo de destino do relacionamento (você também pode usar o ícone Trocar relação para alterná-los). Há um menu suspenso Relacionamento que contém os tipos de relacionamento que o gêmeo de origem pode ter, de acordo com seu modelo DTDL. Selecione uma opção para o tipo de relação e Salve a nova relação.
Editar propriedades de gêmeos e relacionamentos
Para exibir os valores de propriedade de um gêmeo ou de um relacionamento, selecione o elemento no Gráfico de gêmeos e use o botão Alternar inspetor de propriedades para expandir o painel Propriedades gêmeas ou Propriedades derelacionamento, respectivamente.
Você pode usar esse painel para editar diretamente as propriedades graváveis. Atualize seus valores embutidos e selecione o botão Salvar alterações na parte superior do painel para salvar. Quando a atualização é salva, a tela exibe uma janela modal mostrando a operação de patch JSON que foi aplicada pela API de atualização.
Gorjeta
As propriedades mostradas nos painéis Propriedades gêmeas e Propriedades de relacionamento são exibidas com um ícone, indicando o tipo de campo do modelo DTDL. Para obter mais informações sobre os ícones de tipo, consulte Ícones de tipo de dados.
Excluir gêmeos e relacionamentos
Para excluir um gêmeo ou um relacionamento, clique com o botão direito do mouse nele na janela Twin Graph . Isso abrirá um menu com uma opção para excluir o elemento.
Você pode excluir vários gêmeos ou vários relacionamentos ao mesmo tempo, usando as teclas CTRL/CMD ou SHIFT para selecionar vários elementos do mesmo tipo no gráfico. A partir daqui, siga o mesmo processo de clique com o botão direito do mouse para excluir os elementos.
Você também pode optar por excluir todos os gêmeos em sua instância ao mesmo tempo, usando o botão Excluir todos os gêmeos na barra de ferramentas superior.
Explore modelos e o gráfico de modelos
Os modelos podem ser visualizados no painel Modelos, no lado esquerdo do ecrã do Azure Digital Twins Explorer, e no painel Gráfico de Modelo, no meio do ecrã.
O painel Modelos : 
O painel Gráfico modelo: 
Nota
Atualmente, o Azure Digital Twins Explorer suporta totalmente modelos DTDL v2 e suporta funcionalidade limitada para modelos DTDL v3. No Azure Digital Twins Explorer, os modelos DTDL v3 podem ser exibidos no painel Modelos e os gêmeos criados com modelos DTDL v3 podem ser exibidos e editados (incluindo aqueles com propriedades de matriz). No entanto, os modelos DTDL v3 não aparecerão no painel Gráfico de modelo e não podem ser importados usando o Azure Digital Twins Explorer. Para importar modelos DTDL v3 para sua instância, use outra interface de desenvolvedor, como APIs e SDKs ou a CLI do Azure.
Pode utilizar estes painéis para visualizar os seus modelos.
O painel Gráfico modelo também fornece várias habilidades para personalizar sua experiência de visualização de gráfico:
- Editar layout de gráfico de modelo
- Filtrar e realçar elementos do gráfico do modelo
- Carregue imagens de modelo para representar modelos nos gráficos
Ver modelos
Você pode exibir uma lista simples dos modelos em sua instância no painel Modelos . Esta lista pode ser pesquisada usando a barra de pesquisa no painel.
Você pode usar o painel Gráfico de modelo para exibir uma representação gráfica dos modelos em sua instância, juntamente com as relações, herança e componentes que os conectam uns aos outros.
Nota
Atualmente, o Azure Digital Twins Explorer suporta totalmente modelos DTDL v2 e suporta funcionalidade limitada para modelos DTDL v3. No Azure Digital Twins Explorer, os modelos DTDL v3 podem ser exibidos no painel Modelos e os gêmeos criados com modelos DTDL v3 podem ser exibidos e editados (incluindo aqueles com propriedades de matriz). No entanto, os modelos DTDL v3 não aparecerão no painel Gráfico de modelo e não podem ser importados usando o Azure Digital Twins Explorer. Para importar modelos DTDL v3 para sua instância, use outra interface de desenvolvedor, como APIs e SDKs ou a CLI do Azure.
Ver definição de modelo
Para ver a definição completa de um modelo, localize esse modelo no painel Modelos e selecione os pontos de menu ao lado do nome do modelo. Em seguida, selecione Exibir modelo. Isso exibirá um modal de Informações do Modelo mostrando a definição DTDL bruta do modelo.
Você também pode visualizar a definição completa de um modelo selecionando-o no Gráfico do modelo e usando o botão Alternar detalhes do modelo para expandir o painel Detalhes do modelo. Este painel também exibirá o código DTDL completo para o modelo.
Editar layout de gráfico de modelo
Você pode reorganizar os modelos em diferentes configurações clicando e arrastando-os pela tela Gráfico do modelo.
Você também pode aplicar um dos vários algoritmos de layout ao gráfico do modelo a partir das opções no menu Escolher layout .
Filtrar e realçar elementos do gráfico do modelo
Você pode filtrar os tipos de referências de modelo que aparecem no Gráfico de modelo. Desligar um dos tipos de referência através dos interruptores neste menu impedirá que esse tipo de referência seja exibido no gráfico.
Você também pode filtrar os modelos e referências que aparecem no gráfico por texto, selecionando este ícone Filtro :
Você pode destacar os modelos e referências que aparecem no gráfico por texto, selecionando este ícone Realce :
Carregar imagens de modelo
Você pode carregar imagens personalizadas para representar modelos diferentes nas visualizações Gráfico modelo e Gráfico gêmeo. Pode carregar imagens para modelos individuais ou para vários modelos de uma só vez.
Nota
Essas imagens são armazenadas no armazenamento local do navegador. Isso significa que as imagens não estarão disponíveis em outros navegadores além daquele em que você as salvou, e elas permanecerão no armazenamento do navegador indefinidamente até que o armazenamento local seja limpo.
Para carregar uma imagem para um único modelo, localize esse modelo no painel Modelos e selecione os pontos de menu ao lado do nome do modelo. Em seguida, selecione Carregar imagem do modelo. Na caixa de seleção de ficheiros apresentada, navegue na sua máquina até ao ficheiro de imagem que pretende carregar para esse modelo. Escolha Abrir para carregá-lo.
Você também pode carregar imagens de modelo em massa.
Primeiro, use as instruções a seguir para definir os nomes dos arquivos de imagem antes de fazer o upload. Isso permite que o Azure Digital Twins Explorer atribua automaticamente as imagens aos modelos corretos após o carregamento.
- Comece com o valor da ID do modelo (por exemplo,
dtmi:example:Floor;1) - Substitua instâncias de ":" por "_" (o exemplo torna-se
dtmi_example_Floor;1) - Substitua instâncias de ";" por "-" (o exemplo torna-se
dtmi_example_Floor-1) - Verifique se o arquivo tem uma extensão de imagem (o exemplo se torna algo como
dtmi_example_Floor-1.png)
Nota
Se você tentar carregar uma imagem que não seja mapeada para nenhum modelo existente usando os critérios acima, a imagem não será carregada ou armazenada.
Em seguida, para carregar as imagens ao mesmo tempo, use o ícone Carregar imagens do modelo na parte superior do painel Modelos. Na caixa seletor de arquivos, escolha quais arquivos de imagem carregar.
Gerir modelos
Você pode usar o painel Modelos no lado esquerdo da tela do Azure Digital Twins Explorer para executar atividades de gerenciamento em todo o conjunto de modelos ou em modelos individuais.
Com este painel, você pode concluir as seguintes atividades de gerenciamento de modelo:
- Carregar modelos na sua instância do Azure Digital Twins
- Excluir modelos da instância
- Atualizar modelos para recarregar a lista de todos os modelos neste painel
Para obter informações sobre a experiência de visualização de modelos, consulte Explorar modelos e o Gráfico de modelos.
Carregar modelos
Você pode carregar modelos de sua máquina selecionando arquivos de modelo individualmente ou carregando uma pasta inteira de arquivos de modelo de uma só vez. Se você estiver carregando um arquivo JSON que contém o código para muitos modelos, certifique-se de revisar as limitações de carregamento de modelo em massa.
Nota
Atualmente, o Azure Digital Twins Explorer suporta totalmente modelos DTDL v2 e suporta funcionalidade limitada para modelos DTDL v3. No Azure Digital Twins Explorer, os modelos DTDL v3 podem ser exibidos no painel Modelos e os gêmeos criados com modelos DTDL v3 podem ser exibidos e editados (incluindo aqueles com propriedades de matriz). No entanto, os modelos DTDL v3 não aparecerão no painel Gráfico de modelo e não podem ser importados usando o Azure Digital Twins Explorer. Para importar modelos DTDL v3 para sua instância, use outra interface de desenvolvedor, como APIs e SDKs ou a CLI do Azure.
Para carregar um ou mais modelos selecionados individualmente, selecione o ícone Carregar um modelo mostrando uma seta para cima.
Na caixa de seleção de ficheiros apresentada, navegue na sua máquina até ao(s) modelo(s) que pretende carregar. Você pode selecionar um ou mais arquivos de modelo JSON e selecionar Abrir para carregá-los.
Para carregar uma pasta de modelos, incluindo tudo o que está dentro dela, selecione o ícone Carregar um diretório de modelos mostrando uma pasta de arquivo.
Na caixa de seletor de arquivos exibida, navegue em sua máquina até uma pasta que contenha arquivos de modelo JSON. Selecione Abrir para carregar essa pasta de nível superior e todo o seu conteúdo.
Importante
Se um modelo fizer referência a outro modelo em sua definição, como quando você está definindo relacionamentos ou componentes, o modelo que está sendo referenciado precisa estar presente na instância para carregar o modelo que o usa. Se estiver a carregar modelos um a um, isso significa que deve carregar o modelo que está a ser referenciado antes de carregar quaisquer modelos que o utilizem. Se você estiver carregando modelos em massa, poderá selecioná-los todos na mesma importação e os Gêmeos Digitais do Azure inferirão a ordem para carregá-los. No entanto, se você estiver carregando mais de 50 modelos no mesmo arquivo, consulte as limitações de carregamento de modelo em massa.
Limitações do carregamento de modelos em massa
As limitações nesta seção se aplicam a modelos contidos em um único arquivo JSON, sendo carregados no Azure Digital Twins Explorer ao mesmo tempo.
Embora não haja limite para quantos modelos você pode incluir com um único arquivo JSON, há considerações especiais para arquivos que contêm mais de 50 modelos. Se você estiver carregando mais de 50 modelos no mesmo arquivo de modelo, siga estas dicas:
- Se houver modelos que herdam de outros modelos definidos no mesmo arquivo, coloque-os perto do final da lista.
- Se houver algum modelo que faça referência a outros modelos definidos no mesmo arquivo como componentes, coloque-o perto do final da lista.
- Verifique se sempre que um modelo faz referência a outro modelo definido no mesmo arquivo (por herança ou como componente), o modelo que contém a referência vem mais tarde na lista do que a definição de modelo referenciado.
Isso ajudará a garantir que as dependências do modelo sejam resolvidas corretamente durante o processo de carregamento.
Excluir modelos
Você pode usar o painel Modelos para excluir modelos individuais ou todos os modelos em sua instância de uma só vez.
Para excluir um único modelo, localize esse modelo na lista e selecione os pontos de menu ao lado do nome do modelo. Em seguida, selecione Excluir modelo.
Para excluir todos os modelos em sua instância de uma só vez, escolha o ícone Excluir todos os modelos na parte superior do painel Modelos.
Atualizar modelos
Quando você abre o Azure Digital Twins Explorer, o painel Modelos deve mostrar automaticamente todos os modelos disponíveis em seu ambiente.
No entanto, você pode atualizar manualmente o painel a qualquer momento para recarregar a lista de todos os modelos em sua instância do Azure Digital Twins. Para fazer isso, selecione o ícone Atualizar modelos .
Gráfico de importação/exportação
No painel Twin Graph , você tem as opções para importar e exportar recursos de gráfico.
Importar gráfico
Você pode usar o recurso de importação para adicionar gêmeos, relacionamentos e modelos à sua instância. Esse recurso pode ser útil para criar muitos gêmeos, relacionamentos e/ou modelos ao mesmo tempo.
Nota
Se o arquivo de importação do gráfico incluir modelos, eles estarão sujeitos às limitações de carregamento de modelo em massa.
Criar arquivo de importação
A primeira etapa na importação de um gráfico é criar um arquivo que represente os gêmeos e os relacionamentos que você deseja adicionar.
O arquivo de importação pode estar em qualquer um destes dois formatos:
- O formato baseado em JSON gerado na exportação de gráficos. Esse formato pode conter gêmeos, relacionamentos e/ou modelos.
- O formato personalizado baseado no Excel descrito no restante desta seção. Este formato permite-lhe carregar gémeos e relações.
Criar arquivo de importação no Excel
Para criar um gráfico personalizado no Excel que possa carregar gêmeos e relacionamentos no Azure Digital Twins Explorer, use o seguinte formato.
Cada linha representa um elemento a ser criado: um gêmeo, um relacionamento ou uma combinação de gêmeo e relacionamento correspondente. Use as colunas a seguir para estruturar os dados de gêmeos ou relacionamentos. Os nomes das colunas podem ser personalizados, mas devem permanecer nesta ordem.
| ID do modelo | ID | Relação (fonte) | Nome da Relação | Dados de inicialização |
|---|---|---|---|---|
| (Opcional) O ID DTMI do modelo a ser usado para o novo gêmeo. Esta definição de modelo já deveria existir na instância. Você pode deixar esta coluna em branco para uma linha se quiser que essa linha crie apenas um relacionamento (sem gêmeos). |
(Obrigatório) O ID único para um gémeo. Se um novo gêmeo estiver sendo criado nessa linha, esse valor será a ID do novo gêmeo. Se houver informações de relacionamento na linha, essa ID será usada como o destino da relação. |
(Opcional) A identificação de um gémeo que deve ser o gémeo de origem para uma nova relação. Você pode deixar esta coluna em branco para uma linha se quiser que essa linha crie apenas um gêmeo (sem relacionamentos). |
(Opcional) O nome da nova relação a ser criada. A direção da relação será do gêmeo na coluna C para o gêmeo na coluna B. |
(Opcional) Uma cadeia de caracteres JSON contendo configurações de propriedade para o gêmeo a ser criado. As propriedades devem corresponder às definidas no modelo da coluna A. |
Aqui está um exemplo .xlsx arquivo que cria um pequeno gráfico de dois andares e duas salas.
Você pode exibir esse arquivo e outros exemplos de gráficos .xlsx no repositório do Azure Digital Twins Explorer no GitHub.
Nota
As propriedades e relações descritas no .xlsx devem corresponder ao que está definido nas definições de modelo para os gêmeos relacionados.
Importar arquivo para o Azure Digital Twins Explorer
Depois de ter um arquivo em sua máquina pronto para ser importado, selecione o ícone Importar gráfico no painel Gráfico gêmeo.
Na caixa de seletor de arquivos exibida, navegue em sua máquina até o arquivo gráfico (.xlsx ou .json) que você deseja carregar e escolha Abrir para carregá-lo.
Os Gêmeos Digitais do Azure abrirão um painel Importar mostrando uma visualização do gráfico a ser importado. Para confirmar, selecione o ícone Salvar no canto superior direito do painel.
Se a importação for bem-sucedida, uma janela modal exibirá o número de modelos, gêmeos e relacionamentos que foram carregados.
Exportar gráfico e modelos
Você pode usar o recurso de exportação para exportar gráficos parciais ou completos, incluindo modelos, gêmeos e relacionamentos. Exportar serializa os gêmeos e relacionamentos dos resultados de consulta mais recentes, bem como todos os modelos na instância, para um formato baseado em JSON que você pode baixar para sua máquina.
Para começar, use o painel Explorador de Consultas para executar uma consulta que seleciona os gêmeos e os relacionamentos que você deseja baixar. Isso irá preenchê-los no painel Twin Graph.
Gorjeta
A consulta para exibir todos os gêmeos e relacionamentos é SELECT * FROM digitaltwins.
Quando o painel Twin Graph estiver mostrando a parte do gráfico que você deseja baixar, selecione o ícone Exportar gráfico .
Esta ação ativa um link Download na caixa Twin Graph. Selecione-o para baixar uma representação baseada em JSON do resultado da consulta e de todos os modelos em sua instância para sua máquina.
Gorjeta
Este ficheiro pode ser editado e/ou recarregado para os Gêmeos Digitais do Azure através da funcionalidade de importação .
Link para seu ambiente e consulta específica
Você pode compartilhar um link para seu ambiente do Azure Digital Twins Explorer com outras pessoas para colaborar no trabalho. Esta seção descreve como gerar um link para seu ambiente do Azure Digital Twins Explorer, que opcionalmente pode incluir uma consulta específica para ser executada quando o link é aberto. Esta seção também descreve quais permissões o destinatário precisa ter para interagir com seus dados gêmeos.
Requisitos de acesso do destinatário
Para que o destinatário abra o link e exiba a instância no Azure Digital Twins Explorer, ele deve fazer logon em sua conta do Azure e ter acesso ao Azure Digital Twins Data Reader à instância (você pode ler mais sobre as funções do Azure Digital Twins em Segurança).
Para que o destinatário faça alterações no gráfico e nos dados, ele deve ter a função de Proprietário de Dados dos Gêmeos Digitais do Azure na instância.
Gerar link para o ambiente com consulta específica
Para gerar um link para seu ambiente do Azure Digital Twins Explorer que inclua uma consulta específica, insira a consulta que deseja capturar no Gerenciador de Consultas e selecione o botão Compartilhar para copiar o link completo.
Para o exemplo e consulta na captura de tela acima, o botão Compartilhar produz este link: https://explorer.digitaltwins.azure.net/?query=SELECT%20*%20FROM%20digitaltwins%20T%20WHERE%20T.InFlow%20%3E%2070&tid=<tenant-ID>&eid=<Azure-Digital-Twins-instance-host-name>. O link contém a ID do locatário e o nome do host da instância do Azure Digital Twins, bem como o texto de consulta formatado.
Pode partilhar este URL para permitir que alguém aceda à sua instância e a esta consulta. Quando eles abrem o Azure Digital Twins Explorer com o link, os resultados da consulta serão preenchidos automaticamente no painel Twin Graph .
Gerar link para o ambiente sem consulta específica
Para compartilhar um link para seu ambiente do Azure Digital Twins Explorer sem nenhuma consulta específica anexada, comece usando o botão Compartilhar para copiar o link para sua instância.
Em seguida, remova manualmente o parâmetro de consulta do resultado.
Por exemplo, o botão Compartilhar na captura de tela acima produziria este link: https://explorer.digitaltwins.azure.net/?query=SELECT%20*%20FROM%20digitaltwins&tid=<tenant-ID>&eid=<Azure-Digital-Twins-instance-host-name>. Você pode remover a query=SELECT%20*%20FROM%20digitaltwins& parte para produzir o URL https://explorer.digitaltwins.azure.net/?tid=<tenant-ID>&eid=<Azure-Digital-Twins-instance-host-name>.
Em seguida, compartilhe essa URL para permitir que alguém acesse sua instância. Quando eles abrirem o Azure Digital Twins Explorer com o link, eles estarão conectados à sua instância e não verão nenhum resultado de consulta pré-preenchido.
Acessibilidade e configurações avançadas
Você pode habilitar várias configurações avançadas para o Azure Digital Twins Explorer para personalizar sua experiência ou torná-la mais acessível.
Pode utilizar o ícone Atalhos de Teclado na barra de ferramentas no canto superior direito para ver uma lista de atalhos de teclado que podem ser utilizados para navegar no Azure Digital Twins Explorer.
Existem vários recursos avançados que podem ser acessados na engrenagem Configurações na barra de ferramentas superior direita:
- Carregamento ansioso: quando uma consulta retorna gêmeos que têm relações com outros gêmeos que não estão incluídos nos resultados da consulta, esse recurso carregará os gêmeos "ausentes" antes de renderizar o gráfico.
- Cache: Quando esse recurso está habilitado, o Azure Digital Twins Explorer manterá um cache local de relacionamentos e modelos na memória para melhorar o desempenho da consulta. Esses caches são limpos em quaisquer operações de gravação nos elementos relevantes, bem como na atualização do navegador. Esse recurso está desativado por padrão.
- Console: Este recurso permite a exibição de uma janela de console, capaz de usar funções simples de shell para trabalhar com o gráfico.
- Saída: Este recurso permite a exibição de uma janela de saída, que mostra um rastreamento de diagnóstico de operações.
- Alto Contraste: este recurso altera as cores do Azure Digital Twins Explorer para que elas apareçam com maior contraste.
Você pode personalizar o layout do painel editando as posições dos painéis que compõem o Azure Digital Twins Explorer (Query Explorer, Twins, Models, Twin Graph, Model Graph). Para mover um painel para um local diferente, clique e mantenha pressionado o nome do painel e arraste-o para a nova posição desejada.
As posições do painel serão redefinidas após a atualização da janela do navegador.
Próximos passos
Saiba mais sobre como escrever consultas para o gráfico de gêmeos do Azure Digital Twins: