Cognito-formulieren

Cognito Forms is een online formulierbouwer voor het verzamelen en beheren van indieningsgegevens. Met deze connector kunnen geautomatiseerde stromen worden geactiveerd wanneer items worden gemaakt, bijgewerkt of verwijderd en acties worden geboden voor het maken, bijwerken en ophalen van items. Integreer Cognito Forms met andere services om gegevens te routeren, geüploade bestanden te verwerken en zakelijke werkstromen te automatiseren.

Deze connector is beschikbaar in de volgende producten en regio's:

Dienst	Class	Regions
Copilot Studio	Standaard	Alle Power Automate regio's behalve: - Amerikaanse overheid (GCC) - Amerikaanse overheid (GCC High) - China Cloud beheerd door 21Vianet - Us Department of Defense (DoD)
Logic-apps	Standaard	Alle Logic Apps-regio's , met uitzondering van het volgende: - Azure Government regio's - Azure China-regio's - Us Department of Defense (DoD)
Power Apps	Standaard	Alle Power Apps regio's behalve: - Amerikaanse overheid (GCC) - Amerikaanse overheid (GCC High) - China Cloud beheerd door 21Vianet - Us Department of Defense (DoD)
Power Automate	Standaard	Alle Power Automate regio's behalve: - Amerikaanse overheid (GCC) - Amerikaanse overheid (GCC High) - China Cloud beheerd door 21Vianet - Us Department of Defense (DoD)

Contactpersoon
Naam	Ondersteuning voor Cognito-formulieren
URL	https://www.cognitoforms.com/support
E-mailen	support@cognitoforms.com

Connectormetagegevens
Publisher	Cognito Forms, LLC
Webpagina	https://www.cognitoforms.com
Privacybeleid	https://www.cognitoforms.com/legal/privacy
Categorieën	Productiviteit; Samenwerking

Cognito-formulieren

Met Cognito Forms kunt u eenvoudig krachtige onlineformulieren maken, zoals enquêtes, bestelformulieren, registratieformulieren en meer. Gratis. Raadpleeg onze documentatie ondersteuning of neem contact met ons op voor hulp bij onze openbare Power Automate-connector.

Publisher: Cognito-formulieren

Vereiste voorwaarden

Er is een betaald abonnement vereist.

Ondersteunde bewerkingen

Triggers

Triggers worden kort nadat de geabonneerde gebeurtenis plaatsvindt verzonden.

NewEntry

Dit wordt geactiveerd wanneer er een nieuwe vermelding wordt gemaakt voor het opgegeven formulier. De uitvoer zijn de invoergegevens, inclusief bestandsgegevens en tijdelijke koppelingen naar bestanden, handtekeningen en invoerdocumenten.

Parameters:

form: De naam van het formulier waarvoor nieuwe itemgebeurtenissen worden geabonneerd.

UpdateEntry

Dit wordt geactiveerd wanneer een vermelding voor het opgegeven formulier wordt bijgewerkt. De uitvoer zijn de invoergegevens, inclusief bestandsgegevens en tijdelijke koppelingen naar bestanden, handtekeningen en invoerdocumenten.

Parameters:

form: De naam van het formulier waarvoor bijgewerkte itemgebeurtenissen worden geabonneerd.

EntryDeleted

Dit wordt geactiveerd wanneer een vermelding voor het opgegeven formulier wordt verwijderd. De uitvoer is de invoergegevens, met uitzondering van koppelingen.

Parameters:

form: De naam van het formulier waarvoor verwijderde items worden geregistreerd.

Acties

CreateEntry

Met deze actie wordt een vermelding voor het opgegeven formulier gemaakt. De actie bevat settabeleigenschappen voor elk invoerveld, met uitzondering van sommige veldtypen. De uitvoer is de invoergegevens.

Parameters:

form: De naam of id van het interne formulier

EditEntry

