Memperbarui Baris di Excel menggunakan n8n tindakan
PDF4me Memperbarui Baris di Excel memodifikasi baris lembar kerja yang sudah ada secara langsung dari n8nBeri makan satu atau lebih JSON objek (selalu dibungkus dalam array) dan PDF4me Mencocokkan properti dengan header kolom, menerapkan konversi tipe otomatis, dan menelusuri lembar kerja secara berurutan mulai dari baris yang Anda pilih. Sempurna untuk sinkronisasi. SQL hasil yang menyegarkan CRM mengambil snapshot, atau menambal kolom status persetujuan tanpa menyisipkan baris baru.
Pengaturan
Tambahkan PDF4me Tambahkan node “Perbarui Baris” ke n8n alur kerja dan konfigurasikan parameter yang diperlukan. Untuk petunjuk pengaturan awal, lihat halaman kami. n8n Panduan Integrasi.
Prasyarat
- PDF4me API kredensial
- n8n akses alur kerja
Konfigurasi
- Tambahkan PDF4me simpul ke alur kerja
- Pilih tindakan "Perbarui baris"
- Berikan file sumber Excel-nya, JSON array, dan perbarui offset

Parameter
Penting: Parameter yang ditandai dengan tanda bintang (***) wajib diisi.
Json Dataharus selalu menjadi JSON array (bungkus baris tunggal dalam[]).
| Parameter | Jenis | Keterangan | Contoh |
|---|---|---|---|
| Tipe Data Masukan*** | String | Pemilih sumber Excel. Opsi: Binary Data, Base64 String, URL. | Binary Data |
| Masukkan Bidang Biner*** | Biner | Diperlukan ketika Input Data Type = Binary DataReferensi biner hulu. | {{ $binary.data }} |
| Konten Dokumen Base64*** | String | Diperlukan ketika Input Data Type = Base64 StringSediakan buku kerja base64. | UEsDBBQAAAA... |
| URL Dokumen*** | String | Diperlukan ketika Input Data Type = URLTautan publik ke buku kerja. | https://files.example.com/report.xlsx |
| Nama File*** | String | Nama pemrosesan/tampilan buku kerja (beserta ekstensinya). | inventory.xlsx |
| Data JSON*** | String | JSON Deretan objek. Setiap objek memperbarui satu baris secara berurutan. | [{"SKU":"A-100","Stock":45}] |
| Nama Lembar Kerja | String | Lembar kerja target. Kosong menggunakan lembar pertama. | Inventory |
| Baris Awal | Nomor | Baris lembar kerja berbasis 1 untuk mulai diperbarui (header biasanya baris 1). | 2 |
| Kolom Awal | Nomor | Offset kolom berbasis 1 digunakan untuk perataan header. | 1 |
| Konversi Angka dan Tanggal | Boolean | Konversi otomatis string numerik/tanggal menjadi nilai Excel. Default true. | true |
| Format Tanggal | String | Format tanggal Excel diterapkan saat konversi diaktifkan. | yyyy-MM-dd |
| Format Numerik | String | Format angka Excel saat konversi diaktifkan. | #,##0.00 |
| Abaikan Nilai Null | Boolean | Kapan trueNilai null tidak mengubah nilai sel yang sudah ada. | true |
| Abaikan Judul Atribut | Boolean | Pencocokan header tanpa memperhatikan huruf besar/kecil. Default false. | true |
| Nama Budaya | String | Budaya untuk mengurai angka/tanggal. Kosong = tidak berubah. | en-US |
| Nama Keluaran Data Biner*** | String | Nama slot biner keluaran yang menyimpan buku kerja yang telah ditambal. | document |
Keluaran
Parameter Keluaran
| Parameter | Jenis | Keterangan | Contoh |
|---|---|---|---|
| nama file | String | Nama file dokumen Excel dengan baris yang diperbarui - Nama file dokumen Excel keluaran setelah pembaruan baris | excel_updated.xlsx |
| Ukuran berkas | Nomor | Ukuran file dalam byte - Ukuran dokumen Excel dalam byte setelah pembaruan baris | 212810 |
| kesuksesan | Boolean | PDF4me status operasi - Boolean Bendera yang menunjukkan keberhasilan atau kegagalan proses pembaruan baris. PDF4me pengembalian true untuk operasi yang sukses dan false atas segala kesalahan | true |
| namafileasli | String | Nama file dokumen Excel asli - Nama file dokumen Excel yang dimasukkan | myExcelFile.xlsx |
| Nama lembar kerja | String | Nama lembar kerja - Nama lembar kerja tempat baris diperbarui | Sheet1 |
| baris awal | Nomor | Nomor baris awal - Nomor baris berbasis 1 tempat pembaruan dimulai | 1 |
| mulaiKolom | Nomor | Nomor kolom awal - Nomor kolom berbasis 1 tempat pembaruan dimulai | 1 |
| barisDiperbarui | Nomor | Jumlah baris yang diperbarui - Jumlah total baris yang berhasil diperbarui | 1 |
| konversiNumericAndDate | Boolean | Status konversi angka dan tanggal - Menunjukkan apakah konversi angka dan tanggal otomatis telah diaktifkan. true jika diaktifkan, false jika dinonaktifkan | true |
| Format tanggal | String | Format tanggal yang diterapkan - String format tanggal yang diterapkan selama konversi | yyyy-MM-dd |
| Format numerik | String | Format numerik diterapkan - String format numerik yang diterapkan selama konversi | N2 |
| abaikan nilai null | Boolean | Penanganan nilai null - Menunjukkan apakah nilai null diabaikan. true jika nilai null diabaikan (nilai yang sudah ada dipertahankan), false jika nilai null ditulis | false |
| abaikanJudulAtribut | Boolean | Pencocokan header tanpa memperhatikan huruf besar/kecil - Menunjukkan apakah pencocokan header tanpa memperhatikan huruf besar/kecil digunakan. true jika diaktifkan, false jika peka terhadap huruf besar/kecil | false |
| nama budaya | String | Kode Budaya/Lokal - Kode budaya yang digunakan untuk menguraikan angka dan tanggal (misalnya, "en-US", "de-DE", "fr-FR") | en-US |
| pesan | String | Pesan operasi - Pesan deskriptif yang menunjukkan hasil operasi pembaruan baris, termasuk jumlah baris yang diperbarui dan nama lembar kerja. | Successfully updated 1 row(s) in worksheet 'Sheet1' |
N8N Tindakan dan Respons
Yang PDF4me Perbarui baris API Mengembalikan respons yang dapat dilihat dalam berbagai format. Pilih tampilan yang paling sesuai dengan kebutuhan Anda:
- JSON
- Table
- Schema
- Binary
JSON Format Respons
Mentah JSON tanggapan dari API:
[
{
"fileName": "excel_updated.xlsx",
"fileSize": 212810,
"success": true,
"originalFileName": "myExcelFile.xlsx",
"worksheetName": "Sheet1",
"startRow": 1,
"startColumn": 1,
"rowsUpdated": 1,
"convertNumericAndDate": true,
"dateFormat": "yyyy-MM-dd",
"numericFormat": "N2",
"ignoreNullValues": false,
"ignoreAttributeTitles": false,
"cultureName": "en-US",
"message": "Successfully updated 1 row(s) in worksheet 'Sheet1'"
}
]
Tampilan Tabel
Data respons dalam format tabel terstruktur:
| Parameter | Nilai |
|---|---|
| nama file | excel_updated.xlsx |
| Ukuran berkas | 212810 |
| kesuksesan | true |
| namafileasli | myExcelFile.xlsx |
| Nama lembar kerja | Sheet1 |
| baris awal | 1 |
| mulaiKolom | 1 |
| barisDiperbarui | 1 |
| konversiNumericAndDate | true |
| Format tanggal | yyyy-MM-dd |
| Format numerik | N2 |
| abaikan nilai null | false |
| abaikanJudulAtribut | false |
| nama budaya | en-US |
| pesan | Successfully updated 1 row(s) in worksheet 'Sheet1' |
Tampilan Skema
Struktur data dan tipe respons:
1 item
fileName: T excel_updated.xlsx
fileSize: # 212810
success: ☑ true
originalFileName: T myExcelFile.xlsx
worksheetName: T Sheet1
startRow: # 1
startColumn: # 1
rowsUpdated: # 1
convertNumericAndDate: ☑ true
dateFormat: T yyyy-MM-dd
numericFormat: T N2
ignoreNullValues: ☑ false
ignoreAttributeTitles: ☑ false
cultureName: T en-US
message: T Successfully updated 1 row(s) in worksheet 'Sheet1'
Indikator Tipe:
T= String (Teks)#= Angka☑= Boolean[]= Array
Tampilan Data Biner
Data dan metadata file dokumen Excel yang sebenarnya:
data
─────────────────────────────
File Name: excel_updated.xlsx
File Extension: xlsx
Mime Type: application/vnd.openxmlformats-officedocument.spreadsheetml.sheet
File Size: 212.8 kB
Akses Data Biner:
- n8n Objek Biner:
$binary.data.data - Base64 Isi: Tersedia untuk penggunaan langsung
- Operasi FileSiap untuk diunduh, dikirim melalui email, atau disimpan.
Kasus Penggunaan
- Sinkronisasi inventaris: Perbarui jumlah stok yang diambil dari ERP kueri sambil tetap mempertahankan harga dan metadata tanpa mengubah apa pun.
- Status pesanan atau proyek: Status patch, pemilik, atau SLA kolom setiap kali sistem hulu mengeluarkan pembaruan.
- Penyesuaian keuangan: Menulis ulang baris perkiraan atau data aktual setiap malam tanpa merusak rumus/struktur yang ada.