Partilhar via


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

Captura de ecrã do portal do Azure a mostrar a página Descrição Geral de uma instância dos Gêmeos Digitais do Azure. Há um destaque em torno do botão Open 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.)

Captura de ecrã do Azure Digital Twins Explorer. O modal URL dos Gêmeos Digitais do Azure exibe uma caixa editável vazia para a URL dos Gêmeos Digitais do Azure.

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.

Importante

O Azure Digital Twins Explorer não suporta pontos de extremidade privados. Se quiser usar o Azure Digital Twins Explorer com uma instância do Azure Digital Twins que usa o Private Link para desabilitar o acesso público, você pode 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.

Captura de ecrã do Azure Digital Twins Explorer. O nome da ocorrência na barra de ferramentas superior é realçado.

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.

Captura de ecrã do Azure Digital Twins Explorer. O modal de URL dos Gêmeos Digitais do Azure exibe uma caixa editável contendo https:// e um nome de host.

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.

Captura de ecrã do Azure Digital Twins Explorer. O painel Explorador de Consultas está realçado.

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.

Captura de ecrã do painel Azure Digital Twins Explorer Query Explorer. A caixa Resultados da sobreposição está marcada e dois gêmeos são realçados no gráfico maior mostrado no painel Gráfico gêmeo.

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.

Captura de ecrã do painel Azure Digital Twins Explorer Query Explorer. O ícone Salvar está realçado.

Depois que a consulta for salva, ela estará disponível para ser selecionada no menu suspenso Consultas salvas para executá-la facilmente novamente.

Captura de ecrã do painel Azure Digital Twins Explorer Query Explorer. O menu suspenso Consultas salvas está realçado e mostra duas consultas de exemplo.

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.

Captura de ecrã do Azure Digital Twins Explorer. O painel Twin Graph está realçado.

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:

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.

Captura de ecrã do painel Azure Digital Twins Explorer Twin Graph. O gêmeo FactoryA é selecionado e o painel Propriedades do gêmeo é expandido, mostrando as propriedades do gêmeo.

Í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.

Ícone Tipo de dados
ícone booleano boolean
ícone do componente componente
ícone de data data
Ícone dateTime dateTime
ícone de duração Duração
ícone enum enum
ícone do mapa mapa
ícone numérico Tipos numéricos, incluindo duplo, flutuante, inteiro e longo
ícone de objeto objeto
ícone de cadeia de caracteres string
ícone de hora 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:

Captura de ecrã do painel Propriedades Twin do Azure Digital Twins Explorer, mostrando duas mensagens de erro. Um erro indica que os modelos estão faltando e o outro indica que as propriedades estão faltando um modelo.

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.

  1. 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.

    Captura de ecrã do painel Propriedades Twin do Azure Digital Twins Explorer, realçando o ícone para abrir o explorador do histórico de dados.

  2. 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.

    Captura de tela do explorador de histórico de dados e um modal solicitando detalhes de gêmeos e propriedades.

  3. 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.

    Captura de ecrã do explorador de histórico de dados com os detalhes da propriedade realçados.

    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.

  4. 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.

Captura de ecrã do explorador de histórico de dados a realçar a opção para adicionar outra série cronológica.

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.

Captura de tela do explorador de histórico de dados mostrando um gráfico de valores históricos de uma propriedade.

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.

Captura de ecrã do botão para abrir consulta no Azure Data Explorer.

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.

Captura de tela do explorador de histórico de dados mostrando uma tabela de valores históricos para uma propriedade.

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.

Captura de ecrã do painel Azure Digital Twins Explorer Twin Graph. O centro da tela exibe um modal de Informações de Relacionamento mostrando as relações 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.

Captura de ecrã do painel Azure Digital Twins Explorer Twin Graph. O botão Select Twin Display Name Property (Selecionar propriedade de nome de exibição de gêmeos) é realçado, mostrando um menu que lista diferentes propriedades dos gêmeos no gráfico.

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 .

