Formularze Cognito

Cognito Forms to konstruktor formularzy online do zbierania danych przesyłania i zarządzania nimi. Ten łącznik umożliwia automatyczne przepływy wyzwalanie podczas tworzenia, aktualizowania lub usuwania wpisów oraz udostępnia akcje tworzenia, aktualizowania i pobierania wpisów. Integrowanie aplikacji Cognito Forms z innymi usługami w celu kierowania danych, przetwarzania przekazanych plików i automatyzowania przepływów pracy biznesowych.

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

Usługa Class Regions
Copilot Studio Standard Wszystkie regiony 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:
     - Azure Government regionów
     - Azure regionach Chin
     - Departament Obrony USA (DoD)
Power Apps Standard Wszystkie regiony 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 - narzędzie do automatyzacji procesów Standard Wszystkie regiony 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 Cognito Forms, LLC
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ą support lub contact us aby uzyskać pomoc dotyczącą naszego publicznego łącznika Power Automate.

Publisher: 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

ImportEntries

Ta akcja spowoduje utworzenie, zaktualizowanie lub usunięcie wpisów przy użyciu udostępnionej zawartości pliku (.xlsx lub .csv). Dane wyjściowe będą obiektem zawierającym identyfikator importu i stan.

Parametry:
  • form: wewnętrzna nazwa formularza lub identyfikator
  • File: plik (.xlsx lub .csv) zawierający wpisy do zaimportowania
  • ImportMode: tryb importowania (CreateNew, UpdateExisting lub SyncEntries)
  • Email: adres e-mail do odbierania powiadomień importowych (opcjonalnie)
  • MatchEntriesUsing: Zastępca identyfikatora wpisu (opcjonalnie)

GetImportStatus

Ta akcja spowoduje pobranie bieżącego stanu importu i zwrócenie liczby pomyślnych i nieudanych wpisów. Dane wyjściowe będą obiektem zawierającym stan importu, liczby i informacje o błędzie, jeśli ma to zastosowanie.

Parametry:
  • form: wewnętrzna nazwa formularza lub identyfikator
  • importId: Identyfikator importu, aby sprawdzić stan dla

Uploadfile

Ta akcja spowoduje przekazanie pliku do aplikacji Cognito Forms.

Parametry:
  • fileContent: dane binarne pliku
  • fileName: nazwa pliku

GetEntryViewEntries

Ta akcja spowoduje pobranie wszystkich wpisów dla określonego widoku. Dane wyjściowe będą danymi wejściowymi na podstawie konfiguracji widoku.

Parametry:
  • form: wewnętrzna nazwa formularza lub identyfikator
  • viewId: identyfikator widoku
  • $count: Uwzględnij łączną liczbę wpisów (opcjonalnie)
  • $select: Zwraca listę identyfikatorów wpisu w widoku, gdy określono $select=Id (opcjonalnie)

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 Id obiekty i Name. W przypadku użycia parametru form dla akcji i wyzwalaczy użytkownik powinien zobaczyć Nameelement , ale Id powinien zostać wysłany do interfejsu API. Zarchiwizowane formularze nie są uwzględniane w odpowiedzi.

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.
Importowanie wpisów

Tworzy, aktualizuje lub usuwa wpisy przy użyciu udostępnionej zawartości pliku.
Pobieranie dokumentu

Pobiera dokument
Pobieranie pliku

Pobiera plik według identyfikatora.
Pobieranie wpisów formularza

Pobieranie wszystkich wpisów dla określonego widoku
Przekaż plik

Przekazuje plik do użycia w wpisach formularza.
Tworzenie wpisu

Tworzy nowy wpis.
Ustawianie dostępności formularza

Ustawia dostępność formularza.
Usuń wpis

Usuń wpis.
Uzyskiwanie stanu importu

Pobiera bieżący stan importu i zwraca liczbę pomyślnych i nieudanych wpisów.
Uzyskiwanie wpisu

