HUE Datagate (wersja zapoznawcza)

Datagate to platforma do zarządzania danymi typu oprogramowanie jako usługa z aplikacji Works, która zapewnia użytkownikom usprawnioną metodę przechowywania danych biznesowych, zarządzania nimi i generowania ich. Ten łącznik umożliwia korzystanie z danych biznesowych w usłudze Datagate z poziomu platformy Power Platform.

Ten łącznik jest dostępny w następujących produktach i regionach:

Datagate to platforma do zarządzania danymi typu oprogramowanie jako usługa z aplikacji Works, która zapewnia użytkownikom usprawnioną metodę przechowywania danych biznesowych, zarządzania nimi i generowania ich. Może ona służyć jako scentralizowana platforma do przechowywania danych i zarządzania nimi

Ten łącznik udostępnia interfejs API umożliwiający dostęp do danych biznesowych w usłudze Datagate z poziomu platformy Power Platform.

Wymagania wstępne

Aby użyć tego łącznika, potrzebne są następujące elementy:

• klucz interfejsu API datagate z dostępem do interfejsu API OData.
• poświadczenia roli datagate (identyfikator roli, wpis tajny roli) z dostępem do żądanej tabeli.
• Konto użytkownika datagate w celu uzyskania dostępu do konstruktora zapytań w usłudze Datagate.

Jak uzyskać poświadczenia

Istnieją dwie warstwy uwierzytelniania i autoryzacji w celu uzyskania dostępu do tabeli w usłudze Datagate, czyli klucza interfejsu API datagate i roli Datagate. Poniżej przedstawiono uproszczone kroki uzyskiwania poświadczeń roli Datagate API Key i Datagate. Aby uzyskać więcej informacji, zapoznaj się z instrukcjami dotyczącymi usługi Datagate w witrynie @SUPPORTlub skontaktuj się z naszymi konsultantami.

Aby uzyskać klucz interfejsu API usługi Datagate:

1. Zaloguj się do ekranu datagate.
2. Przejdź do strony zarządzania kluczami interfejsu API. Przycisk Klucz interfejsu API będzie dostępny na lewym pasku nawigacyjnym strony. Kliknij ikonę klucza i wybierz pozycję "API Key Management", aby przejść do strony usługi API Key Management.
3. Kliknij przycisk Utwórz klucz interfejsu API w prawej górnej części strony.
4. Strona edycji interfejsu API zostanie wyświetlona z pustymi polami.
5. W sekcji Informacje o kluczu interfejsu API wypełnij żądany opis.
6. Wybierz odpowiednie uprawnienia, aby nadać klucz interfejsu API.
7. Kliknij przycisk "Zapisz klucz interfejsu API" w prawym górnym rogu strony, aby utworzyć żądany klucz interfejsu API.

Aby uzyskać poświadczenia roli datagate:

1. Zaloguj się do ekranu datagate.
2. Przejdź do strony zarządzania rolami. Link Zarządzanie rolami będzie dostępny na lewym pasku nawigacyjnym strony. Kliknij ikonę tabeli i wybierz pozycję "Zarządzanie rolami", aby przejść do strony zarządzania rolami.
3. Kliknij przycisk Utwórz rolę w prawym górnym rogu strony.
4. Zostanie wyświetlona strona Tworzenie roli.
5. W sekcji informacje o roli wypełnij żądaną nazwę roli i wybierz typ uprawnień.
6. Wybierz odpowiednie uprawnienia, aby nadać rolę z listy schematu lub tabeli.
7. Kliknij przycisk "Zapisz rolę" w prawym górnym rogu strony, aby utworzyć nową rolę i uzyskać odpowiednie poświadczenia roli.

Wprowadzenie do łącznika

Obecnie istnieje jeden interfejs API dostępny do użycia, interfejs API OData, który umożliwia dostęp do odczytu do danych tabeli w usłudze Datagate. Za pomocą zapytania Datagate OData można ustawić kolumny, które mają być wybrane, kolejność sortowania, Wymagane parametry są ciągiem zapytania i poświadczeniami roli roli, która ma dostęp do tabeli. Zapoznaj się z poprzednią sekcją "How to get credentials" (Jak uzyskać poświadczenia) w celu uzyskania wymaganych poświadczeń klucza interfejsu API i roli. Aby uzyskać ciąg zapytania, zapoznaj się z poniższymi krokami.

1. Na ekranie Datagate wyszukaj żądaną tabelę na stronie listy tabel.
2. Otwórz stronę podglądu danych żądanej tabeli.
3. Ustaw żądane parametry i skopiuj wynikowy ciąg zapytania.

Wysyłanie codziennego raportu pocztą e-mail

Za pomocą łącznika usługi Datagate utwórz przepływ zasilania, który automatycznie wysyła raport sprzedaży codziennie

1. Przygotuj klucz interfejsu API do użycia. (Zapoznaj się z poprzednią sekcją "Jak uzyskać poświadczenia")
2. Przygotuj rolę (identyfikator roli i wpis tajny roli). (Zapoznaj się z poprzednią sekcją "Jak uzyskać poświadczenia")
3. Uzyskaj zapytanie dla tabeli wyjściowej.
4. Utwórz zaplanowany przepływ chmury.
5. Ustaw żądany harmonogram.
6. Sprawdź, czy zestaw harmonogramu jest poprawny.
7. Dodaj krok, aby uzyskać bieżącą godzinę daty i przekonwertować strefę czasową UTC na żądaną strefę czasową.
8. Dodaj krok interfejsu API OData. Istnieje możliwość wygenerowania dynamicznych ciągów zapytania przez wstawienie zmiennych w ciągu zapytania.
9. Dodaj krok konwersji JSON. Wygeneruj schemat przy użyciu przykładowego ładunku JSON.
10. Dodaj krok, aby utworzyć tabelę HTML.
11. Dodaj krok, aby wysłać wiadomość e-mail i wprowadzić żądaną treść wiadomości e-mail, a następnie zapisz łącznik. Możesz przetestować przepływ, uruchamiając go ręcznie.
12. Wiadomość e-mail zostanie wysłana w następującym formacie zgodnie ze zdefiniowanym harmonogramem.

Znane problemy i ograniczenia

Maksymalny rozmiar zwracanych danych to 6 MB na wywołanie interfejsu API.

Jeśli żądany rozmiar zestawu danych jest większy niż 6 MB, wywołanie interfejsu API zwróci błąd "413 Payload Too Large".

Typowe błędy i środki zaradcze

Obecnie w łączniku istnieje tylko jeden interfejs API— interfejs API OData. Poniżej przedstawiono niektóre z możliwych błędów, które mogą wystąpić podczas korzystania z interfejsu API.

200 OK

"relacja "public_view.nazwa_tabeli" nie istnieje"

Tabela może już nie istnieć. Sprawdź, czy tabela jest dostępna za pośrednictwem przeglądarki danych usługi Datagate.

"Nie można przeanalizować filtru (XXX)" (wiersz X, kolumna X)"

Wystąpił problem z podanym zapytaniem. Upewnij się, czy zapytanie zostało poprawnie skopiowane z ekranu datagate.

413 Ładunek jest za duży

Istnieje limit 6 MB dla rozmiaru ładunku z interfejsu API OData. Ustaw niższy limit liczby wierszy, ustawiając parametr "limit" w zapytaniu OData.

500 Wewnętrzny błąd serwera

Nie można ustanowić połączenia z serwerem. Sprawdź naszych konsultantów, czy problem będzie się powtarzać.

Często zadawane pytania

Poniżej przedstawiono typowe pytania użytkowników usługi Datagate. W przypadku pytań, które nie zostały tutaj omówione lub aby uzyskać więcej informacji, zapoznaj się z instrukcjami dotyczącymi usługi Datagate dostępnymi na platformie aplikacji @SUPPORT Works. W przeciwnym razie skontaktuj się z naszymi konsultantami.

Jak uzyskać dane tabeli zewnętrznej z łącznika?

Uzyskaj dostęp do strony przeglądarki danych żądanej tabeli zewnętrznej i uzyskaj odpowiedni ciąg zapytania z konstruktora zapytań.

Tworzenie połączenia

Łącznik obsługuje następujące typy uwierzytelniania:

Domyślny

Dotyczy: wszystkie regiony

Parametry tworzenia połączenia.

Nie jest to możliwe do udostępnienia połączenie. Jeśli aplikacja power zostanie udostępniona innemu użytkownikowi, zostanie wyświetlony monit o jawne utworzenie nowego połączenia.

Limity ograniczania

Akcje

OData API