Moduli Cognito

Questo connettore è disponibile nei prodotti e nelle aree seguenti:

Servizio	Class	Regions
Copilot Studio	Normale	Tutte le aree Power Automate ad eccezione delle seguenti:      - Governo degli Stati Uniti (GCC)      - Us Government (GCC High)      - China Cloud gestito da 21Vianet      - Dipartimento della Difesa degli Stati Uniti (DoD)
App per la logica	Normale	Tutte le aree di App per la logica , ad eccezione delle seguenti:      - aree Azure per enti pubblici      - Azure cina      - Dipartimento della Difesa degli Stati Uniti (DoD)
Power Apps	Normale	Tutte le aree Power Apps ad eccezione delle seguenti:      - Governo degli Stati Uniti (GCC)      - Us Government (GCC High)      - China Cloud gestito da 21Vianet      - Dipartimento della Difesa degli Stati Uniti (DoD)
Power Automate	Normale	Tutte le aree Power Automate ad eccezione delle seguenti:      - Governo degli Stati Uniti (GCC)      - Us Government (GCC High)      - China Cloud gestito da 21Vianet      - Dipartimento della Difesa degli Stati Uniti (DoD)

Contatto
Nome	Supporto di Cognito Forms
URL	https://www.cognitoforms.com/support
Email	support@cognitoforms.com

Metadati del connettore
Publisher	Cognito Forms, LLC
Sito web	https://www.cognitoforms.com
Informativa sulla privacy	https://www.cognitoforms.com/legal/privacy
Categorie	Produttività; Collaborazione

Moduli Cognito

Cognito Forms consente di creare facilmente moduli online potenti, ad esempio sondaggi, moduli di ordine, moduli di registrazione e altro ancora. Gratis. Vedere la documentazione support o contact us per assistenza con il connettore Power Automate pubblico.

Publisher: Cognito Forms

Prerequisiti

È necessaria una sottoscrizione a pagamento.

Operazioni supportate

Attivatori

I trigger verranno inviati poco dopo che si verifica l'evento sottoscritto.

NewEntry

Verrà attivato quando viene creata una nuova voce per il modulo specificato. L'output sarà rappresentato dai dati di immissione, inclusi i dati dei file e i collegamenti temporanei a file, firme e documenti di immissione.

Parametri:

• form: nome del modulo per il quale verranno sottoscritti i nuovi eventi di immissione.

UpdateEntry

Verrà attivato quando viene aggiornata una voce per il modulo specificato. L'output sarà rappresentato dai dati di immissione, inclusi i dati dei file e i collegamenti temporanei a file, firme e documenti di immissione.

Parametri:

• form: nome del modulo per il quale verranno sottoscritti gli eventi di immissione aggiornati.

EntryDeleted

Verrà attivato quando viene eliminata una voce per il modulo specificato. L'output sarà rappresentato dai dati di immissione, esclusi i collegamenti.

Parametri:

• form: nome del modulo per il quale verranno sottoscritti gli eventi eliminati di immissione.

Azioni

CreateEntry

Questa azione creerà una voce per il modulo specificato. L'azione includerà le proprietà impostabili per ogni campo di immissione, escludendo alcuni tipi di campo. L'output sarà i dati di immissione.

Parametri:

• form: nome o ID del modulo interno

EditEntry

Questa azione aggiornerà una voce esistente per il modulo specificato. L'azione includerà le proprietà impostabili per ogni campo di immissione, escludendo alcuni tipi di campo. Questa azione avrà esito negativo se la voce include un ordine a pagamento o l'id voce non esiste. L'output sarà i dati di immissione aggiornati.

Parametri:

• form: nome o ID del modulo interno
• entryId: numero di voce o ID voce per la voce da aggiornare

SetFormAvailability

Questa azione imposta le impostazioni di disponibilità limite del modulo. I start parametri e end devono essere vuoti per rendere il modulo sempre disponibile. L'output sarà le impostazioni di disponibilità aggiornate.

Parametri:

• form: nome o ID del modulo interno
• start: data/ora in cui il modulo deve diventare disponibile.
• end: valore datetime in cui il modulo non deve più essere disponibile.
• message: messaggio che deve essere visualizzato agli utenti che tentano di accedere al modulo al di fuori del periodo di disponibilità.

GetFile

Questa azione recupererà un file dall'archiviazione. L'output sarà un oggetto contenente i dati del file, i metadati e un collegamento temporaneo al file.

Parametri:

• id: ID file per il file da recuperare.

GetDocument

Questa azione genererà e recupererà un documento di immissione usando il modulo, la voce e il modello specificati. L'output sarà un oggetto contenente i dati del file del documento, i metadati e un collegamento temporaneo al documento.

Parametri:

• form: nome o ID del modulo interno
• entry: ID voce o numero di voce della voce per cui deve essere generato il documento
• templateNumber: numero del modello da usare per generare il documento di immissione

GetEntry

Questa azione otterrà una voce esistente per il modulo specificato. Questa azione avrà esito negativo se la voce non esiste. L'output sarà i dati di immissione.

Parametri:

• form: nome o ID del modulo interno
• entryId: numero di voce o ID voce per la voce da recuperare

DeleteEntry

Questa azione eliminerà una voce esistente per il modulo specificato. Questa azione avrà esito negativo se la voce non esiste. Non verrà restituito alcun output.

