使用 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 入口網站。

若要針對 Azure Digital Twins 執行個體開啟 Azure Digital Twins Explorer，首先瀏覽至入口網站中的執行個體，方法是在入口網站搜尋列中搜尋其名稱。

接下來，選取 [開啟 Azure Digital Twins Explorer (預覽)] 按鈕。

這會在新索引標籤中開啟 Azure Digital Twins Explorer。如果這是您第一次使用 Explorer，則會看到摘要說明主要功能的歡迎強制回應。

Azure Digital Twins Explorer 可能會自動連線到您的執行個體。 如果沒有，您會看到下列畫面，要求您指定 Azure Digital Twins URL。 (如果您在畫面上沒看到此方塊，則表示 Azure Digital Twins Explorer 已自動完成此步驟。)

如果您看到此方塊，請將 https:// 輸入至欄位中，後面接著執行個體的主機名稱 (您可以在入口網站的 [概觀] 頁面上找到此名稱)。 這些值合起來組成執行個體 URL。 選取 [儲存] 以連線到您的執行個體。

重要

Azure Digital Twins Explorer 不支援 私人端點。 如果您想要搭配使用 Azure Digital Twins Explorer 搭配使用 Private Link 來停用公用存取的 Azure Digital Twins 實例，您可以在雲端私下部署 Azure Digital Twins Explorer 程式代碼基底。 如須瞭解如何執行此動作，請參閱 Azure Digital Twins Explorer：在雲端中執行。

切換應用程式內的內容

一旦在應用程式中，您也能夠從頂端工具列選取執行個體名稱，來變更目前連線到總管的執行個體。

這樣做會顯示 Azure 數位對應項 URL 強制回應，您可以在 https:// 前置詞後輸入另一個 Azure 數位對應項執行個體的主機名稱，以連接到該執行個體。

注意

目前，在應用程式內切換內容的能力不適用於個人 Microsoft 帳戶 (MSA)。 MSA 使用者必須從 Azure 入口網站中選擇的執行個體存取總管，或可能透過環境的直接連結來連線到特定執行個體。

查詢數位對應項圖表

您可以使用 [查詢總管] 面板，在您的圖表上執行查詢。

輸入您想要執行的查詢。 如果您想要在多行中輸入查詢，可以使用 SHIFT + ENTER 將新行加入至查詢方塊。

選取 [執行查詢] 按鈕，在 [對應項圖表] 面板中顯示查詢結果。

注意

如果結果也包含至少一個對應項，則包含關聯性的查詢結果只能在 [對應項圖表] 面板中轉譯。 雖然只傳回關聯性的查詢在 Azure Digital Twins 是可行的，但您只能使用輸出面板，在 Azure Digital Twins Explorer 中檢視這些查詢。

重疊查詢結果

如果您想要從 [對應項圖表] 面板中顯示的內容醒目標示結果，而不是將面板的內容完全取代為新的查詢結果，您可以在執行查詢之前先核取 [重疊結果] 方塊。

如果查詢結果包含目前未顯示在 [對應項圖表] 面板中的項目，元素將會新增至現有的檢視。

儲存並重新執行查詢

查詢可以儲存在瀏覽器的本機儲存體中，讓查詢更容易選取並重新執行。

注意

本機瀏覽器儲存體表示，除了儲存查詢的瀏覽器之外，儲存的查詢將無法在其他瀏覽器中使用，而且這些查詢會無限期地保留在瀏覽器儲存體中，直到系統清除了本機儲存體為止。

若要儲存查詢，請在查詢方塊中輸入該查詢，然後選取面板右側的 [儲存] 圖示。 出現提示時，輸入已儲存的查詢名稱。

一旦儲存了查詢，就可以從 [已儲存的查詢] 下拉式功能表中加以選取，以輕鬆地再次執行該查詢。

若要刪除已儲存的查詢，請在 [已儲存的查詢] 下拉式功能表開啟時，選取查詢名稱旁邊的 X 圖示。

