Azure Digital Twins Explorer を使用する (プレビュー)

  • [アーティクル]

Azure Digital Twins Explorer (プレビュー) は、Azure Digital Twins を視覚化して操作するためのツールです。 この記事では、Azure Digital Twins Explorer の機能と、それらを使用して Azure Digital Twins インスタンス内のデータを管理する方法について説明します。 Azure Digital Twins Explorer は、クリックするか、キーボード ショートカットを使用して操作することができます。

アクセス方法

Azure Digital Twins Explorer にアクセスする主な方法は、Azure portal を使用する方法です。

Azure Digital Twins インスタンスの Azure Digital Twins Explorer を開くには、まず、ポータルの検索バーで名前を検索して、ポータルでインスタンスに移動します。

次に、 [Azure Digital Twins Explorer を開く (プレビュー)] ボタンを選択します。

Screenshot of the Azure portal showing the Overview page for an Azure Digital Twins instance. There's a highlight around the Open Azure Digital Twins Explorer (preview) button.

これにより、Azure Digital Twins Explorer が新しいタブで開きます。 Explorer を初めて使用する場合は、その主要な機能を要約したウェルカム モーダルが表示されます。

Azure Digital Twins Explorer は、お使いのインスタンスに自動的に接続する場合があります。 そうでない場合、次の画面が表示され、Azure Digital Twins URL を指定するように求められます。 (画面上にこのボックスが表示されない場合、このステップは Azure Digital Twins Explorer で自動的に完了しています。)

Screenshot of Azure Digital Twins Explorer. The Azure Digital Twins URL modal displays an empty editable box for the Azure Digital Twins URL.

このボックスが表示された場合は、フィールドに「https://」と入力し、続いてインスタンスのホスト名を入力します (これは、ポータルのインスタンスの [概要] ページで確認できます)。 これらの値の組み合わせがインスタンスの URL を構成します。 [保存] を選んでインスタンスに接続します。

Note

ホストされている Azure Digital Twins Explorer は、パブリック アクセスが有効になっている Azure Digital Twins インスタンスにのみアクセスできます。 Private Link を使用してプライベート エンドポイントを介したインスタンスへのアクセスを制限する場合は、Azure 関数を使用して、Azure Digital Twins Explorer コードベースをクラウドにプライベートにデプロイできます。 これを行う方法については、「 Azure Digital Twins Explorer: クラウドでの実行」を参照してください。

アプリ内のコンテキストを切り替える

アプリケーションを起動したら、エクスプローラーに現在接続されているインスタンスを変更することもできます。そのためには、上部のツール バーからインスタンス名を選択します。

Screenshot of Azure Digital Twins Explorer. The instance name in the top toolbar is highlighted.

こうすると、Azure Digital Twins URL モーダルが表示されます。ここでは、別の Azure digital Twins インスタンスのホスト名を https:// プレフィックスの後に入力して、そのインスタンスに接続できます。

Screenshot of Azure Digital Twins Explorer. The Azure Digital Twins URL modal displays an editable box containing https:// and a host name.

Note

現時点では、アプリ内のコンテキストを切り替える機能は、個人の Microsoft アカウント (MSA) では使用できません。 MSA ユーザーは、Azure portal 内で選んだインスタンスからエクスプローラーにアクセスする必要があります。または、環境への直接リンクを介して特定のインスタンスに接続できます。

デジタル ツイン グラフでクエリを実行する

[クエリ エクスプローラー] パネルを使用すると、グラフに対してクエリを実行できます。

Screenshot of Azure Digital Twins Explorer. The Query Explorer panel is highlighted.

実行するクエリを入力します。 複数の行にクエリを入力する場合は、SHIFT + ENTER キーを使用して、[クエリ] ボックスに新しい行を追加できます。

[クエリの実行] ボタンを選択すると、[ツイン グラフ] パネルにクエリ結果が表示されます。

Note

リレーションシップを含むクエリ結果は、結果に少なくとも 1 つのツインが含まれている場合にのみ、[ツイン グラフ] パネルにレンダリングされます。 Azure Digital Twins では、リレーションシップのみを返すクエリを実行できますが、それらを Azure Digital Twins Explorer で表示できるのは、[出力] パネルを使用した場合のみです。

クエリ結果にオーバーレイを適用する

パネルの内容を新しいクエリ結果に完全に置き換えるのではなく、現在 [ツイン グラフ] パネルに表示されている内容から結果を強調表示したい場合は、クエリを実行する前に [結果にオーバーレイを適用する] ボックスをオンにすることができます。

Screenshot of Azure Digital Twins Explorer Query Explorer panel. The Overlay results box is checked, and two twins are highlighted in the larger graph that is shown in the Twin Graph panel.

現在 [ツイン グラフ] パネルに表示されていないものがクエリ結果に含まれている場合は、既存のビューにその要素が追加されます。

クエリの保存と再実行

クエリは、ブラウザーのローカル ストレージに保存できるため、簡単に選択して再実行することができます。

Note

ローカルのブラウザー ストレージは、クエリを保存したものとは別のブラウザーでは保存したクエリを使用できないことを意味します。ローカル ストレージが消去されるまで、クエリはブラウザー ストレージに無期限に残ります。

クエリを保存するには、クエリ ボックスにクエリを入力して、パネルの右側にある [保存] アイコンを選択します。 入力を求められたら、保存するクエリの名前を入力します。

Screenshot of Azure Digital Twins Explorer Query Explorer panel. The Save icon is highlighted.

クエリが保存されたら、[保存されたクエリ] ドロップダウン メニューから選択して、簡単に再実行できます。