Captura de ecrã do painel Azure Digital Twins Explorer Twin Graph. O botão Escolher layout é realçado, mostrando um menu com as opções de layout Cola, Dagre, fCoSE e Klay.

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.

Captura de ecrã do painel Azure Digital Twins Explorer Twin Graph. O botão Nível de expansão é realçado.

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.

Captura de ecrã do painel Azure Digital Twins Explorer Twin Graph. O botão Direção de expansão é realçado, mostrando um menu com as opções Entrada, Saída e Entrada/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.

Captura de ecrã do painel Azure Digital Twins Explorer Twin Graph. O gêmeo FactoryA está selecionado e há um menu contendo opções para Ocultar selecionado, Ocultar selecionado + Crianças, Ocultar todos os outros e Ocultar não crianças.

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 .

Captura de ecrã do painel Azure Digital Twins Explorer Twin Graph. Os botões Mostrar Tudo e Mostrar Todas as Relações são realçados.

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 :

Captura de ecrã do painel Azure Digital Twins Explorer Twin Graph. O ícone de filtro de texto está selecionado, mostrando a guia Filtro onde você pode inserir um termo de pesquisa.

Você também pode destacar os gêmeos e relacionamentos que aparecem no gráfico por texto, selecionando este ícone Realce :

Captura de ecrã do painel Azure Digital Twins Explorer Twin Graph. O ícone de filtro de texto está selecionado, mostrando a guia Realce onde você pode inserir um termo de pesquisa.

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:

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.

Captura de ecrã do painel Azure Digital Twins Explorer Twins. Um gêmeo é destacado e suas relações são mostradas.

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.

Captura de ecrã do painel Azure Digital Twins Explorer Models. Os pontos de menu para um único modelo são realçados, e a opção de menu para Criar um gêmeo também é realçada.

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.

Captura de ecrã do painel Azure Digital Twins Explorer Twin Graph. Os gêmeos FactoryA e Consumer são selecionados, e um menu mostra a opção Adicionar relacionamentos.

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 de relacionamento, respectivamente.

Captura de ecrã do painel Azure Digital Twins Explorer Twin Graph. O gêmeo FactoryA é selecionado e o painel Propriedades do gêmeo é expandido, mostrando as propriedades do gêmeo.

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.

Captura de ecrã do painel Azure Digital Twins Explorer Twin Graph. O centro da tela exibe um modal de informações de caminho mostrando o código de patch JSON.

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.

Captura de ecrã do painel Azure Digital Twins Explorer Twin Graph. O gêmeo FactoryA está selecionado e há um menu contendo uma opção para Excluir gêmeo(s).

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.

Captura de ecrã do Azure Digital Twins Explorer. O ícone Excluir todos os gêmeos está selecionado.

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 : Captura de ecrã do Azure Digital Twins Explorer. O painel Modelos está realçado.

O painel Gráfico modelo: Captura de ecrã do Azure Digital Twins Explorer. O painel Gráfico do modelo é realçado.

Nota

Atualmente, o Azure Digital Twins Explorer suporta totalmente modelos DTDL v2 e suporta funcionalidade limitada para modelos DTDL v3.

Os modelos DTDL v3 podem ser visualizados no painel Modelos, e os gêmeos criados com modelos DTDL v3 podem ser visualizados 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:

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.

Os modelos DTDL v3 podem ser visualizados no painel Modelos, e os gêmeos criados com modelos DTDL v3 podem ser visualizados 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.

Captura de ecrã do painel Azure Digital Twins Explorer Models. Os pontos de menu para um único modelo são realçados, e a opção de menu para Exibir modelo também é realçada.

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.

Captura de ecrã do painel Azure Digital Twins Explorer Model Graph. O modelo de piso é selecionado e o painel Model DetailS é expandido, mostrando o código DTDL do 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 .

