Schnellere Vertriebsprozesse.

Use Case Hero-Banner

Vom Whitepaper über Verträge bis hin zu Verträgen und Vereinbarungen - während der gesamten Customer Journey sind zahlreiche Dokumente erforderlich. In diesem Tutorial erfährst du, Adobe Acrobat Services könnt ihr während der gesamten Customer Journey Dokumentenerlebnisse integrieren, um den Vertrieb zu beschleunigen.

Verträge und Kundenaufträge aus Daten generieren

Vertriebsvereinbarungen, Verträge und andere Dokumente können je nach Kriterium stark variieren. Ein Verkaufsvertrag kann beispielsweise nur bestimmte Bedingungen basierend auf einem bestimmten Kriterium enthalten, z. B. die Tatsache, dass er sich in einem bestimmten Land oder Staat befindet, oder bestimmte Produkte als Teil des Vertrags. Das manuelle Erstellen dieser Dokumente oder die Verwaltung vieler verschiedener Vorlagenvarianten kann die Rechtskosten für die manuelle Überprüfung von Änderungen erheblich erhöhen.

API für die Dokumentenerzeugung in Adoben können Sie Daten aus Ihrem CRM oder einem anderen Datensystem übernehmen, um anhand dieser Daten dynamisch Verkaufsdokumente zu generieren.

Zugangsdaten abrufen

Registrieren Sie sich zunächst für kostenlose Adobe PDF Services-Anmeldedaten:

  1. Navigieren hier , um Ihre Anmeldeinformationen zu registrieren.

  2. Melden Sie sich mit Ihrer Adobe ID an.

  3. Legen Sie Ihren Anmeldenamen fest (z. B. Verkaufsvereinbarungsdemo).

    Screenshot der Einrichtung Ihres Berechtigungsnamens

  4. Wählen Sie eine Sprache aus, in der Sie den Beispielcode herunterladen möchten (z. B. "Node.js").

  5. Aktivieren, um zuzustimmen Entwicklerbedingungen.

  6. Auswählen Anmeldeinformationen erstellen.
    Eine Datei wird mit einer ZIP-Datei auf Ihren Computer heruntergeladen, die die Beispieldateien pdfservices-api-credentials.json und private.key für die Authentifizierung enthält.

    Screenshot der Anmeldedaten

  7. Auswählen Microsoft Word-Add-in oder gehen Sie zu AppSource zu installieren.

    note note
    NOTE
    Für die Installation des Word-Add-Ins benötigen Sie die Berechtigung zum Installieren von Add-Ins in Microsoft 365. Wenn Sie keine Berechtigung haben, wenden Sie sich an Ihren Microsoft 365-Administrator.

Ihre Daten

Wenn Sie Daten aus einem bestimmten Datensystem abrufen, müssen Sie diese Daten als JSON-Daten ausgeben oder ein eigenes Schema generieren. In diesem Szenario wird der folgende vordefinierte Beispieldatensatz verwendet:

{
    "salesOrder": {
        "comment": "Make sure to call 555-555-1234 when you arrive. The front door is broken."
    },
    "company": {
        "name":"Home Services Co.",
        "address": {
            "city": "Homestead",
            "state": "NY",
            "zip": "14623",
            "streetAddress": "123 Demohome Street"
        }
    },
    "customer": {
        "address": {
            "city": "Seattle",
            "state": "WA",
            "zip": "98052",
            "streetAddress": "20341 Whitworth Institute 405 N. Whitworth"
        },
        "email": "mailto:jane-doe@xyz.edu",
        "jobTitle": "Professor",
        "name": "Jane Doe",
        "telephone": "(425) 123-4567",
        "url": "http://www.janedoe.com"
    },
    "tax": {
        "state":"WA",
        "rate": 0.08
    },
    "referencesOrder": [
        {
            "description": "Carpet Cleaning Service - 3BR 2BA",
            "totalPaymentDue": {
                "price": 359.54
            },
            "orderedItem": {
                "description": "Carpet Cleaning Service"
            }
        },
        {
            "description": "Home Cleaning Service - 3BR 2BA",
            "totalPaymentDue": {
                "price": 299.99
            },
            "orderedItem": {
                "description": "House Cleaning Service"
            }
        }
    ]
}

