Zum Hauptinhalt springen
PDF4me APIIntegrationenWissensdatenbankErweiterungenAPI-TesterBlog

Listen in Vorlagen – Aufzählungszeichen & Nummerierung

Listen sind grundlegende Strukturen zur Organisation und Präsentation von Informationen in Dokumenten. PDF4meDie Template-Engine von unterstützt sowohl die Generierung von Aufzählungslisten als auch von nummerierten Listen, sodass Sie gut strukturierte, lesbare Dokumente mit dynamischen Inhalten aus Ihren Datenquellen erstellen können.

Stichpunktlisten​

Erstellen Sie Aufzählungslisten, indem Sie foreach-Schleifen innerhalb von Absätzen im Aufzählungsformat in Ihrem Text platzieren. Word Vorlage.

Grundlegende Syntax für Aufzählungslisten​

Erstellen Sie einen Absatz mit Aufzählungspunkten in WordFüge dann die foreach-Schleife hinzu:

<<foreach [bullet in EmployeeNames]>><<[bullet.listFirstName]>> <<[bullet.listLastName]>> 
<</foreach>>

Wichtigste Schritte:

  1. In Word, einen Stichpunkt erstellen (Aufzählungszeichenformatierung verwenden)
  2. Füge die foreach-Schleife hinzu und führe die Felder zusammen.
  3. Die Schleife wiederholt den Aufzählungspunkt für jedes Element.

Beispiel: Mitarbeiternamensliste​

Vorlagendesign:

Employee Directory:
• <<foreach [bullet in EmployeeNames]>><<[bullet.listFirstName]>> <<[bullet.listLastName]>> 
<</foreach>>

Datenquelle:

{
  "companyName": "PDF4me",  
  "EmployeeNames": [
    {
      "listFirstName": "Thomas",
      "listLastName": "Baskin"
    },
    {
      "listFirstName": "Jacob",
      "listLastName": "Gregory"
    },
    {
      "listFirstName": "John",
      "listLastName": "Doe"
    }
  ]
}

Generierte Ausgabe:

Employee Directory:
• Thomas Baskin
• Jacob Gregory
• John Doe

Nummerierte Listen​

Erzeugen Sie nummerierte Listen mit demselben foreach-Ansatz, jedoch mit nummerierter Absatzformatierung in WordDie

Syntax für nummerierte Listen​

Numbered List - Instead of bullets, if you apply the syntax in a numbered paragraph format in Word, the list will be generated as a numbered list with automatic numbering.

Beispiel: Aufgabenliste​

Vorlage:

Project Tasks:
1. <<foreach [task in tasks]>><<[task.name]>> - <<[task.status]>>
<</foreach>>

Daten:

{
  "tasks": [
    { "name": "Design mockups", "status": "Complete" },
    { "name": "Develop features", "status": "In Progress" },
    { "name": "Testing phase", "status": "Pending" }
  ]
}

Ausgabe:

Project Tasks:
1. Design mockups - Complete
2. Develop features - In Progress
3. Testing phase - Pending

Mehrstufige Listen​

Erstellen Sie hierarchische Listenstrukturen mit Eltern-Kind-Beziehungen mithilfe verschachtelter foreach-Schleifen.

Beispiel einer zweistufigen Hierarchie​

Vorlagendesign:

<<foreach [manager in employees]>>Manager: <<[manager.listFirstName]>> <<[manager.listLastName]>>
    <<foreach [associate in manager.associates]>>Associate: <<[associate.name]>>
<</foreach>><</foreach>>

Wichtig: Die Listenelemente der zweiten Ebene sollten in Ihrem Word Vorlage zur Erstellung einer korrekten hierarchischen Formatierung.

Beispiel: Organisationsstruktur​

Datenstruktur:

