- 印刷する
Machine Attributes APIの使い方
Node-RED、Python、その他のサービスからのデータを使って、Tulip Machineを作成します。
上級編 - REST APIの使用経験があることを前提とします。
まとめ
Machine Attributes APIは、/attributes/report
エンドポイントを使用したRESTful APIを通じて、Machineの特定の属性にデータを送信することを可能にします。これは、Node-RED、Python、または他の言語やサービスからTulipと統合するための多くの柔軟なオプションを可能にします。
Machine APIをセットアップする
注:すでにTulip Table APIを設定している場合、そのAPI KeyとSecretを使用することができます。
- 設定] > [ボット]に移動します。
- 画面右上の[Create Bot]をクリックします。
- ボット名をつけ、スコープに**
attributes:writeを
**選択します。
{height="" width=""} を選択します。
- API Key、Secret、Auth Headerが表示されたモーダルが表示されます。この情報は二度とアクセスできないので、保存してください。
おめでとうございます - これでMachine APIを正式にセットアップできました。
新しいマシンのセットアップ
Machine APIをセットアップすると、インスタンスに新しいMachineデータソースが表示されます。このデータソースを表示するには、[Shop Floor] > [Machines] をクリックし、[Machine Data Sources] に移動します。
{高さ="" 幅=""}」をクリックします。
このデータソースにリンクした新しいマシンを作成する必要があります。新しいマシンを作成するには、Machine Libraryに移動し、Create Machineをクリックします。
次のようなモーダルが表示されます。
{height="" width=""}.
- マシン名(必須)。マシンの名前
- マシンのデータソース(必須)。Tulip APIを選択
- ステーション(オプション)
- タイプ(必須):この例では、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をさらに活用したい場合は、こちらの記事を参照してください。