Einfache Tags zu Ihrem Dokument hinzufügen

In diesem Szenario wird ein Verkaufsauftragsdokument verwendet, das heruntergeladen werden kann hier.

Screenshot des Beispielauftragsdokuments

  1. Öffnen Sie die SalesOrder.docx Beispieldokument in Microsoft Word verwenden.

  2. Wenn das Plug-in Dokumentenerzeugung installiert ist, wählen Sie Dokumenterstellung in der Multifunktionsleiste. Wenn die Dokumentgenerierung nicht in Ihrem Menüband angezeigt wird, befolgen Sie diese Anweisungen.

  3. Auswählen Erste Schritte.

  4. Kopieren Sie die oben geschriebenen JSON-Beispieldaten in die Datei JSON-Daten ein.

    Screenshot des Kopierens von JSON-Daten

Navigieren Sie dann zum Fenster "Dokumentenerzeugung - Tags", um Tags im Dokument zu platzieren.

  1. Wählen Sie den Text aus, den Sie ersetzen möchten (z. B. FIRMENNAME).

  2. Im Dialogfeld " Tagger für Dokumenterstellung nach "name".

  3. Wählen Sie in der Liste der Tags den Namen unter Firma aus.

  4. Auswählen Text einfügen.

    Screenshot des Einfügens des Tags

    Dieser Prozess platziert ein Tag mit dem Namen {{company.name}} weil sich das Tag unter dem Pfad in der JSON-Datei befindet.

    code language-none
    {
    …
    "company": {
        "name":"Home Services Co.",
        …
    },
    …
    }
    

Wiederholen Sie diese Aktionen für einige der zusätzlichen Tags im Dokument, z. B. STRASSE, STADT, STAAT, PLZ usw.

Generiertes Dokument in der Vorschau anzeigen

Direkt in Microsoft Word können Sie eine Vorschau Ihres generierten Dokuments auf der Grundlage der Beispiel-JSON-Daten anzeigen.

  1. Im Dialogfeld " Tagger für Dokumenterstellung " die Option Dokument generieren. Wenn Sie zum ersten Mal aufgefordert werden, sich mit Ihrer Adobe ID anzumelden, Auswählen Anmelden und füllen Sie die Eingabeaufforderungen aus, um sich mit Ihren Anmeldeinformationen anzumelden.

    Screenshot der Vorschau eines generierten Dokuments

  2. Auswählen Dokument anzeigen.

    Screenshot der Schaltfläche Dokument anzeigen

  3. Ein Browserfenster wird geöffnet, in dem Sie eine Vorschau der Dokumentergebnisse anzeigen können.

    Screenshot des Dokuments im Browserfenster

Sie können die Tags im Dokument sehen, die durch die Daten aus den ursprünglichen Beispieldaten ersetzt wurden.

Screenshot der Tags, die durch Daten ersetzt wurden

Hinzufügen einer Tabelle zu einer Vorlage

Fügen Sie in diesem nächsten Szenario einer Tabelle im Dokument eine Produktliste hinzu.

  1. Setzen Sie den Cursor an die Stelle, an der die Tabelle platziert werden soll.

  2. Im Dialogfeld " Tagger für Dokumenterstellung " die Option Erweitert.

  3. Erweitern Tabellen und Listen.

  4. Im Dialogfeld " Tabellendatensätze ein, wählen Sie referencesOrder, bei dem es sich um ein Array handelt, das alle Produktelemente auflistet.

  5. Geben Sie im Feld Spaltendatensätze auswählen den gewünschten Eintrag ein. Beschreibung und totalPaymentDue.price ein.

  6. Auswählen Tabelle einfügen.

    Screenshot des Einfügens der Tabelle

Bearbeiten Sie die Tabelle, um sie wie jede andere Tabelle in Microsoft Word an Stile, Größen und andere Parameter anzupassen.

Numerische Berechnung hinzufügen

Mit numerischen Berechnungen können Sie Summen und andere Berechnungen auf der Grundlage einer Datensammlung, z. B. eines Arrays, berechnen. Fügen Sie in diesem Szenario ein Feld hinzu, um die Zwischensumme zu berechnen.

  1. Wählen Sie das 0,00 $ neben dem Titel der Zwischensumme.
  2. Im Dialogfeld " Tagger für Dokumenterstellung Panel, erweitern Sie Numerische Berechnungen.
  3. Unter Berechnungstyp auswählen wählen Sie Aggregation.
  4. Unter Typ auswählen wählen Sie Summe.
  5. Unter Datensätze auswählen wählen Sie ReferencesOrder.
  6. Unter Element zum Ausführen der Aggregation auswählen ​ wählen Sie ​ totalPaymentsDue.price*.
  7. Auswählen Berechnung einfügen.

Dieser Prozess fügt ein Berechnungs-Tag ein, das die Summe der Werte bereitstellt. Mit JSONata-Berechnungen können komplexere Berechnungen durchgeführt werden. Beispiel:

  • Zwischensumme: ${{expr($sum(referencesOrder.totalPaymentDue.price))}}
    Berechnet die Summe von referencesOrder.totalPaymentDue.price.

  • Umsatzsteuer: ${{expr($sum(referencesOrder.totalPaymentDue.price)*0.08)}}
    Berechnet den Preis und multipliziert mit 8%, um die Steuer zu berechnen.

  • Fälliger Gesamtbetrag: ${{expr($sum(referencesOrder.totalPaymentDue.price)*1.08)}}
    Berechnet den Preis und multipliziert ihn mit 1,08, um die Zwischensumme + Steuer zu berechnen.

Hinzufügen von bedingten Begriffen

Mit bedingten Abschnitten können Sie nur dann einen Satz oder Absatz einfügen, wenn eine bestimmte Bedingung erfüllt ist. In diesem Szenario ist nur ein Abschnitt enthalten, wenn er einem bestimmten Status entspricht.

  1. Suchen Sie im Dokument nach dem Abschnitt mit dem Namen KALIFORNIEN - DATENSCHUTZERKLÄRUNGEN.

  2. Wählen Sie den Abschnitt mit dem Cursor aus.

    Screenshot der Auswahl

  3. Im Dialogfeld " Tagger für Dokumenterstellung" die Option Erweitert.

  4. Erweitern Bedingter Inhalt.

  5. Im Dialogfeld " Datensätze auswählen ein, suchen und wählen Sie customer.address.state.

  6. Im Dialogfeld " Operator auswählen ein, wählen Sie =.

  7. Im Dialogfeld " Wertfeld, geben Sie CA.

  8. Auswählen Bedingung einfügen.

Der Abschnitt "Kalifornien" wird nur im generierten Dokument angezeigt, wenn customer.address.state = CA.

Wählen Sie als Nächstes den Abschnitt WASHINGTON PRIVACY STATEMENTS und wiederholen Sie die oben genannten Schritte, indem Sie den Wert CA durch WA ersetzen.

Dynamisches Bild hinzufügen.

Mit der API für die Dokumentenerzeugung können Sie Bilder dynamisch aus Daten einfügen. Dies ist nützlich, wenn Sie verschiedene Untermarken haben und Logos, Porträtbilder oder Bilder ändern möchten, um sie für eine bestimmte Branche relevanter zu machen.

Bilder können über eine URL im Daten- oder base64-Inhalt übergeben werden. Im folgenden Beispiel wird eine URL verwendet.

  1. Platzieren Sie den Cursor an der Stelle, an der Sie ein Bild einfügen möchten.

  2. Im Dialogfeld " Tagger für Dokumenterstellung " die Option Erweitert.

  3. Erweitern Bilder.

  4. Im Dialogfeld " Tags auswählen ein, wählen Sie Logo.

  5. Im Dialogfeld " Optionaler alternativer Text eine Beschreibung (z. B. Logo) ein. Dieser Vorgang fügt einen Bildplatzhalter ein, der wie folgt aussieht:

    Screenshot des Platzhalterbilds

Sie möchten das Bild jedoch dynamisch für ein Bild festlegen, das bereits im Layout enthalten ist. Dazu haben Sie folgende Möglichkeiten:

  1. Klicken Sie mit der rechten Maustaste auf das eingefügte Platzhalterbild.

    Screenshot des Platzhalterbilds

  2. Auswählen Alt-Text bearbeiten.

  3. Kopieren Sie im Bedienfeld den Text, der wie folgt aussieht:
    { "location-path": "logo", "image-props": { "alt-text": "Logo" }}

  4. Wähle ein anderes Bild in deinem Dokument aus, das dynamisch sein soll.

    Screenshot des neuen Bildes im Dokument

  5. Klicken Sie mit der rechten Maustaste auf das Bild und wählen Sie Alt-Text bearbeiten.

  6. Fügen Sie den Wert in das Fenster ein.

Bei diesem Vorgang wird das Bild durch ein Bild ersetzt, das sich in der Logovariablen in den Daten befindet.

Tags für Acrobat Sign hinzufügen

Mit Adobe Acrobat Sign können Sie elektronische Signaturen für Ihre Dokumente erfassen. Acrobat Sign bietet eine einfache Möglichkeit, Felder innerhalb der Weboberfläche zu ziehen und abzulegen. Sie können jedoch auch die Unterschrift und andere Feldplatzierungen mithilfe eines Text-Tags steuern. Mit dem Tagger für die Generierung von Adobe-Dokumenten können Sie diese Text-Tag-Felder ganz einfach platzieren.

  1. Navigieren Sie zu der Stelle, an der im Beispieldokument eine Signatur erforderlich ist.
  2. Setze den Cursor an die Stelle, an der die Unterschrift nötig ist.
  3. Im Dialogfeld " Tagger für die Generierung von Adobe-Dokumenten " die Option Adobe Sign.
  4. Im Dialogfeld " Anzahl der Empfänger angeben die Anzahl der Empfänger fest (in diesem Beispiel ist es einer).
  5. Im Dialogfeld " Empfänger ein, wählen Sie Unterzeichner-1.
  6. Im Dialogfeld " Feld Typ, wählen Sie Unterschrift.
  7. Auswählen Adobe Sign-Text-Tag einfügen.

Ein Tag wird in das Dokument eingefügt.

Screenshot des Signatur-Tags im Dokument

Acrobat Sign bietet verschiedene andere Feldtypen, die Sie einfügen können, z. B. Datumsfelder.

  1. Im Dialogfeld " Feld Typ, wählen Sie Datum.
  2. Bewegen Sie den Cursor über die Datumsposition im Dokument.
  3. Auswählen Adobe Sign-Text-Tag einfügen.

Screenshot des Datums-Tags im Dokument

Vereinbarung generieren

Sie haben Ihr Dokument jetzt mit Tags versehen und können fortfahren. Im nächsten Abschnitt wird erläutert, wie Sie mithilfe der API-Beispiele für die Dokumentenerzeugung für "Node.js" ein Dokument generieren, diese funktionieren jedoch in allen Sprachen.

Öffnen Sie den pdfservices-node-sdk-samples-master , der beim Registrieren Ihrer Anmeldeinformationen heruntergeladen wurde. Die Dateien pdfservices-api-credentials.json und private.key sollten in diese Dateien aufgenommen werden.

  1. Öffnen Sie ein Terminal, um Abhängigkeiten mithilfe von npm install zu installieren.
  2. Kopieren Sie die Beispieldatei data.json in den Ressourcenordner.
  3. Kopieren Sie die Word-Vorlage in den Ressourcenordner.
  4. Erstellen Sie eine neue Datei mit dem Namen generate-salesOrder.js im Stammverzeichnis des Ordners mit den Beispielen.
const PDFServicesSdk = require('@adobe/pdfservices-node-sdk');
const fs = require('fs');
const path = require('path');

var dataFileName = path.join('resources', '<INSERT JSON FILE');
var outputFileName = path.join('output', 'salesOrder_'+Date.now()+".pdf");
var inputFileName = path.join('resources', '<INSERT DOCX>');

//Loads credentials from the file that you created.
const credentials =  PDFServicesSdk.Credentials
    .serviceAccountCredentialsBuilder()
    .fromFile("pdfservices-api-credentials.json")
    .build();

// Setup input data for the document merge process
const jsonString = fs.readFileSync(dataFileName),
jsonDataForMerge = JSON.parse(jsonString);

// Create an ExecutionContext using credentials
const executionContext = PDFServicesSdk.ExecutionContext.create(credentials);

// Create a new DocumentMerge options instance
const documentMerge = PDFServicesSdk.DocumentMerge,
documentMergeOptions = documentMerge.options,
options = new documentMergeOptions.DocumentMergeOptions(jsonDataForMerge, documentMergeOptions.OutputFormat.PDF);

// Create a new operation instance using the options instance
const documentMergeOperation = documentMerge.Operation.createNew(options)

// Set operation input document template from a source file.
const input = PDFServicesSdk.FileRef.createFromLocalFile(inputFileName);
documentMergeOperation.setInput(input);

// Execute the operation and Save the result to the specified location.
documentMergeOperation.execute(executionContext)
.then(result => result.saveAsFile(outputFileName))
.catch(err => {
    if(err instanceof PDFServicesSdk.Error.ServiceApiError
        || err instanceof PDFServicesSdk.Error.ServiceUsageError) {
        console.log('Exception encountered while executing operation', err);
    } else {
        console.log('Exception encountered while executing operation', err);
    }
});
  1. Ersetzen <INSERT JSON FILE> mit dem Namen der JSON-Datei in /resources.
  2. Ersetzen <INSERT DOCX> mit dem Namen der DOCX-Datei.
  3. Verwenden Sie zum Ausführen den Knoten generate-salesOrder.js mit Terminal.

Die Ausgabedatei sollte sich im Ordner /output befinden, wobei das Dokument ordnungsgemäß generiert wird.

Weitere Optionen

Nachdem das Dokument generiert wurde, können Sie weitere Aktionen ausführen, z. B.:

  • Sicheres Dokument mit einem Kennwort
  • PDF komprimieren, wenn große Bilder vorhanden sind
  • Elektronische Unterschriften im Dokument erfassen

Weitere Informationen zu einigen der anderen verfügbaren Aktionen finden Sie in den Skripts im Ordner "/src" in den Beispieldateien. Weitere Informationen erhalten Sie auch in der Dokumentation der verschiedenen Aktionen.

Zusätzliche Anwendungsfälle

Adobe Acrobat Services können mit digitalen Dokumenten-Workflows viele Bereiche eines Vertriebszyklus optimieren:

  • Mit der Adobe PDF Embed-API könnt ihr Whitepaper und andere Inhalte in Websites einbetten und gleichzeitig Analysen für die Zuschauer erfassen
  • Mit Acrobat Sign elektronische Signaturen in generierten Vereinbarungen erfassen
  • Extrahieren von Vereinbarungsdaten aus PDF-Dokumenten mithilfe der Adobe PDF Extract-API

Weiterbildung

Möchten Sie mehr erfahren? Weitere Möglichkeiten zur Verwendung Adobe Acrobat Services:

recommendation-more-help
61c3404d-2baf-407c-beb9-87b95f86ccab