Udostępnij za pośrednictwem


Korzystanie z usługi Azure Digital Twins Explorer (wersja zapoznawcza)

Azure Digital Twins Explorer (wersja zapoznawcza) to narzędzie do wizualizacji i pracy z usługą Azure Digital Twins. W tym artykule opisano funkcje eksploratora usługi Azure Digital Twins oraz sposób ich używania do zarządzania danymi w wystąpieniu usługi Azure Digital Twins. Możesz korzystać z Eksploratora usługi Azure Digital Twins za pomocą kliknięć lub skrótów klawiaturowych.

Jak uzyskać dostęp

Głównym sposobem uzyskiwania dostępu do eksploratora usługi Azure Digital Twins jest witryna Azure Portal.

Aby otworzyć eksploratora usługi Azure Digital Twins dla wystąpienia usługi Azure Digital Twins, najpierw przejdź do wystąpienia w portalu, wyszukując jego nazwę na pasku wyszukiwania portalu.

Następnie wybierz przycisk Open Azure Digital Twins Explorer (wersja zapoznawcza).

Zrzut ekranu witryny Azure Portal przedstawiający stronę Przegląd wystąpienia usługi Azure Digital Twins. Istnieje wyróżnienie przycisku Open Azure Digital Twins Explorer (wersja zapoznawcza).

Spowoduje to otwarcie Eksploratora usługi Azure Digital Twins na nowej karcie. Jeśli używasz Eksploratora po raz pierwszy, zobaczysz modalne podsumowanie jego kluczowych funkcji.

Narzędzie Azure Digital Twins Explorer może automatycznie łączyć się z wystąpieniem. Jeśli nie, zostanie wyświetlony następujący ekran z prośbą o określenie adresu URL usługi Azure Digital Twins. (Jeśli to pole nie jest widoczne na ekranie, narzędzie Azure Digital Twins Explorer zostało już ukończone automatycznie).

Zrzut ekranu przedstawiający eksploratora usługi Azure Digital Twins. Modalny adres URL usługi Azure Digital Twins zawiera puste pole edytowalne dla adresu URL usługi Azure Digital Twins.

Jeśli zobaczysz to pole, wprowadź https:// w polu, a następnie nazwę hosta wystąpienia (można go znaleźć ponownie na stronie Przegląd wystąpienia w portalu). Te wartości razem tworzą adres URL wystąpienia. Wybierz pozycję Zapisz , aby nawiązać połączenie z wystąpieniem.

Ważne

Eksplorator usługi Azure Digital Twins nie obsługuje prywatnych punktów końcowych. Jeśli chcesz użyć narzędzia Azure Digital Twins Explorer z wystąpieniem usługi Azure Digital Twins, które używa usługi Private Link do wyłączenia dostępu publicznego, możesz wdrożyć bazę kodu usługi Azure Digital Twins Explorer prywatnie w chmurze. Aby uzyskać instrukcje dotyczące tego, jak to zrobić, zobacz Azure Digital Twins Explorer: Running in the cloud (Eksplorator usługi Azure Digital Twins: uruchamianie w chmurze).

Przełączanie kontekstów w aplikacji

Po przejściu do aplikacji możesz również zmienić wystąpienie, które jest obecnie połączone z eksploratorem, wybierając nazwę wystąpienia z górnego paska narzędzi.

Zrzut ekranu przedstawiający eksploratora usługi Azure Digital Twins. Nazwa wystąpienia na górnym pasku narzędzi jest wyróżniona.

Spowoduje to wyświetlenie modalnego adresu URL usługi Azure Digital Twins, w którym można wprowadzić nazwę hosta innego wystąpienia usługi Azure Digital Twins po prefiksie https:// , aby nawiązać połączenie z tym wystąpieniem.

Zrzut ekranu przedstawiający eksploratora usługi Azure Digital Twins. Modalny adres URL usługi Azure Digital Twins zawiera pole edytowalne zawierające https:// i nazwę hosta.

Uwaga

Obecnie możliwość przełączania kontekstów w aplikacji nie jest dostępna dla osobistych kont Microsoft (MSA). Użytkownicy msA będą musieli uzyskać dostęp do eksploratora z wybranego wystąpienia w witrynie Azure Portal lub połączyć się z określonym wystąpieniem za pośrednictwem bezpośredniego linku do środowiska.

Wykonywanie zapytań względem grafu cyfrowej reprezentacji bliźniaczej

Do uruchamiania zapytań na grafie można użyć panelu Eksploratora zapytań.

Zrzut ekranu przedstawiający eksploratora usługi Azure Digital Twins. Panel Eksploratora zapytań jest wyróżniony.

Wprowadź zapytanie, które chcesz uruchomić. Jeśli chcesz wprowadzić zapytanie w wielu wierszach, możesz użyć SHIFT + ENTER, aby dodać nowy wiersz do pola zapytania.

Wybierz przycisk Uruchom zapytanie, aby wyświetlić wyniki zapytania w panelu Twin Graph.

Uwaga

Wyniki zapytania zawierające relacje można renderować tylko w panelu Twin Graph , jeśli wyniki zawierają również co najmniej jedną reprezentację bliźniaczą. Zapytania zwracające tylko relacje są możliwe w usłudze Azure Digital Twins, ale można je wyświetlać tylko w Eksploratorze usługi Azure Digital Twins za pomocą panelu Dane wyjściowe.

Wyniki zapytania nakładki

Przed uruchomieniem zapytania możesz zaznaczyć pole Wyniki nakładki, jeśli chcesz, aby wyniki były wyróżnione na podstawie aktualnie wyświetlanych wyników w panelu Twin Graph , zamiast całkowicie zastępować zawartość panelu nowymi wynikami zapytania.

Zrzut ekranu przedstawiający panel Eksplorator zapytań eksploratora zapytań usługi Azure Digital Twins. Pole Wyniki nakładki jest zaznaczone, a dwie reprezentacje bliźniacze są wyróżnione na większym grafie, który jest wyświetlany w panelu Twin Graph.

Jeśli wynik zapytania zawiera coś, co nie jest obecnie wyświetlane w panelu Twin Graph , element zostanie dodany do istniejącego widoku.

Zapisywanie i ponowne uruchamianie zapytań

Zapytania można zapisywać w magazynie lokalnym w przeglądarce, co ułatwia ich wybieranie i ponowne uruchamianie.

Uwaga

Magazyn w przeglądarce lokalnej oznacza, że zapisane zapytania nie będą dostępne w innych przeglądarkach poza tym, w którym zostały zapisane, i pozostaną w magazynie przeglądarki przez czas nieokreślony do czasu wyczyszczenia magazynu lokalnego.

Aby zapisać zapytanie, wprowadź je w polu zapytania i wybierz ikonę Zapisz po prawej stronie panelu. Wprowadź nazwę zapisanego zapytania po wyświetleniu monitu.

Zrzut ekranu przedstawiający panel Eksplorator zapytań eksploratora zapytań usługi Azure Digital Twins. Ikona Zapisz jest wyróżniona.