Screenshot of Azure Digital Twins Explorer Query Explorer panel. The Saved Queries dropdown menu is highlighted and shows two sample queries.

保存したクエリを削除するには、[保存されたクエリ] ドロップダウン メニューが開いているときに、クエリ名の横にある [X] アイコンを選択します。

ヒント

大きなグラフの場合は、限定されたサブセットに対してのみクエリを実行し、必要に応じてグラフの残りの部分を読み込むことをお勧めします。 [ツイン グラフ] パネルでツインをダブルクリックすると、追加の関連ノードを取得できます。

ツイン グラフを確認する

[ツイン グラフ] パネルでは、インスタンス内のツインとリレーションシップを調べることができます。

Screenshot of Azure Digital Twins Explorer. The Twin Graph panel is highlighted.

このパネルを使用して、ツイン データを探索できます。

[ツイン グラフ] パネルには、グラフの表示エクスペリエンスをカスタマイズするための機能もいくつか用意されています。

ツイン データを探索する

[クエリ エクスプローラー] を使用してクエリを実行すると、[ツイン グラフ] パネルに表示されるクエリ結果にツインとリレーションシップが表示されます。

ヒント

すべてのツインおよびリレーションシップを表示するクエリは SELECT * FROM digitaltwins です。

ツインとリレーションシップのプロパティを表示する

ツインまたはリレーションシップのプロパティ値を表示するには、[ツイン グラフ] でツインまたはリレーションシップを選択し、[プロパティ インスペクターの切り替え] ボタンを使用して [ツインのプロパティ] または [リレーションシップのプロパティ] パネルをそれぞれ展開します。 このパネルには、要素に関連付けられているすべてのプロパティとその値が表示されます。 また、まだ設定されていないプロパティの既定値も含まれています。

Screenshot of Azure Digital Twins Explorer Twin Graph panel. The FactoryA twin is selected, and the Twin Properties panel is expanded, showing the properties of the twin.

データ型のアイコン

[ツインのプロパティ] および [リレーションシップのプロパティ] パネルに表示される各プロパティには、DTDL モデルのフィールドの型を示すアイコンが表示されます。 アイコンの上にマウス ポインターを置くと、関連付けられている型を表示できます。

次の表は、使用可能なデータ型とそれに対応するアイコンを示しています。 このテーブルには、DTDL v3 言語の説明の 各データ型からスキーマの説明へのリンクも含まれています。

アイコン データの種類
boolean icon boolean
component icon コンポーネント
date icon date
dateTime icon dateTime
duration icon duration
enum icon enum
map icon map
numeric icon Double、float、integer、long を含む数値型
object icon object
string icon string
time icon time
エラー

ツインまたはそのプロパティの一部がモデルと一致しなくなった場合、[ツインのプロパティ] パネルにエラー メッセージが表示されます。

エラーには 2 つのシナリオがあり、それぞれに独自のエラー メッセージが表示されます。

  • ツインで使用されている 1 つまたは複数のモデルがみつかりません。 この場合、ツインのプロパティ パネルで、そのモデルに関連付けられているすべてのプロパティに "missing" というフラグが設定されます。 このエラーは、ツインの作成後にモデルが削除された場合に発生する可能性があります。
  • ツインの一部のプロパティが、ツインのモデルの一部ではありません。 ツインのプロパティ パネルでは、これらのプロパティにのみ "missing" というフラグが設定されます。 このエラーは、プロパティの設定後にツインのモデルが置換または変更され、そのプロパティが最新バージョンのモデルに存在しなくなった場合に発生する可能性があります。

両方のエラー メッセージは、次のスクリーンショットに示されています。

Screenshot of Azure Digital Twins Explorer Twin Properties panel, showing two error messages. One error indicates that models are missing, and the other indicates that properties are missing a model.

履歴付きプロパティの検証と探索

Azure Digital Twins インスタンスでデータ履歴が有効になっている場合は、Azure Digital Twins エクスプローラーでその履歴データを検証して調査できます。 グラフ内の履歴データを視覚化するか、テーブル内の生の値を表示するには、次の手順に従います。

  1. Twin Graph ビューアーから、履歴プロパティを表示するツインを選択し、[ツインのプロパティ] パネルで開きます。 パネルの右上隅にある時系列アイコンを選択して、データ履歴エクスプローラーを開きます。

    Screenshot of Azure Digital Twins Explorer Twin Properties panel, highlighting the icon to open the data history explorer.

  2. 左側からツイン名を選択すると、表示するツインの履歴プロパティを選択するためのオプションが表示されます。 [ ツイン ID ] フィールドには、ツインの選択が事前に設定されます。 このフィールドの横にある [プロパティの検査] アイコンを選択してツイン データを表示したり、[詳細ツイン検索] アイコンを選択し、プロパティ値のクエリを実行して他のツインを検索したりできます。

    Screenshot of the Data history explorer and a modal asking for twin and property details.

  3. [プロパティ] フィールドで、履歴データを表示するプロパティを選択します。 プロパティが数値ではなく、数値で構成されている場合は、[数値にキャスト] プロパティ値を使用して、グラフ上で視覚化できるように、このデータを数値にキャストします。

    Screenshot of the Data history explorer with the property details highlighted.

    Note

    リストが応答していないためにドロップダウン リストからプロパティを選択できない場合は、インスタンス内の一部のモデルでエラーが発生している可能性があります。 たとえば、モデルの属性に一意でない列挙値があると、この機能が中断されます。 この場合は、 モデル定義 を確認し、すべてのプロパティが有効であることを確認します。

  4. 時系列のラベルを選択し、[更新] を選択します。

