Dela via

Cognito-formulär

Med Cognito Forms kan du enkelt skapa kraftfulla onlineformulär, till exempel undersökningar, orderformulär, registreringsformulär med mera. Gratis.

Den här anslutningsappen är tillgänglig i följande produkter och regioner:

Tjänster Class Regioner
Copilot Studio Norm Alla Power Automate-regioner utom följande:
     - Amerikanska myndigheter (GCC)
     - Amerikanska myndigheter (GCC High)
     – China Cloud drivs av 21Vianet
     - US Department of Defense (DoD)
Logiska appar Norm Alla Logic Apps-regioner utom följande:
     – Azure Government-regioner
     – Regioner i Azure Kina
     - US Department of Defense (DoD)
Power Apps Norm Alla Power Apps-regioner utom följande:
     - Amerikanska myndigheter (GCC)
     - Amerikanska myndigheter (GCC High)
     – China Cloud drivs av 21Vianet
     - US Department of Defense (DoD)
Power Automate Norm Alla Power Automate-regioner utom följande:
     - Amerikanska myndigheter (GCC)
     - Amerikanska myndigheter (GCC High)
     – China Cloud drivs av 21Vianet
     - US Department of Defense (DoD)
Kontakt
Namn Stöd för Cognito-formulär
URL https://www.cognitoforms.com/support
E-postmeddelande support@cognitoforms.com
Metadata för anslutningsprogram
Utgivare Cognito-formulär
Webbplats https://www.cognitoforms.com
Integritetspolicy https://www.cognitoforms.com/legal/privacy
Kategorier Produktivitet; Samarbete

Cognito-formulär

Med Cognito Forms kan du enkelt skapa kraftfulla onlineformulär, till exempel undersökningar, orderformulär, registreringsformulär med mera. Gratis. Se vår supportdokumentation eller kontakta oss om du vill ha hjälp med vår offentliga Power Automate-anslutning.

Utgivare: Cognito Forms

Förutsättningar

En betald prenumeration krävs.

Åtgärder som stöds

Triggers

Utlösare skickas strax efter att den prenumererade händelsen inträffar.

NewEntry

Detta utlöses när en ny post skapas för det angivna formuläret. Utdata är indata, inklusive fildata och tillfälliga länkar till filer, signaturer och inmatningsdokument.

Parameters:
  • form: Namnet på formuläret som nya posthändelser prenumererar på.

UpdateEntry

Detta utlöses när en post uppdateras för det angivna formuläret. Utdata är indata, inklusive fildata och tillfälliga länkar till filer, signaturer och inmatningsdokument.

Parameters:
  • form: Namnet på formuläret som uppdaterade posthändelser prenumererar på.

EntryDeleted

Detta utlöses när en post tas bort för det angivna formuläret. Utdata kommer att vara indata, exklusive länkar.

Parameters:
  • form: Namnet på formuläret som borttagna händelser kommer att prenumerera på.

Åtgärder

CreateEntry

Den här åtgärden skapar en post för det angivna formuläret. Åtgärden innehåller inställbara egenskaper för varje postfält, exklusive vissa fälttyper. Utdata blir inmatningsdata.

Parameters:
  • form: Det interna formulärnamnet eller ID:t

EditEntry

Den här åtgärden uppdaterar en befintlig post för det angivna formuläret. Åtgärden innehåller inställbara egenskaper för varje postfält, exklusive vissa fälttyper. Den här åtgärden misslyckas om posten innehåller en betald order eller om entryId inte finns. Utdata blir de uppdaterade inmatningsdata.

Parameters:
  • form: Det interna formulärnamnet eller ID:t
  • entryId: Postnumret eller post-ID:t för posten som ska uppdateras

SetFormAvailability

Den här åtgärden anger formulärets inställningar för gränstillgänglighet. Parametrarna start och end bör vara tomma för att göra formuläret tillgängligt hela tiden. Utdata är de uppdaterade tillgänglighetsinställningarna.

Parameters:
  • form: Det interna formulärnamnet eller ID:t
  • start: Datum då formuläret ska bli tillgängligt.
  • end: Datum då formuläret inte längre ska vara tillgängligt.
  • message: Meddelandet som ska visas för användare som försöker komma åt formuläret utanför tillgänglighetsperioden.