Po zapisaniu zapytania jest ono dostępne do wybrania z menu rozwijanego Zapisane zapytania , aby łatwo je uruchomić ponownie.

Zrzut ekranu przedstawiający panel Eksplorator zapytań eksploratora zapytań usługi Azure Digital Twins. Menu rozwijane Zapisane zapytania jest wyróżnione i pokazuje dwa przykładowe zapytania.

Aby usunąć zapisane zapytanie, wybierz ikonę X obok nazwy zapytania po otwarciu menu rozwijanego Zapisane zapytania .

Napiwek

W przypadku dużych grafów zaleca się wykonywanie zapytań tylko w ograniczonym podzestawie, a następnie załadowanie pozostałej części grafu zgodnie z potrzebami. Aby pobrać dodatkowe powiązane węzły, możesz kliknąć dwukrotnie reprezentację bliźniaczą reprezentację bliźniaczą.

Eksplorowanie grafu bliźniaczej reprezentacji

Panel Twin Graph umożliwia eksplorowanie bliźniaczych reprezentacji bliźniaczych i relacji w twoim wystąpieniu.

Zrzut ekranu przedstawiający eksploratora usługi Azure Digital Twins. Panel Twin Graph został wyróżniony.

Ten panel umożliwia eksplorowanie danych bliźniaczych reprezentacji.

Panel Twin Graph udostępnia również kilka możliwości dostosowywania środowiska wyświetlania grafu:

Eksplorowanie danych bliźniaczych reprezentacji

Uruchom zapytanie przy użyciu Eksploratora zapytań, aby wyświetlić reprezentacje bliźniacze i relacje w wynikach zapytania wyświetlanych w panelu Twin Graph .

Napiwek

Zapytanie do wyświetlania wszystkich reprezentacji bliźniaczych i relacji to SELECT * FROM digitaltwins.

Wyświetlanie właściwości bliźniaczej reprezentacji i relacji

Aby wyświetlić wartości właściwości bliźniaczej reprezentacji bliźniaczej lub relacji, wybierz bliźniacze lub relację w grafie bliźniaczej reprezentacji i użyj przycisku Przełącz inspektora właściwości, aby rozwinąć odpowiednio panel Właściwości bliźniaczej reprezentacji lub Właściwości relacji. Ten panel wyświetli wszystkie właściwości skojarzone z elementem wraz z ich wartościami. Zawiera również wartości domyślne właściwości, które jeszcze nie zostały ustawione.

Zrzut ekranu przedstawiający panel usługi Azure Digital Twins Explorer Twin Graph. Wybrano bliźniacze reprezentację FactoryA, a panel Właściwości bliźniaczej reprezentacji jest rozwinięty, pokazując właściwości bliźniaczej reprezentacji bliźniaczej.

Ikony typów danych

Właściwości wyświetlane w panelach Właściwości reprezentacji bliźniaczej i Właściwości relacji są wyświetlane z ikoną wskazującą typ pola z modelu DTDL. Możesz umieścić wskaźnik myszy na ikonie, aby wyświetlić skojarzony typ.

W poniższej tabeli przedstawiono możliwe typy danych i odpowiadające im ikony. Tabela zawiera również linki z każdego typu danych do opisu schematu w opisie języka DTDL w wersji 3.

Ikona Typ danych
Ikona wartości logicznej boolean
ikona składnika składnik
ikona daty data
ikona dateTime data/godzina
ikona czasu trwania czas trwania
Ikona wyliczenia enum
ikona mapy mapa
ikona liczbowa Typy liczbowe, w tym podwójne, zmiennoprzecinkowe, całkowite i długie
ikona obiektu object
ikona ciągu string
ikona godziny Godzina
Błędy

Panel Właściwości bliźniaczej reprezentacji wyświetli komunikaty o błędach, jeśli bliźniacze lub niektóre jej właściwości nie są już zgodne z modelem.

Istnieją dwa możliwe scenariusze błędów, z których każdy daje własny komunikat o błędzie:

  • Brakuje jednego lub wielu modeli używanych przez bliźniacze reprezentacje. W związku z tym wszystkie właściwości skojarzone z tym modelem zostaną oznaczone jako "brakujące" w panelu Właściwości bliźniaczej reprezentacji. Ten błąd może wystąpić, jeśli model został usunięty od czasu utworzenia bliźniaczej reprezentacji.
  • Niektóre właściwości bliźniaczej reprezentacji bliźniaczej nie są częścią modelu bliźniaczej reprezentacji. Tylko te właściwości zostaną oznaczone jako "brakujące" w panelu Właściwości bliźniaczej reprezentacji. Ten błąd może wystąpić, jeśli model bliźniaczej reprezentacji bliźniaczej został zastąpiony lub zmieniony od czasu ustawienia właściwości, a właściwości nie istnieją już w najnowszej wersji modelu.

Oba te komunikaty o błędach są wyświetlane na poniższym zrzucie ekranu:

Zrzut ekranu przedstawiający panel Właściwości bliźniaczej reprezentacji eksploratora usługi Azure Digital Twins z dwoma komunikatami o błędach. Jeden błąd wskazuje, że brakuje modeli, a drugi wskazuje, że brakuje właściwości modelu.

Weryfikowanie i eksplorowanie właściwości historized

Jeśli twoje wystąpienie usługi Azure Digital Twins ma włączoną historię danych, możesz zweryfikować i eksplorować dane z historized w usłudze Azure Digital Twins Explorer. Wykonaj poniższe kroki, aby zwizualizować dane historizowane na wykresie lub wyświetlić nieprzetworzone wartości w tabeli.

  1. W przeglądarce Twin Graph wybierz bliźniętą reprezentację, której właściwości historizowane chcesz wyświetlić, aby otworzyć je w panelu Właściwości bliźniaczej reprezentacji. W prawym górnym rogu panelu wybierz ikonę Szereg czasowy, aby otworzyć eksploratora historii danych.

    Zrzut ekranu przedstawiający panel Właściwości bliźniaczej reprezentacji usługi Azure Digital Twins Explorer z wyróżnioną ikoną otwierania eksploratora historii danych.

  2. Wybierz nazwę bliźniaczej reprezentacji po lewej stronie, aby wyświetlić opcje wybierania właściwości historycznych reprezentacji bliźniaczej. Pole Identyfikator bliźniaczej reprezentacji zostanie wstępnie wypełnione zaznaczeniem bliźniaczej reprezentacji. Obok tego pola możesz wybrać ikonę Inspekcja właściwości , aby wyświetlić dane bliźniaczej reprezentacji lub ikonę zaawansowanego wyszukiwania reprezentacji bliźniaczej, aby znaleźć inne reprezentacje bliźniacze, wykonując zapytanie o wartości właściwości.

    Zrzut ekranu przedstawiający Eksploratora historii danych i modalny monit o szczegóły bliźniaczej reprezentacji i właściwości.

  3. W polu Właściwość wybierz właściwość, której historięzowane dane chcesz wyświetlić. Jeśli właściwość nie jest liczbowa, ale składa się z wartości liczbowych, użyj wartości właściwości Rzutuj , aby podjąć próbę rzutowania tych danych na liczby, aby można je było wizualizować na wykresie.

    Zrzut ekranu przedstawiający Eksploratora historii danych z wyróżnionymi szczegółami właściwości.

    Uwaga

    Jeśli nie możesz wybrać właściwości z listy rozwijanej, ponieważ lista nie odpowiada, może to oznaczać błąd w niektórych modelach w wystąpieniu. Na przykład posiadanie wartości wyliczenia innych niż unikatowe w atrybutach modelu spowoduje przerwanie tej funkcji. Jeśli tak się stanie, przejrzyj definicje modelu i upewnij się, że wszystkie właściwości są prawidłowe.

  4. Wybierz etykietę dla szeregu czasowego i wybierz pozycję Aktualizuj.

