Utilizar o Explorador do Azure Digital Twins (pré-visualização)

O Azure Digital Twins Explorer (pré-visualização) é uma ferramenta para visualizar e trabalhar com o Azure Digital Twins. Este artigo descreve as funcionalidades do Azure Digital Twins Explorer e como utilizá-los para gerir os dados na sua instância do Azure Digital Twins. Pode interagir com o Explorador do Azure Digital Twins com cliques ou atalhos de teclado.

Como aceder

A principal forma de aceder ao Azure Digital Twins Explorer é através do portal do Azure.

Para abrir o Azure Digital Twins Explorer para uma instância do Azure Digital Twins, navegue primeiro para a instância no portal ao procurar o respetivo nome na barra de pesquisa do portal.

Em seguida, selecione o botão Abrir o Explorador do Azure Digital Twins (pré-visualização ).

Captura de ecrã do portal do Azure a mostrar a página Descrição geral de uma instância do Azure Digital Twins. Existe um destaque em torno do botão Abrir o Explorador do Azure Digital Twins (pré-visualização).

Esta ação irá abrir o Explorador do Azure Digital Twins num novo separador. Se esta for a primeira vez que utiliza o Explorador, verá um modal de boas-vindas a resumir as suas principais funcionalidades.

O Explorador do Azure Digital Twins pode ligar-se automaticamente à sua instância. Caso contrário, verá o ecrã seguinte a pedir-lhe para especificar um URL do Azure Digital Twins. (Se não vir esta caixa no ecrã, o Explorador do Azure Digital Twins já concluiu este passo automaticamente.)

Captura de ecrã do Explorador do Azure Digital Twins. O modal de URL do Azure Digital Twins apresenta uma caixa editável vazia para o URL do Azure Digital Twins.

Se vir esta caixa, introduza https:// no campo, seguido do nome do anfitrião da sua instância (isto pode ser encontrado novamente na página Descrição Geral da instância no portal). Estes valores, em conjunto, compõem o URL da instância. Selecione Guardar para ligar à sua instância.

Nota

O Azure Digital Twins Explorer alojado só pode aceder a instâncias do Azure Digital Twins com acesso público ativado. Se estiver a utilizar Private Link para restringir o acesso à sua instância através de um ponto final privado, pode utilizar as funções do Azure para implementar a base de código do Azure Digital Twins Explorer em privado na cloud. Para obter instruções sobre como fazê-lo, veja Explorador do Azure Digital Twins: Em execução na cloud.

Mudar de contexto na aplicação

Uma vez na aplicação, também pode alterar a instância que está atualmente ligada ao explorador, ao selecionar o nome da instância na barra de ferramentas superior.

Captura de ecrã do Explorador do Azure Digital Twins. O nome da instância na barra de ferramentas superior está realçado.

Ao fazê-lo, irá apresentar o modal de URL do Azure Digital Twins, onde pode introduzir o nome de anfitrião de outra instância do Azure Digital Twins após o https:// prefixo para ligar a essa instância.

Captura de ecrã do Explorador do Azure Digital Twins. O modal de URL do Azure Digital Twins apresenta uma caixa editável que contém https:// e um nome de anfitrião.

Nota

Neste momento, a capacidade de mudar de contexto na aplicação não está disponível para Contas Microsoft pessoais (MSA). Os utilizadores do MSA terão de aceder ao explorador a partir da instância escolhida no portal do Azure ou podem ligar-se a uma determinada instância através de uma ligação direta para o ambiente.

Consultar o gráfico duplo digital

Pode utilizar o painel Explorador de Consultas para executar consultas no gráfico.

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

Introduza a consulta que pretende executar. Se quiser 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 apresentar os resultados da consulta no painel Gráfico Duplo .

Nota

Os resultados da consulta que contenham relações só podem ser compostos no painel Gráfico Duplo se os resultados também incluírem, pelo menos, um duplo. Embora as consultas que devolvem apenas relações sejam possíveis no Azure Digital Twins, só pode vê-las no Explorador do Azure Digital Twins através do painel Saída.

Resultados da consulta sobreposta

Pode verificar a caixa Sobreposição de resultados antes de executar a consulta se quiser que os resultados sejam realçados a partir do que está a ser apresentado atualmente no painel Gráfico Duplo , em vez de substituir completamente os conteúdos do painel pelos novos resultados da consulta.

Captura de ecrã do painel Explorador de Consultas do Azure Digital Twins Explorer. A caixa Resultados da sobreposição está selecionada e dois duplos estão realçados no gráfico maior que é apresentado no painel Gráfico Duplo.

Se o resultado da consulta incluir algo que não está a ser mostrado no painel Gráfico Duplo , o elemento será adicionado à vista existente.