これにより、選択したプロパティの履歴値のグラフ ビューが読み込まれます。 グラフの上のタブを使用して、グラフ ビューとテーブル ビューを切り替えることができます。

視覚化にさらにプロパティを追加するには、左側の [時系列の追加] ボタンを使用します。

Screenshot of the Data history explorer highlighting the option to add another time series.

データ履歴エクスプローラーを終了し、Azure Digital Twins エクスプローラーメインに戻すには、[閉じる] を選択します。

グラフで履歴を表示する

履歴付きプロパティのグラフ ビューには、時間の経過に伴う折れ線グラフ上のポイントとしてプロパティ値が表示されます。

Screenshot of the Data history explorer showing a chart of historized values for a property.

グラフの上にあるアイコンを使用して、グラフの設定を制御できます。..

  • グラフに含まれるデータの時間範囲を変更します。
  • 複数の時系列を個別に表示するか、共有 y 軸に表示するかを選択します。 軸に対して [独立] を選択すると、各時系列がグラフにスケーリングされ、スケール用に独自の軸メイン含まれます。 [共有軸] を選択すると、すべての時系列データが同じ軸にスケーリングされます。
  • グラフの集計ロジックを選択します。 プロパティにグラフに表示できるデータ ポイントよりも多くのデータ ポイントがある場合、データは平均、最小、または最大のいずれかの関数を使用して有限の数のデータ ポイントに集計されます。

Azure Data エクスプローラー でクエリを開くボタンもあり、現在のクエリを表示および変更して時系列データをさらに探索できます。

Screenshot of the button to open query in Azure Data Explorer.

テーブルの履歴を表示する

履歴付きプロパティのテーブル ビューには、テーブル内のプロパティ値とそのタイムスタンプが表示されます。

Screenshot of the Data history explorer showing a table of historized values for a property.

テーブルの上にあるアイコンを使用して、テーブルの設定を制御できます。..

  • テーブルに含まれるデータの時間範囲を変更する。
  • 独立した分析のためのテーブル データのダウンロード。

ツインのリレーションシップを表示する

特定のツインに関係するすべてのリレーションシップのコードをすばやく表示することもできます (受信と発信のリレーションシップを含む)。

グラフ内のツインを右クリックして、[リレーションシップの取得] を選択します。 こうすると、受信および発信のすべてのリレーションシップの JSON 表現を表示する [リレーションシップ情報] モーダルが表示されます。

Screenshot of Azure Digital Twins Explorer Twin Graph panel. The center of the screen displays a Relationship Information modal showing Incoming and Outgoing relationships.

ツインの表示プロパティを変更する

ツイン グラフでツインを識別するために表示するプロパティを構成できます。 既定値は $dtId 値ですが、モデル セットに存在するプロパティ (すべてのツインに存在しないものも含む) から選ぶことができます。

表示プロパティを変更するには、[Select Twin Display Name Property]\(ツインの表示名プロパティの選択\) ドロップダウン メニューを使用します。 ドロップダウン メニューは、プロパティを含むモデルの数順に並べ替えられます。

Screenshot of Azure Digital Twins Explorer Twin Graph panel. The Select Twin Display Name Property button is highlighted, showing a menu that lists different properties of the twins in the graph.

すべてのツインに存在するわけではないプロパティを選んだ場合、グラフ内のそのプロパティを持たないツインにはアスタリスク (*) とそれに続く $dtId 値が表示されます。

ツイン グラフのレイアウトを編集する

[ツイン グラフ] 画面でツインをクリックしてドラッグすると、さまざまな構成にツインを再配置することができます。

また、[レイアウトの選択] メニューのオプションから、いくつかのレイアウト アルゴリズムのうちのいずれかをグラフに適用することもできます。

Screenshot of Azure Digital Twins Explorer Twin Graph panel. The Choose Layout button is highlighted, showing a menu with the layout options Cola, Dagre, fCoSE, and Klay.

ツイン グラフの展開を制御する

[ツイン グラフ] パネルにクエリ結果が表示されているときにツインをダブルクリックすると、そのリレーションシップと関連するツインをグラフに取り込んで、それらを表示することができます (ビューにまだ存在していない場合)。 この展開をカスタマイズするには、サイズと方向を設定して、取り込むツインの数を決定します。

展開するレイヤーの数を設定するには、[展開レベル] オプションを使用します。 この数値は、選択したツインから取り込むリレーションシップのレイヤーの数を示します。

Screenshot of Azure Digital Twins Explorer Twin Graph panel. The Expansion Level button is highlighted.

展開時に対象とするリレーションシップの種類を指定するには、[Expansion Direction]\(展開方向\) ボタンを使用します。 こうすると、受信のみ、発信のみ、または受信と発信の両方のリレーションシップから選択できます。

Screenshot of Azure Digital Twins Explorer Twin Graph panel. The Expansion Direction button is highlighted, showing a menu with the options In, Out, and In/Out.

ツイン グラフの要素を表示または非表示にする

グラフ ビューでツインまたはリレーションシップを非表示にするには、このオプションを切り替えます。

ツインまたはリレーションシップを非表示にするには、[ツイン グラフ] ウィンドウでそれを右クリックします。 こうすると、要素またはその他の関連する要素を非表示にするためのオプションを含むメニューが表示されます。

Screenshot of Azure Digital Twins Explorer Twin Graph panel. The FactoryA twin is selected, and there's a menu containing options to Hide selected, Hide selected + Children, Hide all others, and Hide non children.

