Formularze Cognito

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

Usługa	Class	Regions
Copilot Studio	Standard	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	Standard	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	Standard	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	Obsługa formularzy Cognito
adres URL	https://www.cognitoforms.com/support
Email	support@cognitoforms.com

Metadane łącznika
Publisher	Formularze Cognito
Witryna internetowa	https://www.cognitoforms.com
Zasady ochrony prywatności	https://www.cognitoforms.com/legal/privacy
Kategorie	Produktywność; Kolaboracja

Formularze Cognito

Aplikacja Cognito Forms umożliwia łatwe tworzenie zaawansowanych formularzy online, takich jak ankiety, formularze zamówień, formularze rejestracji i nie tylko. Bezpłatnie. Zapoznaj się z naszą dokumentacją pomocy technicznej lub skontaktuj się z nami , aby uzyskać pomoc dotyczącą naszego publicznego łącznika usługi Power Automate.

Wydawca: Cognito Forms

Wymagania wstępne

Wymagana jest płatna subskrypcja.

Obsługiwane operacje

Triggers

Wyzwalacze zostaną wysłane wkrótce po wystąpieniu subskrybowanego zdarzenia.

NewEntry

Zostanie to wyzwolone po utworzeniu nowego wpisu dla określonego formularza. Dane wyjściowe będą danymi wejściowymi, w tym danymi plików i tymczasowymi linkami do plików, podpisów i dokumentów wejściowych.

Parametry:

• form: nazwa formularza, dla którego będą subskrybowane nowe zdarzenia wprowadzania.

UpdateEntry

Zostanie to wyzwolone po zaktualizowaniu wpisu dla określonego formularza. Dane wyjściowe będą danymi wejściowymi, w tym danymi plików i tymczasowymi linkami do plików, podpisów i dokumentów wejściowych.

Parametry:

• form: nazwa formularza, dla którego będą subskrybowane zaktualizowane zdarzenia wprowadzania.

EntryDeleted

Zostanie to wyzwolone po usunięciu wpisu dla określonego formularza. Dane wyjściowe będą danymi wejściowymi, z wyłączeniem linków.

Parametry:

• form: nazwa formularza, dla którego zostaną zasubskrybowane zdarzenia usunięte wpisów.

Czynności

CreateEntry

Ta akcja spowoduje utworzenie wpisu dla określonego formularza. Akcja będzie zawierać właściwości tabeli settable dla każdego pola wejścia, z wyłączeniem niektórych typów pól. Dane wyjściowe będą danymi wejściowymi.

Parametry:

• form: wewnętrzna nazwa formularza lub identyfikator

EditEntry

Ta akcja spowoduje zaktualizowanie istniejącego wpisu dla określonego formularza. Akcja będzie zawierać właściwości tabeli settable dla każdego pola wejścia, z wyłączeniem niektórych typów pól. Ta akcja zakończy się niepowodzeniem, jeśli wpis zawiera płatne zamówienie lub identyfikator entryId nie istnieje. Dane wyjściowe będą zaktualizowanymi danymi wejściowymi.

Parametry:

• form: wewnętrzna nazwa formularza lub identyfikator
• entryId: numer wpisu lub identyfikator wpisu, który ma zostać zaktualizowany

SetFormAvailability

Ta akcja spowoduje ustawienie ustawień dostępności limitu formularza. Parametry start i end powinny być puste, aby cały czas udostępnić formularz. Dane wyjściowe będą zaktualizowanymi ustawieniami dostępności.

Parametry:

• form: wewnętrzna nazwa formularza lub identyfikator
• start: data/godzina udostępnienia formularza.
• end: data/godzina, w której formularz nie powinien być już dostępny.
• message: Komunikat, który powinien być wyświetlany użytkownikom, którzy próbują uzyskać dostęp do formularza poza okresem dostępności.

GetFile

Ta akcja spowoduje pobranie pliku z magazynu. Dane wyjściowe będą obiektem zawierającym dane pliku, metadane i tymczasowy link do pliku.

Parametry:

• id: identyfikator pliku do pobrania.

GetDocument

Ta akcja spowoduje wygenerowanie i pobranie dokumentu wpisu przy użyciu określonego formularza, wpisu i szablonu. Dane wyjściowe będą obiektem zawierającym dane pliku dokumentu, metadane i tymczasowy link do dokumentu.

Parametry:

• form: wewnętrzna nazwa formularza lub identyfikator
• entry: identyfikator wpisu lub numer wpisu, dla którego powinien zostać wygenerowany dokument
• templateNumber: liczba szablonu, który powinien zostać użyty do wygenerowania dokumentu wpisu