Guardar e executar novamente consultas

As consultas podem ser guardadas no armazenamento local no browser, tornando-as fáceis de selecionar e executar novamente.

Nota

O armazenamento do browser local significa que as consultas guardadas não estarão disponíveis noutros browsers para além daquela em que as guardou e permanecerão indefinidamente no armazenamento do browser 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. Introduza um nome para a consulta guardada quando lhe for pedido.

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

Assim que a consulta tiver sido guardada, está disponível para selecionar no menu pendente Consultas Guardadas para voltar a executá-la facilmente.

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

Para eliminar uma consulta guardada, selecione o ícone X junto ao nome da consulta quando o menu pendente Consultas Guardadas estiver aberto.

Dica

Para gráficos grandes, é sugerido consultar apenas um subconjunto limitado e, em seguida, carregar o resto do gráfico conforme necessário. Pode fazer duplo clique num duplo no painel Gráfico Duplo para obter nós relacionados adicionais.

Explorar o Gráfico Duplo

O painel Gráfico Duplo permite-lhe explorar os duplos e as relações na sua instância.

Captura de ecrã do Explorador do Azure Digital Twins. O painel Gráfico Duplo está realçado.

Pode utilizar este painel para ver os seus duplos e relações.

O painel Gráfico Duplo também fornece várias capacidades para personalizar a sua experiência de visualização de gráficos:

Ver duplos e relações

Execute uma consulta com o Explorador de Consultas para ver os duplos e as relações no resultado da consulta apresentados no painel Gráfico Duplo .

Dica

A consulta para apresentar todos os duplos e relações é SELECT * FROM digitaltwins.

Ver propriedades de duplos e relações

Para ver os valores de propriedade de um duplo ou de uma relação, selecione o duplo ou a relação no Gráfico Duplo e utilize o botão Desativar o inspetor de propriedades para expandir o painel Propriedades do Duplo ou Propriedades da Relação , respetivamente. Este painel apresentará todas as propriedades associadas ao elemento, juntamente com os respetivos valores. Também inclui valores predefinidos para propriedades que ainda não foram definidas.

Captura de ecrã a mostrar o painel Graph do Azure Digital Twins Explorer Twin. O duplo FactoryA está selecionado e o painel Propriedades do Duplo é expandido, mostrando as propriedades do duplo.

Ícones de tipo de dados

As propriedades apresentadas nos painéis Propriedades do Duplo e Propriedades da Relação são apresentadas com um ícone, indicando o tipo de campo do modelo DTDL. Pode pairar o cursor sobre um ícone para apresentar o tipo associado.

A tabela abaixo mostra os tipos de dados possíveis e os ícones correspondentes. A tabela também contém ligações de cada tipo de dados para a descrição do esquema na especificação DTDL.

Ícone Tipo de dados
ícone booleano booleano
ícone de componente componente
ícone de data data
ícone dateTime dateTime
ícone de duração duração
ícone de enum enum
ícone de mapa mapa
ícone numérico Tipos numéricos, incluindo duplo, flutuante, número inteiro e longo
ícone de objeto objeto
ícone de cadeia string
ícone de hora hora
Erros

O painel Propriedades do Duplo apresentará mensagens de erro se o duplo ou algumas das respetivas propriedades já não corresponderem ao modelo.

Existem dois cenários de erro possíveis que cada um dá a sua própria mensagem de erro:

  • Um ou muitos modelos utilizados pelo duplo estão em falta. Como resultado, todas as propriedades associadas a esse modelo serão sinalizadas como "em falta" no painel Propriedades do Duplo. Este erro pode ocorrer se o modelo tiver sido eliminado desde que o duplo foi criado.
  • Algumas propriedades no duplo não fazem parte do modelo do duplo. Apenas estas propriedades serão sinalizadas como "em falta" no painel Propriedades do Duplo. Este erro pode ocorrer se o modelo do duplo tiver sido substituído ou alterado desde que as propriedades foram definidas e as propriedades já não existirem na versão mais recente do modelo.

Ambas as mensagens de erro são apresentadas na captura de ecrã abaixo:

Captura de ecrã do painel Propriedades do Explorador de Duplos do Azure Digital Twins, com duas mensagens de erro. Um erro indica que os modelos estão em falta e o outro indica que faltam propriedades num modelo.

Ver as relações de um duplo

Também pode ver rapidamente o código de todas as relações que envolvem um determinado duplo (incluindo relações de entrada e saída).

Clique com o botão direito do rato num duplo no gráfico e selecione Obter relações. Ao fazê-lo, é apresentada uma moda de Informação de Relação que apresenta a representação JSON de todas as relações de entrada e saída.