Parametri:

• form: nome o ID del modulo interno
• entryId: numero di voce o ID voce per la voce da eliminare

ImportEntries

Questa azione creerà, aggiornerà o eliminerà le voci usando il contenuto del file fornito (.xlsx o .csv). L'output sarà un oggetto contenente l'ID di importazione e lo stato.

Parametri:

• form: nome o ID del modulo interno
• File: file (.xlsx o .csv) contenente le voci da importare
• ImportMode: modalità per l'importazione (CreateNew, UpdateExisting o SyncEntries)
• Email: indirizzo di posta elettronica per ricevere notifiche di importazione (facoltativo)
• MatchEntriesUsing: sostituzione dell'ID voce (facoltativo)

GetImportStatus

Questa azione otterrà lo stato corrente di un'importazione e restituirà il numero di voci riuscite e non riuscite. L'output sarà un oggetto contenente lo stato di importazione, i conteggi e le informazioni sull'errore, se applicabile.

Parametri:

• form: nome o ID del modulo interno
• importId: ID dell'importazione per verificare lo stato

UploadFile

Questa azione caricherà un file in Cognito Forms.

Parametri:

• fileContent: dati binari del file
• fileName: nome del file

GetEntryViewEntries

Questa azione otterrà tutte le voci per una visualizzazione specificata. L'output sarà i dati di immissione in base alla configurazione della vista.

Parametri:

• form: nome o ID del modulo interno
• viewId: ID della visualizzazione
• $count: includere il numero totale di voci (facoltativo)
• $select: restituisce un elenco di ID voce in una visualizzazione quando viene specificato $select=ID (facoltativo)

Operazioni private

Queste operazioni sono abilitanti per i trigger e le azioni pubblici.

GetForms

Questa operazione restituirà un elenco di moduli come oggetti che contengono e IdName. Se usato per il form parametro per azioni e trigger, l'utente dovrebbe visualizzare Name, ma Id deve essere inviato all'API. I moduli archiviati non sono inclusi nella risposta.

GetFormSchema

Questa operazione restituirà lo schema per il modulo specificato. Il input parametro deve essere true per le azioni per escludere le proprietà di sola lettura e false per i trigger per includere tutte le proprietà. Il includeLinks parametro deve essere true per tutte le azioni e i trigger ad eccezione di EntryDeleted.

Parametri:

• form: nome o ID del modulo interno
• input: valore booleano che indica se lo schema restituito deve escludere proprietà che non possono essere impostate. False per impostazione predefinita.
• includeLinks: valore booleano che indica se le proprietà di collegamento per file, firme e documenti devono essere incluse nello schema. True per impostazione predefinita.

UnsubscribeWebhook

Questa operazione annulla la sottoscrizione del webhook specificato. Il webhook non riceverà più eventi dopo l'invio di tutti gli eventi attualmente in coda.

Parametri:

• id: ID del webhook che deve essere annullato.
• module: modulo del webhook. Questa opzione deve essere impostata su "forms", perché questo connettore supporta solo tale modulo.

Recupero delle credenziali

Un proprietario dell'organizzazione deve accedere a Cognito Forms e autorizzare la connessione.

Problemi noti

None

Istruzioni per la distribuzione

Cognito Forms richiede un connettore valido Client id e Client secret per creare un connettore. Queste proprietà sono disponibili nell'insieme di credenziali delle chiavi e devono essere impostate solo nelle impostazioni di autenticazione del connettore personalizzato.

1. Run:

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

2. Accedere a PowerAutomate

3. Passare al nuovo connettore

4. In "Sicurezza" aggiornare e Client idClient secret

5. Aggiornare il connettore

Limiti per la limitazione delle richieste

Nome	Chiamate	Periodo di rinnovo
Chiamate API per connessione	100	60 secondi

Azioni

Aggiornare la voce	Aggiorna una voce.
Carica il file	Carica un file da usare nelle voci del modulo.
Creare una voce	Crea una nuova voce.
Elimina voce	Eliminare una voce.
Importare voci	Crea, aggiorna o elimina voci usando il contenuto del file fornito.
Impostare la disponibilità dei moduli	Imposta la disponibilità di un modulo.
Ottenere le voci del modulo	Ottenere tutte le voci per una visualizzazione specificata
Ottenere lo stato di importazione	Ottiene lo stato corrente di un'importazione e restituisce il numero di voci riuscite e non riuscite.
Ottenere una voce	Ottiene una voce.
Ottieni file	Ottiene un file in base all'ID.
Recupera documento	Ottiene un documento

Aggiornare la voce

Carica il file

Creare una voce

Elimina voce

Importare voci

Impostare la disponibilità dei moduli

Ottenere le voci del modulo

Ottenere lo stato di importazione

Ottenere una voce

Ottieni file

Recupera documento

Trigger

Quando viene aggiornata una voce	Si attiva quando un utente aggiorna una voce.
Quando viene creata una nuova voce	Si attiva quando un utente crea una nuova voce.
Quando viene eliminata una voce	Si attiva quando un utente elimina una voce.

Quando viene aggiornata una voce

Quando viene creata una nuova voce

Quando viene eliminata una voce

Definizioni

FileDataRef

FormAvailability

oggetto