Pobiera wpis.

Aktualizowanie wpisu

Identyfikator operacji:
EditEntry

Aktualizuje wpis.

Parametry

Nazwa Klucz Wymagane Typ Opis
Form
 form True string

Nazwa formularza
Identyfikator wpisu
 entryId True string

Identyfikator wpisu
Entry
 entry True dynamic

Zaktualizowane dane wprowadzania

Zwraca

Dane wyjściowe tej operacji są dynamiczne.

Importowanie wpisów

Identyfikator operacji:
ImportEntries

Tworzy, aktualizuje lub usuwa wpisy przy użyciu udostępnionej zawartości pliku.

Parametry

Nazwa Klucz Wymagane Typ Opis
Form
 form True string

Nazwa formularza
Importowanie pliku
 File True file

Plik (.xlsx lub .csv) zawierający wpisy do zaimportowania.
Tryb importu
 ImportMode True string

Tryb importowania
Wiadomość e-mail z powiadomieniem
 Email email

Adres e-mail do odbierania powiadomień importowania
Dopasuj pole
 MatchEntriesUsing string

Zastępowanie identyfikatora wpisu

Zwraca

Nazwa Ścieżka Typ Opis
Id
 Id string

Identyfikator importu
Status
 Status string

Stan importu
Komunikat o błędzie
 ErrorMessage string

Komunikat opisujący, dlaczego importowanie nie powiodło się

Pobieranie dokumentu

Identyfikator operacji:
GetDocument

Pobiera dokument

Parametry

Nazwa Klucz Wymagane Typ Opis
Form
 form True string

Nazwa formularza
Identyfikator wpisu
 entry True string

Identyfikator wpisu
Numer szablonu
 templateNumber True integer

Numer szablonu

Zwraca

Odwołanie do pliku zawierające dane pliku i metadane

Body
FileDataRef

Pobieranie pliku

Identyfikator operacji:
GetFile

Pobiera plik według identyfikatora.

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator pliku
 id True string

Unikatowy identyfikator pliku

Zwraca

Odwołanie do pliku zawierające dane pliku i metadane

Body
FileDataRef

Pobieranie wpisów formularza

Identyfikator operacji:
GetEntryViewEntries

Pobieranie wszystkich wpisów dla określonego widoku

Parametry

Nazwa Klucz Wymagane Typ Opis
Form
 form True string

Nazwa formularza
Identyfikator widoku
 viewId True string

Identyfikator widoku
Liczba uwzględnień
 $count string

Uwzględnij łączną liczbę wpisów
Wybieranie identyfikatorów
 $select string

Zwraca listę identyfikatorów pozycji w widoku, gdy określono $select=Id

Zwraca

response
object

Przekaż plik

Identyfikator operacji:
UploadFile

Przekazuje plik do użycia w wpisach formularza.

Parametry

Nazwa Klucz Wymagane Typ Opis
File
 File True file

Plik do przekazania.

Zwraca

Nazwa Ścieżka Typ Opis
Identyfikator pliku
 Id string

Unikatowy identyfikator pliku.
Nazwa pliku
 Name string

Nazwa pliku
Typ zawartości pliku
 ContentType string

Typ zawartości pliku.
Rozmiar pliku
 Size integer

Rozmiar pliku w bajtach.

Tworzenie wpisu

Identyfikator operacji:
CreateEntry

Tworzy nowy wpis.

Parametry

Nazwa Klucz Wymagane Typ Opis
Form
 form True string

Nazwa formularza
Entry
 entry True dynamic

Wpis do utworzenia formularza

Zwraca

Dane wyjściowe tej operacji są dynamiczne.

Ustawianie dostępności formularza

Identyfikator operacji:
SetFormAvailability

Ustawia dostępność formularza.

Parametry

Nazwa Klucz Wymagane Typ Opis
Form
 form True string

Nazwa formularza
Rozpoczęcie dostępności
 start date-time