Spowoduje to załadowanie widoku wykresu wartości historizowanych dla wybranej właściwości. Za pomocą kart nad wykresem można przełączać się między widokiem wykresu a widokiem tabeli.

Aby dodać więcej właściwości do wizualizacji, użyj przycisku Dodaj szereg czasowy po lewej stronie.

Zrzut ekranu przedstawiający eksploratora historii danych z wyróżnioną opcją dodawania kolejnej serii czasowej.

Aby zamknąć eksploratora historii danych i wrócić do głównego Eksploratora usługi Azure Digital Twins, wybierz pozycję Zamknij.

Wyświetlanie historii na wykresie

Widok Wykres właściwości z historized pokazuje wartości właściwości jako punkty na wykresie liniowym w czasie.

Zrzut ekranu przedstawiający eksploratora historii danych przedstawiający wykres wartości historizowanych dla właściwości.

Możesz użyć ikon nad wykresem, aby kontrolować ustawienia wykresu, w tym...

  • zmiana zakresu czasu dla danych uwzględnionych na wykresie.
  • wybranie, czy wiele szeregów czasowych jest wyświetlanych niezależnie, czy na udostępnionej osi y. Wybranie pozycji Niezależne dla osi oznacza, że każda seria czasowa będzie skalowana do wykresu i utrzymuje własną oś na potrzeby skalowania. Wybranie współużytkowanych osi oznacza, że wszystkie dane szeregów czasowych będą skalowane na tę samą oś.
  • wybieranie logiki agregacji dla wykresu. Jeśli właściwość ma więcej punktów danych niż można wyświetlić na wykresie, dane zostaną zagregowane w skończonej liczbie punktów danych przy użyciu funkcji średniej, minimalnej lub maksymalnej.

Istnieje również przycisk Otwórz zapytanie w usłudze Azure Data Explorer, w którym można wyświetlić i zmodyfikować bieżące zapytanie, aby dokładniej eksplorować dane szeregów czasowych.

Zrzut ekranu przedstawiający przycisk umożliwiający otwarcie zapytania w usłudze Azure Data Explorer.

Wyświetlanie historii w tabeli

Widok Tabela właściwości historizowanych przedstawia wartości właściwości i ich znaczniki czasu w tabeli.

Zrzut ekranu przedstawiający eksploratora historii danych z tabelą wartości historizowanych dla właściwości.

Możesz użyć ikon powyżej tabeli, aby kontrolować ustawienia tabeli, w tym...

  • zmiana zakresu czasu danych zawartych w tabeli.
  • pobieranie danych tabeli na potrzeby niezależnej analizy.

Wyświetlanie relacji bliźniaczej reprezentacji

Możesz również szybko wyświetlić kod wszystkich relacji, które obejmują określoną reprezentację bliźniaczą (w tym relacje przychodzące i wychodzące).

Kliknij prawym przyciskiem myszy reprezentację bliźniaczą na wykresie, a następnie wybierz pozycję Pobierz relacje. Spowoduje to wyświetlenie modalnego elementu Informacje o relacji z reprezentacją JSON wszystkich relacji przychodzących i wychodzących.

Zrzut ekranu przedstawiający panel usługi Azure Digital Twins Explorer Twin Graph. Na środku ekranu jest wyświetlana modalna informacja o relacji z relacjami przychodzącymi i wychodzącymi.

Zmienianie właściwości wyświetlania bliźniaczej reprezentacji

Możesz skonfigurować właściwość, którą chcesz wyświetlić, aby zidentyfikować bliźniacze reprezentacje na grafie bliźniaczej reprezentacji. Wartość domyślna $dtId to wartość, ale można wybrać spośród dowolnych właściwości istniejących w zestawie modelu (nawet tych, które nie są obecne w każdej reprezentacji bliźniaczej).

Aby zmienić właściwość wyświetlania, użyj menu rozwijanego Wybierz właściwość wyświetlaną reprezentacji bliźniaczej. Menu rozwijane jest uporządkowane według liczby modeli, które zawierają właściwość .

Zrzut ekranu przedstawiający panel usługi Azure Digital Twins Explorer Twin Graph. Przycisk Wybierz właściwość nazwy wyświetlanej reprezentacji bliźniaczej jest wyróżniony, pokazując menu z listą różnych właściwości bliźniaczych reprezentacji bliźniaczych na grafie.

Jeśli wybierzesz właściwość, która nie jest obecna w każdej reprezentacji bliźniaczej, wszystkie reprezentacje bliźniacze na grafie, które nie mają tej właściwości, będą wyświetlane gwiazdką (*) i ich $dtId wartością.

Edytowanie układu grafu reprezentacji bliźniaczej

Bliźniacze reprezentacje można zmienić w różne konfiguracje, klikając i przeciągając je wokół ekranu twin Graph.

Możesz również zastosować jeden z kilku algorytmów układu do grafu z opcji w menu Wybierz układ .

Zrzut ekranu przedstawiający panel usługi Azure Digital Twins Explorer Twin Graph. Przycisk Wybierz układ został wyróżniony z menu z opcjami układu Cola, Dagre, fCoSE i Klay.

Rozszerzanie wykresu bliźniaczej reprezentacji bliźniaczej

Podczas wyświetlania wyniku zapytania w panelu Twin Graph możesz kliknąć dwukrotnie reprezentację bliźniaczą, aby wykres pobierał relacje i powiązane reprezentacje bliźniacze i wyświetlał je, jeśli nie są jeszcze obecne w widoku. Możesz dostosować tę ekspansję, ustawiając rozmiar i kierunek, aby określić liczbę bliźniaczych reprezentacji do pobrania.

Aby ustawić liczbę warstw do rozwinięcia, użyj opcji Poziom rozszerzenia. Ta liczba wskazuje, ile warstw relacji ma być pobieranych z wybranej reprezentacji bliźniaczej.

Zrzut ekranu przedstawiający panel usługi Azure Digital Twins Explorer Twin Graph. Przycisk Poziom rozszerzenia został wyróżniony.

Aby wskazać, które typy relacji mają być obserwowane podczas rozszerzania, użyj przycisku Kierunek rozszerzania. Dzięki temu można wybierać relacje przychodzące, wychodzące lub przychodzące i wychodzące.