提示

若為大型圖表，建議只查詢有限的子集，然後視需要載入圖表的其餘部分。 您可以在 [對應項圖表] 面板中按兩下對應項，以擷取其他相關節點。

探索對應項圖表

[對應項圖表] 面板可讓您探索執行個體中的對應項和關聯性。

您可以使用此面板來探索對應項資料。

[對應項圖表] 面板也提供數種自訂圖表檢視體驗的能力：

• 變更對應項顯示屬性
• 編輯對應項圖表配置
• 控制對應項圖表展開
• 顯示和隱藏對應項圖表元素
• 篩選和醒目提示對應項圖表元素

探索對應項資料

使用查詢總管執行查詢，以查看 [對應項圖表] 面板中所顯示查詢結果中的對應項和關聯性。

提示

顯示所有對應項和關聯性的查詢為 SELECT * FROM digitaltwins。

檢視對應項和關聯性屬性

若要檢視對應項或關聯性的屬性值，請選取 [對應項圖表] 中的對應項或關聯性，並使用 [切換屬性偵測器] 按鈕，分別展開 [對應項屬性] 或 [關聯性屬性] 面板。 此面板會顯示與元素相關聯的所有屬性，以及其值。 對於尚未設定的屬性，其也包含預設值。

資料類型圖示

[對應項屬性] 和 [關聯性屬性] 面板中顯示的屬性，每個都會以圖示顯示，指出來自 DTDL 模型的欄位類型。 您可以將滑鼠停留在圖示上，以顯示相關聯的類型。

下表顯示可能的資料類型及其對應的圖示。 資料表也包含 DTDL v3 語言規格中從每個資料類型到其結構描述的連結。

Icon	資料類型
	boolean
	component
	date
	dateTime
	duration
	enum
	map
	數值類型，包括 double、float、integer 和 long
	object
	string
	time

錯誤

如果對應項或其部分屬性不再符合其模型，[對應項屬性] 面板會顯示錯誤訊息。

有兩個可能的錯誤案例，每個案例都會提供自己的錯誤訊息：

• 遺漏對應項所使用的一或多個模型。 因此，與該模型相關聯的所有屬性都會在 [對應項屬性] 面板中標示為「遺漏」。 如果自從建立了對應項後已刪除模型，就會發生此錯誤。
• 對應項上的某些屬性不是對應項模型的一部分。 只有這些屬性會在 [對應項屬性] 面板中標示為「遺漏」。 如果自從設定了屬性後已取代或變更對應項的模型，而且屬性已不再存在於最新版的模型中，就可能發生此錯誤。

以下螢幕擷取畫面會顯示這兩則錯誤訊息：

驗證和探索歷程記錄屬性

如果您的 Azure Digital Twins 執行個體已啟用資料歷程記錄，您可以在 Azure Digital Twins Explorer 中驗證和探索其歷程記錄資料。 請遵循下列步驟，將圖表中的歷程記錄資料視覺化，或檢視資料表中的原始值。

1. 從對應項圖表檢視器中，選取您要檢視其歷程記錄屬性的對應項，以在 [對應項屬性] 面板中將其開啟。 在面板右上角，選取時間序列圖示，以開啟資料歷程記錄總管。

   

2. 從左側選取對應項名稱，這會顯示選項，以便您選擇要檢視的對應項歷程記錄屬性。 [對應項識別碼] 欄位會預先填入選取的對應項。 在此欄位旁邊，您可以選取檢查屬性圖示來檢視對應項資料，或選取進階對應項搜尋圖示，透過查詢屬性值來尋找其他對應項。

   

3. 在 [屬性] 欄位中，選取您要檢視其歷程記錄資料的屬性。 如果屬性不是數值，但包含數值，請使用 [將屬性值轉換為數字] 選項，嘗試將此資料轉換為數字，以便在圖表上視覺化。

   

   注意

   如果您無法從下拉式清單中選取屬性，因為清單沒有回應，這可能表示執行個體中的某些模型發生錯誤。 例如，在模型屬性中具有非唯一列舉值將會中斷這項功能。 如果發生這種情況，請檢閱您的模型定義，並確定所有屬性都有效。