Data rozpoczęcia dostępności
Koniec dostępności
 end date-time

Data zakończenia dostępności
Komunikat niedostępny
 message string

Komunikat niedostępny

Zwraca

Informacje o dostępności formularza, takie jak dostępność początkowa/końcowa i niedostępny komunikat.

Body
FormAvailability

Usuń wpis

Identyfikator operacji:
DeleteEntry

Usuń wpis.

Parametry

Nazwa Klucz Wymagane Typ Opis
Form
 form True string

Nazwa formularza
Identyfikator wpisu
 entryId True string

Identyfikator wpisu

Uzyskiwanie stanu importu

Identyfikator operacji:
GetImportStatus

Pobiera bieżący stan importu i zwraca liczbę pomyślnych i nieudanych wpisów.

Parametry

Nazwa Klucz Wymagane Typ Opis
Form
 form True string

Nazwa formularza
Identyfikator importu
 importId True string

Identyfikator importu

Zwraca

Nazwa Ścieżka Typ Opis
Id
 Id string

Identyfikator importu
Status
 Status string

Stan importu
Komunikat o błędzie
 ErrorMessage string

Komunikat opisujący, dlaczego importowanie nie powiodło się
Powodzenieentries
 SuccessfulEntries integer

Liczba wpisów pomyślnie zaimportowanych
Nieudane
 UnsuccessfulEntries integer

Liczba wpisów, których nie można zaimportować
TotalEntries
 TotalEntries integer

Całkowita liczba wpisów w importze
ImportLink
 ImportLink string

Link do strony wpisów w celu pobrania pliku z adnotacjami

Uzyskiwanie wpisu

Identyfikator operacji:
GetEntry

Pobiera wpis.

Parametry

Nazwa Klucz Wymagane Typ Opis
Form
 form True string

Nazwa formularza
Identyfikator wpisu
 entryId True string

Identyfikator wpisu

Zwraca

Dane wyjściowe tej operacji są dynamiczne.

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

Identyfikator operacji:
EntryDeleted

Wyzwala, gdy ktoś usunie wpis.

Parametry

Nazwa Klucz Wymagane Typ Opis
Form
 publisher True string

Nazwa formularza

Zwraca

Dane wyjściowe tej operacji są dynamiczne.

Po utworzeniu nowego wpisu

Identyfikator operacji:
NewEntry

Wyzwala, gdy ktoś utworzy nowy wpis.

Parametry

Nazwa Klucz Wymagane Typ Opis
Form
 publisher True string

Nazwa formularza

Zwraca

Dane wyjściowe tej operacji są dynamiczne.

Po zaktualizowaniu wpisu

Identyfikator operacji:
UpdateEntry

Wyzwala, gdy ktoś aktualizuje wpis.

Parametry

Nazwa Klucz Wymagane Typ Opis
Form
 publisher True string

Nazwa formularza

Zwraca

Dane wyjściowe tej operacji są dynamiczne.

Definicje

FileDataRef

Odwołanie do pliku zawierające dane pliku i metadane

Nazwa Ścieżka Typ Opis
Identyfikator pliku
 Id string

Unikatowy identyfikator pliku.
Nazwa pliku
 Name string

Nazwa pliku
Typ zawartości pliku
 ContentType string

Typ zawartości pliku.
Rozmiar pliku
 Size integer

Rozmiar pliku.
Adres URL pliku
 File string

Adres URL pliku.
Zawartość pliku
 Content byte

Zawartość pliku

FormAvailability

Informacje o dostępności formularza, takie jak dostępność początkowa/końcowa i niedostępny komunikat.

Nazwa Ścieżka Typ Opis
Rozpoczęcie dostępności formularza
 availabilityStart date-time

Rozpoczęcie dostępności formularza
Koniec dostępności formularza
 availabilityEnd date-time

Koniec dostępności formularza
Komunikat niedostępny
 notAvailableMessage string

Komunikat niedostępny

obiekt

Jest to typ "object".