Sdílet prostřednictvím

Cognito Forms

Cognito Forms umožňuje snadno vytvářet výkonné online formuláře, jako jsou průzkumy, formuláře objednávek, registrační formuláře a další. Zdarma.

Tento konektor je dostupný v následujících produktech a oblastech:

Service Class Regions
Copilot Studio Standard Všechny oblasti Power Automate kromě následujících:
     – státní správa USA (GCC)
     – státní správa USA (GCC High)
     - China Cloud provozovaný společností 21Vianet
     - Ministerstvo obrany USA (DoD)
Logic Apps Standard Všechny oblasti Logic Apps s výjimkou následujících:
     – Azure Government oblastí
     – Azure oblasti Čína
     - Ministerstvo obrany USA (DoD)
Power Apps Standard Všechny oblasti Power Apps s výjimkou následujících:
     – státní správa USA (GCC)
     – státní správa USA (GCC High)
     - China Cloud provozovaný společností 21Vianet
     - Ministerstvo obrany USA (DoD)
Power Automate Standard Všechny oblasti Power Automate kromě následujících:
     – státní správa USA (GCC)
     – státní správa USA (GCC High)
     - China Cloud provozovaný společností 21Vianet
     - Ministerstvo obrany USA (DoD)
Kontakt
Název Podpora pro Cognito Forms
URL https://www.cognitoforms.com/support
Email support@cognitoforms.com
Metadata konektoru
Publisher Cognito Forms
Internetová stránka https://www.cognitoforms.com
Zásady ochrany osobních údajů https://www.cognitoforms.com/legal/privacy
Kategorie Produktivita; Spolupráce

Cognito Forms

Cognito Forms umožňuje snadno vytvářet výkonné online formuláře, jako jsou průzkumy, formuláře objednávek, registrační formuláře a další. Zdarma. Nápovědu k našemu veřejnému konektoru Power Automate najdete v naší dokumentaci k podporu nebo .

Publisher: Cognito Forms

Požadavky

Vyžaduje se placené předplatné.

Podporované operace

Triggers

Triggery se posílají krátce po přihlášení k odběru události.

NewEntry

Tato akce se aktivuje při vytvoření nové položky pro zadaný formulář. Výstupem budou vstupní data, včetně dat souborů a dočasných odkazů na soubory, podpisy a vstupní dokumenty.

Parametry:
  • form: Název formuláře, pro který se budou odebírat události nové položky.

UpdateEntry

Tato akce se aktivuje při aktualizaci položky pro zadaný formulář. Výstupem budou vstupní data, včetně dat souborů a dočasných odkazů na soubory, podpisy a vstupní dokumenty.

Parametry:
  • form: Název formuláře, pro který se budou odebírat aktualizované události položky.

EntryDeleted

Tato akce se aktivuje při odstranění položky pro zadaný formulář. Výstupem budou vstupní data s výjimkou odkazů.

Parametry:
  • form: Název formuláře, pro který se budou odebírat odstraněné události.

Akce

CreateEntry

Tato akce vytvoří položku pro zadaný formulář. Akce bude obsahovat nastavitelné vlastnosti pro každé pole položky s výjimkou některých typů polí. Výstupem budou vstupní data.

Parametry:
  • form: Název nebo ID interního formuláře

EditEntry

Tato akce aktualizuje existující položku pro zadaný formulář. Akce bude obsahovat nastavitelné vlastnosti pro každé pole položky s výjimkou některých typů polí. Tato akce selže, pokud položka obsahuje placenou objednávku nebo id položky neexistuje. Výstupem budou aktualizovaná vstupní data.

Parametry:
  • form: Název nebo ID interního formuláře
  • entryId: Číslo položky nebo ID položky, které se má aktualizovat.

SetFormAvailability

Tato akce nastaví nastavení limitu dostupnosti formuláře. Parametry start a end parametry by měly být prázdné, aby byl formulář dostupný po celou dobu. Výstupem bude aktualizované nastavení dostupnosti.

Parametry:
  • form: Název nebo ID interního formuláře
  • start: Datum a čas, ve kterém by měl být formulář k dispozici.
  • end: Datum a čas, kdy by formulář již neměl být k dispozici.
  • message: Zpráva, která by se měla zobrazit uživatelům, kteří se pokusí získat přístup k formuláři mimo dobu dostupnosti.

Získat soubor

Tato akce načte soubor z úložiště. Výstupem bude objekt obsahující data souboru, metadata a dočasné propojení se souborem.

Parametry:
  • id: ID souboru, který se má načíst.

GetDocument

Tato akce vygeneruje a načte vstupní dokument pomocí zadaného formuláře, položky a šablony. Výstupem bude objekt obsahující data souboru dokumentu, metadata a dočasný odkaz na dokument.