Captura de ecrã a mostrar o painel Graph do Azure Digital Twins Explorer Twin. O centro do ecrã apresenta um modal Informações de Relação que mostra as relações Entrada e Saída.

Alterar propriedade de apresentação de duplos

Pode configurar a propriedade que pretende apresentar para identificar duplos no gráfico duplo. A predefinição é o $dtId valor, mas pode escolher entre quaisquer propriedades existentes no seu conjunto de modelos (mesmo as que não estão presentes em cada duplo).

Para alterar a propriedade de apresentação, utilize o menu pendente Selecionar Propriedade de Nome a Apresentar Duplo . O menu pendente é ordenado pelo número de modelos que contêm a propriedade.

Captura de ecrã a mostrar o painel Graph do Azure Digital Twins Explorer Twin. O botão Selecionar Propriedade nome a apresentar duplo está realçado, mostrando um menu que lista diferentes propriedades dos duplos no gráfico.

Se escolher uma propriedade que não esteja presente em todos os duplos, todos os duplos no gráfico que não tenham essa propriedade serão apresentados com um asterisco (*) seguido do respetivo $dtId valor.

Editar esquema de gráfico duplo

Pode reorganizar os duplos em diferentes configurações ao clicar e arrastá-los ao redor do ecrã gráfico duplo.

Também pode aplicar um de vários algoritmos de esquema ao gráfico a partir das opções no menu Escolher Esquema .

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

Controlar a expansão de gráficos duplos

Ao ver um resultado de consulta no painel Gráfico Duplo , pode fazer duplo clique num duplo para que o gráfico obtenha as relações e os duplos relacionados e apresente-os se ainda não estiverem presentes na vista. Pode personalizar esta expansão ao definir um tamanho e direção para determinar o número de duplos a obter.

Para definir o número de camadas a expandir, utilize a opção Nível de Expansão . Este número indica quantas camadas de relações obter a partir do duplo selecionado.

Captura de ecrã a mostrar o painel Graph do Azure Digital Twins Explorer Twin. O botão Nível de Expansão está realçado.

Para indicar que tipos de relações deve seguir ao expandir, utilize o botão Direção de Expansão . Fazê-lo permite-lhe selecionar entre relações de entrada, saída ou entrada e saída.

Captura de ecrã a mostrar o painel Graph do Azure Digital Twins Explorer Twin. O botão Direção da Expansão está realçado, mostrando um menu com as opções In, Out e In/Out.

Mostrar e ocultar elementos de gráfico duplo

Pode alternar a opção para ocultar duplos ou relações da vista de gráfico.

Para ocultar um duplo ou relação, clique com o botão direito do rato na janela Gráfico Duplo . Ao fazê-lo, será apresentado um menu com opções para ocultar o elemento ou outros elementos relacionados.

Captura de ecrã a mostrar o painel Graph do Azure Digital Twins Explorer Twin. O duplo FactoryA está selecionado e existe um menu que contém opções para Ocultar selecionado, Ocultar selecionado + Crianças, Ocultar todos os outros e Ocultar não crianças.

Também pode ocultar múltiplos duplos ou relações ao mesmo tempo com 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 duplos depois de alguns terem sido ocultos, utilize o botão Mostrar Tudo . Para voltar a mostrar todas as relações, utilize o botão Mostrar Todas as Relações .

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

Filtrar e realçar elementos de grafos duplos

Pode filtrar os duplos e as relações que aparecem no grafo por texto ao selecionar este ícone Filtro :

Captura de ecrã a mostrar o painel Graph do Azure Digital Twins Explorer Twin. O ícone de filtro de texto está selecionado, com o separador Filtro onde pode introduzir um termo de pesquisa.

Também pode realçar os duplos e as relações que aparecem no grafo por texto ao selecionar este ícone Realçar :

Captura de ecrã a mostrar o painel Graph do Azure Digital Twins Explorer Twin. O ícone de filtro de texto está selecionado, com o separador Realçar onde pode introduzir um termo de pesquisa.

Gerir duplos e gráficos

O Azure Digital Twins Explorer fornece várias formas de gerir os duplos e as relações na sua instância.

Esta secção descreve como realizar as seguintes atividades de gestão:

Para obter informações sobre a experiência de visualização de duplos e relações, consulte Explorar duplos e o Twin Graph.

Ver lista plana de duplos e relações

O painel Twins mostra uma lista simples dos seus duplos e as respetivas relações associadas. Pode procurar duplos por nome e expandi-los para obter detalhes sobre as respetivas relações de entrada e saída.

Captura de ecrã do painel Azure Digital Twins Explorer Twins. Um duplo está realçado e as relações são apresentadas.