Met deze actie wordt een bestaande vermelding voor het opgegeven formulier bijgewerkt. De actie bevat settabeleigenschappen voor elk invoerveld, met uitzondering van sommige veldtypen. Deze actie mislukt als de vermelding een betaalde bestelling bevat of de entryId niet bestaat. De uitvoer is de bijgewerkte invoergegevens.

Parameters:

form: De naam of id van het interne formulier
entryId: het invoernummer of de invoer-id voor de vermelding die moet worden bijgewerkt

SetFormAvailability

Met deze actie worden de limietinstellingen voor de beschikbaarheid van het formulier ingesteld. De start parameters moeten end leeg zijn om het formulier altijd beschikbaar te maken. De uitvoer is de bijgewerkte beschikbaarheidsinstellingen.

Parameters:

form: De naam of id van het interne formulier
start: De datum/tijd waarop het formulier beschikbaar moet komen.
end: De datum/tijd waarop het formulier niet meer beschikbaar mag zijn.
message: het bericht dat moet worden weergegeven aan gebruikers die het formulier proberen te openen wanneer ze zich buiten de beschikbaarheidsperiode bevinden.

GetFile

Met deze actie wordt een bestand opgehaald uit de opslag. De uitvoer is een object met de bestandsgegevens, de metagegevens en een tijdelijke koppeling naar het bestand.

Parameters:

id: de bestands-id voor het bestand dat moet worden opgehaald.

GetDocument

Met deze actie wordt een invoerdocument gegenereerd en opgehaald met behulp van het opgegeven formulier, de vermelding en de sjabloon. De uitvoer is een object met de bestandsgegevens van het document, de metagegevens en een tijdelijke koppeling naar het document.

Parameters:

form: De naam of id van het interne formulier
entry: De invoer-id of het invoernummer van de vermelding waarvoor het document moet worden gegenereerd
templateNumber: Het nummer van de sjabloon die moet worden gebruikt om het invoerdocument te genereren

GetEntry

Met deze actie wordt een bestaande vermelding voor het opgegeven formulier weergegeven. Deze actie mislukt als de vermelding niet bestaat. De uitvoer is de invoergegevens.

Parameters:

form: De naam of id van het interne formulier
entryId: het invoernummer of de invoer-id voor de vermelding die moet worden opgehaald

DeleteEntry

Met deze actie wordt een bestaande vermelding voor het opgegeven formulier verwijderd. Deze actie mislukt als de vermelding niet bestaat. Er is geen uitvoer.

Parameters:

form: De naam of id van het interne formulier
entryId: het itemnummer of de vermeldings-id voor de vermelding die moet worden verwijderd

ImportEntries

Met deze actie worden vermeldingen gemaakt, bijgewerkt of verwijderd met behulp van de opgegeven bestandsinhoud (.xlsx of .csv). De uitvoer is een object met de import-id en status.

Parameters:

form: De naam of id van het interne formulier
File: het bestand (.xlsx of .csv) met de vermeldingen die moeten worden geïmporteerd
ImportMode: De modus voor het importeren (CreateNew, UpdateExisting of SyncEntries)
Email: Het e-mailadres voor het ontvangen van importmeldingen (optioneel)
MatchEntriesUsing: Een vervangende vermeldings-id (optioneel)

GetImportStatus

Deze actie krijgt de huidige status van een import en retourneert het aantal geslaagde en mislukte vermeldingen. De uitvoer is een object met de importstatus, aantallen en foutinformatie, indien van toepassing.

Parameters:

form: De naam of id van het interne formulier
importId: de id van de import om de status te controleren op

UploadFile

Met deze actie wordt een bestand geüpload naar Cognito Forms.

Parameters:

fileContent: De binaire gegevens van het bestand
fileName: De naam van het bestand

GetEntryViewEntries

Met deze actie worden alle vermeldingen voor een opgegeven weergave weergegeven. De uitvoer is de invoergegevens op basis van de weergaveconfiguratie.

Parameters:

form: De naam of id van het interne formulier
viewId: De id van de weergave
$count: Het totale aantal vermeldingen opnemen (optioneel)
$select: retourneert een lijst met vermeldings-id's in een weergave wanneer $select=Id is opgegeven (optioneel)

