Plemienne — platforma (wersja zapoznawcza)
Rozszerzanie i ulepszanie plemiennych przyjęć i plemiennych wiz i imigracji z potężnymi dostosowaniami, które wspierają pracowników, wnioskodawców i studentów w kluczowych procesach administracyjnych. Umożliwianie organizacji tworzenia dostosowanych przepływów pracy i środowisk, które dotyczą tych krytycznych obszarów w administracji edukacyjnej.
Ten łącznik jest dostępny w następujących produktach i regionach:
| Usługa | Class | Regions |
|---|---|---|
| Copilot Studio | Premium | Wszystkie regiony usługi Power Automate z wyjątkiem następujących: - Rząd USA (GCC) - Rząd USA (GCC High) - China Cloud obsługiwane przez firmę 21Vianet - Departament Obrony USA (DoD) |
| Logic Apps | Standard | Wszystkie regiony usługi Logic Apps z wyjątkiem następujących: — Regiony platformy Azure Government — Regiony platformy Azure (Chiny) - Departament Obrony USA (DoD) |
| Power Apps | Premium | Wszystkie regiony usługi Power Apps z wyjątkiem następujących: - Rząd USA (GCC) - Rząd USA (GCC High) - China Cloud obsługiwane przez firmę 21Vianet - Departament Obrony USA (DoD) |
| Power Automate | Premium | Wszystkie regiony usługi Power Automate z wyjątkiem następujących: - Rząd USA (GCC) - Rząd USA (GCC High) - China Cloud obsługiwane przez firmę 21Vianet - Departament Obrony USA (DoD) |
| Kontakt | |
|---|---|
| Name | Grupa plemienna |
| adres URL | https://www.tribalgroup.com |
| servicedesk@tribalgroup.com |
| Metadane łącznika | |
|---|---|
| Publisher | Grupa plemienna |
| Witryna internetowa | https://www.tribalgroup.com |
| Zasady ochrony prywatności | https://www.tribalgroup.com/privacy-policy |
| Kategorie | Zarządzanie biznesem |
Moduły plemienne edge, takie jak plemienne przyjęcia, zapewniają pracownikom i uczniom narzędzia, których potrzebują, aby odnieść sukces w świecie edukacji. Łącznik plemienny umożliwia powiadamianie o zdarzeniach oraz wykonywanie zapytań o jednostki i manipulowanie nimi w module Tribal Edge.
Wymagania wstępne
Aby użyć łącznika plemiennego, musisz być użytkownikiem aplikacji Tribal Edge dla wybranego modułu.
Jak uzyskać poświadczenia
Aby uzyskać dostęp do łącznika plemiennego, musisz mieć użytkownika w dzierżawie, który ma uprawnienia:
- Subskrybowanie zdarzeń
- Wykonywanie jakichkolwiek akcji/zapytań w programie Tribal Edge, np. jeśli chcesz uzyskać dane referencyjne, musisz mieć uprawnienie "Dane referencyjne — odczyt"
W usłudze Power Automate podczas tworzenia połączenia będziesz promowany dla:
- Typ środowiska, do którego chcesz uzyskać dostęp, tj. Live, Testing lub Development.
- Region, w którym jesteś w regionie EMEA lub APAC
- Dzierżawa otrzymana po dołączeniu do usługi Tribal Edge
Po wprowadzeniu poświadczeń zostanie wyświetlony monit o zgodę, wymagane są poniższe
- Punkt końcowy łącznika zdarzeń
- Nawiązywanie połączenia z elementami webhook
Wprowadzenie do łącznika
Celem łącznika plemiennego jest umożliwienie integracji z dowolnym łącznikiem usługi Power Automate i rozszerzenie logiki krawędzi plemiennej poza to, co może zapewnić wewnętrznie. Łącznik plemienny udostępnia wyzwalacze, aby otrzymywać powiadomienia, na przykład osoba ubiegająca się o szczegółowe informacje i akcje, które można wykonać w ramach krawędzi plemiennej, np. utworzyć nowy typ sprawdzania odprawy.
Poniżej przedstawiono 2 typowe scenariusze.
- Użyj łącznika programu Excel, aby pobrać wiersze z arkusza kalkulacyjnego programu Excel hostowanego w chmurze i użyć akcji tworzenia i aktualizowania plemiennego w celu wypełnienia danych referencyjnych.
- Użyj łącznika plemiennego, aby nasłuchiwać, czy dana osoba została zaktualizowana, pobierać szczegółowe informacje o tej osobie i powiadamiać członka personelu za pośrednictwem łącznika usługi Teams.
Znane problemy i ograniczenia
- Wyzwalacze, które są generowane za pośrednictwem programu Tribal Edge, kontynuują tylko unikatowe tożsamości, które wymagają dalszego wykonywania zapytań. Można wykonać oddzielną akcję pobierania szczegółów, które są chronione przez uprawnienia, aby dowiedzieć się więcej.
- Wyzwalacze i akcje są obecnie w trakcie opracowywania. Staną się one dostępne w łączniku jako i wtedy, gdy będą gotowe.
Typowe błędy i środki zaradcze
- Podczas wykonywania akcji może wystąpić błąd uprawnień. Można to rozwiązać, żądając uprawnień od administratora.
Tworzenie połączenia
Łącznik obsługuje następujące typy uwierzytelniania:
| Wartość domyślna | Parametry tworzenia połączenia. | Wszystkie regiony | Nie można udostępniać |
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.
| Name | Typ | Description | Wymagane |
|---|---|---|---|
| Środowisko | ciąg | Środowisko | Prawda |
| Region | ciąg | Region | Prawda |
| Identyfikator dzierżawy usługi Edge | ciąg | Identyfikator dzierżawy dla krawędzi plemiennej | Prawda |
Limity ograniczania
| Nazwa | Wywołania | Okres odnowienia |
|---|---|---|
| Wywołania interfejsu API na połączenie | 100 | 60 sekund |
Akcje
| Odczytywanie jednostki |
Odczytywanie jednostki |
| Odczytywanie jednostki podrzędnej |
Odczytywanie jednostki podrzędnej |
| Odczytywanie kolekcji jednostek |
Odczytywanie kolekcji jednostek |
| Odczytywanie kolekcji jednostek podrzędnych |
Odczytywanie kolekcji jednostek podrzędnych |
| Przekazywanie dokumentu do jednostki |
Przekazywanie dokumentu do jednostki |
| Przekazywanie dokumentu do jednostki podrzędnej |
Przekazywanie dokumentu do jednostki podrzędnej |
| Tworzenie encji |
Tworzenie encji |
| Tworzenie jednostki podrzędnej |
Tworzenie jednostki podrzędnej |
| Usuwanie jednostki |
Usuwanie jednostki |
| Usuwanie jednostki podrzędnej |
Usuwanie jednostki podrzędnej |
| Zastępowanie jednostki |
Spowoduje to zastąpienie zawartości jednostki. Spowoduje to usunięcie wszelkich właściwości z jednostki, które nie zostały uwzględnione. |
| Zastępowanie jednostki podrzędnej |
Zastępuje to zawartość jednostki podrzędnej. Spowoduje to usunięcie wszelkich właściwości z jednostki, które nie zostały uwzględnione. |
| Żądanie HTTP |
Wysyłanie żądania HTTP do usługi Edge |
Odczytywanie jednostki
Odczytywanie jednostki
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Usługa
|
service | True | string |
Usługa zawierająca informacje |
|
Wersja interfejsu API
|
api-version | True | string |
Wersja interfejsu API do użycia |
|
Encja
|
entityType | True | string |
Odczytywana jednostka |
|
Id
|
id | True | string |
Identyfikator jednostki |
|
Identyfikator korelacji
|
x-correlation-id | string |
Identyfikator korelacji dodany w nagłówku x-correlation-id |
Zwraca
Odczytywanie jednostki podrzędnej
Odczytywanie jednostki podrzędnej
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Usługa
|
service | True | string |
Usługa zawierająca informacje |
|
Wersja interfejsu API
|
api-version | True | string |
Wersja interfejsu API do użycia |
|
Jednostka nadrzędna
|
parentEntity | True | string |
Jednostka nadrzędna, która jest odczytywana przez element podrzędny |
|
Identyfikator jednostki nadrzędnej
|
parentId | True | string |
Unikatowy identyfikator jednostki nadrzędnej tworzonej przez element podrzędny |
|
Jednostka podrzędna
|
childEntity | True | string |
Odczytywana jednostka podrzędna |
|
Identyfikator jednostki podrzędnej
|
childId | True | string |
Identyfikator jednostki podrzędnej |
|
Identyfikator korelacji
|
x-correlation-id | string |
Identyfikator korelacji dodany w nagłówku x-correlation-id |
Zwraca
Odczytywanie kolekcji jednostek
Odczytywanie kolekcji jednostek
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Usługa
|
service | True | string |
Usługa zawierająca informacje |
|
Wersja interfejsu API
|
api-version | True | string |
Wersja interfejsu API do użycia |
|
Encja
|
entityType | True | string |
Odczytywana jednostka |
|
Rekordy do pominięcia
|
skip | True | integer |
Liczba rekordów do pominięcia |
|
Rekordy do podjęcia
|
take | True | integer |
Liczba rekordów do wykonania |
|
Filter
|
filter | string |
Filtrowanie rekordów przy użyciu składni protokołu Open Data Protocol |
Zwraca
Odczytywanie kolekcji jednostek podrzędnych
Odczytywanie kolekcji jednostek podrzędnych
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Usługa
|
service | True | string |
Usługa zawierająca informacje |
|
Wersja interfejsu API
|
api-version | True | string |
Wersja interfejsu API do użycia |
|
Jednostka nadrzędna
|
parentEntity | True | string |
Jednostka nadrzędna, która jest odczytywana przez element podrzędny |
|
Identyfikator jednostki nadrzędnej
|
parentId | True | string |
Unikatowy identyfikator jednostki nadrzędnej tworzonej przez element podrzędny |
|
Jednostki podrzędne
|
childEntity | True | string |
Odczytywane jednostki podrzędne |
|
Rekordy do pominięcia
|
skip | True | integer |
Liczba rekordów do pominięcia |
|
Rekordy do podjęcia
|
take | True | integer |
Liczba rekordów do wykonania |
|
Filter
|
filter | string |
Filtrowanie rekordów przy użyciu składni protokołu Open Data Protocol |
|
|
Identyfikator korelacji
|
x-correlation-id | string |
Identyfikator korelacji dodany w nagłówku x-correlation-id |
Zwraca
Przekazywanie dokumentu do jednostki
Przekazywanie dokumentu do jednostki
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Usługa
|
service | True | string |
Usługa zawierająca informacje |
|
Wersja interfejsu API
|
api-version | True | string |
Wersja interfejsu API do użycia |
|
Encja
|
entityType | True | string |
Tworzona jednostka |
|
Id
|
id | True | string |
Identyfikator jednostki |
|
Plik wejściowy do wykonania operacji.
|
file | True | file |
Plik wejściowy do wykonania operacji. |
|
Typ przekazywanego dokumentu
|
documentTypeName | string |
Typ przekazywanego dokumentu |
|
|
Kto utworzył dokument
|
createdBy | string |
Kto utworzył dokument |
Przekazywanie dokumentu do jednostki podrzędnej
Przekazywanie dokumentu do jednostki podrzędnej
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Usługa
|
service | True | string |
Usługa zawierająca informacje |
|
Wersja interfejsu API
|
api-version | True | string |
Wersja interfejsu API do użycia |
|
Jednostka nadrzędna
|
parentEntity | True | string |
Jednostka nadrzędna elementu podrzędnego |
|
Identyfikator jednostki nadrzędnej
|
parentId | True | string |
Unikatowy identyfikator jednostki nadrzędnej elementu podrzędnego |
|
Jednostka podrzędna
|
childEntity | True | string |
Jednostka podrzędna przekazywana do dokumentu |
|
Identyfikator jednostki podrzędnej
|
childId | True | string |
Identyfikator jednostki podrzędnej |
|
Plik wejściowy do wykonania operacji.
|
file | True | file |
Plik wejściowy do wykonania operacji. |
|
Typ przekazywanego dokumentu
|
documentTypeName | string |
Typ przekazywanego dokumentu |
|
|
Kto utworzył dokument
|
createdBy | string |
Kto utworzył dokument |
Tworzenie encji
Tworzenie encji
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Usługa
|
service | True | string |
Usługa zawierająca informacje |
|
Wersja interfejsu API
|
api-version | True | string |
Wersja interfejsu API do użycia |
|
Encja
|
entityType | True | string |
Tworzona jednostka |
|
Identyfikator korelacji
|
x-correlation-id | string |
Identyfikator korelacji dodany w nagłówku x-correlation-id |
|
|
body
|
body | True | dynamic |
Zwraca
Tworzenie jednostki podrzędnej
Tworzenie jednostki podrzędnej
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Usługa
|
service | True | string |
Usługa zawierająca informacje |
|
Wersja interfejsu API
|
api-version | True | string |
Wersja interfejsu API do użycia |
|
Jednostka nadrzędna
|
parentEntity | True | string |
Jednostka nadrzędna tworzona przez element podrzędny |
|
Identyfikator jednostki nadrzędnej
|
parentId | True | string |
Unikatowy identyfikator jednostki nadrzędnej tworzonej przez element podrzędny |
|
Jednostka podrzędna
|
childEntity | True | string |
Tworzona jednostka podrzędna |
|
Identyfikator korelacji
|
x-correlation-id | string |
Identyfikator korelacji dodany w nagłówku x-correlation-id |
|
|
body
|
body | True | dynamic |
Zwraca
Usuwanie jednostki
Usuwanie jednostki
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Usługa
|
service | True | string |
Usługa zawierająca informacje |
|
Wersja interfejsu API
|
api-version | True | string |
Wersja interfejsu API do użycia |
|
Encja
|
entityType | True | string |
Usunięto jednostkę |
|
Id
|
id | True | string |
Identyfikator jednostki |
|
Identyfikator korelacji
|
x-correlation-id | string |
Identyfikator korelacji dodany w nagłówku x-correlation-id |
Usuwanie jednostki podrzędnej
Usuwanie jednostki podrzędnej
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Usługa
|
service | True | string |
Usługa zawierająca informacje |
|
Wersja interfejsu API
|
api-version | True | string |
Wersja interfejsu API do użycia |
|
Jednostka nadrzędna
|
parentEntity | True | string |
Jednostka nadrzędna, która jest usuwana przez element podrzędny |
|
Identyfikator jednostki nadrzędnej
|
parentId | True | string |
Identyfikator jednostki nadrzędnej |
|
Jednostka podrzędna
|
childEntity | True | string |
Kwerenda jednostki podrzędnej |
|
Identyfikator jednostki podrzędnej
|
childId | True | string |
Identyfikator jednostki podrzędnej |
|
Identyfikator korelacji
|
x-correlation-id | string |
Identyfikator korelacji dodany w nagłówku x-correlation-id |
Zastępowanie jednostki
Spowoduje to zastąpienie zawartości jednostki. Spowoduje to usunięcie wszelkich właściwości z jednostki, które nie zostały uwzględnione.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Usługa
|
service | True | string |
Usługa zawierająca informacje |
|
Wersja interfejsu API
|
api-version | True | string |
Wersja interfejsu API do użycia |
|
Encja
|
entityType | True | string |
Aktualizowana jednostka |
|
Id
|
id | True | string |
Identyfikator jednostki |
|
Identyfikator korelacji
|
x-correlation-id | string |
Identyfikator korelacji dodany w nagłówku x-correlation-id |
|
|
If-Match
|
If-Match | True | string |
Element ETag dodany w nagłówku If-Match |
|
body
|
body | True | dynamic |
Zwraca
Zastępowanie jednostki podrzędnej
Zastępuje to zawartość jednostki podrzędnej. Spowoduje to usunięcie wszelkich właściwości z jednostki, które nie zostały uwzględnione.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Usługa
|
service | True | string |
Usługa zawierająca informacje |
|
Wersja interfejsu API
|
api-version | True | string |
Wersja interfejsu API do użycia |
|
Jednostka nadrzędna
|
parentEntity | True | string |
Jednostka nadrzędna, która jest aktualizowana |
|
Identyfikator jednostki nadrzędnej
|
parentId | True | string |
Unikatowy identyfikator jednostki nadrzędnej, w ramach których element podrzędny jest aktualizowany |
|
Jednostka podrzędna
|
childEntity | True | string |
Aktualizowana jednostka nadrzędna |
|
Identyfikator jednostki podrzędnej
|
childId | True | string |
Identyfikator jednostki podrzędnej |
|
Identyfikator korelacji
|
x-correlation-id | string |
Identyfikator korelacji dodany w nagłówku x-correlation-id |
|
|
If-Match
|
If-Match | True | string |
Element ETag dodany w nagłówku If-Match |
|
body
|
body | True | dynamic |
Zwraca
Żądanie HTTP
Wysyłanie żądania HTTP do usługi Edge
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Usługa
|
service | string |
Usługa zawierająca informacje |
|
|
klucz
|
key | string |
klucz |
|
|
value
|
value | string |
value |
|
|
Czasownik
|
verb | True | string |
Czasownik HTTP |
|
Body
|
body | string |
Treść żądania |
|
|
Względny adres URL, np. /api/referenceData
|
relativeUrl | True | string |
Względny adres URL |
Wyzwalacze
| Gdy długotrwała operacja jest wykonywana na jednostce |
Gdy długotrwała operacja jest wykonywana na jednostce |
| Po usunięciu jednostki |
Po usunięciu jednostki |
| Po utworzeniu jednostki |
Po utworzeniu jednostki |
| Po wyzwoleniu zdarzenia w jednostce |
Po wyzwoleniu zdarzenia w jednostce |
| Po zaktualizowaniu jednostki |
Po zaktualizowaniu jednostki |
Gdy długotrwała operacja jest wykonywana na jednostce
Gdy długotrwała operacja jest wykonywana na jednostce
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Usługa
|
service | True | string |
Usługa zawierająca informacje |
|
Encja
|
entityType | True | string |
Jednostka |
|
Typ Wydarzenia
|
eventType | True | string |
Typ zdarzenia |
|
Majątek
|
key | string |
Dalej filtruj jednostkę |
|
|
Wartość
|
value | string |
Wartość |
Zwraca
Po usunięciu jednostki
Po usunięciu jednostki
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Usługa
|
service | True | string |
Usługa zawierająca informacje |
|
Encja
|
entityType | True | string |
Usunięto jednostkę |
|
Encja
|
key | string |
Dalej filtruj jednostkę |
|
|
value
|
value | string |
value |
Zwraca
Po utworzeniu jednostki
Po utworzeniu jednostki
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Usługa
|
service | True | string |
Usługa zawierająca informacje |
|
Encja
|
entityType | True | string |
Tworzona jednostka |
|
Encja
|
key | string |
Dalej filtruj jednostkę |
|
|
value
|
value | string |
value |
Zwraca
Po wyzwoleniu zdarzenia w jednostce
Po wyzwoleniu zdarzenia w jednostce
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Usługa
|
service | True | string |
Usługa zawierająca informacje |
|
Typ jednostki
|
entityType | True | string |
Wyzwalana jednostka |
|
Typ zdarzenia
|
eventType | True | string |
Typ zdarzenia dla operacji |
|
Encja
|
key | string |
Dalej filtruj jednostkę |
|
|
value
|
value | string |
value |
Zwraca
Po zaktualizowaniu jednostki
Po zaktualizowaniu jednostki
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Usługa
|
service | True | string |
Usługa zawierająca informacje |
|
Encja
|
entityType | True | string |
Aktualizowana jednostka |
|
Encja
|
key | string |
Dalej filtruj jednostkę |
|
|
value
|
value | string |
value |