Cómo utilizar la API de atributos de la máquina

Cómo utilizar la API de atributos de la máquina

Crea una máquina Tulipán utilizando datos de Node-RED, Python u otros servicios.

Resumen

La API de atributos de la máquina permite enviar datos a un atributo específico de una máquina a través de una API RESTful utilizando el punto final /attributes/report. Esto permite muchas opciones flexibles para integrar con Tulip desde Node-RED, Python u otros lenguajes y servicios.

Configuración de la API de la máquina

Nota: Si tienes una API de Tulip Table ya configurada, puedes utilizar esa clave y secreto de la API

1. Navega a tu Configuración > Bots
2. Haz clic en Crear Bot en la esquina superior derecha de tu pantalla
3. Nombra tu bot, y selecciona attributes:write para su alcance:

1. Aparecerá un modal con tu API Key, Secret y Auth Header. Guarda esta información, ya que no se puede volver a acceder a ella.

Enhorabuena: ¡ha configurado oficialmente su Machine API!

Configurar una nueva máquina

Una vez que haya configurado su API de máquina, aparecerá una nueva fuente de datos de máquina en su instancia. Para ver esta fuente de datos, haga clic en Shop Floor > Machines, y navegue hasta Machine Data Sources:

Tendrá que crear una nueva máquina vinculada a esta fuente de datos. Para crear una nueva máquina navegue a la Biblioteca de Máquinas, y haga clic en Crear Máquina.

Aparecerá el siguiente modal:

1. Nombre de la máquina (obligatorio): Nombre de la máquina
2. Fuente de Datos de la Máquina (Requerido): Seleccione Tulip API
3. Estación (Opcional)
4. Tipo (Requerido): Si no hay ningún tipo disponible, cree primero un tipo, en este ejemplo el tipo creado se llama default

Ahora que su máquina está creada, necesitará añadir un atributo. Haga clic en Editar en la parte superior derecha de su pantalla. Luego haga clic en el botón + en la parte superior derecha de su pantalla:

Ya que no se han creado atributos de la máquina todavía, presione el tipo de máquina en azul, en este caso su defecto.

Esto le llevará al Tipo de Máquina asociado a la máquina. Presione el botón Editar en la esquina superior derecha de su pantalla.

Luego presione el botón + al lado de Atributos de la Máquina en la esquina inferior izquierda.

Ahora presione + Create Machine Attribute en la esquina inferior derecha

Para este ejemplo, vamos a crear un atributo Counter de tipo Integer.

Una vez que su atributo es creado, haga clic en el Atributo del Contador en la lista de Atributos de la Máquina y luego presione Guardar en la esquina superior derecha

Vuelva a la página de su máquina.

Ahora que su Atributo de Máquina es creado, puede agregarlo a su Máquina. Pulse el botón Editar en la esquina superior derecha. Luego presione el botón + en la esquina superior derecha y seleccione el atributo Contador que acaba de crear:

Haga clic en Guardar en la esquina superior derecha.

Tu instancia de Tulip está ahora configurada con la API de la máquina, una máquina y un atributo de la máquina - ¡ahora puedes enviar datos a una máquina de Tulip desde cualquier lugar!

Desde aquí puedes ver el attributeId y machineID para el atributo Counter. Esta información se puede copiar haciendo clic en el icono y se utilizará en el cuerpo de la solicitud http.

Para hacer esto necesitarás estar familiarizado con las APIs REST. La documentación completa sobre cómo utilizar el endpoint /attributes/report, incluyendo los parámetros de consulta y el formato del cuerpo, se puede encontrar en your-company.tulip.co/apidocs o siguiendo el enlace en la página de Bots...

... y en los documentos hay una sección para el monitoreo de máquinas

Más información

Consulta este artículo si quieres llevar la API más allá y ver cómo se puede utilizar con Edge MC y Node-RED.