また、複数のツインまたはリレーションシップを一度に非表示にするには、CTRL/CMD キーまたは SHIFT キーを使用して、グラフ内の同じ種類のいくつかの要素を複数選択します。 ここから、同じ右クリックのプロセスに従って、非表示のオプションを参照します。

一部のツインを非表示にした後にすべてのツインが表示されるように戻すには、[すべて表示] ボタンを使用します。 すべてのリレーションシップが表示されるように戻すには、[すべてのリレーションシップの表示] ボタンを使用します。

Screenshot of Azure Digital Twins Explorer Twin Graph panel. The Show All and Show All Relationships buttons are highlighted.

ツイン グラフの要素をフィルター処理および強調表示する

グラフに表示されるツインおよびリレーションシップをテキストでフィルター処理するには、この [フィルター] アイコンを選択します。

Screenshot of Azure Digital Twins Explorer Twin Graph panel. The text filter icon is selected, showing the Filter tab where you can enter a search term.

また、グラフに表示されるツインとリレーションシップをテキストで強調表示するには、この [強調表示] アイコンを選択します。

Screenshot of Azure Digital Twins Explorer Twin Graph panel. The text filter icon is selected, showing the Highlight tab where you can enter a search term.

ツインとグラフを管理する

Azure Digital Twins Explorer には、インスタンス内のツインとリレーションシップを管理するためのいくつかの方法が用意されています。

このセクションでは、次の管理アクティビティを実行する方法について説明します。

ツインとリレーションシップの表示エクスペリエンスの詳細については、ツインとツイン グラフの確認に関するセクションを参照してください。

ツインとリレーションシップの単純なリストを表示する

[ツイン] パネルには、ツインとそれに関連付けられているリレーションシップの単純なリストが表示されます。 ツインを名前で検索したり、展開して受信と発信のリレーションシップの詳細を確認することができます。

Screenshot of Azure Digital Twins Explorer Twins panel. A twin is highlighted and its relationships are shown.

ツインを作成する

新しいデジタル ツインは、[モデル] パネルのモデルの定義から作成できます。

モデルからツインを作成するには、一覧でそのモデルを見つけて、モデル名の横にあるメニュー ドットを選択します。 その後、[Create a Twin]\(ツインの作成\) を選択します。 新しいツインの名前を入力するように求められます。この名前は一意である必要があります。 次にツインを保存します。これにより、グラフに追加されます。

Screenshot of Azure Digital Twins Explorer Models panel. The menu dots for a single model are highlighted, and the menu option to Create a Twin is also highlighted.

ツインにプロパティ値を追加するには、「ツインとリレーションシップのプロパティを編集する」を参照してください。

リレーションシップの作成

2 つのツイン間のリレーションシップを作成するには、まず [ツイン グラフ] ウィンドウでリレーションシップのソース ツインを選択します。 次に、CTRL/CMD キーまたは SHIFT キーを押しながら、リレーションシップのターゲットとなる 2 つ目のツインを選択します。

2 つのツインを同時に選択したら、ターゲットのツインを右クリックすると、その間に [リレーションシップの追加] を行うためのオプションを含むメニューが表示されます。

Screenshot of Azure Digital Twins Explorer Twin Graph panel. The FactoryA and Consumer twins are selected, and a menu shows the option to Add relationships.

これにより、リレーションシップのソース ツインとターゲット ツインが設定された [リレーションシップの作成] ダイアログが表示されます ([リレーションシップのスワップ] アイコンを使用して切り替えすることもできます)。 DTDL モデルに従って、ソース ツインで使用できるリレーションシップの種類を含む [リレーションシップ] ドロップダウン メニューがあります。 リレーションシップの種類のオプションを選択し、新しいリレーションシップを [保存] します。

ツインとリレーションシップのプロパティを編集する

ツインまたはリレーションシップのプロパティ値を表示するには、[ツイン グラフ] で要素を選択し、[プロパティ インスペクターの切り替え] ボタンを使用して [ツイン プロパティ] または [リレーションシップのプロパティ] パネルをそれぞれ展開します。

Screenshot of Azure Digital Twins Explorer Twin Graph panel. The FactoryA twin is selected, and the Twin Properties panel is expanded, showing the properties of the twin.

このパネルを使用すると、書き込み可能なプロパティを直接編集できます。 値をインラインで更新し、パネルの上部にある [変更を保存する] ボタンを選択して保存します。 更新が保存されると、更新 API によって適用された JSON パッチ操作を示すモーダル ウィンドウが画面に表示されます。

Screenshot of Azure Digital Twins Explorer Twin Graph panel. The center of the screen displays a Path Information modal showing JSON Patch code.

ヒント

[ツインのプロパティ] および [リレーションシップのプロパティ] パネルに表示される各プロパティには、DTDL モデルのフィールドの型を示すアイコンが表示されます。 型のアイコンの詳細については、「データ型のアイコン」を参照してください。

ツインとリレーションシップを削除する

ツインまたはリレーションシップを削除するには、[ツイン グラフ] ウィンドウでそれを右クリックします。 こうすると、要素を削除するためのオプションを含むメニューが表示されます。

Screenshot of Azure Digital Twins Explorer Twin Graph panel. The FactoryA twin is selected, and there's a menu containing an option to Delete twin(s).

複数のツインまたはリレーションシップを一度に削除するには、CTRL/CMD キーまたは SHIFT キーを使用して、グラフ内の同じ種類のいくつかの要素を複数選択します。 ここから、同じ右クリックのプロセスに従って、要素を削除します。

また、インスタンス内のすべてのツインを同時に削除するには、上部のツール バーにある [すべてのツインの削除] ボタンを使用します。

