BuildFileFromProperties

Zum Erstellen der Ausgabedatei schreibt der Schritt zunächst den Wert des Merkmals Datei-Header in die Ausgabedatei. Dann schreibt der Schritt den Wert des Merkmals Dateistruktur in die Datei, einmal für alle Dokumente in der Datei der Dokumentmerkmale. Wenn es einen Wert für die Eigenschaft Begrenzer gibt, wird dieser nach jedem Vorkommen des Textes Dateistruktur eingefügt, mit Ausnahme des letzten Vorkommens. Zum Schluss schreibt der Schritt den Wert des Merkmals Fußzeile der Datei in die Datei.

Sie können für alle diese Eigenschaftswerte die Symbolschreibweise RICOH ProcessDirector verwenden. Die Symbole sind Platzhalter für den Job und die Dokumentwerte, die Sie in der Datei hinzufügen möchten, wenn der Schritt diese erstellt.

Sie können in den Merkmalen Datei-Header und Fußzeile der Datei Symbole für Jobmerkmale verwenden, jedoch nicht für Dokumentmerkmale.

Sie können Symbole für sowohl Job- als auch Dokumentmerkmale im Wert für das Merkmal Dateistruktur verwenden. In der Ausgabedatei sind die Jobwerte für alle Dokumente gleich.

Der Schritt verwendet die Datei der Dokumentmerkmale im Spoolverzeichnis für den Job als Eingabe. Der Dateiname hat das Format jobid.document.dpf, wobei jobid die Jobnummer darstellt. Beispiel: 10000009.document.dpf. Die erste Zeile in der Datei enthält den Namen der Datenbank für alle Dokumentmerkmale. Jede zusätzliche Zeile enthält Werte für jedes der Merkmale aus einem einzigen Dokument.

Beispiel

Diese Beispiele zeigen, wie der Schritt eine XML-, eine CSV- oder eine JSON-Ausgabedatei für drei Dokumente in einem Job namens Bank Statements 02032017 mit 14 Seiten erstellt.

Das Beispiel erstellt XML-Elemente, die den Wert von zwei Jobmerkmalen enthalten:

• Jobname ( Job.Name)
• Gesamtzahl Seiten ( Job.TotalPages)

Die Datenbanknamen der Merkmale werden in Klammern dargestellt.

Das Beispiel erstellt Elemente, die die Werte von vier Dokumenteigenschaften enthalten:

• Dokumentnummer ( Doc.ID)
• Aktuelle Seiten ( Doc.CurrentPages)
• Kundenname ( Doc.Custom.CustomerName)
• Kundenkontonummer ( Doc.Custom.AccountNumber)

Wert des Merkmals Datei-Header:

XML

<?xml version="1.0" encoding="utf-8"?>
<InputFile>
  <PDF>${Job.Name}</PDF>
  <TotalPages>${Job.TotalPages}</TotalPages>

JSON

{
  "JobName": "{Job.Name}",
  "TotalPages": {Job.TotalPages},
  "Documents": [

CSV

JobName,TotalPages,DocNumber,PageCount,Custname,CustAccount

Wert des Merkmals Dateistruktur:

XML

<Document>
  <DocNumber>{Doc.ID}</DocNumber>
  <PageCount>{Doc.CurrentPages}</PageCount>
  <Customer Custname="{Doc.Custom.CustomerName}" CustAccount="{Doc.Custom.AccountNumber}" />
</Document>

JSON

{
    "DocNumber": {Doc.ID},
    "PageCount": {Doc.CurrentPages},
    "Custname": "{Doc.Custom.CustomerName}",
    "CustAccount": "{Doc.Custom.AccountNumber}"
  }

CSV

{Job.Name},{Job.TotalPages},{Doc.ID},{Doc.CurrentPages},{Doc.Custom.CustomerName},{Doc.Custom.AccountNumber}

Wert der Eigenschaft Begrenzer:

JSON

,

Hinweis:
• Wenn Sie eine XML- oder CSV-Datei erstellen, können Sie die Eigenschaft Begrenzer leer lassen.

Wert des Merkmals Fußzeile der Datei:

XML

</InputFile>

JSON

  ]
}

Hinweis:
• Wenn Sie eine CSV-Datei erstellen, können Sie die Eigenschaft Fußzeile der Datei leer lassen.

Die Dokumentmerkmaldatei wird im Spoolverzeichnis für den Job gespeichert:

Doc.ID,Doc.CurrentPages,Doc.Custom.CustomerName,Doc.Custom.AccountNumber
1,4,Jane Smith,SA349088
2,4,Chris Lopez,SA347202
3,6,John Gray,SA340655

XML-Ausgabedatei:

<?xml version="1.0" encoding="utf-8"?>
<InputFile>
  <PDF>Bank Statements 02032017</PDF>
  <TotalPages>14</TotalPages>
  <Document>
    <DocNumber>1</DocNumber>
    <PageCount>4</PageCount>
    <Customer Custname="Jane Smith" CustAccount="SA349088" />
  </Document>
  <Document>
    <DocNumber>2</DocNumber>
    <PageCount>4</PageCount>
    <Customer Custname="Chris Lopez" CustAccount="SA347202" />
  </Document>
  <Document>
    <DocNumber>3</DocNumber>
    <PageCount>6</PageCount>
    <Customer Custname="John Gray" CustAccount="SA340655" />
  </Document>
</InputFile>

JSON-Ausgabedatei (mit der Eigenschaft Begrenzer)

{
  "JobName": "Bank Statements 02032017",
  "TotalPages": 14,
  "Documents": [
    {
      "DocNumber": 1,
      "PageCount": 4,
      "Custname": "Jane Smith",
      "CustAccount": "SA349088"
    },
    {
      "DocNumber": 2,
      "PageCount": 4,
      "Custname": "Chris Lopez",
      "CustAccount": "SA347202"
    },
    {
      "DocNumber": 3,
      "PageCount": 6,
      "Custname": "John Gray",
      "CustAccount": "SA340655"
    }
  ]
}

CSV-Ausgabedatei

JobName,TotalPages,DocNumber,PageCount,Custname,CustAccount
Bank Statements 02032017,14,1,4,Jane Smith,SA349088
Bank Statements 02032017,14,2,4,Chris Lopez,SA347202
Bank Statements 02032017,14,3,6,John Gray,SA340655

Standardwerte für Jobmerkmale

• Datei-Header:

• Dateistruktur:

• Begrenzer:

• Fußzeile der Datei:

• Ausgabedatei:

Hinweise zur Verwendung:

• Für die Erstellung einer Ausgabedatei, die die Werte der Jobmerkmale jedoch nicht die Dokumentmerkmale enthält, muss der Wert des Merkmals Dateistruktur frei bleiben.
• Der Schritt schreibt den Wert des Merkmals Dateistruktur in die Ausgabedatei nur dann, wenn diese beiden Bedingungen zutreffen:
  • Das Merkmal Dateistruktur gibt einen Wert an, der sich typischerweise auf ein oder mehrere gültige Dokumentmerkmale bezieht.
  • Das Spoolverzeichnis für den Job enthält eine Dokumentmerkmaldatei.

• Sie können ein oder mehrere Zeichen in der Eigenschaft Begrenzer verwenden, um jedes Vorkommen des Textes zu trennen.

• Wenn Sie eine XML- oder JSON-Ausgabe erstellt haben, können Sie diese validieren, indem Sie einen Schritt verwenden, der auf der Schrittvorlage CheckFileStructure basiert.
• Wenn für die Merkmale Datei-Header, Dateistruktur und Fußzeile der Datei keine Werte bereitgestellt werden, erstellt der Schritt eine leere Datei.