Criar duplos

Pode criar um novo duplo digital a partir da respetiva definição de modelo no painel Modelos .

Para criar um duplo a partir de um modelo, localize esse modelo na lista e selecione os pontos de menu junto ao nome do modelo. Em seguida, selecione Criar um Duplo. Ser-lhe-á pedido que introduza um nome para o novo duplo, que tem de ser exclusivo. Em seguida, guarde o duplo, que irá adicioná-lo ao seu gráfico.

Captura de ecrã do painel Modelos do Explorador do Azure Digital Twins. Os pontos de menu de um único modelo estão realçados e a opção de menu Para Criar um Duplo também está realçada.

Para adicionar valores de propriedade ao seu duplo, consulte Editar propriedades de duplo e relação.

Criar relações

Para criar uma relação entre dois duplos, comece por selecionar o duplo de origem para a relação na janela Twin Graph . Em seguida, mantenha premida uma tecla CTRL/CMD ou SHIFT enquanto seleciona um segundo duplo para ser o destino da relação.

Assim que os dois duplos estiverem selecionados em simultâneo, clique com o botão direito do rato no duplo de destino para apresentar um menu com uma opção para Adicionar relações entre eles.

Captura de ecrã a mostrar o painel Graph do Azure Digital Twins Explorer Twin. Os duplos FactoryA e Consumer estão selecionados e um menu mostra a opção Adicionar relações.

Ao fazê-lo, irá apresentar a caixa de diálogo Criar Relação , preenchida com o duplo de origem e o duplo de destino da relação (também pode utilizar o ícone Trocar Relação para alterá-los). Existe um menu pendente Relação que contém os tipos de relação que o duplo de origem pode ter, de acordo com o modelo DTDL. Selecione uma opção para o tipo de relação e Guarde a nova relação.

Editar propriedades de duplo e relação

Para ver os valores de propriedade de um duplo ou uma relação, selecione o elemento no Gráfico Duplo e utilize o botão Desativar o inspetor de propriedades para expandir o painel Propriedades do Duplo ou Propriedades da Relação , respetivamente.

Captura de ecrã a mostrar o painel Graph do Azure Digital Twins Explorer Twin. O duplo FactoryA está selecionado e o painel Propriedades do Duplo é expandido, mostrando as propriedades do duplo.

Pode utilizar este painel para editar diretamente propriedades graváveis. Atualize os respetivos valores inline e selecione o botão Guardar alterações na parte superior do painel para guardar. Quando a atualização é guardada, o ecrã apresenta uma janela modal que mostra a operação de Patch JSON que foi aplicada pela API de atualização.

Captura de ecrã a mostrar o painel Graph do Azure Digital Twins Explorer Twin. O centro do ecrã apresenta um modal Informações de Caminho que mostra o código de Patch JSON.

Dica

As propriedades apresentadas nos painéis Propriedades do Duplo e Propriedades da Relação são apresentadas com um ícone, indicando o tipo de campo do modelo DTDL. Para obter mais informações sobre os ícones do tipo, veja Ícones de tipo de dados.

Eliminar duplos e relações

Para eliminar um duplo ou uma relação, clique com o botão direito do rato na janela Gráfico Duplo . Ao fazê-lo, será apresentado um menu com uma opção para eliminar o elemento.

Captura de ecrã a mostrar o painel Graph do Azure Digital Twins Explorer Twin. O duplo FactoryA está selecionado e existe um menu que contém uma opção para Eliminar duplos.

Pode eliminar múltiplos duplos ou múltiplas relações de uma só vez, utilizando 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 eliminar os elementos.

Também pode optar por eliminar todos os duplos na sua instância ao mesmo tempo, utilizando o botão Eliminar Todos os Duplos na barra de ferramentas superior.

Captura de ecrã do Explorador do Azure Digital Twins. O ícone Eliminar Todos os Duplos está selecionado.

Explorar modelos e o Model Graph

Os modelos podem ser visualizados no painel Modelos no lado esquerdo do ecrã do Explorador do Azure Digital Twins e no painel Model Graph no meio do ecrã.

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

O painel Model Graph : Captura de ecrã do Explorador do Azure Digital Twins. O painel Gráfico de Modelos está realçado.

Pode utilizar estes painéis para ver os seus modelos.

O painel Model Graph também fornece várias capacidades para personalizar a sua experiência de visualização de gráficos:

Ver modelos

Pode ver uma lista simples dos modelos na sua instância no painel Modelos . Esta lista é pesquisável com a Barra de pesquisa no painel.