Screenshot of Azure Digital Twins Explorer. The Delete All Twins icon is selected.

モデルとモデル グラフを確認する

モデルは、Azure Digital Twins Explorer 画面の左側にある [モデル] パネルと画面の中央にある [モデル グラフ] パネルの両方に表示できます。

[モデル] パネル:Screenshot of Azure Digital Twins Explorer. The Models panel is highlighted.

[ モデル グラフ ] パネル: Screenshot of Azure Digital Twins Explorer. The Model Graph panel is highlighted.

Note

現在、Azure Digital Twins エクスプローラーは DTDL v2 モデルを完全にサポートし、DTDL v3 モデルの限られた機能をサポートしています。 Azure Digital Twins エクスプローラーでは、[モデル] パネルで DTDL v3 モデルを表示でき、DTDL v3 モデルで作成されたツイン (配列プロパティを含む) を表示および編集できます。 ただし、DTDL v3 モデルは [モデル グラフ] パネルに表示されません。また、Azure Digital Twins エクスプローラーを使用してインポートすることはできません。 DTDL v3 モデルをインスタンスにインポートするには、API や SDK、Azure CLI などの別の開発者インターフェイスを使用します。

これらのパネルを使用すると、モデルを表示できます。

[モデル グラフ] パネルには、グラフの表示エクスペリエンスをカスタマイズするための機能もいくつか用意されています。

モデルの表示

インスタンス内のモデルの単純な一覧を [モデル] パネルに表示できます。 この一覧は、パネルの検索バーを使用して検索できます。

[モデル グラフ] パネルを使用すると、インスタンス内のモデルと、それらを相互に接続するリレーションシップ、継承、コンポーネントをグラフィカルに表示できます。

Note

現在、Azure Digital Twins エクスプローラーは DTDL v2 モデルを完全にサポートし、DTDL v3 モデルの限られた機能をサポートしています。 Azure Digital Twins エクスプローラーでは、[モデル] パネルで DTDL v3 モデルを表示でき、DTDL v3 モデルで作成されたツイン (配列プロパティを含む) を表示および編集できます。 ただし、DTDL v3 モデルは [モデル グラフ] パネルに表示されません。また、Azure Digital Twins エクスプローラーを使用してインポートすることはできません。 DTDL v3 モデルをインスタンスにインポートするには、API や SDK、Azure CLI などの別の開発者インターフェイスを使用します。

モデルの定義を表示する

モデルの完全な定義を表示するには、[モデル] ペインでそのモデルを見つけて、モデル名の横にあるメニュー ドットを選択します。 その後、[モデルの表示] を選択します。 こうすると、モデルの生の DTDL 定義を示す [モデル情報] モーダルが表示されます。

Screenshot of Azure Digital Twins Explorer Models panel. The menu dots for a single model are highlighted, and the menu option to View Model is also highlighted.

[モデル グラフ]でモデルを選択し、[モデルの詳細の切り替え] ボタンを使用して [モデルの詳細] パネルを展開することによって、モデルの完全な定義を表示することもできます。 このパネルには、モデルのすべての DTDL コードも表示されます。

Screenshot of Azure Digital Twins Explorer Model Graph panel. The Floor model is selected, and the Model DetailS panel is expanded, showing the DTDL code of the model.

モデル グラフのレイアウトを編集する

[モデル グラフ] 画面でモデルをクリックしてドラッグすると、さまざまな構成にモデルを再配置することができます。

また、[レイアウトの選択] メニューのオプションのいくつかのレイアウト アルゴリズムのいずれかを、モデル グラフに適用することもできます。

Screenshot of Azure Digital Twins Explorer Model Graph panel. The Choose Layout button is highlighted, showing a menu with the layout options Cola, Dagre, fCoSE, Klay, and d3Force.

モデル グラフの要素をフィルター処理および強調表示する

モデル グラフに表示されるモデル参照の種類をフィルター処理できます。 このメニューのスイッチを使用していずれかの参照型をオフにすると、その参照の種類がグラフに表示されなくなります。

Screenshot of Azure Digital Twins Explorer Model Graph panel. The filter menu for Relationships, Inheritance, and Components are highlighted.

次 のフィルター アイコンを選択して、グラフに表示されるモデルと参照をテキストでフィルター処理 することもできます。

Screenshot of Azure Digital Twins Explorer Model Graph panel. The text filter icon is selected, showing the Filter tab where you can enter a search term.

グラフに表示されるモデルと参照をテキストで強調表示する場合は、次 の強調表示 アイコンを選択します。

Screenshot of Azure Digital Twins Explorer Model Graph panel. The text filter icon is selected, showing the Highlight tab where you can enter a search term.

モデルの画像をアップロードする

カスタム画像をアップロードして、[モデル グラフ] および [ツイン グラフ] ビューでさまざまなモデルを表すことができます。 個々のモデルまたは複数のモデルの画像を一度にアップロードできます。

Note

これらの画像は、ローカルのブラウザー ストレージに格納されます。 これは、画像を保存したものとは別のブラウザーでは画像を使用できないことを意味します。ローカル ストレージが消去されるまで、画像はブラウザー ストレージに無期限に残ります。

1 つのモデルの画像をアップロードするには、[モデル] パネルでモデルを見つけて、モデル名の横にあるメニュー ドットを選択します。 次に、[Upload Model Image]\(モデル画像のアップロード\) を選択します｡ 表示されたファイル セレクター ボックスで、マシン上のそのモデルにアップロードする画像ファイルに移動します。 [開く] を選択してアップロードします。