Zrzut ekranu przedstawiający panel usługi Azure Digital Twins Explorer Twin Graph. Przycisk Kierunek rozszerzenia został wyróżniony, pokazując menu z opcjami W, Wyjaś i W/Wy.

Pokaż i ukryj elementy grafu reprezentacji bliźniaczej

Możesz przełączyć opcję ukrywania bliźniaczych reprezentacji lub relacji z widoku grafu.

Aby ukryć bliźniętą lub relację, kliknij ją prawym przyciskiem myszy w oknie Twin Graph . Spowoduje to wyświetlenie menu z opcjami ukrywania elementu lub innych powiązanych elementów.

Zrzut ekranu przedstawiający panel usługi Azure Digital Twins Explorer Twin Graph. Wybrano bliźniacze reprezentację FactoryA i jest dostępne menu z opcjami Ukryj zaznaczone, Ukryj zaznaczone + Dzieci, Ukryj wszystkie inne i Ukryj inne elementy podrzędne.

Można również ukryć wiele reprezentacji bliźniaczych lub relacji jednocześnie, używając CTRL/CMD lub SHIFT, aby wybrać wiele elementów tego samego typu na grafie. W tym miejscu wykonaj ten sam proces kliknięcia prawym przyciskiem myszy, aby wyświetlić opcje ukrywania.

Aby powrócić do wyświetlania wszystkich bliźniaczych reprezentacji po ukryciu niektórych, użyj przycisku Pokaż wszystko . Aby powrócić do wyświetlania wszystkich relacji, użyj przycisku Pokaż wszystkie relacje .

Zrzut ekranu przedstawiający panel usługi Azure Digital Twins Explorer Twin Graph. Przyciski Pokaż wszystko i Pokaż wszystkie relacje są wyróżnione.

Filtrowanie i wyróżnianie elementów grafu reprezentacji bliźniaczej

Bliźniacze i relacje wyświetlane na grafie można filtrować według tekstu, wybierając tę ikonę Filtr :

Zrzut ekranu przedstawiający panel usługi Azure Digital Twins Explorer Twin Graph. Wybrano ikonę filtru tekstu z kartą Filtr, na której można wprowadzić termin wyszukiwania.

Możesz również wyróżnić bliźniacze i relacje wyświetlane na grafie według tekstu, wybierając tę ikonę wyróżnienia :

Zrzut ekranu przedstawiający panel usługi Azure Digital Twins Explorer Twin Graph. Wybrano ikonę filtru tekstu z kartą Wyróżnienie, na której można wprowadzić termin wyszukiwania.

Zarządzanie reprezentacjami bliźniaczymi i grafami

Narzędzie Azure Digital Twins Explorer udostępnia kilka sposobów zarządzania bliźniaczymi reprezentacjami i relacjami w twoim wystąpieniu.

W tej sekcji opisano sposób wykonywania następujących działań związanych z zarządzaniem:

Aby uzyskać informacje o środowisku wyświetlania reprezentacji bliźniaczych i relacji, zobacz Eksplorowanie reprezentacji bliźniaczych i wykresu bliźniaczych reprezentacji.

Wyświetlanie płaskiej listy bliźniaczych reprezentacji i relacji

Panel Twins zawiera płaską listę bliźniaczych reprezentacji i skojarzonych z nimi relacji. Możesz wyszukać bliźniacze reprezentacje według nazwy i rozwinąć je, aby uzyskać szczegółowe informacje o ich relacjach przychodzących i wychodzących.

Zrzut ekranu przedstawiający panel usługi Azure Digital Twins Explorer Twins. Reprezentacja bliźniacze jest wyróżniona, a jej relacje są wyświetlane.

Tworzenie reprezentacji bliźniaczych

Nową cyfrową reprezentację bliźniaczą można utworzyć na podstawie definicji modelu w panelu Modele .

Aby utworzyć bliźniacze reprezentacje bliźniacze na podstawie modelu, znajdź ten model na liście i wybierz kropki menu obok nazwy modelu. Następnie wybierz pozycję Utwórz reprezentację bliźniaczą. Zostanie wyświetlony monit o wprowadzenie nazwy nowej reprezentacji bliźniaczej, która musi być unikatowa. Następnie zapisz bliźniacze reprezentację, która doda ją do grafu.

Zrzut ekranu przedstawiający panel Modele usługi Azure Digital Twins Explorer. Kropki menu dla pojedynczego modelu są wyróżnione, a opcja menu Tworzenie bliźniaczej reprezentacji jest również wyróżniona.

Aby dodać wartości właściwości do bliźniaczej reprezentacji, zobacz Edytowanie właściwości bliźniaczej reprezentacji i relacji.

Utwórz relacje

Aby utworzyć relację między dwiema reprezentacjami bliźniaczymi, zacznij od wybrania źródłowej reprezentacji bliźniaczej dla relacji w oknie Twin Graph . Następnie przytrzymaj wciśnięty CTRL/CMD lub SHIFT podczas wybierania drugiej reprezentacji bliźniaczej jako elementu docelowego relacji.

Po wybraniu obu bliźniaczych reprezentacji jednocześnie kliknij prawym przyciskiem myszy docelową reprezentację bliźniaczą, aby wyświetlić menu z opcją Dodaj relacje między nimi.

Zrzut ekranu przedstawiający panel usługi Azure Digital Twins Explorer Twin Graph. Wybrano bliźniacze reprezentacje FactoryA i Consumer, a menu zawiera opcję Dodaj relacje.

Spowoduje to wyświetlenie okna dialogowego Tworzenie relacji wypełnionego źródłową reprezentacją bliźniaczą i docelową reprezentacją bliźniaczą relacji (możesz również użyć ikony Zamiana relacji , aby je przełączyć). Istnieje menu rozwijane Relacja, które zawiera typy relacji, które może mieć źródłowa reprezentacja bliźniacza zgodnie z modelem DTDL. Wybierz opcję typu relacji i zapisz nową relację.

Edytowanie właściwości bliźniaczej reprezentacji i relacji

Aby wyświetlić wartości właściwości bliźniaczej reprezentacji bliźniaczej lub relacji, wybierz element w grafie bliźniaczej reprezentacji i użyj przycisku Inspektor właściwości przełącznika, aby rozwinąć odpowiednio panel Właściwości bliźniaczej reprezentacji lub Właściwości relacji.

Zrzut ekranu przedstawiający panel usługi Azure Digital Twins Explorer Twin Graph. Wybrano bliźniacze reprezentację FactoryA, a panel Właściwości bliźniaczej reprezentacji jest rozwinięty, pokazując właściwości bliźniaczej reprezentacji bliźniaczej.

Za pomocą tego panelu można bezpośrednio edytować właściwości zapisywalne. Zaktualizuj swoje wartości w tekście i wybierz przycisk Zapisz zmiany w górnej części panelu, aby zapisać. Po zapisaniu aktualizacji na ekranie zostanie wyświetlone modalne okno z operacją JSON Patch zastosowaną przez interfejs API aktualizacji.

Zrzut ekranu przedstawiający panel usługi Azure Digital Twins Explorer Twin Graph. Na środku ekranu jest wyświetlany modalny kod poprawki JSON.

