使用 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 Digital Twins URL 強制回應，您可以在前置詞之後 https:// 輸入另一個 Azure Digital Twins 實例的主機名，以連線到該實例。

注意

目前，無法針對個人 Microsoft 帳戶 （MSA） 切換應用程式內的內容。 MSA 使用者必須從 Azure 入口網站 中所選實例存取總管，或可能透過直接連結連線到特定實例。

查詢數位對應項圖表

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

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

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

注意

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

重疊查詢結果

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

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

儲存並重新執行查詢

查詢可以儲存在瀏覽器中的本機記憶體中，使其易於選取並重新執行。

注意

本機瀏覽器記憶體表示，除了儲存查詢的位置以外，其他瀏覽器將無法使用已儲存的查詢，而且它們會無限期地保留在瀏覽器記憶體中，直到清除本機記憶體為止。

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

儲存查詢之後，即可從 [ 已儲存的查詢 ] 下拉功能表中選取 ，以輕鬆再次執行查詢。

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

提示

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

探索對應項圖形

[ 對應項圖形 ] 面板可讓您探索 實例中的對應項和關聯性。

您可以使用此面板來 探索對應項數據。

[對應項圖形] 面板也提供數個功能來自定義圖形檢視體驗：

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

探索對應項數據

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

提示

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

檢視對應項和關聯性屬性

若要檢視對應項或關聯性的屬性值，請選取 Twin Graph 中的對應項或關聯性，並使用 [切換屬性檢查] 按鈕分別展開 [對應項屬性] 或 [關聯性屬性] 面板。 此面板會顯示與專案相關聯的所有屬性，以及其值。 它也包含尚未設定之屬性的預設值。

數據類型圖示

[對應項屬性] 和 [關聯性屬性] 面板中顯示的屬性會以圖示顯示，指出 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. 在 [ 屬性] 欄位中，選取您想要檢視其歷程記錄數據的屬性。 如果屬性不是數值，但它是由數值所組成，請使用 Cast 屬性值 to number 選項，嘗試將此數據轉換成數位，以便在圖表上可視化。

   

   注意

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

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

這會載入所選屬性之歷史化值的圖表檢視。 您可以使用圖表上方的索引標籤，在圖表檢視和數據表檢視之間切換。

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

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

在圖表中檢視歷程記錄

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

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

• 變更圖表中包含的數據時間範圍。
• 選取多個時間序列是獨立顯示還是顯示在共用的 Y 軸上。 針對座標軸選取 [獨立 ] 表示每個時間序列都會縮放至圖表，並維護自己的座標軸以進行縮放。 選取 [共享 軸] 表示所有時間序列數據都會調整為相同的座標軸。
• 選擇圖表的匯總邏輯。 當屬性的數據點數目比圖表上顯示的數據點多時，數據會使用平均、最小值或最大函式，匯總成有限數目的數據點。

您也可以在 Azure 資料總管中開啟查詢的按鈕，您可以在其中檢視和修改目前的查詢，以進一步探索時間序列數據。

在數據表中檢視歷程記錄

歷史化屬性的 [ 數據表 ] 檢視會顯示資料表中的屬性值及其時間戳。

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

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

檢視對應項的關聯性

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

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

變更對應項顯示屬性

您可以設定您想要顯示的屬性，以識別對應項圖形中的對應項。 默認值是 $dtId 值，但您可以從模型集內的任何屬性中選擇（即使是每個對應項上不存在的屬性也一樣）。

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

如果您選擇不在每一個對應項上的屬性，則圖形中沒有該屬性的任何對應項都會顯示星號 \ ，後面接著其 $dtId 值。

編輯對應項圖形配置

您可以按下對應項，並將其拖曳到對應項圖形畫面，以重新排列成不同的組態。

您也可以從 [選擇設定] 選單中的選項，將數種配置演算法之一套用至圖形。

控制對應項圖表展開

在 [對應項圖形] 面板中檢視查詢結果時，您可以按兩下對應項，讓圖形擷取其關聯性和相關的對應項，並在檢視中還不存在時顯示它們。 您可以藉由設定大小和方向來自定義此擴充，以判斷要擷取的對應項數目。

若要設定要展開的圖層數目，請使用 [展開層級 ] 選項。 這個數位表示要從選取的對應項擷取多少層關聯性。

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

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

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

若要隱藏對應項或關聯性，請在 [對應項圖形] 視窗中以滑鼠右鍵按兩下它。 這麼做將會顯示功能表，其中包含隱藏專案或其他相關元素的選項。

您也可以使用 CTRL/CMD 或 SHIFT 鍵一次隱藏多個對應項或關聯性，以多重選取圖表中相同類型的數個專案。 從這裡，遵循相同的按兩下滑鼠右鍵程式以查看隱藏選項。

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

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

您可以選擇此篩選圖示，依文字篩選圖形中顯示的對應項目和關聯性：

您也可以選擇此 醒目提示 圖示，以文字顯示圖形中的對應項目和關聯性：

管理對應項和圖形

Azure Digital Twins Explorer 提供數種方式來管理 實例中的對應項 和 關聯 性。

本節說明如何執行下列管理活動：

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

如需對應項和關聯性檢視體驗的相關信息，請參閱 探索對應項和對應項圖形。

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

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

建立對應項

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

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

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

建立關聯

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

同時選取兩個對應項之後，以滑鼠右鍵按下目標對應項，以顯示具有 [新增關聯性] 選項的功能表。

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

編輯對應項和關聯性屬性

若要檢視對應項或關聯性的屬性值，請選取 Twin Graph 中的專案，並使用 [切換屬性檢查] 按鈕分別展開 [對應項屬性] 或 [關聯性屬性] 面板。

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

提示

[對應項屬性] 和 [關聯性屬性] 面板中顯示的屬性會以圖示顯示，指出 DTDL 模型中的字段類型。 如需類型圖示的詳細資訊，請參閱 數據類型圖示。

刪除對應項及關聯性

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

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

您也可以使用 頂端工具列中的 [刪除所有對應 項] 按鈕，選擇同時刪除實例中的所有對應項。

探索模型和模型圖表

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

[ 模型] 面板：

[ 模型圖形 ] 面板：

注意

目前，Azure Digital Twins Explorer 完全支援 DTDL v2 模型，並支援 DTDL v3 模型的有限功能。 在 Azure Digital Twins Explorer 中，DTDL v3 模型可以在 [模型] 面板中檢視，並使用 DTDL v3 模型建立的對應項可以檢視和編輯（包括具有數位屬性的模型）。 不過，DTDL v3 模型不會顯示在 [模型圖形] 面板中，而且 無法使用 Azure Digital Twins Explorer 匯入 它們。 若要將 DTDL v3 模型匯入您的實例，請使用另一個開發人員介面，例如 API 和 SDK 或 Azure CLI。

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

[模型圖形] 面板也提供數個自定義圖表檢視體驗的功能：

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

檢視模型

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

您可以使用 [ 模型圖形 ] 面板來檢視實例中模型的圖形表示法，以及彼此連線的關聯性、繼承和元件。

注意

目前，Azure Digital Twins Explorer 完全支援 DTDL v2 模型，並支援 DTDL v3 模型的有限功能。 在 Azure Digital Twins Explorer 中，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 模型的有限功能。 在 Azure Digital Twins Explorer 中，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	識別碼	關聯性 （來源）	關聯名稱	Init 數據
(選擇性) 要用於新對應項之模型的 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& 以產生網址 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 對應項圖形的查詢：

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