Come utilizzare l'API Attributi macchina

Come utilizzare l'API Attributi macchina

Creare una macchina Tulip utilizzando i dati di Node-RED, Python o altri servizi.

:::(Info) (NOTA) Articolo avanzato - presuppone un'esperienza precedente con le API REST.Fare clic qui per visualizzare la documentazione dell'API delle macchine:

Riepilogo

L'API Machine Attributes consente di inviare dati a un attributo specifico di una macchina tramite un'API RESTful utilizzando l'endpoint /attributes/report. Ciò consente molte opzioni flessibili per l'integrazione con Tulip da Node-RED, Python o altri linguaggi e servizi.

Impostazione dell'API della macchina

Nota: se è già stata configurata un'API di Tulip Table, è possibile utilizzare la chiave e il segreto dell'API.

1. Andare in Impostazioni > Token API
2. Fare clic su Crea token API nell'angolo in alto a destra dello schermo.
3. Date un nome al vostro token API e selezionate attributi:scrivere per il suo ambito:

1. Apparirà una maschera con la chiave API, il segreto e l'intestazione di autorizzazione. Salvate queste informazioni, perché non è possibile accedervi di nuovo!

Congratulazioni: avete ufficialmente configurato la vostra Machine API!

Impostazione di una nuova macchina

Una volta impostata l'API della macchina, sulla vostra istanza apparirà una nuova fonte di dati della macchina. Per visualizzare questa fonte di dati, fare clic su Shop Floor > Machines e navigare in Machine Data Sources:

È necessario creare una nuova macchina collegata a questa origine dati. Per creare una nuova macchina, passare alla Libreria macchine e fare clic su Crea macchina.

Verrà visualizzata la seguente finestra di dialogo:

1. Nome macchina (obbligatorio): Nome della macchina
2. Origine dati macchina (Obbligatorio): Selezionare Tulip API
3. Stazione (opzionale)
4. Tipo (Obbligatorio): Se non è disponibile alcun tipo, creare prima un tipo; in questo esempio il tipo creato è denominato default.

Ora che la macchina è stata creata, è necessario aggiungere un attributo. Fare clic su Modifica in alto a destra dello schermo. Quindi fare clic sul pulsante + in alto a destra:

Poiché non è stato ancora creato alcun attributo della macchina, premere il tipo di macchina in blu, in questo caso Default.

In questo modo si accede al Tipo di macchina associato alla macchina. Premere il pulsante Modifica nell'angolo in alto a destra dello schermo.

Quindi premere il pulsante + accanto a Attributi macchina nell'angolo in basso a sinistra.

Ora premere + Crea attributo macchina nell'angolo in basso a destra.

In questo esempio, creeremo un attributo Counter di tipo Integer.

Una volta creato l'attributo, fare clic sull'attributo Contatore nell'elenco degli attributi macchina e premere Salva in alto a destra.

Tornare alla pagina della macchina.

Ora che l'attributo della macchina è stato creato, è possibile aggiungerlo alla macchina. Premere il pulsante Modifica in alto a destra. Fare quindi clic sul pulsante + in alto a destra e selezionare l'attributo del contatore appena creato:

Fare clic su Salva nell'angolo in alto a destra.

La vostra Istanza Tulip è ora configurata con l'API Macchina, una Macchina e un Attributo Macchina - ora potete inviare dati a una Macchina Tulip da qualsiasi luogo!

Da qui è possibile vedere l'attributeId e il machineID per l'attributo Counter. Queste informazioni possono essere copiate facendo clic sull'icona e saranno utilizzate nel corpo della richiesta http.

Per fare questo è necessario avere familiarità con le API REST. La documentazione completa su come utilizzare l'endpoint /attributes/report, compresi i parametri della query e il formato del corpo, è disponibile all'indirizzo your-company.tulip.co/apidocs o seguendo il link nella pagina del token API...

... e nei documenti c'è una sezione dedicata al monitoraggio delle macchine.

Ulteriori letture

Se volete approfondire l'API e vedere come può essere utilizzata con Edge MC e Node-RED,consultate questo articolo!