Privébewerkingen

Deze bewerkingen zijn enablers voor de openbare triggers en acties.

GetForms

Met deze bewerking wordt een lijst met formulieren geretourneerd als objecten die de Id en Namebevatten. Wanneer deze wordt gebruikt voor de form parameter voor acties en triggers, moet de gebruiker de Name, maar de Id moet worden verzonden naar de API. Gearchiveerde formulieren worden niet opgenomen in het antwoord.

GetFormSchema

Met deze bewerking wordt het schema voor het opgegeven formulier geretourneerd. De input parameter moet waar zijn voor acties om alleen-lezeneigenschappen en onwaar uit te sluiten voor triggers om alle eigenschappen op te nemen. De includeLinks parameter moet waar zijn voor alle acties en triggers, met uitzondering van EntryDeleted.

Parameters:

form: De naam of id van het interne formulier
input: Een Booleaanse waarde die aangeeft of het geretourneerde schema eigenschappen moet uitsluiten die niet kunnen worden ingesteld. Standaard onwaar.
includeLinks: Een Booleaanse waarde die aangeeft of koppelingseigenschappen voor bestanden, handtekeningen en documenten moeten worden opgenomen in het schema. Is standaard waar.

UnsubscribeWebhook

Met deze bewerking wordt de opgegeven webhook afgemeld. De webhook ontvangt geen gebeurtenissen meer nadat alle momenteel in de wachtrij geplaatste gebeurtenissen zijn verzonden.

Parameters:

id: De id van de webhook die moet worden afgemeld.
module: de module van de webhook. Dit moet worden ingesteld op 'formulieren', omdat deze connector alleen ondersteuning biedt voor die module.

Referenties verkrijgen

Een eigenaar van de organisatie moet zich aanmelden bij Cognito Forms en de verbinding autoriseren.

Bekende problemen

Geen

Implementatie-instructies

Cognito Forms vereist een geldige Client id en Client secret om een connector te maken. Deze eigenschappen zijn te vinden in de sleutelkluis en mogen alleen worden ingesteld in de verificatie-instellingen van de aangepaste connector.

Rennen:

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

Aanmelden bij PowerAutomate
Ga naar de nieuwe connector
Werk onder 'Beveiligingsupdate' de Client id en Client secret
De connector bijwerken

Beperkingslimieten

Name	Aanroepen	Verlengingsperiode
API-aanroepen per verbinding	100	60 seconden

Acties

Beschikbaarheid van formulier instellen	Hiermee stelt u de beschikbaarheid van een formulier in.
Bestand ophalen	Hiermee haalt u een bestand op id op.
Bestand uploaden	Hiermee wordt een bestand geüpload dat moet worden gebruikt in formuliervermeldingen.
Document ophalen	Hiermee haalt u een document op
Formuliervermeldingen ophalen	Alle vermeldingen voor een opgegeven weergave ophalen
Importstatus ophalen	Haalt de huidige status van een import op en retourneert het aantal geslaagde en mislukte vermeldingen.
Item bijwerken	Hiermee wordt een vermelding bijgewerkt.
Item verwijderen	Een vermelding verwijderen.
Vermelding maken	Hiermee maakt u een nieuwe vermelding.
Vermelding ophalen	Hiermee haalt u een vermelding op.
Vermeldingen importeren	Hiermee worden vermeldingen gemaakt, bijgewerkt of verwijderd met behulp van opgegeven bestandsinhoud.

Beschikbaarheid van formulier instellen

Bewerkings-id:: SetFormAvailability

Hiermee stelt u de beschikbaarheid van een formulier in.

Parameters

Name	Sleutel	Vereist	Type	Description
Form	form	True	string	De naam van het formulier
Beschikbaarheid starten	start		date-time	Begindatum van beschikbaarheid
Einde van beschikbaarheid	end		date-time	Einddatum beschikbaarheid
Bericht niet beschikbaar	message		string	Bericht niet beschikbaar

