Integracja z usługami Power Platform i Logic Apps przy użyciu łącznika usługi Azure Digital Twins

Usługę Azure Digital Twins można zintegrować z przepływem usługi Microsoft Power Platform lub Azure Logic Apps przy użyciu łącznika usługi Azure Digital Twins Power Platform.

Łącznik jest otoką interfejsów API płaszczyzny danych usługi Azure Digital Twins na potrzeby operacji bliźniaczych, modeli i zapytań, dzięki czemu podstawowa usługa może komunikować się z usługami Microsoft Power Automate, Microsoft Power Apps i Azure Logic Apps. Łącznik umożliwia użytkownikom łączenie kont i korzystanie z zestawu wstępnie utworzonych akcji w celu tworzenia aplikacji i przepływów pracy.

Aby zapoznać się z wprowadzeniem do łącznika, w tym krótkiego pokazu, obejrzyj następujący film wideo przedstawiający usługę IoT:

Możesz również ukończyć podstawowy przewodnik we wpisie w blogu Upraszczanie tworzenia zautomatyzowanych przepływów pracy i aplikacji obsługiwanych przez usługę Azure Digital Twins. Aby uzyskać więcej informacji na temat łącznika, w tym pełną listę akcji łącznika i ich parametrów, zobacz dokumentację referencyjną łącznika usługi Azure Digital Twins.

Wymagania wstępne

Jeśli nie masz subskrypcji platformy Azure, przed rozpoczęciem utwórz bezpłatne konto. Zaloguj się do Azure Portal przy użyciu konta.

Aby pracować z usługą Azure Digital Twins w tym artykule, potrzebujesz wystąpienia usługi Azure Digital Twins i wymaganych uprawnień do korzystania z niego. Jeśli masz już skonfigurowane wystąpienie usługi Azure Digital Twins, możesz użyć tego wystąpienia i przejść do następnej sekcji. W przeciwnym razie postępuj zgodnie z instrukcjami w temacie Konfigurowanie wystąpienia i uwierzytelniania. Instrukcje zawierają informacje ułatwiające sprawdzenie, czy każdy krok został ukończony pomyślnie.

Po skonfigurowaniu wystąpienia zanotuj nazwę hosta wystąpienia. Nazwę hosta można znaleźć w Azure Portal.

Na koniec należy skonfigurować wszystkie usługi platformy Power Platform , w których chcesz używać łącznika.

Konfigurowanie łącznika

W przypadku usług Power Automate i Power Apps należy najpierw skonfigurować połączenie przed utworzeniem przepływu. Wykonaj poniższe kroki, aby dodać połączenie w usługach Power Automate i Power Apps.

1. Wybierz pozycję Połączenia z menu nawigacji po lewej stronie (w usłudze Power Automate znajduje się on pod nagłówkiem Dane ). Na stronie Połączenia wybierz pozycję + Nowe połączenie.
2. Wyszukaj usługę Azure Digital Twins i wybierz łącznik Azure Digital Twins (wersja zapoznawcza).
3. Gdzie łącznik prosi o nazwę wystąpienia usługi ADT, wprowadź nazwę hosta wystąpienia.
4. Wprowadź szczegóły uwierzytelniania po zażądaniu zakończenia konfigurowania połączenia.
5. Aby sprawdzić, czy połączenie zostało utworzone, poszukaj go na stronie Połączenia.

W przypadku usługi Logic Apps możesz użyć wbudowanego połączenia usługi Azure Digital Twins podczas tworzenia przepływu w następnej sekcji. Aby uzyskać więcej informacji na temat wbudowanych łączników, zobacz Wbudowane łączniki w usłudze Azure Logic Apps.

Tworzenie przepływu

Usługę Azure Digital Twins można dołączyć do przepływów usługi Power Automate, przepływów usługi Logic Apps lub aplikacji usługi Power Apps. Korzystając z łącznika usługi Azure Digital Twins i ponad 700 innych łączników platformy Power Platform, można pozyskiwać dane z innych systemów do bliźniaczych reprezentacji lub reagować na zdarzenia systemowe.

Wykonaj poniższe kroki, aby utworzyć przykładowy przepływ z łącznikiem w usłudze Power Automate.

1. W usłudze Power Automate wybierz pozycję Moje przepływy z menu nawigacji po lewej stronie. Wybierz pozycję + Nowy przepływ i Błyskawiczny przepływ w chmurze.
2. Wprowadź nazwę przepływu i wybierz pozycję Ręcznie wyzwól przepływ z listy wyzwalaczy. Utwórz przepływ.
3. Dodaj krok do przepływu i wyszukaj usługę Azure Digital Twins , aby znaleźć połączenie. Wybierz połączenie usługi Azure Digital Twins.
4. Zostanie wyświetlona lista wszystkich akcji dostępnych w łączniku. Wybierz jedną z nich, aby korzystać z interfejsów API usługi Azure Digital Twins.
5. Możesz nadal edytować lub dodawać kolejne kroki do przepływu pracy, korzystając z innych łączników w celu skompilowania scenariusza integracji.

Wykonaj poniższe kroki, aby utworzyć przykładowy przepływ z łącznikiem w usłudze Power Apps.

1. W usłudze Power Apps wybierz pozycję + Utwórz z menu nawigacji po lewej stronie. Wybierz pozycję Pusta aplikacja i postępuj zgodnie z monitami, aby utworzyć nową aplikację.
2. W konstruktorze aplikacji wybierz pozycję Dane z menu nawigacji po lewej stronie. Wybierz pozycję Dodaj dane i wyszukaj ciąg Azure Digital Twins , aby znaleźć połączenie danych. Wybierz połączenie usługi Azure Digital Twins.
3. Teraz akcje z łącznika usługi Azure Digital Twins będą dostępne jako funkcje do użycia w aplikacji.
4. Możesz kontynuować tworzenie aplikacji z dostępem do danych usługi Azure Digital Twins. Aby uzyskać więcej informacji na temat tworzenia usługi Power Apps, zobacz Omówienie tworzenia aplikacji w usłudze Power Apps.

Wykonaj poniższe kroki, aby utworzyć przykładowy przepływ z łącznikiem w usłudze Logic Apps.

1. Przejdź do aplikacji logiki w Azure Portal. Wybierz pozycję Przepływy pracy z menu nawigacji po lewej stronie i pozycję + Dodaj. Postępuj zgodnie z monitami, aby utworzyć nowy przepływ pracy.
2. Wybierz nowy przepływ i wprowadź go w Projektancie.
3. Dodaj wyzwalacz do aplikacji.
4. Wybierz pozycję Wybierz operację, aby dodać akcję z łącznika usługi Azure Digital Twins. Wyszukaj usługę Azure Digital Twins na karcie Azure , aby znaleźć połączenie danych. Wybierz połączenie usługi Azure Digital Twins.
5. Zostanie wyświetlona lista wszystkich akcji dostępnych w łączniku. Wybierz jedną z nich, aby korzystać z interfejsów API usługi Azure Digital Twins.
6. Po wybraniu akcji z łącznika usługi Azure Digital Twins zostanie wyświetlony monit o wprowadzenie szczegółów uwierzytelniania w celu utworzenia połączenia.
7. Możesz nadal edytować lub dodawać kolejne kroki do przepływu pracy, korzystając z innych łączników w celu skompilowania scenariusza integracji.

Ograniczenia i sugestie

Poniżej przedstawiono pewne ograniczenia łącznika i sugestie dotyczące pracy z nimi.

• Niektóre akcje łącznika (takie jak Dodawanie modelu) wymagają danych wejściowych w postaci ciągu literału rozpoczynającego się od @. W takich przypadkach należy zamiast tego @@ użyć znaku ucieczki@. Dzięki temu wartość literału nie będzie interpretowana jako wyrażenie JSON.
• Ponieważ usługa Azure Digital Twins obsługuje odpowiedzi na schemat dynamiczny, należy przeanalizować dane JSON odebrane z interfejsów API przed użyciem go w aplikacji. Oto na przykład zestaw wywołań, które analizują dane przed wyodrębnienie dtId wartości: Set(jsonVal, AzureDigitalTwins.GetTwinById("your_twin_id").result); Set(parsedResp, ParseJSON(jsonVal)); Set( DtId, Text(parsedResp.'$dtId'));.

Następne kroki

Aby uzyskać więcej informacji na temat łączników platformy Power Platform, w tym sposobu ich używania w przepływach pracy w wielu produktach, zobacz dokumentację łączników usług Power Platform i Azure Logic Apps.