Pode utilizar o painel Model Graph para ver uma representação gráfica dos modelos na sua instância, juntamente com as relações, a herança e os componentes que os ligam uns aos outros.

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 junto ao nome do modelo. Em seguida, selecione Ver Modelo. Ao fazê-lo, será apresentado um Modelo de Informação modal que mostra a definição de DTDL não processada do modelo.

Captura de ecrã do painel Modelos do Explorador do Azure Digital Twins. Os pontos de menu de um único modelo estão realçados e a opção de menu para Ver Modelo também está realçada.

Também pode ver a definição completa de um modelo ao selecioná-la no Model Graph e ao utilizar o botão Alternar detalhes do modelo para expandir o painel Detalhes do Modelo . Este painel também apresentará o código DTDL completo do modelo.

Captura de ecrã do painel Azure Digital Twins Explorer Model Graph( Gráfico de Modelos do Azure Digital Twins Explorer). O modelo Floor está selecionado e o painel Detalhes do Modelo é expandido, mostrando o código DTDL do modelo.

Editar esquema de gráfico de modelo

Pode reorganizar os modelos em diferentes configurações ao clicar e arrastá-los ao redor do ecrã do Model Graph.

Também pode aplicar um de vários algoritmos de esquema ao gráfico de modelos a partir das opções no menu Escolher Esquema .

Captura de ecrã do painel Azure Digital Twins Explorer Model Graph( Gráfico de Modelos do Azure Digital Twins Explorer). O botão Escolher Esquema está realçado, mostrando um menu com as opções de esquema Cola, Dagre, fCoSE, Klay e d3Force.

Filtrar e realçar elementos do gráfico de modelos

Pode filtrar os tipos de ligações que aparecem no Model Graph. Desativar um dos tipos de ligação através dos comutadores neste menu impedirá que esse tipo de ligação seja apresentado no gráfico.

Captura de ecrã do painel Azure Digital Twins Explorer Model Graph( Gráfico de Modelos do Azure Digital Twins Explorer). O menu de filtro para Relações, Herança e Componentes está realçado.

Também pode filtrar os modelos e ligações que aparecem no grafo por texto ao selecionar este ícone Filtro :

Captura de ecrã do painel Azure Digital Twins Explorer Model Graph( Gráfico de Modelos do Azure Digital Twins Explorer). O ícone de filtro de texto está selecionado, com o separador Filtro onde pode introduzir um termo de pesquisa.

Pode realçar os modelos e ligações que aparecem no grafo por texto ao selecionar este ícone Realçar :

Captura de ecrã do painel Azure Digital Twins Explorer Model Graph( Gráfico de Modelos do Azure Digital Twins Explorer). O ícone de filtro de texto está selecionado, com o separador Realçar onde pode introduzir um termo de pesquisa.

Carregar imagens de modelo

Pode carregar imagens personalizadas para representar diferentes modelos nas vistas do Model Graph e do Twin Graph . Pode carregar imagens para modelos individuais ou para vários modelos ao mesmo tempo.

Nota

Estas imagens são armazenadas no armazenamento do browser local. Isto significa que as imagens não estarão disponíveis noutros browsers para além daquela em que as guardou e permanecerão indefinidamente no armazenamento do browser 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 junto ao nome do modelo. Em seguida, selecione Carregar Imagem de Modelo. Na caixa seletor de ficheiros apresentada, navegue no computador para o ficheiro de imagem que pretende carregar para esse modelo. Selecione Abrir para carregá-lo.

Captura de ecrã do painel Modelos do Explorador do Azure Digital Twins. Os pontos de menu de um único modelo estão realçados e a opção de menu para Carregar Imagem de Modelo também está realçada.

Também pode carregar imagens de modelo em massa.

Primeiro, utilize as seguintes instruções para definir os nomes dos ficheiros de imagem antes de carregar. Ao fazê-lo, o Azure Digital Twins Explorer atribui automaticamente as imagens aos modelos corretos após o carregamento.

  1. Comece com o valor do ID do modelo (por exemplo, dtmi:example:Floor;1)
  2. Substituir instâncias de ":" por "_" (o exemplo torna-se dtmi_example_Floor;1)
  3. Substituir instâncias de ";" por "-" (o exemplo torna-se dtmi_example_Floor-1)
  4. Certifique-se de que o ficheiro tem uma extensão de imagem (o exemplo torna-se algo como dtmi_example_Floor-1.png)

Nota

Se tentar carregar uma imagem que não mapeie para nenhum modelo existente com os critérios acima, a imagem não será carregada nem armazenada.

Em seguida, para carregar as imagens ao mesmo tempo, utilize o ícone Carregar Imagens do Modelo na parte superior do painel Modelos. Na caixa seletor de ficheiros, escolha os ficheiros de imagem a carregar.

