Freigeben über


Kognito-Formulare

Mit Cognito Forms können Sie auf einfache Weise leistungsstarke Onlineformulare wie Umfragen, Bestellformulare, Registrierungsformulare und vieles mehr erstellen. Umsonst.

Dieser Connector ist in den folgenden Produkten und Regionen verfügbar:

Dienstleistung Class Regions
Copilot Studio Norm Alle Power Automate-Regionen mit Ausnahme der folgenden Bereiche:
     - US Government (GCC)
     - US Government (GCC High)
     - China Cloud betrieben von 21Vianet
     - US Department of Defense (DoD)
Logik-Apps Norm Alle Logik-Apps-Regionen mit Ausnahme der folgenden Bereiche:
     – Azure Government-Regionen
     - Azure China-Regionen
     - US Department of Defense (DoD)
Power Apps Norm Alle Power Apps-Regionen mit Ausnahme der folgenden:
     - US Government (GCC)
     - US Government (GCC High)
     - China Cloud betrieben von 21Vianet
     - US Department of Defense (DoD)
Power Automate Norm Alle Power Automate-Regionen mit Ausnahme der folgenden Bereiche:
     - US Government (GCC)
     - US Government (GCC High)
     - China Cloud betrieben von 21Vianet
     - US Department of Defense (DoD)
Kontakt
Name Unterstützung von Cognito Forms
URL https://www.cognitoforms.com/support
Email support@cognitoforms.com
Connectormetadaten
Herausgeber Kognito-Formulare
Webseite https://www.cognitoforms.com
Datenschutzrichtlinie https://www.cognitoforms.com/legal/privacy
Kategorien Produktivität; Zusammenarbeit

Kognito-Formulare

Mit Cognito Forms können Sie auf einfache Weise leistungsstarke Onlineformulare wie Umfragen, Bestellformulare, Registrierungsformulare und vieles mehr erstellen. Umsonst. Bitte lesen Sie unsere Supportdokumentation , oder wenden Sie sich an uns , um Hilfe zu unserem öffentlichen Power Automate-Connector zu finden.

Herausgeber: Cognito Forms

Voraussetzungen

Ein kostenpflichtiges Abonnement ist erforderlich.

Unterstützte Vorgänge

Auslöser

Trigger werden kurz nach auftreten des abonnierten Ereignisses gesendet.

NewEntry

Dies wird ausgelöst, wenn ein neuer Eintrag für das angegebene Formular erstellt wird. Die Ausgabe ist die Eingabedaten, einschließlich Dateidaten und temporäre Links zu Dateien, Signaturen und Eintragsdokumenten.

Parameters:
  • form: Der Name des Formulars, für das neue Eintragsereignisse abonniert werden.

UpdateEntry

Dies wird ausgelöst, wenn ein Eintrag für das angegebene Formular aktualisiert wird. Die Ausgabe ist die Eingabedaten, einschließlich Dateidaten und temporäre Links zu Dateien, Signaturen und Eintragsdokumenten.

Parameters:
  • form: Der Name des Formulars, für das aktualisierte Eintragsereignisse abonniert werden.

EntryDeleted

Dies wird ausgelöst, wenn ein Eintrag für das angegebene Formular gelöscht wird. Die Ausgabe ist die Eingabedaten, mit Ausnahme von Verknüpfungen.

Parameters:
  • form: Der Name des Formulars, für das gelöschte Einträge abonniert werden.

Aktionen

CreateEntry

Diese Aktion erstellt einen Eintrag für das angegebene Formular. Die Aktion enthält festgelegte Eigenschaften für jedes Eintragsfeld, mit Ausnahme einiger Feldtypen. Die Ausgabe ist die Eingabedaten.

Parameters:
  • form: Der name oder die ID des internen Formulars

EditEntry

Diese Aktion aktualisiert einen vorhandenen Eintrag für das angegebene Formular. Die Aktion enthält festgelegte Eigenschaften für jedes Eintragsfeld, mit Ausnahme einiger Feldtypen. Diese Aktion schlägt fehl, wenn der Eintrag eine kostenpflichtige Bestellung enthält oder die EntryId nicht vorhanden ist. Die Ausgabe ist die aktualisierten Eintragsdaten.

Parameters:
  • form: Der name oder die ID des internen Formulars
  • entryId: Die Eintragsnummer oder Eintrags-ID für den zu aktualisierenden Eintrag

SetFormAvailability

Diese Aktion legt die Einstellungen für die Maximale Verfügbarkeit des Formulars fest. Die start Parameter sollten end leer sein, um das Formular jederzeit verfügbar zu machen. Die Ausgabe ist die aktualisierten Verfügbarkeitseinstellungen.

Parameters:
  • form: Der name oder die ID des internen Formulars
  • start: Die Datumszeit, zu der das Formular verfügbar werden soll.
  • end: Die Uhrzeit, zu der das Formular nicht mehr verfügbar sein soll.
  • message: Die Meldung, die Benutzern angezeigt werden soll, die versuchen, außerhalb des Verfügbarkeitszeitraums auf das Formular zuzugreifen.

GetFile

Diese Aktion ruft eine Datei aus dem Speicher ab. Bei der Ausgabe handelt es sich um ein Objekt, das die Dateidaten, die Metadaten und einen temporären Link zur Datei enthält.

Parameters:
  • id: Die Datei-ID für die abzurufende Datei.

GetDocument

Diese Aktion generiert und ruft ein Eintragsdokument mithilfe des angegebenen Formulars, Eintrags und der angegebenen Vorlage ab. Bei der Ausgabe handelt es sich um ein Objekt, das die Dateidaten des Dokuments, die Metadaten und einen temporären Link zum Dokument enthält.

Parameters:
  • form: Der name oder die ID des internen Formulars
  • entry: Die Eintrags-ID oder Die Eintragsnummer des Eintrags, für den das Dokument generiert werden soll
  • templateNumber: Die Nummer der Vorlage, die zum Generieren des Eintragsdokuments verwendet werden soll

GetEntry

Diese Aktion ruft einen vorhandenen Eintrag für das angegebene Formular ab. Diese Aktion schlägt fehl, wenn der Eintrag nicht vorhanden ist. Die Ausgabe ist die Eingabedaten.

Parameters:
  • form: Der name oder die ID des internen Formulars
  • entryId: Die Eintragsnummer oder Eintrags-ID für den abzurufenden Eintrag

DeleteEntry

Diese Aktion löscht einen vorhandenen Eintrag für das angegebene Formular. Diese Aktion schlägt fehl, wenn der Eintrag nicht vorhanden ist. Es wird keine Ausgabe vorhanden sein.

Parameters:
  • form: Der name oder die ID des internen Formulars
  • entryId: Die Eintragsnummer oder Eintrags-ID für den zu löschenden Eintrag

Private Vorgänge

Diese Vorgänge sind Enabler für die öffentlichen Trigger und Aktionen.

GetForms

Dieser Vorgang gibt eine Liste von Formularen als Objekte zurück, die das Id, InternalNameund Name. Wenn er für den form Parameter für Aktionen und Trigger verwendet wird, sollte der Benutzer die NameApi sehen, die InternalName aber an die API gesendet werden soll.

GetFormSchema

Dieser Vorgang gibt das Schema für das angegebene Formular zurück. Der input Parameter sollte true sein, damit Aktionen schreibgeschützte Eigenschaften und false für Trigger ausschließen, um alle Eigenschaften einzuschließen. Der includeLinks Parameter sollte für alle Aktionen und Trigger mit Ausnahme von EntryDeleted true sein.

Parameters:
  • form: Der name oder die ID des internen Formulars
  • input: Ein boolescher Wert, der angibt, ob das zurückgegebene Schema Eigenschaften ausschließen soll, die nicht festgelegt werden können. False standardmäßig.
  • includeLinks: Ein boolescher Wert, der angibt, ob Verknüpfungseigenschaften für Dateien, Signaturen und Dokumente im Schema enthalten sein sollen. True standardmäßig.

UnsubscribeWebhook

Dieser Vorgang gekündigt den angegebenen Webhook. Der Webhook empfängt keine Ereignisse mehr, nachdem alle aktuell in die Warteschlange gestellten Ereignisse gesendet wurden.

Parameters:
  • id: Die ID des Webhooks, der abbestellt werden soll.
  • module: Das Webhook-Modul. Dies sollte auf "Formulare" festgelegt werden, da dieser Connector dieses Modul nur unterstützt.

Abrufen von Anmeldeinformationen

Ein Besitzer der Organisation muss sich bei Cognito Forms anmelden und die Verbindung autorisieren.

Bekannte Probleme

Nichts

Bereitstellungsanweisungen

Cognito Forms erfordert einen gültigen Client id Und Client secret zum Erstellen eines Verbinders. Diese Eigenschaften finden Sie im Schlüsseltresor und sollten nur in den Authentifizierungseinstellungen des benutzerdefinierten Connectors festgelegt werden.

  1. Run:

     paconn create --api-def apiDefinition.swagger.json --api-prop apiProperties.json
    
  2. Anmelden bei PowerAutomate

  3. Navigieren zum neuen Connector

  4. Aktualisieren Sie unter "Sicherheitsupdate" und Client idClient secret

  5. Aktualisieren des Connectors

Drosselungsgrenzwerte

Name Aufrufe Verlängerungszeitraum
API-Aufrufe pro Verbindung 100 60 Sekunden

Aktionen

Datei abrufen

Ruft eine Datei nach ID ab.

Dokument abrufen

Ruft ein Dokument ab

Eintrag abrufen

Ruft einen Eintrag ab.

Eintrag aktualisieren

Aktualisiert einen Eintrag.

Eintrag erstellen

Erstellt einen neuen Eintrag.

Eintrag löschen

Löschen eines Eintrags.

Festlegen der Formularverfügbarkeit

Legt die Verfügbarkeit eines Formulars fest.

Datei abrufen

Ruft eine Datei nach ID ab.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Datei-ID
id True string

Der eindeutige Bezeichner der Datei

Gibt zurück

Dateiverweis, der Dateidaten und Metadaten enthält

Dokument abrufen

Ruft ein Dokument ab

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Formular
form True string

Der Name des Formulars

Eintrags-ID
entry True string

Die Eintrags-ID

Vorlagennummer
templateNumber True integer

Die Vorlagennummer

Gibt zurück

Dateiverweis, der Dateidaten und Metadaten enthält

Eintrag abrufen

Ruft einen Eintrag ab.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Formular
form True string

Der Name des Formulars

Eintrags-ID
entryId True string

Die Eintrags-ID

Gibt zurück

Die Ausgaben dieses Vorgangs sind dynamisch.

Eintrag aktualisieren

Aktualisiert einen Eintrag.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Formular
form True string

Der Name des Formulars

Eintrags-ID
entryId True string

Die Eintrags-ID

Entry
entry True dynamic

Die aktualisierten Eintragsdaten

Gibt zurück

Die Ausgaben dieses Vorgangs sind dynamisch.

Eintrag erstellen

Erstellt einen neuen Eintrag.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Formular
form True string

Der Name des Formulars

Entry
entry True dynamic

Der für das Formular zu erstellende Eintrag

Gibt zurück

Die Ausgaben dieses Vorgangs sind dynamisch.

Eintrag löschen

Löschen eines Eintrags.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Formular
form True string

Der Name des Formulars

Eintrags-ID
entryId True string

Die Eintrags-ID

Gibt zurück

Die Ausgaben dieses Vorgangs sind dynamisch.

Festlegen der Formularverfügbarkeit

Legt die Verfügbarkeit eines Formulars fest.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Formular
form True string

Der Name des Formulars

Verfügbarkeit starten
start date-time

Verfügbarkeitsanfangsdatum

Verfügbarkeitsende
end date-time

Enddatum der Verfügbarkeit

Nicht verfügbare Nachricht
message string

Nicht verfügbare Nachricht

Gibt zurück

Formularverfügbarkeitsinformationen wie Start-/End-Verfügbarkeit und keine verfügbare Meldung.

Trigger

Beim Erstellen eines neuen Eintrags

Wird ausgelöst, wenn jemand einen neuen Eintrag erstellt.

Wenn ein Eintrag aktualisiert wird

Wird ausgelöst, wenn jemand einen Eintrag aktualisiert.

Wenn ein Eintrag gelöscht wird

Wird ausgelöst, wenn jemand einen Eintrag löscht.

Beim Erstellen eines neuen Eintrags

Wird ausgelöst, wenn jemand einen neuen Eintrag erstellt.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Formular
publisher True string

Der Name des Formulars

Gibt zurück

Die Ausgaben dieses Vorgangs sind dynamisch.

Wenn ein Eintrag aktualisiert wird

Wird ausgelöst, wenn jemand einen Eintrag aktualisiert.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Formular
publisher True string

Der Name des Formulars

Gibt zurück

Die Ausgaben dieses Vorgangs sind dynamisch.

Wenn ein Eintrag gelöscht wird

Wird ausgelöst, wenn jemand einen Eintrag löscht.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Formular
publisher True string

Der Name des Formulars

Gibt zurück

Die Ausgaben dieses Vorgangs sind dynamisch.

Definitionen

FileDataRef

Dateiverweis, der Dateidaten und Metadaten enthält

Name Pfad Typ Beschreibung
Datei-ID
Id string

Die eindeutige ID der Datei.

Dateiname
Name string

Der Name der Datei

Dateiinhaltstyp
ContentType string

Der Inhaltstyp der Datei.

Dateigröße
Size integer

Die Größe der Datei.

Datei-URL
File string

Die URL der Datei.

Inhalt der Datei
Content byte

Der Dateiinhalt

FormAvailability

Formularverfügbarkeitsinformationen wie Start-/End-Verfügbarkeit und keine verfügbare Meldung.

Name Pfad Typ Beschreibung
Start der Formularverfügbarkeit
availabilityStart date-time

Start der Formularverfügbarkeit

Ende der Formularverfügbarkeit
availabilityEnd date-time

Ende der Formularverfügbarkeit

Nachricht nicht verfügbar
notAvailableMessage string

Nachricht nicht verfügbar