Screenshot of Azure Digital Twins Explorer Models panel. The menu dots for a single model are highlighted, and the menu option to Upload Model Image is also highlighted.

また、モデルの画像を一括でアップロードすることもできます。

まず、次の手順を使用して、アップロードする前に画像ファイル名を設定します。 こうすると、アップロード後に Azure Digital Twins Explorer で画像を適切なモデルに自動的に割り当てることができます。

  1. モデル ID 値で開始します (dtmi:example:Floor;1 など)
  2. ":" のインスタンスを "_" に置き換えます (この例では dtmi_example_Floor;1 になります)
  3. ";" のインスタンスを "-" に置き換えます (この例では dtmi_example_Floor-1 になります)
  4. ファイルに画像の拡張子が付いていることを確認します (この例では dtmi_example_Floor-1.png のようになります)

Note

上記の条件を使用して既存のモデルにマップされていない画像をアップロードしようとすると、画像はアップロードまたは保存されません。

次に、同時に複数の画像をアップロードするには、[モデル] パネルの上部にある [モデルの画像のアップロード] アイコンを使用します。 ファイル セレクター ボックスで、アップロードする画像ファイルを選択します。

Screenshot of Azure Digital Twins Explorer Models panel. The Upload Model Images icon is highlighted.

モデルを管理する

Azure Digital Twins Explorer 画面の左側にある [モデル] パネルを使用すると、一連のすべてのモデルまたは個々のモデルに対する管理アクティビティを実行できます。

Screenshot of Azure Digital Twins Explorer. The Models panel is highlighted.

このパネルでは、次のモデル管理アクティビティを実行できます。

モデルの表示エクスペリエンスの詳細については、「モデルとモデル グラフを確認する」を参照してください。

モデルのアップロード

お使いのマシンからモデルをアップロードするには、モデル ファイルを個別に選択するか、モデル ファイルのフォルダー全体を一度にアップロードします。 多数のモデルのコードを含む 1 つの JSON ファイルをアップロードする場合は、モデルの一括アップロードの制限事項を確認してください。

Note

現在、Azure Digital Twins エクスプローラーは DTDL v2 モデルを完全にサポートし、DTDL v3 モデルの限られた機能をサポートしています。 Azure Digital Twins エクスプローラーでは、[モデル] パネルで DTDL v3 モデルを表示でき、DTDL v3 モデルで作成されたツイン (配列プロパティを含む) を表示および編集できます。 ただし、DTDL v3 モデルは [モデル グラフ] パネルに表示されません。また、Azure Digital Twins エクスプローラーを使用してインポートすることはできません。 DTDL v3 モデルをインスタンスにインポートするには、API や SDK、Azure CLI などの別の開発者インターフェイスを使用します。

個別に選択した 1 つ以上のモデルをアップロードするには、上向きの矢印が示されているモデルのアップロード アイコンを選択します。

Screenshot of Azure Digital Twins Explorer Models panel. The Upload a model icon is highlighted.

表示されたファイル セレクター ボックスで、マシン上のアップロードするモデルに移動します。 1 つまたは複数の JSON モデル ファイルを選択し、[開く] を選択してアップロードします。

モデルのフォルダー (フォルダー内のすべてのものを含む) をアップロードするには、ファイル フォルダーが示されているモデルのディレクトリのアップロード アイコンを選択します。

Screenshot of Azure Digital Twins Explorer Models panel. The Upload a directory of Models icon is highlighted.

表示されたファイル セレクター ボックスで、マシン上の JSON モデル ファイルを含むフォルダーに移動します。 [開く] を選択して、その最上位のフォルダーとそのすべての内容をアップロードします。

重要

モデルの定義内で別のモデルが参照されている場合 (リレーションシップやコンポーネントを定義する場合など)、それを使用するモデルをアップロードするには、参照されているモデルがインスタンス内に存在する必要があります。 モデルを 1 つずつアップロードする場合は、使用するモデルをアップロードする前に参照されているモデルをアップロードする必要があります。 モデルを一括でアップロードする場合は、同じインポートでそれらすべてを選択できます。Azure Digital Twins によって、それらをアップロードする順序が推論されます。 ただし、同じファイルで 50 を超えるモデルをアップロードする場合は、モデルの一括アップロードの制限事項を参照してください。

モデルの一括アップロードの制限事項

このセクションの制限は、1 つの JSON ファイル内に含まれるモデルに適用され、Azure Digital Twins Explorer に同時にアップロードされます。

1 つの JSON ファイルに含めることができるモデルの数に制限はありませんが、50 を超えるモデルを含むファイルには特別な考慮事項があります。 同じモデル ファイル内に 50 を超えるモデルをアップロードする場合は、次のヒントに従います。

  • 同じファイルで定義されている他のモデルから継承するモデルがある場合は、それらをリストの末尾付近に配置します。
  • コンポーネントと同じファイルで定義された他のモデルを参照するモデルがある場合は、それらをリストの末尾付近に配置します。
  • モデルが同じファイルで定義されている別のモデルを (継承によって、またはコンポーネントとして) 参照する場合は常に、参照を含むモデルが、参照先のモデル定義よりもリストの後ろに来ることを確認します。

これにより、アップロード プロセス中にモデルの依存関係が正しく解決されるようになります。

モデルを削除する

[モデル] パネルを使用すると、個々のモデル、またはインスタンス内のすべてのモデルを一度に削除できます。

1 つのモデルを削除するには、そのモデルを一覧から見つけて、モデル名の横にあるメニュー ドットを選択します。 次に、[モデルの削除] を選択します。

Screenshot of Azure Digital Twins Explorer Models panel. The menu dots for a single model are highlighted, and the menu option to Delete Model is also highlighted.

インスタンス内のすべてのモデルを一度に削除するには、[モデル] パネルの上部にある [すべてのモデルの削除] アイコンを選択します。

Screenshot of Azure Digital Twins Explorer Models panel. The Delete All Models icon is highlighted.

モデルを最新の情報に更新する

Azure Digital Twins Explorer を開くと、環境で使用可能なすべてのモデルが [モデル] パネルに自動的に表示されます。

ただし、いつでもパネルを手動で更新して、Azure Digital Twins インスタンス内のすべてのモデルの一覧を再度読み込むことができます。 これを行うには、[モデルの更新] アイコンを選択します。

Screenshot of Azure Digital Twins Explorer Models panel. The Refresh models icon is highlighted.

グラフのインポート/エクスポート

[ツイン グラフ] パネルには、グラフ機能をインポートおよびエクスポートするオプションがあります。

グラフのインポート

インポート機能を使用すると、ツイン、リレーションシップ、モデルをインスタンスに追加できます。 この機能は、多くのツイン、リレーションシップ、モデルを一度に作成する場合に便利です。

Note

グラフ インポート ファイルにモデルが含まれている場合、モデルの一括アップロードの制限が適用されます。

インポート ファイルを作成する

グラフをインポートする最初の手順は、追加するツインとリレーションシップを表すファイルの作成です。

インポート ファイルは、次の 2 つの形式のいずれかにすることができます。

  • グラフのエクスポートで生成される JSON ベースの形式。 この形式には、ツイン、リレーションシップ、モデルを含めることができます。
  • このセクションの残りの部分で説明する Excel ベースのカスタム形式。 この形式では、ツインとリレーションシップをアップロードできます。
Excel でインポート ファイルを作成する

ツインとリレーションシップを Azure Digital Twins Explorer にアップロードできるカスタム グラフを Excel で作成するには、次の形式を使用します。

各行は作成する要素を表します (ツイン、リレーションシップ、またはツインと対応するリレーションシップの組み合わせ)。 ツインまたはリレーションシップのデータを構造化するには、次の列を使用します。 列名はカスタマイズできますが、この順序のままである必要があります。

ModelID ID リレーションシップ (ソース) リレーションシップ名 初期データ
(省略可能)
新しいツインに使用するモデルの DTMI ID。 このモデル定義は、インスタンスに既に存在している必要があります。

行でリレーションシップのみを作成する (ツインなし) 場合は、行のこの列を空白のままにすることができます。		 (必須)
ツインの一意の ID。

この行で新しいツインが作成される場合、この値は新しいツインの ID です。
行にリレーションシップ情報がある場合、この ID はリレーションシップのターゲットとして使用されます。		 (省略可能)
新しいリレーションシップのソース ツインである必要があるツインの ID。

行でツインのみを作成する (リレーションシップなし) 場合は、行のこの列を空白のままにすることができます。		 (省略可能)
作成する新しいリレーションシップの名前。 リレーションシップの方向は、列 C のツインから列 B のツインになります。		 (省略可能)
作成されるツインのプロパティ設定を含む JSON 文字列。 プロパティは、列 A のモデルで定義されているものと一致している必要があります。

2 つのフロアと 2 つのルームの小さなグラフを作成する .xlsx ファイルの例を次に示します。

Screenshot of graph data in Excel. The column headers correspond to the fields above, in order, and the rows contain corresponding data values.

このファイルとその他の .xlsx グラフの例は、GitHub の Azure Digital Twins Explorer リポジトリで確認できます。

Note

.xlsx に記述されているプロパティとリレーションシップは、関連するツインのモデル定義に定義されている内容と一致する必要があります。

Azure Digital Twins Explorer にファイルをインポートする

インポートする準備ができたファイルをマシンに配置したら、[ツイン グラフ]パネルの [グラフのインポート] アイコンを選択します。

Screenshot of Azure Digital Twins Explorer Twin Graph panel. The Import Graph button is highlighted.

表示されたファイル セレクター ボックスで、マシン上のアップロードするグラフ ファイル (.xlsx または .json) に移動し、[開く] を選択してアップロードします。

Azure Digital Twins で、インポートするグラフのプレビューが表示された [インポート] パネルが開きます。 確定するには、パネルの右上隅にある [保存] アイコンを選択します。

インポートが成功すると、アップロードされたモデル、ツイン、リレーションシップの数がモーダル ウィンドウに表示されます。

Screenshot of Azure Digital Twins Explorer Twin Graph panel. The center of the screen displays an Import Successful modal showing four twins imported and two relationships imported.

グラフとモデルのエクスポート

エクスポート機能を使用すると、モデル、ツイン、リレーションシップを含む部分的なグラフまたは完全なグラフをエクスポートできます。 エクスポートでは、最新のクエリ結果とインスタンス内のすべてのモデルのツインとリレーションシップが、お使いのマシンにダウンロードできる JSON ベースの形式にシリアル化されます。

まず、[クエリ エクスプローラー] パネルを使用して、ダウンロードするツインとリレーションシップを選択するクエリを実行します。 こうすると、それらが [ツイン グラフ] パネルに読み込まれます。

ヒント

すべてのツインおよびリレーションシップを表示するクエリは SELECT * FROM digitaltwins です。

ダウンロードするグラフの一部が [ツイン グラフ] パネルに表示されたら、[グラフのエクスポート] アイコンを選択します。

Screenshot of Azure Digital Twins Explorer Twin Graph panel. The Export Graph button is highlighted.