Parametry:
  • form: Název nebo ID interního formuláře
  • entry: ID položky nebo číslo položky, pro kterou má být dokument generován.
  • templateNumber: Číslo šablony, která se má použít k vygenerování vstupního dokumentu

GetEntry

Tato akce získá existující položku pro zadaný formulář. Tato akce selže, pokud položka neexistuje. Výstupem budou vstupní data.

Parametry:
  • form: Název nebo ID interního formuláře
  • entryId: Číslo položky nebo ID položky, které se má načíst.

DeleteEntry

Tato akce odstraní existující položku pro zadaný formulář. Tato akce selže, pokud položka neexistuje. Nebude k dispozici žádný výstup.

Parametry:
  • form: Název nebo ID interního formuláře
  • entryId: Číslo položky nebo ID položky, které se má odstranit.

ImportEntries

Tato akce vytvoří, aktualizuje nebo odstraní položky pomocí zadaného obsahu souboru (.xlsx nebo .csv). Výstupem bude objekt obsahující ID a stav importu.

Parametry:
  • form: Název nebo ID interního formuláře
  • File: Soubor (.xlsx nebo .csv) obsahující položky k importu
  • ImportMode: Režim importu (CreateNew, UpdateExisting nebo SyncEntries)
  • Email: E-mailová adresa pro příjem oznámení o importu (volitelné)
  • MatchEntriesUsing: Náhrada ID položky (volitelné)

GetImportStatus

Tato akce získá aktuální stav importu a vrátí počet úspěšných a neúspěšných položek. Výstupem bude objekt obsahující stav importu, počty a informace o chybě, pokud je to možné.

Parametry:
  • form: Název nebo ID interního formuláře
  • importId: ID importu ke kontrole stavu

Uploadfile

Tato akce nahraje soubor do Cognito Forms.

Parametry:
  • fileContent: Binární data souboru
  • fileName: Název souboru

GetEntryViewEntries

Tato akce získá všechny položky pro zadané zobrazení. Výstupem budou vstupní data na základě konfigurace zobrazení.

Parametry:
  • form: Název nebo ID interního formuláře
  • viewId: ID zobrazení
  • $count: Zahrnout celkový počet položek (volitelné)
  • $select: Vrátí seznam ID položek v zobrazení, pokud je zadána $select=ID (volitelné).

Privátní operace

Tyto operace jsou povolením pro veřejné triggery a akce.

GetForms

Tato operace vrátí seznam formulářů jako objekty, které obsahují a IdName. Při použití parametru form pro akce a triggery by měl uživatel vidět Name, ale Id měl by být odeslán do rozhraní API. Archivované formuláře nejsou součástí odpovědi.

GetFormSchema

Tato operace vrátí schéma pro zadaný formulář. Parametr input by měl být pravdivý pro akce, které mají vyloučit vlastnosti jen pro čtení a false pro triggery, aby zahrnovaly všechny vlastnosti. Parametr includeLinks by měl být pravdivý pro všechny akce a triggery s výjimkou EntryDeleted.

Parametry:
  • form: Název nebo ID interního formuláře
  • input: Logická hodnota označující, zda má vrácené schéma vyloučit vlastnosti, které nelze nastavit. Ve výchozím nastavení je false.
  • includeLinks: Logická hodnota označující, zda mají být ve schématu zahrnuty vlastnosti propojení pro soubory, podpisy a dokumenty. True ve výchozím nastavení.

Odhlášení odběruWebhooku

Tato operace zruší odběr zadaného webhooku. Webhook už nebude po odeslání všech aktuálně zařazených událostí do fronty přijímat žádné události.

Parametry:
  • id: ID webhooku, který by se měl odhlásit.
  • module: Modul webhooku. Tento konektor by měl být nastavený na "formuláře", protože tento konektor podporuje pouze tento modul.

Získání přihlašovacích údajů

Vlastník organizace se musí přihlásit k Cognito Forms a autorizovat připojení.

Známé problémy

None

Pokyny k nasazení

Cognito Forms vyžaduje platný Client id konektor a Client secret vytvořit ho. Tyto vlastnosti najdete v trezoru klíčů a měly by být nastaveny pouze v nastavení ověřování vlastního konektoru.

  1. Běh:

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

  2. Přihlášení k PowerAutomate

  3. Přechod na nový konektor

  4. V části Zabezpečení aktualizujte Client idClient secret

  5. Aktualizace konektoru

Limity omezování

Name Volání Období obnovení
Volání rozhraní API na připojení 100 60 sekund

Akce

Aktualizovat položku

Aktualizuje položku.
Nastavení dostupnosti formuláře

Nastaví dostupnost formuláře.
Odstranit položku

