Lewati ke konten utama
API PDF4meIntegrasiBasis PengetahuanEkstensiPenguji APIBlog

Daftar dalam Templat - Poin dan Penomoran

Daftar adalah struktur fundamental untuk mengatur dan menyajikan informasi dalam dokumen. PDF4meMesin templatnya mendukung pembuatan daftar berpoin dan bernomor, memungkinkan Anda membuat dokumen yang terstruktur dengan baik dan mudah dibaca dengan konten dinamis dari sumber data Anda.

Daftar Berpoin​

Buat daftar berpoin dengan menempatkan perulangan foreach di dalam paragraf berformat poin di dalam Word templat.

Sintaks Daftar Poin Dasar​

Buat paragraf berpoin di Word, lalu tambahkan perulangan foreach:

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

Langkah-langkah Utama:

  1. Di dalam Word, buat poin-poin (gunakan format poin)
  2. Tambahkan perulangan foreach dan gabungkan kolom.
  3. Perulangan akan mengulang poin tersebut untuk setiap item.

Contoh: Daftar Nama Karyawan​

Desain Templat:

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

Sumber Data:

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

Output yang dihasilkan:

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

Daftar Bernomor​

Buat daftar bernomor menggunakan pendekatan foreach yang sama, tetapi dengan format paragraf bernomor. Word.

Sintaks Daftar Bernomor​

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.

Contoh: Daftar Tugas​

Templat:

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

Data:

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

Keluaran:

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

Daftar Bertingkat​

Buat struktur daftar hierarkis dengan hubungan induk-anak menggunakan perulangan foreach bersarang.

Contoh Hierarki Dua Tingkat​

Desain Templat:

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

Penting: Item daftar tingkat kedua harus diberi indentasi pada daftar Anda. Word Templat untuk membuat format hierarki yang tepat.

Contoh: Struktur Organisasi​

Struktur Data:

{
  "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" }
      ]
    }
  ]
}

Output yang dihasilkan:

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

Menangani Sub-Daftar Kosong​

Gunakan pemeriksaan bersyarat untuk menangani kasus di mana sub-daftar mungkin kosong.

Sub-Daftar Bersyarat​

Templat:

<<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>>

Item Daftar yang Diformat​

Terapkan pemformatan pada konten item daftar untuk presentasi yang lebih baik.

Contoh: Nama dan Tanggal yang Diformat​

Templat:

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

Data:

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

Keluaran:

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

Daftar yang Diurutkan​

Buat daftar dalam urutan tertentu menggunakan metode enumerasi.

Daftar yang Diurutkan Berdasarkan Abjad​

Templat:

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

Diurutkan berdasarkan Beberapa Properti​

Templat:

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

Daftar yang Difilter​

Tampilkan hanya item yang memenuhi kriteria tertentu.

Penyaringan Bersyarat​

Templat:

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

Penyaringan Berdasarkan Usia​

Templat:

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

Jenis Daftar Campuran​

Menggabungkan berbagai gaya daftar dalam dokumen yang sama.

Contoh: Gambaran Umum Proyek​

Templat:

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

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

Contoh Kompleks Bertingkat​

Hierarki Tiga Tingkat​

Templat:

<<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>>

Hal ini menghasilkan:

  • Level 1: Departemen (gaya poin 1)
    • Level 2: Tim (gaya peluru 2)
      • Level 3: Anggota (gaya poin 3)

Desain Daftar di Word Templat​

Mengatur Pemformatan Daftar​

  1. Buat struktur daftar - Menggunakan Wordalat pemformatan daftar bawaan
  2. Pilih gaya poin - Pilih gaya poin atau penomoran yang sesuai
  3. Atur indentasi - Konfigurasikan tingkat indentasi untuk daftar bertingkat
  4. Tambahkan kolom gabungan - Sisipkan sintaks perulangan foreach dan penggabungan kolom
  5. Pertahankan formatnya - Pastikan pemformatan daftar diterapkan pada teks templat

Tingkat Indentasi​

Untuk daftar bertingkat:

  • Level 1: Tidak ada indentasi atau indentasi tingkat pertama.
  • Level 2: Penambahan satu tab atau indentasi
  • Level 3: Dua tab atau indentasi tingkat kedua

Word Secara otomatis menangani penataan poin/nomor berdasarkan tingkat indentasi.

Aplikasi Praktis​

Kasus Penggunaan 1: Agenda Rapat​

Templat:

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>>

Kasus Penggunaan 2: Fitur Produk​

Templat:

<<[productName]>> Features:

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

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

Kasus Penggunaan 3: Item Faktur​

Templat:

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)]>>

Praktik Terbaik​

Desain Daftar​

  1. Format yang konsisten - Gunakan gaya daftar yang sama untuk jenis konten yang serupa
  2. Kedalaman yang sesuai - Batasi penestingan hingga 3-4 level untuk keterbacaan.
  3. Pengelompokan logis - Kelompokkan item-item yang terkait bersama-sama
  4. Hierarki yang jelas - Gunakan gaya poin yang berbeda untuk level yang berbeda

Struktur Data​

  1. Koleksi bersih - Pastikan koleksi berisi data yang valid dan lengkap
  2. Sifat yang konsisten - Gunakan nama properti yang konsisten di seluruh item
  3. Tangani nilai null - Periksa koleksi yang kosong dengan Any()
  4. Urutkan dengan tepat - Urutkan data terlebih dahulu atau gunakan OrderBy di templat.

Pertunjukan​

  1. Batasi ukuran daftar - Pertimbangkan penggunaan paginasi untuk daftar yang sangat panjang
  2. Saring secara efisien. - Terapkan filter pada sumber data jika memungkinkan
  3. Hindari penataan bertingkat yang kompleks. - Penataan bertingkat yang dalam dapat memengaruhi kecepatan pemrosesan
Pemformatan Daftar

Terapkan pemformatan daftar (poin, angka, indentasi) langsung di dalam daftar Anda Word Gunakan template sebelum menambahkan perulangan foreach. Mesin template akan mempertahankan format yang Anda tetapkan. Word.