ネットワーク
Thing ネットワークは Thing 間の関係を定義します。ある Thing が別の Thing の親、子、または兄弟である場合があります。Thing ネットワークによって Thing 階層が定義されます。Thing 階層をナビゲートしなければならない場合には、ネットワークと REST インタフェースを使用して、Thing の親や兄弟について Thing に問い合わせることができます。ネットワークのナビゲーションにはサービスまたは購読のスクリプト、または REST サービスを使用できます。ネットワークの一部または全体を取得してからマッシュアップにネットワークを表示できる REST サービスがあります。
ネットワークサーバー側スクリプト関数
• GetChildren(name) - (オプション) 子ノードの名前が格納されている文字列の配列を返します。name には子を取得するノードを指定します。name を指定しない場合、ルートノードからリストが開始されます。
• GetParent(name) - 親ノード名が格納されている文字列を返します。第一レベルのノードの場合には空の文字列を返し、ルート (空) ノードの場合には Null を返します。name には親を取得するノードを指定します。
• GetChildrenForShape(parentName,shapeName) - Thing 名の配列を返します。
• GetChildrenForTemplate(parentName,templateName) - Thing 名の配列を返します。
ネットワークサービス (スクリプト + マッシュアップ + REST API)
• GetNetworkConnections(maxDepth) - すべての親子関係が 1 つのテーブルに格納されているインフォテーブルを返します。maxDepth (オプション) が定義されていない場合は、すべての親子関係を返します。
• GetSubNetworkConnections(start,maxDepth) - ネットワーク全体のうちの、指定されたノード名から開始するサブセットのすべての親子関係が 1 つのテーブルに格納されているインフォテーブルを返します。
◦ start - サブツリーを開始するノード。定義されていない場合は、ルートノードから開始します。
◦ maxDepth - 定義されていない場合は、すべての親子関係を返します。
• GetNetworkAsNestedInfoTables(maxDepth) - GetNetworkConnections に似ていますが、ネストされたインフォテーブルを使用します。maxDepth はオプションであり、指定されていない場合はすべてを返します。
• GetSubNetworkAsNestedInfoTables(start,maxDepth) - GetSubNetworkConnections に似ていますが、ネストされたインフォテーブルを使用します。
◦ start - サブツリーを開始するノード。定義されていない場合は、ルートノードから開始します。
◦ maxDepth - 定義されていない場合は、すべての親子関係を返します。
• GetChildConnections(name) - 子ノードのみが直接格納されているインフォテーブルを返します。ここで、name は子を取得するノードです。指定されていない場合は、ルートノードから開始します。
• GetParentName(name) - 親ノード名が格納されている文字列を返します。第一レベルのノードの場合には空の文字列を返し、ルート (空) ノードの場合には Null を返します。ここで、name には親を取得するノードを指定します。
• IsInNetwork(name) - ブール値を返します。ここで、name はサーチするノードの名前です。
• IsInSubNetwork(start,name) - ブール値を返します。
◦ start - サブツリーを開始するノード。指定されていない場合は、ルートノードから開始します。
◦ name - サーチするノードの名前。
• GetChildConnectionsForShape(parentName,shapeName) - 親と Thing Shape によってフィルタされた子のインフォテーブルを返します。
• GetChildConnectionsForTemplate(parentName,templateName) - 親と Thing Template によってフィルタされた子のインフォテーブルを返します。
• GetChildren(name) - 子ノードの名前が格納されている文字列の配列を返します。
◦ name - 子を取得するノード。name を指定しない場合、ルートノードからリストが開始されます。
• GetParent(name) - 親ノード名が格納されている文字列を返します。第一レベルのノードの場合には空の文字列を返し、ルート (空) ノードの場合には Null を返します。
◦ name - 親を取得するノード。
• GetChildrenForShape(parentName,shapeName) - Thing 名の配列を返します。
• GetChildrenForTemplate(parentName,templateName) - Thing 名の配列を返します。
ネットワークと表示
表示アクセス許可がないユーザーには、ネットワーク内の Thing は表示されません。親 Thing と子 Thing から成るネットワークに対する表示アクセス許可があり、子に対する表示アクセス許可だけがある場合、親と子のどちらも表示されません。親 Thing に対する表示アクセス許可がある場合、親、および表示アクセス許可がある子が表示されます。