Odstraňte položku.
Vytvořit položku

Vytvoří novou položku.
Získání dokumentu

Získá dokument.
Získání položky

Získá položku.
Získání souboru

Získá soubor podle ID.

Aktualizovat položku

ID operace:
EditEntry

Aktualizuje položku.

Parametry

Name Klíč Vyžadováno Typ Description
Formulář
 form True string

Název formuláře
ID položky
 entryId True string

ID položky
Entry
 entry True dynamic

Aktualizovaná vstupní data

Návraty

Výstupy této operace jsou dynamické.

Nastavení dostupnosti formuláře

ID operace:
SetFormAvailability

Nastaví dostupnost formuláře.

Parametry

Name Klíč Vyžadováno Typ Description
Formulář
 form True string

Název formuláře
Zahájení dostupnosti
 start date-time

Datum zahájení dostupnosti
Konec dostupnosti
 end date-time

Koncové datum dostupnosti
Zpráva není k dispozici
 message string

Zpráva není k dispozici

Návraty

Informace o dostupnosti formulářů, jako je počáteční/koncová dostupnost, a ne dostupná zpráva.

Body
FormAvailability

Odstranit položku

ID operace:
DeleteEntry

Odstraňte položku.

Parametry

Name Klíč Vyžadováno Typ Description
Formulář
 form True string

Název formuláře
ID položky
 entryId True string

ID položky

Návraty

Výstupy této operace jsou dynamické.

Vytvořit položku

ID operace:
CreateEntry

Vytvoří novou položku.

Parametry

Name Klíč Vyžadováno Typ Description
Formulář
 form True string

Název formuláře
Entry
 entry True dynamic

Položka, která se má vytvořit pro formulář

Návraty

Výstupy této operace jsou dynamické.

Získání dokumentu

ID operace:
GetDocument

Získá dokument.

Parametry

Name Klíč Vyžadováno Typ Description
Formulář
 form True string

Název formuláře
ID položky
 entry True string

ID položky
Číslo šablony
 templateNumber True integer

Číslo šablony

Návraty

Odkaz na soubor, který obsahuje data a metadata souborů

Body
FileDataRef

Získání položky

ID operace:
GetEntry

Získá položku.

Parametry

Name Klíč Vyžadováno Typ Description
Formulář
 form True string

Název formuláře
ID položky
 entryId True string

ID položky

Návraty

Výstupy této operace jsou dynamické.

Získání souboru

ID operace:
GetFile

Získá soubor podle ID.

Parametry

Name Klíč Vyžadováno Typ Description
ID souboru
 id True string

Jedinečný identifikátor souboru

Návraty

Odkaz na soubor, který obsahuje data a metadata souborů

Body
FileDataRef

Aktivační události

Při aktualizaci položky

Aktivuje se, když někdo aktualizuje položku.
Při odstranění položky

Aktivuje se, když někdo odstraní položku.
Při vytvoření nové položky

Aktivuje se, když někdo vytvoří novou položku.

Při aktualizaci položky

ID operace:
UpdateEntry

Aktivuje se, když někdo aktualizuje položku.

Parametry

Name Klíč Vyžadováno Typ Description
Formulář
 publisher True string

Název formuláře

Návraty

Výstupy této operace jsou dynamické.

Při odstranění položky

ID operace:
EntryDeleted

Aktivuje se, když někdo odstraní položku.

Parametry

Name Klíč Vyžadováno Typ Description
Formulář
 publisher True string

Název formuláře

Návraty

Výstupy této operace jsou dynamické.

Při vytvoření nové položky

ID operace:
NewEntry

Aktivuje se, když někdo vytvoří novou položku.

Parametry

Name Klíč Vyžadováno Typ Description
Formulář
 publisher True string

Název formuláře

Návraty

Výstupy této operace jsou dynamické.

Definice

FileDataRef

Odkaz na soubor, který obsahuje data a metadata souborů

Name Cesta Typ Description
ID souboru
 Id string

Jedinečné ID souboru.
Název souboru
 Name string

Název souboru
Typ obsahu souboru
 ContentType string

Typ obsahu souboru.
Velikost souboru
 Size integer

Velikost souboru.
Adresa URL souboru
 File string

Adresa URL souboru.
Obsah souboru
 Content byte

Obsah souboru

Dostupnost formuláře

Informace o dostupnosti formulářů, jako je počáteční/koncová dostupnost, a ne dostupná zpráva.

Name Cesta Typ Description
Zahájení dostupnosti formuláře
 availabilityStart date-time

Zahájení dostupnosti formuláře
Konec dostupnosti formuláře
 availabilityEnd date-time

Konec dostupnosti formuláře
Zpráva o nedostupné
 notAvailableMessage string

Zpráva o nedostupné