Cognito Forms

Cognito Forms je online tvůrce formulářů pro shromažďování a správu dat odeslání. Tento konektor umožňuje automatické toky aktivovat při vytváření, aktualizaci nebo odstranění položek a poskytuje akce pro vytváření, aktualizaci a načítání položek. Integrujte Cognito Forms s dalšími službami pro směrování dat, zpracování nahraných souborů a automatizaci obchodních pracovních postupů.

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)
Automatizace napájení	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, LLC
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.

Běh:

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

Přihlášení k PowerAutomate
Přechod na nový konektor
V části Zabezpečení aktualizujte Client idClient secret
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.
Import položek	Vytvoří, aktualizuje nebo odstraní položky pomocí zadaného obsahu souboru.
Nastavení dostupnosti formuláře	Nastaví dostupnost formuláře.
Odeslat soubor	Nahraje soubor, který se použije v položkách formuláře.
Odstranit položku	Odstraňte položku.
Vytvořit položku	Vytvoří novou položku.
Získat soubor	Získá soubor podle ID.
Získání dokumentu	Získá dokument.
Získání položek formuláře	Získání všech položek pro zadané zobrazení
Získání položky	Získá položku.
Získání stavu importu	Získá aktuální stav importu a vrátí počet úspěšných a neúspěšných položek.

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é.

Import položek

ID operace:: ImportEntries

Vytvoří, aktualizuje nebo odstraní položky pomocí zadaného obsahu souboru.

Parametry

Name	Klíč	Vyžadováno	Typ	Description
Formulář	form	True	string	Název formuláře
Import souboru	File	True	file	Soubor (.xlsx nebo .csv) obsahující položky k importu.
Režim importu	ImportMode	True	string	Režim importu
E-mail s oznámením	Email		email	E-mailová adresa pro příjem oznámení o importu
Shoda pole	MatchEntriesUsing		string	Náhrada ID položky

Návraty

Name	Cesta	Typ	Description
identifikační číslo	Id	string	ID importu
Stav	Status	string	Stav importu
Chybová zpráva	ErrorMessage	string	Zpráva popisující, proč se import nezdařil

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

Odeslat soubor

ID operace:: UploadFile

Nahraje soubor, který se použije v položkách formuláře.

Parametry

Name	Klíč	Vyžadováno	Typ	Description
File	File	True	file	Soubor, který chcete nahrát.

Návraty

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 v bajtech

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

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ískat soubor

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

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žek formuláře

ID operace:: GetEntryViewEntries

Získání všech položek pro zadané zobrazení

Parametry

Name	Klíč	Vyžadováno	Typ	Description
Formulář	form	True	string	Název formuláře
ID zobrazení	viewId	True	string	ID zobrazení
Zahrnout počet	$count		string	Zahrnout celkový počet položek
Vybrat ID	$select		string	Vrátí seznam ID položek v zobrazení při zadání $select=ID.

Návraty

response: object

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í stavu importu

ID operace:: GetImportStatus

Získá aktuální stav importu a vrátí počet úspěšných a neúspěšných položek.

Parametry

Name	Klíč	Vyžadováno	Typ	Description
Formulář	form	True	string	Název formuláře
ID importu	importId	True	string	ID importu

Návraty

Name	Cesta	Typ	Description
identifikační číslo	Id	string	ID importu
Stav	Status	string	Stav importu
Chybová zpráva	ErrorMessage	string	Zpráva popisující, proč se import nezdařil
Úspěšnéenty	SuccessfulEntries	integer	Počet úspěšně importovaných položek
Neúspěšnéenty	UnsuccessfulEntries	integer	Počet položek, které se nepodařilo importovat
TotalEntries	TotalEntries	integer	Celkový počet položek v importu
ImportLink	ImportLink	string	Odkaz na stránku položek ke stažení souboru s poznámkami

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é

objekt

Toto je typ "object".