Massenversand mit einer CSV-Datei – Neue Version

Achtung:

Dieser Artikel enthält Informationen zur Vorabversion. Veröffentlichungsdaten, Funktionen und andere Informationen können ohne vorherige Ankündigung geändert werden.

Achtung:

Bei Verwendung der CSV-Upload-Funktion für Massenversand wird die In-App-Erstellung von Feldern nicht unterstützt. Alle Felder müssen in der Dokumentvorlage platziert werden, bevor sie in die Massenversand-Schnittstelle hochgeladen werden.

Erstellen der CSV-Datei

Wenn du eine CSV-Datei für den Massenversand-Prozess erstellst, musst du eine CSV-Datei verwenden, die im Format UTF-8 kodiert ist, insbesondere wenn du nicht auf lateinisch basierte Zeichen verwenden.

Die CSV-Datei wird am besten mit einer Tabellenkalkulationsanwendung wie Excel, Numbers, Google Sheets o.ä. erstellt. Die meisten Tabellen können in ein CSV-Format exportiert werden, was für einen erfolgreichen Upload erforderlich ist.

Tabellenkalkulationsblätter stellen die Daten in einem leicht lesbaren Tabellenformat dar, in dem die Zeilen (d. h. die Datensätze) und Spalten (d. h. die Felder) leicht erkennbar sind. Beim Erstellen deiner CSV stellt jede Zeile eine untergeordnete Vereinbarung dar und jede Spalte ist ein einziges Argument, das auf die Vereinbarung angewendet wird (wie die E-Mail-Adresse der empfangenden Person und die personalisierten Formularfelder).

Zwei Dinge solltest du beachten, bevor du mit dem Erstellen der CSV-Datei beginnst:

  • Die Massenversand-Vorlage ermöglicht die Konfiguration vieler Vereinbarungsoptionen. Wenn in der CSV-Datei nicht explizit eine Einstellung definiert ist, wird der Standardwert aus der übergeordneten Vorlage verwendet. Wenn also alle Vereinbarungen den gleichen Vereinbarungsnamen haben, beziehe diese Spalte nicht in deine CSV-Datei ein.
  • Es muss nicht in jedem Feld ein Wert eingegeben werden, da eine Spalte vorhanden ist. Leere Felder werden ignoriert und der Standardwert aus der übergeordneten Vorlage Massenversand wird verwendet. Es muss also nicht jedes Feld in jedem Datensatz ausgefüllt werden.

Die CSV-Datei selbst lässt sich in drei sinnvolle Abschnitte unterteilen:

Hinweis:

Die neue Massenversand-Umgebung unterstützt derzeit nicht die Konfiguration, bei der die sendende Partei als Erstes über die Benutzungsfläche signiert.

Kundschaft, die eine ältere CSV-Datei im neuen Erlebnis verwendet, kann die sendende Partei nicht als erste unterzeichnende Partei einfügen. Eine neue CSV-Datei mit der neuen Formatierung muss so erstellt sein, dass die sendende Partei für jede untergeordnete Vereinbarung als erste empfangende Partei definiert ist.

Mindestens ein und bis zu 100 Empfangende können in jede untergeordnete Vereinbarung aufgenommen werden. 

Alle Empfangende können über sechs Felder definiert werden:

  • Empfangende_Person_X: Name
  • Empfangende_Person_X:E-Mail
  • Empfangende_Person_X:Rolle
  • Empfangende_Person_X:Authentifizierungstyp
  • Empfangende_Person_X:Authentifizierungswert
  • Empfangende_Person_X:private_Nachricht

Dabei steht _X für die Empfänger-Indexnummer (Empfangende_Person_1, Empfangende_Person_2 usw.) und das Argument nach : ist der Wert, der vom System zum Konstruieren der Vereinbarung verwendet wird.

Es ist nur die E-Mail-Adresse erforderlich. Alle anderen Werte können ignoriert oder von der übergeordneten Vorlage übernommen werden, indem die Spalte ausgelassen oder das Feld leer gelassen wird.

Beispiel einer CSV-Datei mit den sechs Empfängerspalten

Hinweis:

Das Definieren von Empfangswerten wie Name der Empfangspartei, Titel und Firma kann mithilfe von eindeutig benannten Spaltenkopfzeilen erfolgen, die den gleichnamigen Feldern im Dokument zugeordnet sind. Siehe Definieren der selbstdefinierten Felder für die Zusammenführung von Daten in die Vereinbarungen unten.

Bei Spaltenüberschriften wird zwischen Groß- und Kleinschreibung unterschieden und die Feldnamen müssen genau übereinstimmen.

Feldwerte:

:Name -–in dieses Feld kann eine beliebige Zeichenfolge eingegeben werden, in der Regel der Name des Empfangenden.

:E-Mail  – Dieses Feld akzeptiert jede Zeichenfolge im Format einer E-Mail-Adresse (x@y.zz). Werte im Feld :E-Mail, die nicht das Format einer E-Mail-Adresse haben, lösen einen Fehler aus.