GetFile

Den här åtgärden hämtar en fil från lagringen. Utdata är ett objekt som innehåller fildata, metadata och en tillfällig länk till filen.

Parameters:
  • id: Fil-ID:t för filen som ska hämtas.

GetDocument

Den här åtgärden genererar och hämtar ett postdokument med det angivna formuläret, posten och mallen. Utdata är ett objekt som innehåller dokumentets fildata, metadata och en tillfällig länk till dokumentet.

Parameters:
  • form: Det interna formulärnamnet eller ID:t
  • entry: Post-ID eller postnummer för posten som dokumentet ska genereras för
  • templateNumber: Antalet mallar som ska användas för att generera postdokumentet

GetEntry

Den här åtgärden hämtar en befintlig post för det angivna formuläret. Den här åtgärden misslyckas om posten inte finns. Utdata blir inmatningsdata.

Parameters:
  • form: Det interna formulärnamnet eller ID:t
  • entryId: Postnummer eller post-ID för posten som ska hämtas

DeleteEntry

Den här åtgärden tar bort en befintlig post för det angivna formuläret. Den här åtgärden misslyckas om posten inte finns. Det kommer inte att finnas några utdata.

Parameters:
  • form: Det interna formulärnamnet eller ID:t
  • entryId: Postnummer eller post-ID för posten som ska tas bort

Privata åtgärder

Dessa åtgärder är aktiverare för offentliga utlösare och åtgärder.

GetForms

Den här åtgärden returnerar en lista med formulär som objekt som innehåller Id, InternalNameoch Name. När den används för parametern form för åtgärder och utlösare bör användaren se Name, men InternalName bör skickas till API:et.

GetFormSchema

Den här åtgärden returnerar schemat för det angivna formuläret. Parametern input ska vara sann för åtgärder för att undanta skrivskyddade egenskaper och falskt för utlösare som ska innehålla alla egenskaper. Parametern includeLinks ska vara sann för alla åtgärder och utlösare förutom EntryDeleted.

Parameters:
  • form: Det interna formulärnamnet eller ID:t
  • input: Ett booleskt värde som anger om schemat som returneras ska undanta egenskaper som inte kan anges. Falskt som standard.
  • includeLinks: Ett booleskt värde som anger om länkegenskaper för filer, signaturer och dokument ska ingå i schemat. Sant som standard.

AvregistreraWebhook

Den här åtgärden avbryter prenumerationen på den angivna webhooken. Webhooken tar inte längre emot några händelser när alla händelser i kö har skickats.

Parameters:
  • id: ID:t för webhooken som ska avbryta prenumerationen.
  • module: Webhookens modul. Detta bör anges till "forms", eftersom den här anslutningsappen endast stöder modulen.

Hämta autentiseringsuppgifter

En ägare av organisationen måste logga in på Cognito Forms och auktorisera anslutningen.

Kända problem

None

Distributionsinstruktioner

Cognito Forms kräver ett giltigt Client id och Client secret för att skapa en anslutningsapp. Dessa egenskaper finns i nyckelvalvet och bör endast anges i autentiseringsinställningarna för den anpassade anslutningsappen.

  1. Run:

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

  2. Logga in på PowerAutomate

  3. Gå till den nya anslutningsappen

  4. Under "Säkerhet" uppdaterar och Client idClient secret

  5. Uppdatera anslutningsappen

Begränsningsgränser

Name Anrop Förnyelseperiod
API-anrop per anslutning 100 60 sekunder

Åtgärder

Ange formulärtillgänglighet

Anger tillgängligheten för ett formulär.
Hämta dokument

Hämtar ett dokument
Hämta fil

Hämtar en fil efter ID
Hämta post

Hämtar en post.
Skapa post

Skapar en ny post.
Ta bort post

Ta bort en post.
Uppdatera post

Uppdaterar en post.

Ange formulärtillgänglighet

Åtgärds-ID:
SetFormAvailability

Anger tillgängligheten för ett formulär.

Parametrar

Name Nyckel Obligatorisk Typ Description
Formulär
 form True string

Formulärets namn
Tillgänglighetsstart
 start date-time

Startdatum för tillgänglighet
Tillgänglighetsslut
 end date-time

Slutdatum för tillgänglighet
Inte tillgängligt meddelande
 message string

Inte tillgängligt meddelande

Returer

Formulärtillgänglighetsinformation, till exempel start-/sluttillgänglighet och inte tillgängligt meddelande.

Body
FormAvailability

Hämta dokument

Åtgärds-ID:
GetDocument

Hämtar ett dokument

Parametrar

Name Nyckel Obligatorisk Typ Description
Formulär
 form True string

Formulärets namn
Post-ID
 entry True string

Post-ID:t
Mallnummer
 templateNumber True integer

Mallnumret

Returer

En filreferens som innehåller fildata och metadata

Body
FileDataRef

Hämta fil

Åtgärds-ID:
GetFile

Hämtar en fil efter ID

Parametrar

Name Nyckel Obligatorisk Typ Description
Fil-ID
 id True string

Den unika identifieraren för filen

Returer

En filreferens som innehåller fildata och metadata

Body
FileDataRef

Hämta post

Åtgärds-ID:
GetEntry

Hämtar en post.

Parametrar

Name Nyckel Obligatorisk Typ Description
Formulär
 form True string

Formulärets namn
Post-ID
 entryId True string

Post-ID:t

Returer

Utdata för den här åtgärden är dynamiska.

Skapa post

Åtgärds-ID:
CreateEntry

Skapar en ny post.

Parametrar

Name Nyckel Obligatorisk Typ Description
Formulär
 form True string

Formulärets namn
Entry
 entry True dynamic

Posten som ska skapas för formuläret

Returer

Utdata för den här åtgärden är dynamiska.

Ta bort post

Åtgärds-ID:
DeleteEntry

Ta bort en post.

Parametrar

Name Nyckel Obligatorisk Typ Description
Formulär
 form True string

Formulärets namn
Post-ID
 entryId True string

Post-ID:t

Returer

Utdata för den här åtgärden är dynamiska.

Uppdatera post

Åtgärds-ID:
EditEntry

Uppdaterar en post.

Parametrar

Name Nyckel Obligatorisk Typ Description
Formulär
 form True string

Formulärets namn
Post-ID
 entryId True string

Post-ID:t
Entry
 entry True dynamic

Uppdaterade inmatningsdata

Returer

Utdata för den här åtgärden är dynamiska.

Utlösare

När en ny post skapas

Utlöses när någon skapar en ny post.
När en post tas bort

Utlöses när någon tar bort en post.
När en post uppdateras

Utlöses när någon uppdaterar en post.

När en ny post skapas

Åtgärds-ID:
NewEntry

Utlöses när någon skapar en ny post.

Parametrar

Name Nyckel Obligatorisk Typ Description
Formulär
 publisher True string

Formulärets namn

Returer

Utdata för den här åtgärden är dynamiska.

När en post tas bort

Åtgärds-ID:
EntryDeleted

Utlöses när någon tar bort en post.

Parametrar

Name Nyckel Obligatorisk Typ Description
Formulär
 publisher True string

Formulärets namn

Returer

Utdata för den här åtgärden är dynamiska.

När en post uppdateras

Åtgärds-ID:
UpdateEntry

Utlöses när någon uppdaterar en post.

Parametrar

Name Nyckel Obligatorisk Typ Description
Formulär
 publisher True string

Formulärets namn

Returer

Utdata för den här åtgärden är dynamiska.

Definitioner

FileDataRef

En filreferens som innehåller fildata och metadata

Name Sökväg Typ Description
Fil-ID
 Id string

Det unika ID:t för filen.
Filnamn
 Name string

Namnet på filen
Filinnehållstyp
 ContentType string

Filens innehållstyp.
Filstorlek
 Size integer

Filens storlek.
Fil-URL
 File string

URL:en för filen.
Filinnehåll
 Content byte

Filinnehållet

FormAvailability

Formulärtillgänglighetsinformation, till exempel start-/sluttillgänglighet och inte tillgängligt meddelande.

Name Sökväg Typ Description
Start av formulärtillgänglighet
 availabilityStart date-time

Start av formulärtillgänglighet
Formulärtillgänglighetsslut
 availabilityEnd date-time

Formulärtillgänglighetsslut
Inte tillgängligt meddelande
 notAvailableMessage string

Inte tillgängligt meddelande