このアクションにより、[ツイン グラフ] ボックスで [ダウンロード] リンクが有効になります。 それを選択して、クエリ結果の JSON ベースの表現とインスタンス内のすべてのモデルをマシンにダウンロードします。

ヒント

このファイルは、インポート機能を使用して、編集または Azure Digital Twins への再アップロード (あるいはその両方) を行うことができます。

Azure Digital Twins Explorer 環境へのリンクを他のユーザーと共有して、共同作業を行うことができます。 このセクションでは、Azure Digital Twins Explorer 環境へのリンクを生成する方法について説明します。必要に応じて、リンクを開いたときに実行される特定のクエリを含めることができます。 このセクションでは、ツイン データを操作するために受信者に必要なアクセス許可についても説明します。

受信者のアクセス権の要件

受信者がリンクを開いて Azure Digital Twins Explorer でインスタンスを表示するには、自分の Azure アカウントにログインし、そのインスタンスへの Azure Digital Twins データ リーダー アクセス権を持っている必要があります (Azure Digital Twins ロールの詳細については、セキュリティに関するページを参照)。

受信者がグラフとデータに変更を加えるには、インスタンスに対する Azure Digital Twins データ所有者ロールを持っている必要があります。

特定のクエリを含む Azure Digital Twins Explorer 環境へのリンクを生成するには、[クエリ エクスプローラー] で取得するクエリを入力し、[共有] ボタンを選択してリンク全体をコピーします。

Screenshot of Azure Digital Twins Explorer Query Explorer panel. The query text and the Send button are highlighted.

上の例とスクリーンショットのクエリの場合、[共有] ボタンをクリックすると、リンク https://explorer.digitaltwins.azure.net/?query=SELECT%20*%20FROM%20digitaltwins%20T%20WHERE%20T.InFlow%20%3E%2070&tid=<tenant-ID>&eid=<Azure-Digital-Twins-instance-host-name> が生成されます。 このリンクには、Azure Digital Twins インスタンスのテナント ID とホスト名、および書式設定されたクエリ テキストが含まれています。

この URL を共有して、他のユーザーがインスタンスとこのクエリにアクセスできるようにします。 リンクを使用して Azure Digital Twins Explorer を開くと、クエリの結果が [Twin Graph] (ツイン グラフ) パネルに自動的に入力されます。

特定のクエリがアタッチされていない Azure Digital Twins Explorer 環境へのリンクを共有するには、まず [共有] ボタンを使用してリンクをインスタンスにコピーします。

Screenshot of Azure Digital Twins Explorer Query Explorer panel. Only the Send button is highlighted.

次に、結果からクエリ パラメーターを手動で削除します。

たとえば、上のスクリーンショットの [共有] ボタンをクリックすると、リンク https://explorer.digitaltwins.azure.net/?query=SELECT%20*%20FROM%20digitaltwins&tid=<tenant-ID>&eid=<Azure-Digital-Twins-instance-host-name> が生成されます。 query=SELECT%20*%20FROM%20digitaltwins& の部分を削除して、URL https://explorer.digitaltwins.azure.net/?tid=<tenant-ID>&eid=<Azure-Digital-Twins-instance-host-name> を生成できます。

次に、この URL を共有して、他のユーザーがインスタンスにアクセスできるようにします。 このリンクを使って Azure Digital Twins Explorer を開くと、インスタンスに接続され、事前に入力されたクエリ結果は表示されません。

アクセシビリティと詳細設定

Azure Digital Twins Explorer のいくつかの詳細設定を有効にして、エクスペリエンスをカスタマイズしたり、よりアクセスしやすくすることができます。

右上のツール バーにあるキーボード ショートカット アイコンを使用すると、Azure Digital Twins Explorer の操作に使用できるキーボード ショートカットの一覧を表示することができます。

Screenshot of Azure Digital Twins Explorer. The Keyboard Shortcuts icon is highlighted in the top toolbar.

右上のツール バーにある設定の歯車アイコンからは、いくつかの高度な機能にアクセスすることができます。

  • 一括読み込み: クエリ結果に含まれていない他のツインとのリレーションシップを持つツインがクエリから返された場合、この機能によって、グラフをレンダリングする前に "含まれていない" ツインが読み込まれます。
  • キャッシュ: この機能を有効にすると、クエリのパフォーマンスを向上させるために、Azure Digital Twins Explorer によって、リレーションシップとモデルのローカル キャッシュがメモリ内に保持されます。 これらのキャッシュは、関連する要素に対する書き込み操作や、ブラウザーの更新時に消去されます。 この機能は既定では無効です。
  • コンソール: この機能を使用すると、コンソール ウィンドウが表示されます。このウィンドウでは、グラフを操作するための単純なシェル関数を使用できます。
  • 出力: この機能を使用すると、操作の診断トレースを示す出力ウィンドウが表示されます。
  • ハイ コントラスト: この機能を使用すると、Azure Digital Twins Explorer の色を変更し、コントラストを高めて表示することができます。

Azure Digital Twins Explorer を構成するパネル ([クエリ エクスプローラー]、[ツイン]、[モデル]、[ツイン グラフ]、[モデル グラフ]) の位置を編集して、パネル レイアウトをカスタマイズすることができます。 パネルを別の位置に移動するには、パネル名をクリックしたままにして、新しい目的の位置にドラッグします。

Screenshot of Azure Digital Twins Explorer. The names of the Query Explorer, Models, Twin Graph, and Model Graph panels are highlighted.

パネルの位置は、ブラウザー ウィンドウの更新時にリセットされます。

次のステップ

Azure Digital Twins のツイングラフ用のクエリの作成について学習します。