Captura de ecrã do painel Azure Digital Twins Explorer Model Graph. O botão Escolher layout é realçado, mostrando um menu com as opções de layout Cola, Dagre, fCoSE, Klay e d3Force.

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.

Captura de ecrã do painel Azure Digital Twins Explorer Model Graph. O menu de filtro para Relações, Herança e Componentes é realçado.

Você também pode filtrar os modelos e referências que aparecem no gráfico por texto, selecionando este ícone Filtro :

Captura de ecrã do painel Azure Digital Twins Explorer Model Graph. O ícone de filtro de texto está selecionado, mostrando a guia Filtro onde você pode inserir um termo de pesquisa.

Você pode destacar os modelos e referências que aparecem no gráfico por texto, selecionando este ícone Realce :

Captura de ecrã do painel Azure Digital Twins Explorer Model Graph. O ícone de filtro de texto está selecionado, mostrando a guia Realce onde você pode inserir um termo de pesquisa.

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.

Captura de ecrã do painel Azure Digital Twins Explorer Models. Os pontos de menu para um único modelo são realçados e a opção de menu para Carregar imagem do modelo também é realçada.

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.

  1. Comece com o valor da ID do modelo (por exemplo, dtmi:example:Floor;1)
  2. Substitua instâncias de ":" por "_" (o exemplo torna-se dtmi_example_Floor;1)
  3. Substitua instâncias de ";" por "-" (o exemplo torna-se dtmi_example_Floor-1)
  4. 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.

Captura de ecrã do painel Azure Digital Twins Explorer Models. O ícone Carregar imagens do modelo está realçado.

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.

Captura de ecrã do Azure Digital Twins Explorer. O painel Modelos está realçado.

Com este painel, você pode concluir as seguintes atividades de gerenciamento de modelo:

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.

Os modelos DTDL v3 podem ser visualizados no painel Modelos, e os gêmeos criados com modelos DTDL v3 podem ser visualizados 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.

Captura de ecrã do painel Azure Digital Twins Explorer Models. O ícone Carregar um modelo está realçado.

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.

Captura de ecrã do painel Azure Digital Twins Explorer Models. O ícone Carregar um diretório de modelos está realçado.

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.

Captura de ecrã do painel Azure Digital Twins Explorer Models. Os pontos de menu para um único modelo são realçados e a opção de menu para Excluir modelo também é realçada.

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.

Captura de ecrã do painel Azure Digital Twins Explorer Models. O ícone Excluir todos os modelos está realçado.

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 .

Captura de ecrã do painel Azure Digital Twins Explorer Models. O ícone Atualizar modelos está realçado.

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.

Captura de ecrã dos dados do gráfico no Excel. Os cabeçalhos das colunas correspondem aos campos acima, em ordem, e as linhas contêm valores de dados correspondentes.

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.

Captura de ecrã do painel Azure Digital Twins Explorer Twin Graph. O botão Importar gráfico está realçado.

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.

Captura de ecrã do painel Azure Digital Twins Explorer Twin Graph. O centro da tela exibe um modal Importação bem-sucedida mostrando quatro gêmeos importados e dois relacionamentos importados.

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 .

Captura de ecrã do painel Azure Digital Twins Explorer Twin Graph. O botão Exportar gráfico está realçado.

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 .

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.

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.

Captura de ecrã do painel Azure Digital Twins Explorer Query Explorer. O texto da consulta e o botão Enviar são realçados.

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 .

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.

Captura de ecrã do painel Azure Digital Twins Explorer Query Explorer. Apenas o botão Enviar está realçado.

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.

Captura de ecrã do Azure Digital Twins Explorer. O ícone Atalhos de teclado está realçado na barra de ferramentas superior.

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.

Captura de ecrã do Azure Digital Twins Explorer. Os nomes dos painéis Explorador de Consultas, Modelos, Twin Graph e Model Graph são realçados.

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: