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.

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. Navigare in Impostazioni > Bot
2. Fare clic su Crea bot nell'angolo in alto a destra dello schermo.
3. Dare un nome al bot e selezionare attributi:write per il suo ambito:

1. Verrà visualizzata una maschera con la chiave API, il segreto e l'intestazione di autorizzazione. Si prega di salvare queste informazioni, poiché 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, fate clic su Shop Floor > Machines e navigate fino a Machine Data Sources:

È necessario creare una nuova macchina collegata a questa origine dati. Per creare una nuova macchina, spostarsi su 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 sono ancora stati creati attributi 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 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 dei bot...

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

Ulteriori letture

Date un'occhiata a questo articolo se volete approfondire l'API e vedere come può essere utilizzata con Edge MC e Node-RED!