Retouren

Formulierbeschikbaarheidsgegevens, zoals beschikbaarheid van begin/eind en niet beschikbaar bericht.

Body: FormAvailability

Bestand ophalen

Bewerkings-id:: GetFile

Hiermee haalt u een bestand op id op.

Parameters

Name	Sleutel	Vereist	Type	Description
Bestands-id	id	True	string	De unieke id van het bestand

Retouren

Een bestandsreferentie met bestandsgegevens en metagegevens

Body: FileDataRef

Bestand uploaden

Bewerkings-id:: UploadFile

Hiermee wordt een bestand geüpload dat moet worden gebruikt in formuliervermeldingen.

Parameters

Name	Sleutel	Vereist	Type	Description
File	File	True	file	Het bestand dat moet worden geüpload.

Retouren

Name	Pad	Type	Description
Bestands-id	Id	string	De unieke id van het bestand.
Bestandsnaam	Name	string	De naam van het bestand
Bestandsinhoudstype	ContentType	string	Het inhoudstype van het bestand.
Bestandsgrootte	Size	integer	De grootte van het bestand in bytes.

Document ophalen

Bewerkings-id:: GetDocument

Hiermee haalt u een document op

Parameters

Name	Sleutel	Vereist	Type	Description
Form	form	True	string	De naam van het formulier
Vermeldings-id	entry	True	string	De vermeldings-id
Sjabloonnummer	templateNumber	True	integer	Het sjabloonnummer

Retouren

Een bestandsreferentie met bestandsgegevens en metagegevens

Body: FileDataRef

Formuliervermeldingen ophalen

Bewerkings-id:: GetEntryViewEntries

Alle vermeldingen voor een opgegeven weergave ophalen

Parameters

Name	Sleutel	Vereist	Type	Description
Form	form	True	string	De naam van het formulier
Weergave-id	viewId	True	string	De id van de weergave
Aantal opnemen	$count		string	Totaal aantal vermeldingen opnemen
Id's selecteren	$select		string	Retourneert een lijst met item-id's in een weergave wanneer $select=Id is opgegeven

Retouren

response: object

Importstatus ophalen

Bewerkings-id:: GetImportStatus

Haalt de huidige status van een import op en retourneert het aantal geslaagde en mislukte vermeldingen.

Parameters

Name	Sleutel	Vereist	Type	Description
Form	form	True	string	De naam van het formulier
Import-id	importId	True	string	De import-id

Retouren

Name	Pad	Type	Description
Id	Id	string	De id van het importeren
Status	Status	string	De status van het importeren
Foutmelding	ErrorMessage	string	Een bericht waarin wordt beschreven waarom het importeren is mislukt
SuccessfulEntries	SuccessfulEntries	integer	Het aantal geïmporteerde items
UnsuccessfulEntries	UnsuccessfulEntries	integer	Het aantal items dat niet kan worden geïmporteerd
TotalEntries	TotalEntries	integer	Het totale aantal vermeldingen in de import
ImportLink	ImportLink	string	De koppeling naar de pagina vermeldingen om het geannoteerde bestand te downloaden

Item bijwerken

Bewerkings-id:: EditEntry

Hiermee wordt een vermelding bijgewerkt.

Parameters

Name	Sleutel	Vereist	Type	Description
Form	form	True	string	De naam van het formulier
Vermeldings-id	entryId	True	string	De vermeldings-id
Entry	entry	True	dynamic	De bijgewerkte invoergegevens

Retouren

De uitvoer van deze bewerking is dynamisch.

Item verwijderen

Bewerkings-id:: DeleteEntry

Een vermelding verwijderen.

Parameters

Name	Sleutel	Vereist	Type	Description
Form	form	True	string	De naam van het formulier
Vermeldings-id	entryId	True	string	De vermeldings-id

Vermelding maken

Bewerkings-id:: CreateEntry

Hiermee maakt u een nieuwe vermelding.

