Integration mit Make

Hilfe-Center

Make-Startseite

Make ermöglicht Ihnen die Integration mit DocuGenerate und die Verbindung mit Tausenden von vorgefertigten Apps, um visuelle Workflows ohne Grenzen zu erstellen, aufzubauen und zu automatisieren.

Erstellen Sie individuelle DocuGenerate-Workflows, indem Sie Trigger und Actions auswählen. Ein Trigger ist ein Ereignis, das den Workflow startet, eine Action ist das ausgeführte Ereignis.

Zusammenfassung

1. DocuGenerate mit Make Verbinden
2. Dokument Generieren (Action)
3. API-Aufruf Durchführen (Action)
4. Neues Dokument Beobachten (Trigger)
5. Neue Vorlage Beobachten (Trigger)

1. DocuGenerate mit Make Verbinden

  • Melden Sie sich bei Ihrem Make-Konto an oder erstellen Sie ein neues Konto.
  • Gehen Sie zu Ihrem Szenario und fügen Sie ein Modul hinzu. Klicken Sie z. B. auf + und suchen Sie nach DocuGenerate. Wählen Sie dann das gewünschte Modul aus, z. B. Dokument Generieren.
  • Klicken Sie auf Create a connection.
  • Im Feld Connection name können Sie Ihrer Verbindung einen Namen geben.
  • Kopieren Sie Ihren API-Schlüssel und fügen Sie ihn in das entsprechende Feld des Authentifizierungsdialogs ein. Klicken Sie anschließend auf Save.

Dialog zur Eingabe des DocuGenerate-API-Schlüssels in Make

2. Dokument Generieren (Action)

Diese Action ermöglicht es Ihnen, automatisch ein Dokument anhand einer Vorlage und dynamischer Daten zu generieren. Die folgenden Eingaben können konfiguriert werden:

  • Template: Wählen Sie die Vorlage aus, die Sie für die Dokumentgenerierung verwenden möchten.
  • Name: Geben Sie einen Namen für das generierte Dokument an. Standardmäßig wird der Name der Vorlage verwendet.
  • Format: Wählen Sie das Ausgabeformat für das generierte Dokument. Das Standardformat ist .docx. Die unterstützten Formate sind .docx, .pdf, .doc, .odt, .txt, .html und .png.
  • Data: Dieses Feld erfordert den dynamischen Datensatz, der zum Befüllen der Vorlage und zur Generierung des Dokuments verwendet wird.

Beim Einrichten dieser Action wählen Sie eine Vorlage aus Ihrem DocuGenerate-Konto aus. Die Vorlage definiert die Struktur des Dokuments und enthält Zusammenführungs-Tags, in die dynamische Daten eingefügt werden.

Vorlagenauswahl für die Dokumentgenerierung

Nach der Auswahl der Vorlage müssen Sie das Datenfeld angeben. Es muss sich um ein JSON-Objekt handeln, das den in der Vorlage definierten Zusammenführungs-Tags entspricht.

Dokumentgenerierung – JSON-Daten eingeben

Am einfachsten erhalten Sie das korrekt formatierte JSON, indem Sie zur Vorlagenseite in der Web-App wechseln, den Dialog zur Dokumentgenerierung öffnen und die Option JSON-Daten auswählen. Kopieren Sie den vordefinierten JSON-Wert mit der richtigen Struktur und fügen Sie ihn in das Datenfeld in Make ein.

Dokumentgenerierung – JSON-Struktur kopieren

Stellen Sie vor der Verwendung dieser Action sicher, dass das JSON-Datenobjekt mit Werten befüllt ist, um es dynamisch zu machen. Anfänglich ist das JSON-Objekt leer. Ersetzen Sie die leeren Zeichenketten "" durch tatsächliche Werte aus Ihren Datenquellen oder anderen Modulen innerhalb von Make.

Nach der Konfiguration generiert diese Action automatisch ein Dokument basierend auf der gewählten Vorlage und den bereitgestellten Daten, sobald das Szenario ausgeführt wird.

3. API-Aufruf Durchführen (Action)

Nutzen Sie die Flexibilität von Make mit dieser Action, die autorisierte API-Aufrufe mühelos ermöglicht. Diese Funktion eröffnet zahlreiche Möglichkeiten, darunter die direkte Interaktion mit der DocuGenerate-API – etwa das Generieren von Dokumenten im Binärformat durch Angabe des Headers Accept: application/octet-stream. Die folgenden Eingaben können konfiguriert werden:

  • URL: Geben Sie die URL des DocuGenerate-API-Endpunkts ein, den Sie aufrufen möchten.
  • Method: Geben Sie die HTTP-Methode für den API-Aufruf an (z. B. GET, POST, PUT, PATCH, DELETE).
  • Headers: Fügen Sie alle erforderlichen Header hinzu, z. B. Authentifizierungstoken oder Inhaltstypen.
  • Query String: Geben Sie alle Query-String-Parameter an, die in die Anfrage aufgenommen werden sollen.
  • Body: Geben Sie alle erforderlichen Daten an, die in den Anfragetext aufgenommen werden sollen, falls zutreffend.

Konfiguration der Action „API-Aufruf durchführen"

4. Neues Dokument Beobachten (Trigger)

Dieser Trigger wird aktiviert, sobald ein neues Dokument aus einer Vorlage in DocuGenerate generiert wird. Die folgenden Eingaben können konfiguriert werden:

  • Template: Wählen Sie die spezifische Vorlage aus, für die Sie Benachrichtigungen erhalten möchten, wenn Dokumente generiert werden.
  • Limit: Die maximale Anzahl der Ergebnisse, die in einem Ausführungszyklus verarbeitet werden.

Trigger „Neues Dokument beobachten"

Beim Einrichten dieses Triggers wählen Sie eine Vorlage aus Ihrem DocuGenerate-Konto aus. Sobald mit dieser Vorlage ein Dokument generiert wird, wird Make benachrichtigt, und Sie können nachfolgende Actions konfigurieren, die auf dieses Ereignis reagieren. Dieser Trigger ist nützlich für Workflows, die auf die Erstellung bestimmter Dokumenttypen reagieren sollen.

5. Neue Vorlage Beobachten (Trigger)

Dieser Trigger wird aktiviert, sobald eine neue Vorlage in Ihrem DocuGenerate-Konto erstellt wird. Die folgenden Eingaben können konfiguriert werden:

  • Limit: Die maximale Anzahl der Ergebnisse, die in einem Ausführungszyklus verarbeitet werden.

Trigger „Neue Vorlage beobachten"

Wenn eine neue Vorlage in DocuGenerate erstellt wird, aktiviert sich dieser Trigger, und Make kann nachfolgende Actions auf Basis dieses Ereignisses auslösen.