GetEntry

Ta akcja spowoduje pobranie istniejącego wpisu dla określonego formularza. Ta akcja zakończy się niepowodzeniem, jeśli wpis nie istnieje. Dane wyjściowe będą danymi wejściowymi.

Parametry:

• form: wewnętrzna nazwa formularza lub identyfikator
• entryId: numer wpisu lub identyfikator wpisu, który ma zostać pobrany

DeleteEntry

Ta akcja spowoduje usunięcie istniejącego wpisu dla określonego formularza. Ta akcja zakończy się niepowodzeniem, jeśli wpis nie istnieje. Nie będzie żadnych danych wyjściowych.

Parametry:

• form: wewnętrzna nazwa formularza lub identyfikator
• entryId: numer wpisu lub identyfikator wpisu, który ma zostać usunięty

Operacje prywatne

Te operacje są elementami włączania dla publicznych wyzwalaczy i akcji.

GetForms

Ta operacja zwróci listę formularzy jako obiektów zawierających Idobiekty , InternalNamei Name. W przypadku użycia parametru form dla akcji i wyzwalaczy użytkownik powinien zobaczyć Nameelement , ale InternalName powinien zostać wysłany do interfejsu API.

GetFormSchema

Ta operacja zwróci schemat dla określonego formularza. Parametr input powinien mieć wartość true dla akcji, aby wykluczyć właściwości tylko do odczytu i wartość false dla wyzwalaczy w celu uwzględnienia wszystkich właściwości. Parametr includeLinks powinien mieć wartość true dla wszystkich akcji i wyzwalaczy z wyjątkiem parametru EntryDeleted.

Parametry:

• form: wewnętrzna nazwa formularza lub identyfikator
• input: wartość logiczna wskazująca, czy zwrócony schemat powinien wykluczać właściwości, których nie można ustawić. Domyślnie false.
• includeLinks: wartość logiczna wskazująca, czy właściwości łącza dla plików, podpisów i dokumentów powinny być zawarte w schemacie. Wartość true domyślnie.

Anuluj subskrypcję elementuWebhook

Ta operacja anuluje subskrypcję określonego elementu webhook. Element webhook nie będzie już otrzymywać żadnych zdarzeń po wysłaniu wszystkich aktualnie zdarzeń w kolejce.

Parametry:

• id: identyfikator elementu webhook, który powinien zostać anulowany.
• module: moduł elementu webhook. Powinno to być ustawione na "formularze", ponieważ ten łącznik obsługuje tylko ten moduł.

Uzyskiwanie poświadczeń

Właściciel organizacji musi zalogować się do aplikacji Cognito Forms i autoryzować połączenie.

Znane problemy

Żaden

Instrukcje dotyczące wdrażania

Aplikacja Cognito Forms wymaga prawidłowego Client id elementu i Client secret utworzenia łącznika. Te właściwości można znaleźć w magazynie kluczy i powinny być ustawione tylko w ustawieniach uwierzytelniania łącznika niestandardowego.

1. Run:

    paconn create --api-def apiDefinition.swagger.json --api-prop apiProperties.json
   

2. Zaloguj się do programu PowerAutomate

3. Przejdź do nowego łącznika

4. W obszarze "Zabezpieczenia" zaktualizuj element Client id i Client secret

5. Aktualizowanie łącznika

Limity ograniczania

Nazwa	Wywołania	Okres odnowienia
Wywołania interfejsu API na połączenie	100	60 sekund

Akcje

Aktualizowanie wpisu	Aktualizuje wpis.
Pobieranie dokumentu	Pobiera dokument
Pobieranie pliku	Pobiera plik według identyfikatora
Tworzenie wpisu	Tworzy nowy wpis.
Ustawianie dostępności formularza	Ustawia dostępność formularza.
Usuń wpis	Usuń wpis.
Uzyskiwanie wpisu	Pobiera wpis.

Aktualizowanie wpisu

Pobieranie dokumentu

Pobieranie pliku

Tworzenie wpisu

Ustawianie dostępności formularza

Usuń wpis

Uzyskiwanie wpisu

Wyzwalacze

Po usunięciu wpisu	Wyzwala, gdy ktoś usunie wpis.
Po utworzeniu nowego wpisu	Wyzwala, gdy ktoś utworzy nowy wpis.
Po zaktualizowaniu wpisu	Wyzwala, gdy ktoś aktualizuje wpis.

Po usunięciu wpisu

Po utworzeniu nowego wpisu

Po zaktualizowaniu wpisu

Definicje

FileDataRef

FormAvailability