4. 選擇一個時間序列標籤，然後選取 [更新]。

這會載入所選屬性之歷程記錄值的圖表檢視。 您可以使用圖表上方的索引標籤，在圖表檢視和資料表檢視之間切換。

若要將更多屬性新增至視覺效果，請使用左側的 [新增時間序列] 按鈕。

若要結束資料歷程記錄總管並返回主要 Azure Digital Twins Explorer，請選取 [關閉]。

在圖表中檢視歷程記錄

歷程記錄屬性的 [圖表] 檢視會將屬性值顯示為一段時間內折線圖上的點。

您可以使用圖表上方的圖示來控制圖表設定，包括...

• 變更圖表中所包含資料的時間範圍。
• 選取多個時間序列是獨立顯示還是在共用的 Y 軸上顯示。 針對軸選取 [獨立] 表示每個時間序列都會按圖表縮放，並保有各自的刻度軸。 選取 [共用] 軸表示所有時間序列資料都會按同一個軸縮放。
• 選擇圖表的彙總邏輯。 當屬性的資料點數比圖表上可顯示的資料點數多時，系統會使用平均、最小或最大函數，將資料彙總成有限的資料點數。

另外還有 [在 Azure Data Explorer 中開啟查詢] 按鈕，可供您在其中檢視和修改目前的查詢，以進一步探索時間序列資料。

在資料表中檢視歷程記錄

歷程記錄屬性的 [資料表] 檢視會在資料表中顯示屬性值及其時間戳記。

您可以使用資料表上方的圖示來控制資料表設定，包括...

• 變更資料表中所包含資料的時間範圍。
• 下載資料表資料以進行獨立分析。

檢視對應項的關聯性

您也可以快速檢視涉及特定對應項的所有關聯性程式碼 (包括傳入和傳出關聯性)。

以滑鼠右鍵按一下圖表中的對應項，然後選擇 [取得關聯性]。 這麼做會顯示關聯性資訊強制回應，顯示所有傳入和傳出關聯性的 JSON 表示法。

變更對應項顯示屬性

您可以設定您想要顯示的屬性，以識別對應項圖表中的對應項。 預設值是 $dtId 值，但您可以從模型集中存在的任何屬性中進行選擇 (甚至是不存在於每個對應項上的屬性)。

若要變更顯示屬性，請使用 [選取對應項顯示名稱屬性] 下拉式功能表。 下拉式功能表會依包含屬性的模型數目來排序。

如果您選擇未存在於每一個對應項上的屬性，則圖表中沒有該屬性的任何對應項都會以星號 (*) 顯示，後面接著其 $dtId 值。

編輯對應項圖表配置

您可以按住對應項並將其繞著 [對應項圖表] 畫面拖曳，以將這些對應項重新排列成不同的設定。

您也可以從 [選擇配置] 功能表中的選項，將數個配置演算法之一套用至圖表。

控制對應項圖表展開

在 [對應項圖表] 面板中檢視查詢結果時，您可以按兩下對應項，讓圖表擷取其關聯性和相關對應項，而且如果它們尚未在檢視中呈現，則會顯示它們。 您可以自訂此展開，方法是設定大小和方向，以判斷要擷取的對應項數目。

若要設定要展開的圖層數目，請使用 [展開圖層] 選項。 此數字指出要從選取的對應項擷取多少層關聯性。

若要指出展開時要遵循的關聯性類型，請使用 [展開方向] 按鈕。 這樣做可讓您從傳入、傳出或傳入和傳出關聯性中進行選取。

顯示和隱藏對應項圖表元素

您可以切換選項，以隱藏圖表檢視中的對應項或關聯性。

若要隱藏對應項或關聯性，請在 [對應項圖表] 視窗中以滑鼠右鍵按一下該對應項或關聯性。 這樣做將會顯示一個功能表，其中具有隱藏元素或其他相關元素的選項。

您也可以一次隱藏多個對應項或關聯性，方法為使用 CTRL/CMD 或 SHIFT 鍵，以在圖表中多重選取相同類型的數個元素。 從這裡，請遵循相同的按一下滑鼠右鍵流程來查看隱藏選項。

若要在隱藏了部分對應項之後回復顯示所有對應項，請使用 [全部顯示] 按鈕。 若要回復顯示所有關聯性，請使用 [顯示所有關聯性] 按鈕。

篩選和醒目提示對應項圖表元素

您可以選取此 [篩選] 圖示，依文字篩選圖表中出現的對應項和關聯性：

您也可以選取此 [醒目提示] 圖示，依文字醒目提示圖表中出現的對應項和關聯性：

管理對應項和圖表

Azure Digital Twins Explorer 提供數種方式，來管理執行個體中的對應項和關聯性。

本節描述如何執行下列管理活動：

• 檢視對應項和關聯性的一般清單
• 建立具有或不含初始屬性的對應項
• 建立對應項之間的關聯性
• 編輯對應項和關聯性屬性
• 刪除對應項和關聯性

如需對應項和關聯性檢視體驗的相關資訊，請參閱探索對應項和對應項圖表。

檢視對應項和關聯性的一般清單

[對應項] 面板會顯示對應項及其相關聯關聯性的一般清單。 您可以依名稱搜尋對應項，並將其展開，以取得其傳入和傳出關聯性的詳細資料。

建立對應項

您可以在 [模型] 面板中，從其模型定義建立新的數位對應項。

若要從模型建立對應項，請在清單中尋找該模型，並選擇模型名稱旁邊的功能表點。 然後，選取 [建立對應項]。 系統會要求您輸入新對應項的名稱，此名稱必須是唯一的。 然後儲存對應項，這會將其新增至您的圖表。

若要將屬性值新增至對應項，請參閱編輯對應項和關聯性屬性。

建立關聯

若要在兩個對應項之間建立關聯性，首先在 [對應項圖表] 視窗中選取關聯性的來源對應項。 接下來，當您選取第二個對應項作為關聯性的目標時，按住 CTRL/CMD 或 SHIFT 鍵。

一旦同時選取了這兩個對應項，請以滑鼠右鍵按一下目標對應項，來顯示功能表，其中包含一個選項，可在它們之間新增關聯性。

這樣做會顯示 [建立關聯性] 對話方塊，其中已填入關聯性的來源對應項和目標對應項 (您也可以使用 [交換關聯性] 圖示來切換它們)。 有一個 [關聯性] 下拉式功能表，其中包含來源對應項根據其 DTDL 模型可以具有的關聯性類型。 選取關聯性類型的選項，然後儲存新的關聯性。

編輯對應項和關聯性屬性

若要檢視對應項或關聯性的屬性值，請選取 [對應項圖表] 中的元素，並使用 [切換屬性偵測器] 按鈕，分別展開 [對應項屬性] 或 [關聯性屬性] 面板。

您可以使用此面板直接編輯可寫入的屬性。 更新其內嵌值，然後選取面板頂端的 [儲存變更] 按鈕以儲存。 儲存更新時，畫面會顯示強制回應視窗，其中顯示更新 API 所套用的 JSON 修補作業。

提示

[對應項屬性] 和 [關聯性屬性] 面板中顯示的屬性，每個都會以圖示顯示，指出來自 DTDL 模型的欄位類型。 如需類型圖示的詳細資訊，請參閱資料類型圖示。

刪除對應項及關聯性

若要刪除對應項或關聯性，請在 [對應項圖表] 視窗中以滑鼠右鍵按一下該對應項或關聯性。 這樣做將會顯示功能表，其中包含刪除元素的選項。

您可以使用 CTRL/CMD 或 SHIFT 鍵，一次刪除多個對應項或多個關聯性，以多重選取圖表中相同類型的數個元素。 從這裡開始，請遵循相同的按一下滑鼠右鍵程序來刪除元素。

您也可以選擇同時刪除執行個體中的所有對應項，方法為使用頂端工具列中的 [刪除所有對應項] 按鈕。

探索模型和模型圖表

您可以在 Azure Digital Twins Explorer 畫面左側的 [模型] 面板中，也可以在畫面中間的 [模型圖表] 面板中檢視模型。

[模型]面板:

[模型圖表] 面板:

注意

目前，Azure Digital Twins Explorer 完全支援 DTDL v2 模型，並支援 DTDL v3 模型的有限功能。

DTDL v3 模型可以在 [模型] 面板中檢視，並使用 DTDL v3 模型建立的對應項可以檢視和編輯（包括具有數位屬性的模型）。 不過，DTDL v3 模型不會顯示在 [模型圖表] 面板中，而且無法使用 Azure Digital Twins Explorer 匯入這些模型。 若要將 DTDL v3 模型匯入執行個體，請使用另一個開發人員介面，例如 API 和 SDK 或 Azure CLI。

您可以使用這些面板來檢視您的模型。

[模型圖表] 面板也提供數種自訂圖表檢視體驗的能力：

• 編輯模型圖表配置
• 篩選和醒目提示模型圖表元素
• 上傳模型影像來代表圖表中的模型

檢視模型

您可以在 [模型 ] 面板中檢視執行個體中模型的一般清單。 此清單可以使用面板中的 [搜尋] 列進行搜尋。

您可以使用 [模型圖表] 面板來檢視執行個體中模型的圖表表示法，以將彼此聯繫的關聯性、繼承和元件。

注意

目前，Azure Digital Twins Explorer 完全支援 DTDL v2 模型，並支援 DTDL v3 模型的有限功能。

DTDL v3 模型可以在 [模型] 面板中檢視，並使用 DTDL v3 模型建立的對應項可以檢視和編輯（包括具有數位屬性的模型）。 不過，DTDL v3 模型不會顯示在 [模型圖表] 面板中，而且無法使用 Azure Digital Twins Explorer 匯入這些模型。 若要將 DTDL v3 模型匯入執行個體，請使用另一個開發人員介面，例如 API 和 SDK 或 Azure CLI。

檢視模型定義

若要查看模型的完整定義，請在 [模型] 窗格中尋找該模型，然後選取模型名稱旁邊的功能表點。 然後，選取 [檢視模型]。 這樣做會顯示模型資訊強制回應，其中顯示模型的原始 DTDL 定義。

您也可以在 [模型圖表] 中選取模型，並使用 [切換模型詳細資料] 按鈕展開 [模型詳細資料] 面板，來檢視模型的完整定義。 此面板也會顯示模型的完整 DTDL 程式碼。

編輯模型圖表配置

您可以按住對應項並將其繞著 [模型圖表] 畫面拖曳，以將這些模型重新排列成不同的設定。

您也可以從 [選擇配置] 功能表中的選項，將數個配置演算法之一套用至模型圖表。

篩選和醒目提示模型圖表元素

您可以篩選 [模型圖表] 中出現的模型參考類型。 透過此功能表中的切換來關閉其中一個參考類型，將會防止該參考類型顯示在圖表中。

您也可以選取此篩選圖示，依文字篩選圖表中出現的模型和參考:

您可以選取此醒目提示圖示，依文字醒目提示圖表中出現的模型和參考:

上傳模型影像

您可以上傳自訂影像，以代表 [模型圖表] 和 [對應項圖表] 檢視中的不同模型。 您可以上傳個別模型的影像，或一次上傳數個模型的影像。

注意

這些影像會儲存在本機瀏覽器儲存體中。 這表示，除了儲存影像的瀏覽器之外，這些影像將無法在其他瀏覽器中使用，而且這些影像會無限期地保留在瀏覽器儲存體中，直到系統清除了本機儲存體為止。

若要上傳單一模型的影像，請在 [模型] 面板中尋找該模型，然後選取模型名稱旁邊的功能表點。 然後，選取 [上傳模型影像]。 在出現的檔案選取器方塊中，於您的機器上瀏覽至您要針對該模型上傳的影像檔。 選擇 [開啟] 以上傳該影像檔。

您也可以大量上傳模型影像。

首先，使用下列指示，在上傳之前設定影像檔名稱。 這樣做可讓 Azure Digital Twins Explorer 在上傳之後自動將影像指派給正確的模型。

1. 從模型識別碼值 (例如，dtmi:example:Floor;1) 開始
2. 將 ":" 的執行個體取代為 "_" (範例會變成 dtmi_example_Floor;1)
3. 將 ";" 的執行個體取代為 "-" (範例會變成 dtmi_example_Floor-1)
4. 確定檔案具有影像副檔名 (範例會變成類似 dtmi_example_Floor-1.png 的檔案)

注意

如果嘗試上傳未使用上述準則對應至任何現有模型的影像，將不會上傳或儲存影像。

然後，若要同時上傳影像，請使用 [模型] 面板頂端的 [上傳模型影像] 圖示。 在檔案選取器方塊中，選擇要上傳的影像檔。

管理模型

您可以使用 Azure Digital Twins Explorer 畫面左側的 [模型] 面板，在整組模型或個別模型上執行管理活動。

使用此面板，您可以完成下列模型管理活動：

• 將模型上傳至您的 Azure Digital Twins 執行個體
• 從執行個體中刪除模型
• 重新整理模型，將所有模型的清單重新載入至這個面板

如需模型檢視體驗的相關資訊，請參閱探索模型和模型圖表。

上傳模型

您可以從電腦上傳模型，方法是個別選取模型檔案，或一次上傳模型檔案的整個資料夾。 如果您要上傳一個 JSON 檔案，其中包含許多模型的程式碼，請務必檢閱大量模型上傳限制。

注意

目前，Azure Digital Twins Explorer 完全支援 DTDL v2 模型，並支援 DTDL v3 模型的有限功能。

DTDL v3 模型可以在 [模型] 面板中檢視，並使用 DTDL v3 模型建立的對應項可以檢視和編輯（包括具有數位屬性的模型）。 不過，DTDL v3 模型不會顯示在 [模型圖表] 面板中，而且無法使用 Azure Digital Twins Explorer 匯入這些模型。 若要將 DTDL v3 模型匯入執行個體，請使用另一個開發人員介面，例如 API 和 SDK 或 Azure CLI。

若要上傳個別選取的一或多個模型，請選取 [上傳模型] 圖示，其中顯示向上箭號。

在出現的檔案選取器方塊中，於您的機器上瀏覽至您要上傳的模型。 您可以選取一或多個 JSON 模型檔案，然後選取 [開啟] 以上傳這些模型檔案。

若要上傳模型的資料夾，包括其中的一切，請選取 [上傳模型的目錄] 圖示，其中顯示檔案資料夾。

在出現的檔案選取器方塊中，於您的機器上瀏覽至包含 JSON 模型檔案的資料夾。 選取 [開啟] 來上傳該最上層資料夾及其所有內容。

重要

如果模型在其定義中參考另一個模型，例如當您定義關聯性或元件時，所參考的模型必須存在於執行個體中，才能上傳使用該模型的模型。 如果您要逐一上傳模型，這表示您應該先上傳所參考的模型，再上傳使用該模型的任何模型。 如果您要大量上傳模型，則可以在相同的匯入中選取所有模型，Azure Digital Twins 將會推斷上傳模型的順序。 不過，如果您要在同一個檔案中上傳超過 50 個模型，請參閱大量模型上傳限制。

大量模型上傳限制

本節中的限制適用於將包含在單一 JSON 檔案中的多個模型同時上傳至 Azure Digital Twins Explorer 的情況。

雖然您可以在單一 JSON 檔案中包含不限數目的模型，但對於包含超過 50 個模型的檔案則有特殊考量。 如果您要在同一個模型檔案中上傳超過 50 個模型，請遵循下列提示:

• 如有任何模型繼承自同一個檔案中定義的其他模型，請將這些模型放在清單結尾附近。
• 如有任何模型參考了同一個檔案中定義的其他模型作為元件，請將這些模型放在清單結尾附近。
• 確認無論模型是否參考同一個檔案中定義的其他模型 (透過繼承或作為元件)，包含參考的模型都會在所參考的模型定義之後出現在清單中。

這有助於確保上傳過程中正確解析模型相依性。

刪除模型

您可以使用 [模型] 面板來刪除個別模型，或一次刪除執行個體中的所有模型。

若要刪除單一模型，請在清單中尋找該模型，然後選取模型名稱旁邊的功能表點。 然後，選取 [刪除模型]。

若要一次刪除執行個體中的所有模型，請選擇 [模型] 面板頂端的 [刪除所有模型] 圖示。

重新整理模型

當您開啟 Azure Digital Twins Explorer 時，[模型] 面板應該會自動顯示可以在您環境中使用的所有模型。

不過，您可以隨時手動重新整理面板，以重新載入 Azure Digital Twins 執行個體中所有模型的清單。 若要這樣做，請選取 [重新整理模型] 圖示。

匯入/匯出圖表

從 [對應項圖表] 面板中，您可以選擇匯入和匯出圖表功能。

匯入圖表

您可以使用匯入功能，將對應項、關聯性和模型新增至執行個體。 這項功能可以用於一次建立許多對應項、關聯性和/或模型。

注意

如果您的圖表匯入檔案包含模型，則須遵守大量模型上傳限制。

建立匯入檔案

匯入圖表的第一個步驟是建立可代表您要新增的對應項和關聯性的檔案。

匯入檔案可以是下列兩種格式的其中一種：

• 在圖形匯出上產生的「JSON 格式」。 此格式可以包含對應項、關聯性和/或模型。
• 本節其餘部分所述的「自訂 Excel 格式」。 此格式可讓您上傳對應項和關聯性。

在 Excel 中建立匯入檔案

若要在 Excel 中建立自訂圖表，以將對應項和關聯性上傳至 Azure Digital Twins Explorer，請使用下列格式。

每個資料列都代表要建立的元素：對應項、關聯性，或對應項和對應關聯性的組合。 使用下列資料行來建構對應項或關聯性資料。 您可以自訂資料行名稱，但這些名稱應該保持此順序。

ModelID	識別碼	關聯性 (來源)	關聯名稱	初始資料
(選擇性) 模型的 DTMI 識別碼，用於表示新的對應項。 此模型定義應該已存在於執行個體中。 如果想要讓資料列只建立關聯性 (沒有對應項)，您可以針對該資料列將此資料行保留空白。	(必要項) 對應項的唯一識別碼。 如果要在此資料列中建立新的對應項，此值將會是新對應項的識別碼。 如果資料列中有關聯性資訊，則此識別碼會用作關聯性的目標。	(選擇性) 對應項的識別碼，而此對應項應該是新關聯性的來源對應項。 如果想要讓資料列只建立對應項 (沒有關聯性)，您可以針對該資料列將此資料行保留空白。	(選擇性) 要建立的新關聯性名稱。 關聯性方向將是從資料行 C 中的對應項到資料行 B 中的對應項。	(選擇性) JSON 字串，其中包含所要建立對應項的屬性設定。 這些屬性必須符合模型 (來自資料行 A) 中定義的屬性。

以下是範例 .xlsx 檔案，其中建立兩個樓層和兩個房間的小型圖表。

您可以在 GitHub 的 Azure Digital Twins Explorer 存放庫中檢視此檔案和其他 .xlsx 圖形範例。

注意

.xlsx 中所述的屬性和關聯性必須符合相關對應項的模型定義中所定義的內容。

將檔案匯入至 Azure Digital Twins Explorer

一旦您的電腦上有了準備好匯入的檔案，請在 [對應項圖表] 面板中選取 [匯入圖表] 圖示。

在出現的檔案選取器方塊中，於您的機器上瀏覽至您要上傳的圖表檔案 (.xlsx 或 .json)，然後選擇 [開啟] 以上傳這些圖表檔案。

Azure Digital Twins 會開啟 [匯入] 面板，其中會顯示要匯入的圖表預覽。 若要確認，請選取面板右上角的 [儲存] 圖示。

如果匯入成功，強制回應視窗會顯示已上傳的模型、對應項和關聯性數目。

匯出圖表和模型

您可以使用匯出功能來匯出部分或完整的圖表，包括模型、對應項和關聯性。 匯出會將來自最新查詢結果的對應項和關聯性，以及執行個體中的所有模型序列化為 JSON 格式，您可以將其下載到您的機器。

若要開始，請使用 [查詢總管] 面板來執行查詢，其會選取您想要下載的對應項和關聯性。 這樣做會在 [對應項圖表] 面板中填入它們。

提示

顯示所有對應項和關聯性的查詢為 SELECT * FROM digitaltwins。

一旦 [對應項圖表] 面板顯示了您想要下載的圖表部分，請選取 [匯出圖表] 圖示。

此動作會在 [對應項圖表] 方塊中啟用 [下載] 連結。 選取該項目即可將查詢結果的 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 環境連結，請在 [查詢總管] 中輸入您要擷取的查詢，然後選取 [分享] 按鈕以複製完整連結。

針對以上螢幕擷取畫面中的範例和查詢，[分享] 按鈕會產生下列連結: 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 執行個體的租用戶識別碼和主機名稱，以及格式化的查詢文字。

您可以分享此 URL，允許某人存取您的執行個體和此查詢。 當他們透過連結開啟 Azure Digital Twins Explorer 時，查詢的結果會自動填入 [對應項圖表] 面板中。

產生不含特定查詢的環境連結

若要分享未附加特定查詢的 Azure Digital Twins Explorer 環境連結，請先使用 [分享] 按鈕來複製您執行個體的連結。

然後，手動從結果中移除查詢參數。

例如，以上螢幕擷取畫面中的 [分享] 按鈕會產生下列連結: 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 的鍵盤快速鍵清單。

在右上方工具列的設定齒輪下，有數個可以存取的進階功能：

• 積極式載入：當查詢傳回的對應項與查詢結果中未包含的其他對應項具有關聯性時，這項功能會在轉譯圖表之前載入「遺漏」對應項。
• 快取：啟用此功能時，Azure Digital Twins Explorer 會將關聯性和模型的本機快取保留在記憶體中，以改善查詢效能。 在相關元素上進行任何寫入作業時，以及瀏覽器重新整理時，即會清除這些快取。 這項功能預設為關閉。
• 主控台：此功能會啟用主控台視窗的顯示，讓您能夠使用簡單的殼層函式來處理圖表。
• 輸出：此功能會啟用輸出視窗的顯示，其中顯示作業的診斷追蹤。
• 高對比：此功能會變更 Azure Digital Twins Explorer 的顏色，讓其能以更大的對比顯示。

您可以編輯組成 Azure Digital Twins Explorer 的面板位置 (查詢總管、對應項、模型、對應項圖表、模型圖表) 來自訂面板配置。 若要將面板移至不同的位置，請按住面板名稱，然後將其拖曳至新的所需位置。

重新整理瀏覽器視窗時，將會重設面板位置。

下一步

了解如何撰寫 Azure Digital Twins 對應項圖表的查詢：

• 查詢語言
• 查詢對應項圖表