{
  "companyName": "PDF4me",
  "employees": [
    {
      "listFirstName": "Christopher",
      "listLastName": "Nolan",
      "associates": [
        { "name": "Will Smith" },
        { "name": "Barry Allen" },
        { "name": "Oliver Queen" }
      ]
    },
    {
      "listFirstName": "Sarah",
      "listLastName": "Parker",
      "associates": []
    },
    {
      "listFirstName": "Justin",
      "listLastName": "Langer",
      "associates": [
        { "name": "Brad Pitt" },
        { "name": "John Smith" }
      ]
    }
  ]
}

Generierte Ausgabe:

• Manager: Christopher Nolan
    ○ Associate: Will Smith
    ○ Associate: Barry Allen
    ○ Associate: Oliver Queen
• Manager: Sarah Parker
• Manager: Justin Langer
    ○ Associate: Brad Pitt
    ○ Associate: John Smith

Umgang mit leeren Unterlisten​

Verwenden Sie bedingte Prüfungen, um Fälle zu behandeln, in denen Unterlisten leer sein könnten.

Bedingte Unterliste​

Vorlage:

<<foreach [manager in employees]>>Manager: <<[manager.listFirstName]>> <<[manager.listLastName]>>
    <<if [manager.associates.Any()]>>
    <<foreach [associate in manager.associates]>>Associate: <<[associate.name]>>
    <</foreach>>
    <<else>>
    No associates assigned
    <</if>>
<</foreach>>

Formatierte Listenelemente​

Formatieren Sie den Inhalt der Listenelemente, um die Darstellung zu verbessern.

Beispiel: Formatierte Namen und Datumsangaben​

Vorlage:

• <<foreach [employee in employees]>><<[employee.name]:caps>> - Joined: <<[employee.joinDate]:"MMMM yyyy"]>>
<</foreach>>

Daten:

{
  "employees": [
    { "name": "john smith", "joinDate": "2020/03/15" },
    { "name": "jane doe", "joinDate": "2021/07/22" }
  ]
}

Ausgabe:

• John Smith - Joined: March 2020
• Jane Doe - Joined: July 2021

Sortierte Listen​

Erzeugen Sie Listen in einer bestimmten Reihenfolge mithilfe von Aufzählungsmethoden.

Alphabetisch sortierte Liste​

Vorlage:

• <<foreach [person in people.OrderBy(p => p.lastName)]>><<[person.lastName]>>, <<[person.firstName]>>
<</foreach>>

Sortiert nach mehreren Eigenschaften​

Vorlage:

• <<foreach [emp in employees.OrderBy(e => e.department).ThenBy(e => e.name)]>><<[emp.name]>> - <<[emp.department]>>
<</foreach>>

Gefilterte Listen​

Es werden nur Artikel angezeigt, die bestimmte Kriterien erfüllen.

Bedingte Filterung​

Vorlage:

Active Employees:
• <<foreach [emp in employees.Where(e => e.status == "Active")]>><<[emp.name]>>
<</foreach>>

Altersbasierte Filterung​

Vorlage:

Senior Team Members:
• <<foreach [person in team.Where(p => p.age > 50)]>><<[person.name]>> (Age: <<[person.age]>>)
<</foreach>>

Gemischte Listentypen​

Kombinieren Sie verschiedene Listenstile innerhalb desselben Dokuments.

Beispiel: Projektübersicht​

Vorlage:

Project Phases (Numbered):
1. <<foreach [phase in phases]>><<[phase.name]>>
<</foreach>>

Team Members (Bulleted):
• <<foreach [member in team]>><<[member.name]>> - <<[member.role]>>
<</foreach>>

Komplexe mehrstufige Beispiele​

Dreistufige Hierarchie​

Vorlage:

<<foreach [dept in departments]>>Department: <<[dept.name]>>
    <<foreach [team in dept.teams]>>Team: <<[team.name]>>
        <<foreach [member in team.members]>><<[member.name]>> - <<[member.position]>>
        <</foreach>>
    <</foreach>>
<</foreach>>

Dadurch entsteht:

  • Ebene 1: Abteilung (Aufzählungszeichen 1)
    • Stufe 2: Team (Aufzählungszeichen 2)
      • Stufe 3: Mitglied (Aufzählungszeichen 3)

Listendesign in Word Vorlage​

Listenformatierung einrichten​

  1. Listenstruktur erstellen - Verwenden Worddie integrierten Listenformatierungswerkzeuge
  2. Wählen Sie den Aufzählungsstil. - Wählen Sie den passenden Aufzählungs- oder Nummerierungsstil.
  3. Einrückung festlegen - Einrückungsebenen für mehrstufige Listen konfigurieren
  4. Zusammenführungsfelder hinzufügen - Füge foreach-Schleifen und die Syntax zum Zusammenführen von Feldern ein
  5. Formatierung beibehalten - Stellen Sie sicher, dass die Listenformatierung auf den Vorlagentext angewendet wird.

Einrückungsebenen​

Für mehrstufige Listen:

  • Stufe 1: Keine Einrückung oder Einrückung erster Ebene.
  • Stufe 2: Eine Tabulator- oder Einrückungserhöhung
  • Stufe 3: Zwei Tabulatoren oder Einzug zweiter Ebene.

Word Die Formatierung von Aufzählungszeichen/Nummern erfolgt automatisch basierend auf der Einrückungsebene.

Praktische Anwendungen​

Anwendungsfall 1: Tagesordnung für Besprechungen​

Vorlage:

Meeting Agenda - <<[meetingDate]:"MMMM dd, yyyy">>

1. <<foreach [item in agendaItems]>><<[item.title]>> (<<[item.duration]>> min)
<</foreach>>

Attendees:
• <<foreach [attendee in attendees]>><<[attendee.name]>> - <<[attendee.department]>>
<</foreach>>

Anwendungsfall 2: Produktmerkmale​

Vorlage:

<<[productName]>> Features:

• <<foreach [feature in features]>><<[feature.name]>> - <<[feature.description]>>
<</foreach>>

Technical Specifications:
1. <<foreach [spec in specifications]>><<[spec.parameter]>>: <<[spec.value]>>
<</foreach>>

Anwendungsfall 3: Rechnungspositionen​

Vorlage:

Order Items:
<<foreach [item in orderItems]>>
<<[$index + 1]>>. <<[item.name]>> - Quantity: <<[item.qty]>> - Price: $<<[item.price]>>
<</foreach>>

Total Items: <<[orderItems.Count()]>>
Total Amount: $<<[orderItems.Sum(i => i.qty * i.price)]>>

Bewährte Verfahren​

Listendesign​

  1. Einheitliche Formatierung - Verwenden Sie für ähnliche Inhaltstypen denselben Listenstil.
  2. Angemessene Tiefe - Beschränken Sie die Verschachtelung aus Gründen der Lesbarkeit auf 3-4 Ebenen.
  3. Logische Gruppierung - Zusammengehörige Elemente gruppieren
  4. Klare Hierarchie - Verwenden Sie für verschiedene Ebenen unterschiedliche Aufzählungszeichenstile.

Datenstruktur​

  1. Saubere Sammlungen - Sicherstellen, dass die Sammlungen gültige und vollständige Daten enthalten
  2. Konsistente Eigenschaften - Verwenden Sie für alle Elemente einheitliche Eigenschaftsnamen.
  3. Nullwerte behandeln - Prüfen Sie mit auf leere Sammlungen Any()
  4. Entsprechend sortieren - Daten vorsortieren oder OrderBy in Vorlagen verwenden

Leistung​

  1. Begrenzen Sie die Listengröße - Bei sehr langen Listen die Paginierung in Betracht ziehen.
  2. Effizientes Filtern - Filter nach Möglichkeit direkt in der Datenquelle anwenden
  3. Vermeiden Sie komplexe Verschachtelungen. - Tiefe Verschachtelung kann die Verarbeitungsgeschwindigkeit beeinträchtigen

:::Tipp Listenformatierung Wenden Sie die Listenformatierung (Aufzählungszeichen, Nummerierung, Einrückung) direkt in Ihrem Word Vorlage vor dem Hinzufügen von foreach-Schleifen. Die Template-Engine behält die von Ihnen festgelegte Formatierung bei. Word.

:::