Machine Attributes APIの使用方法

Machine Attributes APIの使い方

Node-RED、Python、その他のサービスからのデータを使って、Tulip Machineを作成します。

まとめ

Machine Attributes APIは、/attributes/reportエンドポイントを使用したRESTful APIを通じて、Machineの特定の属性にデータを送信することを可能にします。これは、Node-RED、Python、または他の言語やサービスからTulipと統合するための多くの柔軟なオプションを可能にします。

Machine APIをセットアップする

注：すでにTulip Table APIを設定している場合、そのAPI KeyとSecretを使用することができます。

1. 設定] > [ボット]に移動します。
2. 画面右上の[Create Bot]をクリックします。
3. ボット名をつけ、スコープに**attributes:writeを**選択します。

{height="" width=""} を選択します。

1. API Key、Secret、Auth Headerが表示されたモーダルが表示されます。この情報は二度とアクセスできないので、保存してください。

おめでとうございます - これでMachine APIを正式にセットアップできました。

新しいマシンのセットアップ

Machine APIをセットアップすると、インスタンスに新しいMachineデータソースが表示されます。このデータソースを表示するには、[Shop Floor] > [Machines] をクリックし、[Machine Data Sources] に移動します。

{高さ="" 幅=""}」をクリックします。

このデータソースにリンクした新しいマシンを作成する必要があります。新しいマシンを作成するには、Machine Libraryに移動し、Create Machineをクリックします。

次のようなモーダルが表示されます。

{height="" width=""}.

1. マシン名（必須）。マシンの名前
2. マシンのデータソース（必須）。Tulip APIを選択
3. ステーション(オプション)
4. タイプ(必須):この例では、defaultという名前のタイプが作成されています。

これでマシンが作成されたので、アトリビュートを追加する必要があります。画面右上の「Edit」をクリックします。次に、画面右上の「**+」**ボタンをクリックします。

{height="" width=""} をクリックします。

Machine Attributesがまだ作成されていないので、青く表示されているMachine Type（ここではDefault）を押してください。

これにより、マシンに関連付けられたマシン・タイプが表示されま���。画面の右上にあるEditボタンを押します。

次に、左下隅にあるMachine Attributesの隣にある+ボタンを押します。

次に、右下隅にある***+機械属性を作成***するを押します。

この例では、IntegerタイプのCounter属性を作成します。

{height="" width=""} を作成する。

属性が作成されたら、マシン属性のリストでCounter属性をクリックし、右上の保存をクリックする。

マシン・ページに戻る。

これでマシン属性が作成されたので、それをマシンに追加することができる。右上の[Edit]ボタンを押す。そして、右上の**+ボタンをクリックして、今作成したカウンター**属性を選択します。

{height="" width=""} を選択します。

右上の「保存」をクリックしてください。

これで、TulipインスタンスにMachine API、Machine、Machine Attributeがセットアップされ、どこからでもTulip Machineにデータを送信できるようになりました。

ここから、カウンター属性のattributeIdと machineIDを見ることができます。この情報は、アイコンをクリックしてコピーすることができ、httpリクエストのボディで使用されます。

これを行うには、REST APIに精通している必要があります。クエリパラメータとボディフォーマットを含む、/attributes/reportエンドポイントの使用方法に関する完全なドキュメントは、your-company.tulip.co/apidocsまたはBotsページのリンクをたどることで見つけることができます...

{height="" width=""}...

...また、ドキュメントにはマシンモニタリングのセクションがあります。

{height="" width=""} ...そしてドキュメントにはMachine Monitoringのセクションがあります。

その他の情報

Edge MCやNode-REDでAPIをさらに活用したい場合は、こちらの記事を参照してください。