Captura de ecrã do painel Modelos do Explorador do Azure Digital Twins. O ícone Carregar Imagens do Modelo está realçado.

Gerir modelos

Pode utilizar o painel Modelos no lado esquerdo do ecrã do Explorador do Azure Digital Twins para realizar atividades de gestão em todo o conjunto de modelos ou em modelos individuais.

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

Com este painel, pode concluir as seguintes atividades de gestão de modelos:

Para obter informações sobre a experiência de visualização de modelos, veja Explorar modelos e o Model Graph.

Carregar modelos

Pode carregar modelos a partir do seu computador ao selecionar ficheiros de modelo individualmente ou ao carregar uma pasta inteira de ficheiros de modelo ao mesmo tempo. Se estiver a carregar um ficheiro JSON que contém o código para muitos modelos, certifique-se de que revê as limitações de carregamento do modelo em massa.

Para carregar um ou mais modelos selecionados individualmente, selecione o ícone Carregar um modelo que mostra uma seta para cima.

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

Na caixa seletor de ficheiros apresentada, navegue no computador para os modelos que pretende carregar. Pode selecionar um ou mais ficheiros de modelo JSON e selecionar Abrir para os carregar.

Para carregar uma pasta de modelos, incluindo tudo o que está dentro do mesmo, selecione o ícone Carregar um diretório de Modelos que mostra uma pasta de ficheiros.

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

Na caixa seletor de ficheiros apresentada, navegue no seu computador para uma pasta que contenha ficheiros de modelo JSON. Selecione Abrir para carregar essa pasta de nível superior e todos os respetivos conteúdos.

Importante

Se um modelo fizer referência a outro modelo na respetiva definição, como quando está a definir relações ou componentes, o modelo que está a ser referenciado tem de estar presente na instância para carregar o modelo que o utiliza. Se estiver a carregar modelos um a um, isso significa que deve carregar o modelo que está a ser referenciado antes de carregar os modelos que o utilizam. Se estiver a carregar modelos em massa, pode selecioná-los todos na mesma importação e o Azure Digital Twins irá inferir a ordem para os carregar. No entanto, se estiver a carregar mais de 50 modelos no mesmo ficheiro, veja as limitações de carregamento do modelo em massa.

Limitações do carregamento de modelos em massa

As limitações nesta secção aplicam-se a modelos que estão contidos num único ficheiro JSON, sendo carregados para o Explorador do Azure Digital Twins ao mesmo tempo.

Embora não exista limite para quantos modelos pode incluir com um único ficheiro JSON, existem considerações especiais para ficheiros com mais de 50 modelos. Se estiver a carregar mais de 50 modelos no mesmo ficheiro de modelo, siga estas sugestões:

  • Se existirem modelos que herdem de outros modelos definidos no mesmo ficheiro, coloque-os perto do fim da lista.
  • Se existirem modelos que façam referência a outros modelos definidos no mesmo ficheiro que os componentes, coloque-os perto do fim da lista.
  • Verifique se, sempre que um modelo fizer referência a outro modelo definido no mesmo ficheiro (através da herança ou como um componente), o modelo que contém a referência vem mais tarde na lista do que a definição de modelo referenciada.

Isto ajudará a garantir que as dependências do modelo são resolvidas corretamente durante o processo de carregamento.

Eliminar modelos

Pode utilizar o painel Modelos para eliminar modelos individuais ou todos os modelos na sua instância de uma só vez.

Para eliminar um único modelo, localize esse modelo na lista e selecione os pontos de menu junto ao nome do modelo. Em seguida, selecione Eliminar Modelo.

Captura de ecrã do painel Modelos do Explorador do Azure Digital Twins. Os pontos de menu de um único modelo estão realçados e a opção de menu Eliminar Modelo também está realçada.

Para eliminar todos os modelos na sua instância de uma só vez, selecione o ícone Eliminar Todos os Modelos na parte superior do painel Modelos.

Captura de ecrã do painel Modelos do Explorador do Azure Digital Twins. O ícone Eliminar Todos os Modelos está realçado.

Atualizar modelos

Quando abre o Explorador do Azure Digital Twins, o painel Modelos deve mostrar automaticamente todos os modelos disponíveis no seu ambiente.

No entanto, pode atualizar manualmente o painel em qualquer altura para recarregar a lista de todos os modelos na sua instância do Azure Digital Twins. Para tal, selecione o ícone Atualizar modelos .

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

Importar/exportar gráfico

No painel Gráfico Duplo , tem as opções para importar e exportar funcionalidades de gráficos.

Importar gráfico

Pode utilizar a funcionalidade de importação para adicionar duplos, relações e modelos à sua instância. Esta funcionalidade pode ser útil para criar vários duplos, relações e/ou modelos ao mesmo tempo.

Nota

Se o ficheiro de importação de gráficos incluir modelos, estes estarão sujeitos às limitações de carregamento do modelo em massa.

Criar ficheiro de importação

O primeiro passo para importar um gráfico é criar um ficheiro que representa os duplos e as relações que pretende adicionar.

O ficheiro de importação pode estar em qualquer um destes dois formatos:

  • O formato baseado em JSON gerado na exportação de grafos. Este formato pode conter duplos, relações e/ou modelos.
  • O formato personalizado baseado no Excel descrito no resto desta secção. Este formato permite-lhe carregar duplos e relações.
Criar ficheiro de importação no Excel

Para criar um gráfico personalizado no Excel que possa carregar duplos e relações para o Explorador do Azure Digital Twins, utilize o seguinte formato.

Cada linha representa um elemento a criar: um duplo, uma relação ou uma combinação de duplo e relação correspondente. Utilize as seguintes colunas para estruturar os dados duplos ou de relação. Os nomes das colunas podem ser personalizados, mas devem permanecer nesta ordem.

ModelID ID Relação (origem) Nome da Relação Dados Init
(Opcional)
O ID DTMI do modelo a utilizar para o novo duplo. Esta definição de modelo já deve existir na instância.

Pode deixar esta coluna em branco para uma linha se quiser que essa linha crie apenas uma relação (sem duplos).
(Obrigatório)
O ID exclusivo de um duplo.

Se estiver a ser criado um novo duplo nesta linha, este valor será o ID do novo duplo.
Se existirem informações de relação na linha, este ID será utilizado como o destino da relação.
(Opcional)
O ID de um duplo que deve ser o duplo de origem para uma nova relação.

Pode deixar esta coluna em branco para uma linha se quiser que essa linha crie apenas um duplo (sem relações).
(Opcional)
O nome da nova relação a criar. A direção da relação será do duplo na coluna C para o duplo na coluna B.
(Opcional)
Uma cadeia JSON que contém definições de propriedade para o duplo ser criado. As propriedades têm de corresponder às definidas no modelo a partir da coluna A.

Eis um exemplo .xlsx ficheiro a criar um pequeno gráfico de dois pisos e duas salas.

Captura de ecrã a mostrar dados de gráficos no Excel. Os cabeçalhos de coluna correspondem aos campos acima, por ordem, e as linhas contêm valores de dados correspondentes.

Pode ver este ficheiro e outros exemplos de gráficos .xlsx no repositório do Explorador do Azure Digital Twins no GitHub.

Nota

As propriedades e relações descritas no .xlsx têm de corresponder ao que está definido nas definições de modelo para os duplos relacionados.

Importar ficheiro para o Explorador do Azure Digital Twins

Assim que tiver um ficheiro no computador que esteja pronto para ser importado, selecione o ícone Importar Gráfico no painel Gráfico Duplo.

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

Na caixa seletor de ficheiros apresentada, navegue no computador para o ficheiro de gráfico (.xlsx ou .json) que pretende carregar e selecione Abrir para carregá-lo.

O Azure Digital Twins abrirá um painel Importar a mostrar uma pré-visualização do gráfico a importar. Para confirmar, selecione o ícone Guardar no canto superior direito do painel.

Se a importação for bem-sucedida, uma janela modal apresentará o número de modelos, duplos e relações que foram carregados.

Captura de ecrã a mostrar o painel Graph do Azure Digital Twins Explorer Twin. O centro do ecrã apresenta um modal Importar Com Êxito que mostra quatro duplos importados e duas relações importadas.

Exportar grafo e modelos

Pode utilizar a funcionalidade de exportação para exportar gráficos parciais ou completos, incluindo modelos, duplos e relações. A exportação serializa os duplos e as relações dos resultados de consulta mais recentes, bem como de todos os modelos na instância, para um formato baseado em JSON que pode transferir para o seu computador.

Para começar, utilize o painel Explorador de Consultas para executar uma consulta que selecione os duplos e as relações que pretende transferir. Ao fazê-lo, irá preenchê-los no painel Gráfico Duplo.

Dica

A consulta para apresentar todos os duplos e relações é SELECT * FROM digitaltwins.

Assim que o painel Gráfico Duplo mostrar a parte do gráfico que pretende transferir, selecione o ícone Exportar Gráfico .

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

Esta ação ativa uma ligação Transferir na caixa Gráfico Duplo. Selecione-o para transferir uma representação baseada em JSON do resultado da consulta e todos os modelos na sua instância para o seu computador.

Dica

Este ficheiro pode ser editado e/ou recarregado para o Azure Digital Twins através da funcionalidade de importação .

Pode partilhar uma ligação para o seu ambiente do Explorador do Azure Digital Twins com outras pessoas para colaborar no trabalho. Esta secção descreve como gerar uma ligação para o ambiente do Explorador do Azure Digital Twins, que opcionalmente pode incluir uma consulta específica a executar quando a ligação é aberta. Esta secção também descreve as permissões que o destinatário precisa de ter para interagir com os dados duplos.

Requisitos de acesso do destinatário

Para que o destinatário abra a ligação e veja a instância no Explorador do Azure Digital Twins, tem de iniciar sessão na conta do Azure e ter acesso do Leitor de Dados do Azure Digital Twins à instância (pode ler mais sobre as funções do Azure Digital Twins em Segurança).

Para que o destinatário faça alterações ao gráfico e aos dados, tem de ter a função Proprietário de Dados do Azure Digital Twins na instância.

Para gerar uma ligação para o ambiente do Explorador do Azure Digital Twins que inclui uma consulta específica, introduza a consulta que pretende capturar no Explorador de Consultas e, em seguida, selecione o botão Partilhar para copiar a ligação completa.

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

Para o exemplo e consulta na captura de ecrã acima, o botão Partilhar produz esta ligação: 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>. A ligação contém o ID do inquilino e o nome do anfitrião da instância do Azure Digital Twins, bem como texto de consulta formatado.

Pode partilhar este URL para permitir que alguém aceda à sua instância e a esta consulta. Quando abrem o Explorador do Azure Digital Twins com a ligação, os resultados da consulta serão preenchidos automaticamente no painel Gráfico Duplo .

Para partilhar uma ligação para o ambiente do Explorador do Azure Digital Twins sem nenhuma consulta específica anexada, comece por utilizar o botão Partilhar para copiar a ligação para a sua instância.

Captura de ecrã do painel Explorador de Consultas do Azure Digital Twins 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 Partilhar na captura de ecrã acima produziria esta ligação: https://explorer.digitaltwins.azure.net/?query=SELECT%20*%20FROM%20digitaltwins&tid=<tenant-ID>&eid=<Azure-Digital-Twins-instance-host-name>. 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, partilhe este URL para permitir que alguém aceda à sua instância. Quando abrirem o Explorador do Azure Digital Twins com a ligação, estarão ligados à sua instância e não verão quaisquer resultados de consulta pré-preenchidos.

Acessibilidade e definições avançadas

Pode ativar várias definições avançadas para o Explorador do Azure Digital Twins para personalizar a sua experiência ou torná-la mais acessível.

Pode utilizar o ícone Atalhos de Teclado na barra de ferramentas superior direita para ver uma lista de atalhos de teclado que podem ser utilizados para navegar no Explorador do Azure Digital Twins.

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

Existem várias funcionalidades avançadas que podem ser acedidas na engrenagem Definições na barra de ferramentas superior direita:

  • Carregamento Ansioso: quando uma consulta devolve duplos que têm relações com outros duplos que não estão incluídos nos resultados da consulta, esta funcionalidade carregará os duplos "em falta" antes de compor o gráfico.
  • Colocação em cache: quando esta funcionalidade está ativada, o Explorador do Azure Digital Twins manterá uma cache local de relações e modelos na memória para melhorar o desempenho das consultas. Estas caches são desmarcadas em quaisquer operações de escrita nos elementos relevantes, bem como na atualização do browser. Esta funcionalidade está desativada por predefinição.
  • Consola: esta funcionalidade permite a apresentação de uma janela da consola, capaz de utilizar funções de shell simples para trabalhar com o gráfico.
  • Saída: esta funcionalidade permite a apresentação de uma janela de saída, que mostra um rastreio de diagnóstico das operações.
  • Alto Contraste: esta funcionalidade altera as cores do Explorador do Azure Digital Twins para que apareçam com maior contraste.

Pode personalizar o esquema do painel ao editar as posições dos painéis que compõem o Explorador do Azure Digital Twins (Explorador de Consultas, Twins, Modelos, Gráfico Duplo, Gráfico de Modelos). Para mover um painel para uma localização diferente, clique sem soltar no nome do painel e arraste-o para a nova posição pretendida.

Captura de ecrã do Explorador do Azure Digital Twins. Os nomes dos painéis Explorador de Consultas, Modelos, Gráfico Duplo e Gráfico de Modelos estão realçados.

As posições do painel serão repostas após a atualização da janela do browser.

Passos seguintes

Saiba mais sobre como escrever consultas para o grafo duplo do Azure Digital Twins: