Azure Digital Twins Explorer (versión preliminar)

Este artículo contiene información sobre Azure Digital Twins Explorer, incluidos sus casos de uso y una introducción a sus características. Para obtener pasos detallados sobre el uso de cada característica, consulte Uso de Azure Digital Twins Explorer (versión preliminar).

Azure Digital Twins Explorer es una herramienta para desarrolladores que se emplea para visualizar e interactuar con los datos de la instancia de Azure Digital Twins, incluidos los modelos y el grafo del gemelo.

Esta es una vista de la ventana del explorador, en la que se muestran los modelos y gemelos que se han rellenado para un grafo de ejemplo:

Screenshot of Azure Digital Twins Explorer showing sample models and twins.

La interfaz visual es una gran herramienta para explorar y comprender la forma de su grafo y conjunto de modelos. También permite realizar cambios puntuales en gemelos y relaciones individuales.

Cuándo se deben usar

Azure Digital Twins Explorer es una herramienta visual diseñada para los usuarios que desean explorar su grafo del gemelo y modificar gemelos y relaciones en el contexto de este grafo.

Los desarrolladores pueden encontrar esta herramienta especialmente útil en los escenarios siguientes:

  • Exploración: use el explorador para obtener información sobre Azure Digital Twins y la forma en que representa su entorno real. Importe modelos y grafos de ejemplo que pueda ver y editar para familiarizarse con el servicio. Si desea ver pasos guiados para empezar a usar Azure Digital Twins Explorer, consulte Introducción a Azure Digital Twins Explorer.
  • Desarrollo: use el explorador para ver y validar el grafo gemelo. También puede usarlo para investigar propiedades específicas de modelos, gemelos y relaciones. Realice modificaciones de acceso puntual en el grafo y sus datos. Para obtener instrucciones detalladas sobre cómo usar cada característica, consulte Uso de Azure Digital Twins Explorer.

El propósito principal del explorador es ayudarle a visualizar y comprender el grafo, y actualizarlo según sea necesario. Para soluciones a gran escala y para trabajos que se deben repetir o automatizar, considere la posibilidad de usar API y SDK para interactuar con la instancia mediante código.

Cómo obtener acceso

La manera principal de acceder a Azure Digital Twins Explorer es mediante Azure Portal.

Para abrir Azure Digital Twins Explorer para una instancia de Azure Digital Twins, primero vaya a la instancia en el portal; para ello, busque su nombre en la barra de búsqueda del portal.

A continuación, seleccione el botón Azure Digital Twins Explorer (versión preliminar) .

Screenshot of the Azure portal showing the Overview page for an Azure Digital Twins instance. There's a highlight around the Open Azure Digital Twins Explorer (preview) button.

Se abrirá Azure Digital Twins Explorer en una nueva pestaña. Si es la primera vez que usa el Explorador, verá un modal de bienvenida que resume sus características clave.

Azure Digital Twins Explorer podría conectarse automáticamente a su instancia. Si no, verá la pantalla siguiente que le pide especificar una URL de Azure Digital Twins. (Si no ve este cuadro en la pantalla, Azure Digital Twins Explorer ya ha completado este paso automáticamente).

Screenshot of Azure Digital Twins Explorer. The Azure Digital Twins URL modal displays an empty editable box for the Azure Digital Twins URL.

Si ve este cuadro, escriba https:// en el campo, seguido del nombre de host de la instancia (se puede encontrar de nuevo en la página Información general de la instancia en el portal). Estos valores juntos conforman la dirección URL de la instancia. Seleccione Save (Guardar) para conectarse a la instancia.

Nota

Azure Digital Twins Explorer hospedado solo puede acceder a instancias de Azure Digital Twins con acceso público habilitado. Si usa Private Link para restringir el acceso a la instancia a través de un punto de conexión privado, puede usar Azure Functions para implementar el código base de Azure Digital Twins Explorer de forma privada en la nube. Para obtener instrucciones sobre cómo hacerlo, consulte Azure Digital Twins Explorer: Running in the cloud (Azure Digital Twins Explorer: Ejecución en la nube).

Características y funcionalidades

Azure Digital Twins Explorer se organiza en paneles, cada uno con un conjunto diferente de funcionalidades para explorar y administrar los modelos, gemelos y relaciones.

Las secciones del explorador son las siguientes:

  • Explorador de consultas: ejecute consultas en el grafo de gemelos y vea los resultados visuales en el panel Grafo de gemelos.
  • Modelos: vea una lista de los modelos y realice acciones como agregar, quitar y ver detalles de un modelo.
  • Gemelos: vea una lista plana de los gemelos y sus relaciones asociadas.
  • Grafo de gemelos: visualice los gemelos y las relaciones como un grafo de gemelos personalizable. Cree y elimine gemelos y relaciones, y vea o edite sus propiedades.
  • Grafo de modelos: visualice los modelos y las formas en que están interconectados en forma de un grafo de modelos personalizable.

Screenshot of Azure Digital Twins Explorer, with a highlight around each of the panels described above.

Para obtener instrucciones detalladas sobre cómo usar cada característica, consulte Uso de Azure Digital Twins Explorer.

Nota:

Actualmente, Azure Digital Twins Explorer es totalmente compatible con modelos DTDL v2 y admite funcionalidad limitada para los modelos DTDL v3. En Azure Digital Twins Explorer, los modelos DTDL v3 se pueden ver en el panel Modelos y los gemelos creados con modelos DTDL v3 se pueden ver y editar (incluidos los que tienen propiedades de matriz). Sin embargo, los modelos DTDL v3 no se mostrarán en el panel Gráfico de modelos y no se pueden importar mediante Azure Digital Twins Explorer. Para importar modelos DTDL v3 a la instancia, use otra interfaz de desarrollador, como las API y los SDK o la CLI de Azure.

Cómo colaborar

Azure Digital Twins Explorer es una herramienta de código abierto que agradece las contribuciones al código y la documentación. La aplicación hospedada se implementa regularmente desde un repositorio de código fuente de GitHub.

Para ver el código fuente de la herramienta y leer instrucciones detalladas sobre cómo contribuir al código, visite su repositorio de GitHub: digital-twins-explorer.

Para ver las instrucciones para contribuir a esta documentación, revise nuestra Guía para colaboradores.

Otras consideraciones

Regiones admitidas

Azure Digital Twins Explorer está disponible para su uso con todas las instancias de Azure Digital Twins en todas las regiones admitidas.

Sin embargo, durante la versión preliminar pública, los datos se pueden enviar para su procesamiento a través de regiones diferentes de la región donde se hospeda la instancia. Para evitar que los datos de enruten de esta manera en situaciones en las que la soberanía de datos es un problema, puede descargar el código fuente abierto para crear una versión hospedada localmente del explorador en su propia máquina.

Facturación

Azure Digital Twins Explorer es una herramienta gratuita para interactuar con el servicio Azure Digital Twins. Aunque la propia herramienta es gratuita, se puede incurrir en costos durante el uso cuando se envían solicitudes al servicio Azure Digital Twins, el cual sigue estas directrices de precios: Precios de Azure Digital Twins.

Pasos siguientes

Para obtener información sobre cómo usar las características de Azure Digital Twins Explorer, consulte Uso de Azure Digital Twins Explorer.