Napiwek

Właściwości wyświetlane w panelach Właściwości reprezentacji bliźniaczej i Właściwości relacji są wyświetlane z ikoną wskazującą typ pola z modelu DTDL. Aby uzyskać więcej informacji na temat ikon typów, zobacz Ikony typów danych.

Usuwanie bliźniaczych reprezentacji i relacji

Aby usunąć bliźniacze lub relację, kliknij ją prawym przyciskiem myszy w oknie Twin Graph . Spowoduje to wyświetlenie menu z opcją usunięcia elementu.

Zrzut ekranu przedstawiający panel usługi Azure Digital Twins Explorer Twin Graph. Wybrano bliźniacze reprezentacje FactoryA i znajduje się menu zawierające opcję Usuń bliźniacze reprezentacje.

Możesz usunąć wiele reprezentacji bliźniaczych lub wiele relacji jednocześnie, używając CTRL/CMD lub SHIFT, aby wybrać wiele elementów tego samego typu na grafie. W tym miejscu wykonaj ten sam proces kliknięcia prawym przyciskiem myszy, aby usunąć elementy.

Możesz również usunąć wszystkie reprezentacje bliźniacze w swoim wystąpieniu w tym samym czasie, używając przycisku Usuń wszystkie reprezentacje bliźniacze na górnym pasku narzędzi.

Zrzut ekranu przedstawiający eksploratora usługi Azure Digital Twins. Wybrano ikonę Usuń wszystkie reprezentacje bliźniacze.

Eksplorowanie modeli i grafu modelu

Modele można wyświetlać zarówno w panelu Modele po lewej stronie ekranu Eksploratora usługi Azure Digital Twins, jak i w panelu Model Graph na środku ekranu.

Panel Modele : Zrzut ekranu przedstawiający eksploratora usługi Azure Digital Twins. Panel Modele jest wyróżniony.

Panel Model Graph:Zrzut ekranu przedstawiający eksploratora usługi Azure Digital Twins. Panel Model Graph został wyróżniony.

Uwaga

Obecnie usługa Azure Digital Twins Explorer w pełni obsługuje modele DTDL w wersji 2 i obsługuje ograniczone funkcje modeli DTDL w wersji 3.

Modele DTDL w wersji 3 można wyświetlić na panelu Modele, a bliźniacze reprezentacje utworzone za pomocą modeli DTDL w wersji 3 można wyświetlać i edytować (w tym te z właściwościami tablicy). Jednak modele DTDL w wersji 3 nie będą wyświetlane w panelu Model Graph i nie można ich zaimportować przy użyciu eksploratora usługi Azure Digital Twins. Aby zaimportować modele DTDL w wersji 3 do wystąpienia, użyj innego interfejsu deweloperskiego, takiego jak interfejsy API i zestawy SDK lub interfejs wiersza polecenia platformy Azure.

Możesz użyć tych paneli do wyświetlania modeli.

Panel Model Graph oferuje również kilka możliwości dostosowywania środowiska wyświetlania grafu:

Wyświetlanie modeli

W swoim wystąpieniu można wyświetlić płaską listę modeli w panelu Modele . Ta lista jest wyszukiwana przy użyciu paska wyszukiwania w panelu.

Za pomocą panelu Model Graph można wyświetlić graficzną reprezentację modeli w twoim wystąpieniu wraz z relacjami, dziedziczeniem i składnikami, które łączą je ze sobą.

Uwaga

Obecnie usługa Azure Digital Twins Explorer w pełni obsługuje modele DTDL w wersji 2 i obsługuje ograniczone funkcje modeli DTDL w wersji 3.

Modele DTDL w wersji 3 można wyświetlić na panelu Modele, a bliźniacze reprezentacje utworzone za pomocą modeli DTDL w wersji 3 można wyświetlać i edytować (w tym te z właściwościami tablicy). Jednak modele DTDL w wersji 3 nie będą wyświetlane w panelu Model Graph i nie można ich zaimportować przy użyciu eksploratora usługi Azure Digital Twins. Aby zaimportować modele DTDL w wersji 3 do wystąpienia, użyj innego interfejsu deweloperskiego, takiego jak interfejsy API i zestawy SDK lub interfejs wiersza polecenia platformy Azure.

Wyświetlanie definicji modelu

Aby wyświetlić pełną definicję modelu, znajdź ten model w okienku Modele i wybierz kropki menu obok nazwy modelu. Następnie wybierz pozycję Wyświetl model. Spowoduje to wyświetlenie modalne informacje o modelu pokazujące nieprzetworzone definicje DTDL modelu.

Zrzut ekranu przedstawiający panel Modele usługi Azure Digital Twins Explorer. Kropki menu dla pojedynczego modelu są wyróżnione, a opcja menu Wyświetl model jest również wyróżniona.

Możesz również wyświetlić pełną definicję modelu, wybierając ją w grafie modelu i używając przycisku Przełącz szczegóły modelu, aby rozwinąć panel Szczegóły modelu. Ten panel wyświetli również pełny kod DTDL dla modelu.

Zrzut ekranu przedstawiający panel Azure Digital Twins Explorer Model Graph. Wybrano model Floor (Piętro), a panel Model DetailS (Szczegóły modelu) został rozwinięty, pokazując kod DTDL modelu.

Edytowanie układu grafu modelu

Modele można zmienić na różne konfiguracje, klikając i przeciągając je na ekranie Model Graph.

Możesz również zastosować jeden z kilku algorytmów układu do grafu modelu z opcji w menu Wybierz układ .

Zrzut ekranu przedstawiający panel Azure Digital Twins Explorer Model Graph. Przycisk Wybierz układ został wyróżniony z menu z opcjami układu Cola, Dagre, fCoSE, Klay i d3Force.

Filtrowanie i wyróżnianie elementów grafu modelu

Typy odwołań do modelu, które są wyświetlane na wykresie modelu, można filtrować. Wyłączenie jednego z typów odwołań za pośrednictwem przełączników w tym menu uniemożliwi wyświetlanie tego typu odwołania na grafie.

Zrzut ekranu przedstawiający panel Azure Digital Twins Explorer Model Graph. Menu filtru dla opcji Relacje, Dziedziczenie i Składniki są wyróżnione.

Możesz również filtrować modele i odwołania wyświetlane na wykresie według tekstu, wybierając tę ikonę Filtr :

Zrzut ekranu przedstawiający panel Azure Digital Twins Explorer Model Graph. Wybrano ikonę filtru tekstu z kartą Filtr, na której można wprowadzić termin wyszukiwania.

Możesz wyróżnić modele i odwołania wyświetlane na grafie według tekstu, wybierając tę ikonę wyróżnienia :

Zrzut ekranu przedstawiający panel Azure Digital Twins Explorer Model Graph. Wybrano ikonę filtru tekstu z kartą Wyróżnienie, na której można wprowadzić termin wyszukiwania.

Przekazywanie obrazów modelu

Obrazy niestandardowe można przekazać w celu reprezentowania różnych modeli w widokach wykresu modelu i wykresu bliźniaczego . Obrazy można przekazywać dla poszczególnych modeli lub dla kilku modeli jednocześnie.