Parameters

Name	Sleutel	Vereist	Type	Description
Form	form	True	string	De naam van het formulier
Entry	entry	True	dynamic	De vermelding die moet worden gemaakt voor het formulier

Retouren

De uitvoer van deze bewerking is dynamisch.

Vermelding ophalen

Bewerkings-id:: GetEntry

Hiermee haalt u een vermelding op.

Parameters

Name	Sleutel	Vereist	Type	Description
Form	form	True	string	De naam van het formulier
Vermeldings-id	entryId	True	string	De vermeldings-id

Retouren

De uitvoer van deze bewerking is dynamisch.

Vermeldingen importeren

Bewerkings-id:: ImportEntries

Hiermee worden vermeldingen gemaakt, bijgewerkt of verwijderd met behulp van opgegeven bestandsinhoud.

Parameters

Name	Sleutel	Vereist	Type	Description
Form	form	True	string	De naam van het formulier
Bestand importeren	File	True	file	Het bestand (.xlsx of .csv) met de vermeldingen die moeten worden geïmporteerd.
Importmodus	ImportMode	True	string	De modus voor het importeren
E-mailmelding	Email		email	Het e-mailadres voor het ontvangen van importmeldingen
Veld vergelijken	MatchEntriesUsing		string	Een vervangende vermeldings-id

Retouren

Name	Pad	Type	Description
Id	Id	string	De id van het importeren
Status	Status	string	De status van het importeren
Foutmelding	ErrorMessage	string	Een bericht waarin wordt beschreven waarom het importeren is mislukt

Triggers

Wanneer een item wordt verwijderd	Triggers wanneer iemand een vermelding verwijdert.
Wanneer een vermelding wordt bijgewerkt	Wordt geactiveerd wanneer iemand een vermelding bijwerken.
Wanneer er een nieuwe vermelding wordt gemaakt	Triggers wanneer iemand een nieuwe vermelding maakt.

Wanneer een item wordt verwijderd

Bewerkings-id:: EntryDeleted

Triggers wanneer iemand een vermelding verwijdert.

Parameters

Name	Sleutel	Vereist	Type	Description
Form	publisher	True	string	De naam van het formulier

Retouren

De uitvoer van deze bewerking is dynamisch.

Wanneer een vermelding wordt bijgewerkt

Bewerkings-id:: UpdateEntry

Wordt geactiveerd wanneer iemand een vermelding bijwerken.

Parameters

Name	Sleutel	Vereist	Type	Description
Form	publisher	True	string	De naam van het formulier

Retouren

De uitvoer van deze bewerking is dynamisch.

Wanneer er een nieuwe vermelding wordt gemaakt

Bewerkings-id:: NewEntry

Triggers wanneer iemand een nieuwe vermelding maakt.

Parameters

Name	Sleutel	Vereist	Type	Description
Form	publisher	True	string	De naam van het formulier

Retouren

De uitvoer van deze bewerking is dynamisch.

Definities

FileDataRef

Een bestandsreferentie met bestandsgegevens en metagegevens

Name	Pad	Type	Description
Bestands-id	Id	string	De unieke id van het bestand.
Bestandsnaam	Name	string	De naam van het bestand
Bestandsinhoudstype	ContentType	string	Het inhoudstype van het bestand.
Bestandsgrootte	Size	integer	De grootte van het bestand.
Bestands-URL	File	string	De URL van het bestand.
Bestandsinhoud	Content	byte	De bestandsinhoud

FormAvailability

Formulierbeschikbaarheidsgegevens, zoals beschikbaarheid van begin/eind en niet beschikbaar bericht.

Name	Pad	Type	Description
Begin van formulierbeschikbaarheid	availabilityStart	date-time	Begin van formulierbeschikbaarheid
Einde van beschikbaarheid van formulier	availabilityEnd	date-time	Einde van beschikbaarheid van formulier
Bericht niet beschikbaar	notAvailableMessage	string	Bericht niet beschikbaar

object

Dit is het type 'object'.