:Rolle – Akzeptiert die Standard-Rollen für Vereinbarungen:

  • SIGNER
  • APPROVER
  • ACCEPTOR
  • FORM_FILLER
  • CERTIFIED_RECIPIENT
  • DELEGATE_TO_SIGNER
  • DELEGATE_TO_APPROVER
  • DELEGATE_TO_ACCEPTOR
  • DELEGATE_TO_CERTIFIED_RECIPIENT
  • DELEGATE_TO_FORM_FILLER

:Authentifizierungstyp – Akzeptiert eine der nachstehenden Authentifizierungsmethoden. Wenn eine Authentifizierungsmethode definiert wird, die nicht für die sendende Gruppe aktiviert ist, wird ein Fehler generiert.

:Authentifizierungswert – gilt nur für Authentifizierungen per TELEFON und PASSWORT. Kein anderer Authentifizierungstyp darf einen Authentifizierungswert enthalten. Akzeptiert eine Zeichenfolge, die den Wert definiert, der zur Validierung der Authentifizierungsmethode verwendet wird (sofern zutreffend).

  • KENNWORT-Authentifizierung: Eine Zeichenfolge, die einen Wert definiert, den Empfangende eingeben müssen, um die Authentifizierungsanforderung zu bestehen.
  • TELEFONNUMMERN-Authentifizierung: Eine Zeichenfolge mit Zahlen, die die Telefonnummer der empfangenden Person definiert. Die Telefonnummer wird verwendet, um den Code an die empfangende Person zu übermitteln.
    • Die Telefonnummer muss so formatiert sein, dass zwischen dem Ländercode und der Telefonnummer ein Bindestrich steht (z. B. 1-5555551212 und 91-9934765344).
    • Das Format der Telefonnummer kann ein Pluszeichen am Anfang und Bindestriche innerhalb der Zahl enthalten, um bei Bedarf eine besser lesbare Zeichenfolge zu erhalten. (Beispiel: +1-555-555-1212)

:Private_Nachricht – Eine Zeichenfolge mit bis zu 1000 Zeichen, die der empfangenden Person als private Nachricht im Haupttext der E-Mail und auf der Seite für die elektronische Signatur zugestellt wird.

Hinweis:

Für Empfängergruppe wendet Acrobat Sign die private Nachricht, die dem ersten aufgeführten Abonnent zugewiesen ist, auf alle Mitglieder der Gruppe an. Wenn dieser Abonnent keine private Nachricht konfiguriert hat, erhält kein Gruppenmitglied eine Nachricht.

CC_X:E-Mail: Die E-Mail-Adresse einer Vereinbarungsteilnehmerin oder eines Vereinbarungsteilnehmers, die oder der bei der Vereinbarung auf CC gesetzt ist und die Vereinbarung erst nach Abschluss der Vereinbarung anzeigt. Wie bei der Empfängerin oder dem Empfänger ist der X-Wert eine Zahl, die mit 1 beginnt und sich erhöht, wenn es mehrere CC-Parteien gibt. Wenn du zum Beispiel drei Parteien auf CC gesetzt hast, musst du drei Spalten konfigurieren: CC_1:EMAIL, CC_2:EMAIL, CC_3:EMAIL

Diese Spalten beziehen sich auf die Abschnitte Vereinbarungsdetails und Vereinbarungseinstellungen der Konfigurationsschnittstelle für Massenversand. Bei der Konfiguration der Massenversand-Transaktion in der Acrobat Sign-Oberfläche lege die Standardwerte fest, die zu verwenden sind, wenn in diesen Spalten kein Wert explizit definiert ist. Es gibt fünf verschiedene Felder:

  • Gebietsschema – Dieses definiert die Sprache (Lokalisierung), die auf die Oberfläche der empfangenden Partei angewendet wird. Nur die Seitenelemente für E-Mail und e-Signatur, die Teil der Acrobat Sign-Vorlage sind, werden lokalisiert. Benutzerdefinierte Inhalte, die von der absendenden Person hinzugefügt werden, werden nicht übersetzt. Die möglichen Werte sind:
  • Baskisch (Spanien) - eu_ES 
  • Bokmål (Norwegisch) - nb_NO 
  • Katalanisch (Spanien) - ca_ES
  • Chinesisch - zh_CN 
  • Chinesisch (Taiwan) - zh_TW 
  • Kroatisch- hr_HR
  • Tschechisch - cs_CZ
  • Dänisch - da_DK 
  • Niederländisch - nl_NL 
  • Finnisch - fi_FI 
  • Französisch - fr_FR
  • Deutsch - de_DE
  • Hebräisch - iw_IL 
  • Ungarisch - hu_HU
  • Isländisch - is_IS 
  • Indonesisch - in_ID 
  • Italienisch - it_IT 
  • Japanisch - ja_JP 
  • Koreanisch - ko_KR 
  • Malaiisch - ms_MY
  • Norwegisch - no_NO 
  • Nynorsk (Norwegisch) - nn_NO 
  • Polnisch - pl_PL 
  • Portugiesisch - pt_PT 
  • Portugiesisch (Brasilien) - pt_BR 
  • Rumänisch - ro_RO
  • Russisch - ru_RU 
  • Slowakisch - sk_SK 
  • Slowenisch - sl_SI 
  • Spanisch - es_ES
  • Schwedisch - sv_SE 
  • Thai - th_TH
  • Türkisch - tr_TR 
  • Ukrainisch - uk_UA
  • Englisch (UK) - en_GB
  • Englisch (US) - en_US 
  • Vietnamesisch - vi_VN
  • Vereinbarungsname: Der Wert für Vereinbarungsname, der in die E-Mail der empfangenden Person eingefügt und auf der Seite Verwalten angegeben wird.
  • Läuft ab: Mit diesem Feld wird die Anzahl der Tage definiert, bis die Vereinbarung automatisch abgebrochen wird.
  • Vereinbarungsnachricht: Definiert die globale Nachricht, die in den Haupttext der E-Mail der empfangenden Partei eingefügt wird. Diese Nachricht kann bis zu 10.000 Zeichen oder etwa 1600 Wörter enthalten.
  • Reihenfolge: Mit diesem Feld wird die Abfolge der empfangenden Parteien beschrieben:
    • Jeder Empfangende kann nur einmal in der Bestellung angegeben werden.
    • Eine Zeichenfolge empfangender Parteien, in der die Empfangenden nur durch Kommas als Trennzeichen voneinander getrennt werden, wird als sequenzieller Signaturfluss identifiziert. z. B. Empfangender_1,Empfangender_2,Empfangender_3.
      • Jeder Empfangende erhält Zugriff auf die Vereinbarung, nachdem der vorherige Empfangende seinen Teil abgeschlossen hat.
    • Alle Empfangenden in Klammern (Empfangender_4,Empfangender_5) werden als in einem parallelen Signaturfluss liegend identifiziert. 
      • Alle Mitglieder werden gleichzeitig benachrichtigt und alle müssen signieren.
    • Alle Empfangenden in eckigen Klammern [Empfangender_7,Empfangender_8] wird als Teil einer „Empfangsgruppe“ identifiziert. 
      • Alle Abonnierenden werden gleichzeitig benachrichtigt, aber nur ein Abonnierender kann unterschreiben.
    • Du kannst diese Methoden in beliebiger Reihenfolge mischen, um einen hybriden Signaturfluss zu erstellen:
      Beispiel: Empfangender_1, Empfangender_2,(Empfangender_3,Empfangender_4,Empfangender_5),Empfangender_6,(Empfangender_7,Empfangender_8),Empfangender_9
      • Eine Ausnahme bei der Option „Hybrider Workflow“ besteht darin, dass du keine parallele Ablaufstruktur (alle müssen unterschreiben) in eine Empfangsgruppenstruktur (nur ein Mitglied kann unterschreiben) einbetten kannst.
        z. B. [Empfangender_1,Empfangender_2,(Empfangender_3,Empfangender_4),Empfangender_5,Empfangender_6].
Die CSV-Datei mit den angezeigten vereinbarungsbezogenen Spalten

Um benutzerdefinierte Feldzuordnungen zur Transaktion Massenversand hinzuzufügen, musst du den Feldnamen in der Vorlage, die du hochlädst, verstehen. In der CSV-Datei muss der Feldname der Dokumentvorlage als Name für die Spaltenüberschrift verwendet werden.

Wenn in der Dokumentvorlage beispielsweise ein Feld mit dem Namen Investitionen vorhanden ist, muss die Spaltenüberschrift in der CSV-Datei Investitionen lauten.

Wenn ein Feld mit dem Namen Straße ausgefüllt werden soll, muss die Spaltenüberschrift in der CSV-Datei Straße lauten. 

Bei Spaltenüberschriften wird zwischen Groß- und Kleinschreibung unterschieden und die Feldnamen müssen genau übereinstimmen.

Beispiel einer CSV-Datei mit zwei Spalten für benutzerdefinierte Felder

Vorsicht:

Es gibt sechs Wörter, die nicht als selbstdefinierte Feldnamen verwendet werden dürfen:

  • Name
  • Titel
  • Firma
  • E-Mail
  • Signierdatum
  • Rolle
Vorsicht:

Die CSV-Datei darf kein Komma oder Leerzeichen am Ende einer Zeile oder am Ende der CSV-Datei enthalten.

Wenn am Ende einer Zeile oder am Ende der Datei ein Komma oder ein Leerzeichen steht, wird die folgende Fehlermeldung angezeigt: „Fehler beim Lesen der bereitgestellten CSV-Datei“.

Beispiel für eine CSV-Datei, in der nachstehende Kommas und eine leere Zeile am Ende der Datei hervorgehoben sind.

Adobe, Inc.

Schneller und einfacher Hilfe erhalten

Neuer Benutzer?