Uwaga

Te obrazy są przechowywane w lokalnym magazynie przeglądarki. Oznacza to, że obrazy nie będą dostępne w innych przeglądarkach poza tym, w którym zostały zapisane, i pozostaną w magazynie przeglądarki przez czas nieokreślony do czasu wyczyszczenia magazynu lokalnego.

Aby przekazać obraz dla pojedynczego modelu, znajdź ten model w panelu Modele i wybierz kropki menu obok nazwy modelu. Następnie wybierz pozycję Przekaż obraz modelu. W wyświetlonym polu selektora plików przejdź na maszynę do pliku obrazu, który chcesz przekazać dla tego modelu. Wybierz pozycję Otwórz , aby go przekazać.

Zrzut ekranu przedstawiający panel Modele usługi Azure Digital Twins Explorer. Kropki menu dla pojedynczego modelu są wyróżnione, a opcja menu Przekaż obraz modelu jest również wyróżniona.

Obrazy modelu można również przekazywać zbiorczo.

Najpierw użyj poniższych instrukcji, aby ustawić nazwy plików obrazów przed przekazaniem. Dzięki temu program Azure Digital Twins Explorer automatycznie przypisze obrazy do odpowiednich modeli po przekazaniu.

  1. Zacznij od wartości identyfikatora modelu (na przykład dtmi:example:Floor;1)
  2. Zastąp wystąpienia elementu ":" ciągiem "_" (przykład staje dtmi_example_Floor;1się )
  3. Zamień wystąpienia ";" na "-" (przykład staje się dtmi_example_Floor-1)
  4. Upewnij się, że plik ma rozszerzenie obrazu (przykład stanie się podobny dtmi_example_Floor-1.pngdo )

Uwaga

Jeśli spróbujesz przekazać obraz, który nie jest mapowany na żaden istniejący model przy użyciu powyższych kryteriów, obraz nie zostanie przekazany ani zapisany.

Następnie, aby przekazać obrazy w tym samym czasie, użyj ikony Przekaż obrazy modelu w górnej części panelu Modele. W polu selektora plików wybierz pliki obrazów do przekazania.

Zrzut ekranu przedstawiający panel Modele usługi Azure Digital Twins Explorer. Ikona Przekaż obrazy modelu jest wyróżniona.

Zarządzanie modelami

Panel Modele można użyć po lewej stronie ekranu Eksploratora usługi Azure Digital Twins, aby wykonywać działania związane z zarządzaniem w całym zestawie modeli lub na poszczególnych modelach.

Zrzut ekranu przedstawiający eksploratora usługi Azure Digital Twins. Panel Modele jest wyróżniony.

Za pomocą tego panelu można wykonać następujące działania związane z zarządzaniem modelami:

Aby uzyskać informacje o środowisku wyświetlania modeli, zobacz Eksplorowanie modeli i wykres modelu.

Przekazywanie modeli

Modele można przekazywać z komputera, wybierając pliki modelu pojedynczo lub przekazując cały folder plików modelu jednocześnie. Jeśli przekazujesz jeden plik JSON zawierający kod dla wielu modeli, zapoznaj się z ograniczeniami przekazywania modelu zbiorczego.

Uwaga

Obecnie usługa Azure Digital Twins Explorer w pełni obsługuje modele DTDL w wersji 2 i obsługuje ograniczone funkcje modeli DTDL w wersji 3.

Modele DTDL w wersji 3 można wyświetlić na panelu Modele, a bliźniacze reprezentacje utworzone za pomocą modeli DTDL w wersji 3 można wyświetlać i edytować (w tym te z właściwościami tablicy). Jednak modele DTDL w wersji 3 nie będą wyświetlane w panelu Model Graph i nie można ich zaimportować przy użyciu eksploratora usługi Azure Digital Twins. Aby zaimportować modele DTDL w wersji 3 do wystąpienia, użyj innego interfejsu deweloperskiego, takiego jak interfejsy API i zestawy SDK lub interfejs wiersza polecenia platformy Azure.

Aby przekazać co najmniej jeden wybrany model, wybierz ikonę Przekaż model z strzałką w górę.

Zrzut ekranu przedstawiający panel Modele usługi Azure Digital Twins Explorer. Wyróżniono ikonę Przekaż model.

W wyświetlonym polu selektora plików przejdź na maszynę do modeli, które chcesz przekazać. Możesz wybrać co najmniej jeden plik modelu JSON i wybrać pozycję Otwórz , aby je przekazać.

Aby przekazać folder modeli, w tym wszystkiego, co znajduje się w nim, wybierz pozycję Przekaż katalog ikony Modele z wyświetlonym folderem plików.

Zrzut ekranu przedstawiający panel Modele usługi Azure Digital Twins Explorer. Wyróżniono ikonę Przekaż katalog modeli.

W wyświetlonym polu selektora plików przejdź na maszynę do folderu zawierającego pliki modelu JSON. Wybierz pozycję Otwórz, aby przekazać ten folder najwyższego poziomu i całą jego zawartość.

Ważne

Jeśli model odwołuje się do innego modelu w swojej definicji, na przykład podczas definiowania relacji lub składników, przywoływany model musi być obecny w wystąpieniu, aby przekazać model, który go używa. Jeśli przekazujesz modele jeden po jednym, oznacza to, że należy przekazać model, do którego się odwołujesz , przed przekazaniem wszystkich modeli, które go używają. Jeśli przekazujesz modele zbiorczo, możesz wybrać je wszystkie w tym samym zaimportowaniu, a usługa Azure Digital Twins wywnioskuje kolejność ich przekazania. Jeśli jednak przekazujesz więcej niż 50 modeli w tym samym pliku, zobacz ograniczenia przekazywania modelu zbiorczego.

Ograniczenia przekazywania modelu zbiorczego

Ograniczenia w tej sekcji dotyczą modeli znajdujących się w jednym pliku JSON, które są przekazywane do eksploratora usługi Azure Digital Twins w tym samym czasie.

Chociaż nie ma limitu liczby modeli, które można uwzględnić w jednym pliku JSON, istnieją specjalne zagadnienia dotyczące plików zawierających więcej niż 50 modeli. Jeśli przekazujesz więcej niż 50 modeli w tym samym pliku modelu, postępuj zgodnie z następującymi wskazówkami:

  • Jeśli istnieją jakiekolwiek modele dziedziczone z innych modeli zdefiniowanych w tym samym pliku, umieść je na końcu listy.
  • Jeśli istnieją modele odwołujące się do innych modeli zdefiniowanych w tym samym pliku co składniki, umieść je na końcu listy.
  • Sprawdź, czy wszędzie tam, gdzie model odwołuje się do innego modelu zdefiniowanego w tym samym pliku (za pośrednictwem dziedziczenia lub jako składnika), model zawierający odwołanie znajduje się później na liście niż definicja modelu, do którego odwołuje się odwołanie.

Pomoże to upewnić się, że zależności modelu są prawidłowo rozwiązywane podczas procesu przekazywania.

Usuwanie modeli

Za pomocą panelu Modele można usunąć poszczególne modele lub wszystkie modele w twoim wystąpieniu jednocześnie.

Aby usunąć pojedynczy model, znajdź ten model na liście i wybierz kropki menu obok nazwy modelu. Następnie wybierz pozycję Usuń model.

Zrzut ekranu przedstawiający panel Modele usługi Azure Digital Twins Explorer. Kropki menu dla pojedynczego modelu są wyróżnione, a opcja menu Usuń model jest również wyróżniona.

Aby usunąć wszystkie modele w wystąpieniu jednocześnie, wybierz ikonę Usuń wszystkie modele w górnej części panelu Modele.

Zrzut ekranu przedstawiający panel Modele usługi Azure Digital Twins Explorer. Ikona Usuń wszystkie modele jest wyróżniona.

Odświeżanie modeli

Po otwarciu eksploratora usługi Azure Digital Twins panel Modele powinien automatycznie wyświetlać wszystkie dostępne modele w danym środowisku.

Można jednak ręcznie odświeżyć panel w dowolnym momencie, aby ponownie załadować listę wszystkich modeli w wystąpieniu usługi Azure Digital Twins. W tym celu wybierz ikonę Odśwież modele .

Zrzut ekranu przedstawiający panel Modele usługi Azure Digital Twins Explorer. Ikona Odśwież modele jest wyróżniona.

Importowanie/eksportowanie grafu

W panelu Twin Graph dostępne są opcje importowania i eksportowania funkcji grafu.

Importowanie grafu

Możesz użyć funkcji importowania, aby dodać bliźniacze reprezentacje, relacje i modele do wystąpienia. Ta funkcja może być przydatna do tworzenia wielu reprezentacji bliźniaczych, relacji i/lub modeli jednocześnie.

Uwaga

Jeśli plik importu grafu zawiera modele, będą one podlegać ograniczeniom przekazywania modelu zbiorczego.

Tworzenie pliku importu

Pierwszym krokiem importowania grafu jest utworzenie pliku reprezentującego bliźniacze reprezentacje i relacje, które chcesz dodać.

Plik importu może mieć jeden z następujących dwóch formatów:

  • Format oparty na formacie JSON wygenerowany podczas eksportowania grafu. Ten format może zawierać reprezentacje bliźniacze, relacje i/lub modele.
  • Niestandardowy format oparty na programie Excel opisany w pozostałej części tej sekcji. Ten format umożliwia przekazywanie reprezentacji bliźniaczych i relacji.
Tworzenie pliku importu w programie Excel

Aby utworzyć niestandardowy graf w programie Excel, który może przekazywać reprezentacje bliźniacze i relacje do Eksploratora usługi Azure Digital Twins, użyj następującego formatu.

Każdy wiersz reprezentuje element do utworzenia: bliźniaczej reprezentacji, relacji lub kombinacji bliźniaczej reprezentacji i odpowiedniej relacji. Użyj poniższych kolumn, aby sstrukturę danych bliźniaczej reprezentacji lub relacji. Nazwy kolumn można dostosować, ale powinny pozostać w tej kolejności.

Identyfikator modelu ID Relacja (źródło) Nazwa relacji Dane inicjowania
(Opcjonalne)
Identyfikator DTMI modelu do użycia dla nowej reprezentacji bliźniaczej. Ta definicja modelu powinna już istnieć w wystąpieniu.

Możesz pozostawić tę kolumnę pustą dla wiersza, jeśli chcesz, aby ten wiersz utworzył tylko relację (bez bliźniaczych reprezentacji).
(Wymagane)
Unikatowy identyfikator bliźniaczej reprezentacji.

Jeśli nowa reprezentacja bliźniacze zostanie utworzona w tym wierszu, ta wartość będzie identyfikatorem nowej reprezentacji bliźniaczej.
Jeśli w wierszu znajdują się informacje o relacji, ten identyfikator będzie używany jako element docelowy relacji.
(Opcjonalne)
Identyfikator bliźniaczej reprezentacji bliźniaczej, która powinna być źródłową reprezentacją dla nowej relacji.

Możesz pozostawić tę kolumnę pustą dla wiersza, jeśli chcesz, aby ten wiersz utworzył tylko reprezentację bliźniaczą (bez relacji).
(Opcjonalne)
Nazwa nowej relacji do utworzenia. Kierunek relacji będzie od bliźniaczej reprezentacji w kolumnie C do bliźniaczej reprezentacji w kolumnie B.
(Opcjonalne)
Ciąg JSON zawierający ustawienia właściwości dla reprezentacji bliźniaczej do utworzenia. Właściwości muszą być zgodne z właściwościami zdefiniowanymi w modelu z kolumny A.

Oto przykład .xlsx pliku tworzącego mały graf dwóch pomieszczeń i dwóch pomieszczeń.

Zrzut ekranu przedstawiający dane grafu w programie Excel. Nagłówki kolumn odpowiadają powyższym polam, a wiersze zawierają odpowiednie wartości danych.

Ten plik i inne przykłady wykresów .xlsx można wyświetlić w repozytorium Azure Digital Twins Explorer w witrynie GitHub.

Uwaga

Właściwości i relacje opisane w .xlsx muszą być zgodne z definicjami modelu powiązanych reprezentacji bliźniaczych.

Importowanie pliku do eksploratora usługi Azure Digital Twins

Po utworzeniu pliku na komputerze, który będzie gotowy do zaimportowania, wybierz ikonę Importuj graf w panelu Twin Graph .

Zrzut ekranu przedstawiający panel usługi Azure Digital Twins Explorer Twin Graph. Przycisk Importuj graf został wyróżniony.

W wyświetlonym polu selektora plików przejdź na maszynę do pliku grafu (.xlsx lub .json), który chcesz przekazać, a następnie wybierz pozycję Otwórz , aby go przekazać.

Usługa Azure Digital Twins otworzy panel Importuj z podglądem grafu do zaimportowania. Aby potwierdzić, wybierz ikonę Zapisz w prawym górnym rogu panelu.

Jeśli importowanie zakończy się pomyślnie, modalne okno wyświetli liczbę modeli, reprezentacji bliźniaczych i relacji, które zostały przekazane.

Zrzut ekranu przedstawiający panel usługi Azure Digital Twins Explorer Twin Graph. Na środku ekranu zostanie wyświetlona modalna importowana modalna reprezentacja przedstawiająca cztery zaimportowane reprezentacje bliźniacze i dwie zaimportowane relacje.

Eksportowanie grafu i modeli

Za pomocą funkcji eksportowania można eksportować częściowe lub kompletne wykresy, w tym modele, reprezentacje bliźniacze i relacje. Eksportuj serializuje reprezentacje bliźniacze i relacje z najnowszych wyników zapytania, a także wszystkie modele w wystąpieniu do formatu opartego na formacie JSON, który można pobrać na komputer.

Aby rozpocząć, użyj panelu Eksplorator zapytań, aby uruchomić zapytanie, które wybiera bliźniacze i relacje, które chcesz pobrać. Spowoduje to wypełnienie ich w panelu Twin Graph.

Napiwek

Zapytanie do wyświetlania wszystkich reprezentacji bliźniaczych i relacji to SELECT * FROM digitaltwins.

Gdy na panelu Twin Graph zostanie wyświetlona część grafu, który chcesz pobrać, wybierz ikonę Eksportuj wykres .

Zrzut ekranu przedstawiający panel usługi Azure Digital Twins Explorer Twin Graph. Przycisk Eksportuj wykres został wyróżniony.

Ta akcja umożliwia pobranie linku w polu Twin Graph. Wybierz go, aby pobrać reprezentację wyniku zapytania w formacie JSON i wszystkie modele w twoim wystąpieniu na maszynie.

Napiwek

Ten plik można edytować i/lub ponownie przekazać do usługi Azure Digital Twins za pomocą funkcji importowania.

Możesz udostępnić link do środowiska usługi Azure Digital Twins Explorer innym osobom, aby współpracować nad pracą. W tej sekcji opisano sposób generowania linku do środowiska eksploratora usługi Azure Digital Twins, które opcjonalnie może zawierać określone zapytanie do uruchomienia po otwarciu linku. W tej sekcji opisano również uprawnienia, które odbiorca musi mieć w celu interakcji z danymi bliźniaczej reprezentacji.

Wymagania dotyczące dostępu adresata

Aby odbiorca otworzył link i wyświetlił wystąpienie w eksploratorze usługi Azure Digital Twins, musi zalogować się do swojego konta platformy Azure i mieć dostęp czytelnika danych usługi Azure Digital Twins do wystąpienia (możesz przeczytać więcej na temat ról usługi Azure Digital Twins w obszarze Zabezpieczenia).

Aby odbiorca wprowadzał zmiany w grafie i danych, musi mieć rolę właściciela danych usługi Azure Digital Twins w wystąpieniu.

Aby wygenerować link do środowiska eksploratora usługi Azure Digital Twins, który zawiera określone zapytanie, wprowadź zapytanie, które chcesz przechwycić w Eksploratorze zapytań, a następnie wybierz przycisk Udostępnij, aby skopiować pełny link.

Zrzut ekranu przedstawiający panel Eksplorator zapytań eksploratora zapytań usługi Azure Digital Twins. Tekst zapytania i przycisk Wyślij są wyróżnione.

Na przykład i zapytanie na powyższym zrzucie ekranu, przycisk Udostępnij tworzy ten link: 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>. Link zawiera identyfikator dzierżawy i nazwę hosta wystąpienia usługi Azure Digital Twins, a także sformatowany tekst zapytania.

Możesz udostępnić ten adres URL, aby umożliwić komuś dostęp do twojego wystąpienia i tego zapytania. Po otwarciu Eksploratora usługi Azure Digital Twins za pomocą linku wyniki zapytania zostaną automatycznie wypełnione w panelu Twin Graph .

Aby udostępnić link do środowiska eksploratora usługi Azure Digital Twins bez dołączonego konkretnego zapytania, zacznij od użycia przycisku Udostępnij , aby skopiować link do wystąpienia.

Zrzut ekranu przedstawiający panel Eksplorator zapytań eksploratora zapytań usługi Azure Digital Twins. Wyróżniono tylko przycisk Wyślij.

Następnie ręcznie usuń parametr zapytania z wyniku.

Na przykład przycisk Udostępnij na powyższym zrzucie ekranu spowoduje wygenerowanie tego linku: https://explorer.digitaltwins.azure.net/?query=SELECT%20*%20FROM%20digitaltwins&tid=<tenant-ID>&eid=<Azure-Digital-Twins-instance-host-name>. Możesz usunąć część, query=SELECT%20*%20FROM%20digitaltwins& aby utworzyć adres URL https://explorer.digitaltwins.azure.net/?tid=<tenant-ID>&eid=<Azure-Digital-Twins-instance-host-name>.

Następnie udostępnij ten adres URL, aby umożliwić komuś dostęp do twojego wystąpienia. Po otwarciu eksploratora usługi Azure Digital Twins za pomocą linku zostaną one połączone z twoim wystąpieniem i nie będą widzieć żadnych wstępnie wypełnionych wyników zapytania.

Ułatwienia dostępu i ustawienia zaawansowane

Możesz włączyć kilka ustawień zaawansowanych dla eksploratora usługi Azure Digital Twins, aby dostosować środowisko lub zwiększyć jego dostępność.

Możesz użyć ikony Skróty klawiaturowe na prawym górnym pasku narzędzi, aby wyświetlić listę skrótów klawiaturowych, których można użyć do nawigowania po Eksploratorze usługi Azure Digital Twins.

Zrzut ekranu przedstawiający eksploratora usługi Azure Digital Twins. Ikona Skróty klawiaturowe jest wyróżniona na górnym pasku narzędzi.

Istnieje kilka zaawansowanych funkcji, do których można uzyskać dostęp w obszarze Koła zębatego Ustawienia na pasku narzędzi w prawym górnym rogu:

  • Chętne ładowanie: gdy zapytanie zwraca bliźniacze reprezentacje, które mają relacje z innymi reprezentacjami bliźniaczymi, które nie są uwzględnione w wynikach zapytania, ta funkcja załaduje "brakujące" reprezentacje bliźniacze przed renderowaniem grafu.
  • Buforowanie: po włączeniu tej funkcji eksplorator usługi Azure Digital Twins zachowa lokalną pamięć podręczną relacji i modeli w pamięci, aby zwiększyć wydajność zapytań. Te pamięci podręczne są czyszczone na wszystkich operacjach zapisu w odpowiednich elementach, a także podczas odświeżania przeglądarki. Ta funkcja jest domyślnie wyłączona.
  • Konsola: ta funkcja umożliwia wyświetlanie okna konsoli, które umożliwia korzystanie z prostych funkcji powłoki do pracy z grafem.
  • Dane wyjściowe: ta funkcja umożliwia wyświetlanie okna danych wyjściowych, które pokazuje dane diagnostyczne śledzenia operacji.
  • Duży kontrast: ta funkcja zmienia kolory Eksploratora usługi Azure Digital Twins, aby były wyświetlane z większym kontrastem.

Układ panelu można dostosować, edytując pozycje paneli tworzących eksplorator usługi Azure Digital Twins (Eksplorator zapytań, bliźniacze reprezentacje, modele, graf bliźniaczych reprezentacji bliźniaczych, wykres modelu). Aby przenieść panel do innej lokalizacji, kliknij i przytrzymaj nazwę panelu, a następnie przeciągnij go do nowej żądanej pozycji.

Zrzut ekranu przedstawiający eksploratora usługi Azure Digital Twins. Wyróżniono nazwy paneli Eksplorator zapytań, Modele, Twin Graph i Model Graph.

Pozycje panelu zostaną zresetowane po odświeżeniu okna przeglądarki.

Następne kroki

Dowiedz się więcej o pisaniu zapytań dla grafu bliźniaczej reprezentacji bliźniaczej usługi Azure Digital Twins: