Ekstrak baris dari lembar kerja Excel menggunakan n8n tindakan

PDF4me Ekstrak Baris Mengubah setiap bagian lembar kerja menjadi siap pakai. JSON di dalam n8nTentukan rentang baris/kolom berbasis 0, putuskan apakah baris pertama harus menjadi header, lewati baris tersembunyi atau kosong, dan pilih apakah nilai tetap diketik (angka, boolean, ISO tanggal) atau dipaksa menjadi teks. Ideal untuk memasukkan data Excel ke dalam APIs, basis data, atau tambahan PDF4me tindakan.

Postingan Blog Terkait

Belum ada postingan blog untuk fitur ini — akan segera hadir.

Sementara itu, jelajahi blog PDF4me untuk menemukan tutorial dan alur kerja di berbagai platform.

Kunjungi blog ini →

Pengaturan

Tambahkan PDF4me Tambahkan node “Ekstrak 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

Get Your API Key

Konfigurasi

Tambahkan PDF4me simpul ke alur kerja
Pilih tindakan "Ekstrak baris dari lembar kerja Excel"
Sediakan file sumber Excel dan jendela ekstraksi.

Parameter

Penting: Parameter yang ditandai dengan tanda bintang (***) wajib diisi. Indeks baris/kolom adalah berbasis 0 (Baris 0 = Baris 1 Excel).

Parameter	Jenis	Keterangan	Contoh
Tipe Data Masukan***	String	Pemilih sumber Excel (`Binary Data`, `Base64 String`, `URL`).	`Binary Data`
Masukkan Bidang Biner***	Biner	Diperlukan ketika `Binary Data` dipilih.	`{{ $binary.data }}`
Konten Dokumen Base64***	String	Diperlukan ketika `Base64 String` dipilih.	`UEsDBBQAAAA...`
URL Dokumen***	String	Diperlukan ketika `URL` dipilih. Tautan file publik.	`https://files.example.com/report.xlsx`
Nama File***	String	Nama buku kerja yang logis beserta ekstensinya.	`analytics.xlsx`
Nama Lembar Kerja	String	Lembar kerja untuk dibaca. Kosong = lembar pertama.	`Summary`
Baris Pertama***	Nomor	Baris awal berbasis 0 untuk ekstraksi.	`0`
Baris Terakhir	Nomor	Baris akhir berbasis 0. Gunakan `-1` untuk membaca hingga baris data terakhir.	`-1`
Kolom Pertama	Nomor	Kolom awal berbasis 0 (0 = kolom A).	`0`
Kolom Terakhir	Nomor	Kolom akhir berbasis 0. Gunakan `-1` untuk kolom data terakhir.	`-1`
Memiliki Baris Header	Boolean	`true` menggunakan `First Row` sebagai judul kolom dan mengecualikannya dari data.	`true`
Kecualikan Baris Tersembunyi	Boolean	Lewati baris yang disembunyikan di Excel.	`false`
Kecualikan Kolom Tersembunyi	Boolean	Lewati kolom tersembunyi.	`false`
Kecualikan Baris Kosong	Boolean	Hapus baris yang semua selnya kosong.	`true`
Ekspor Sel Kosong	Boolean	Sertakan sel kosong dengan nilai berupa string kosong, alih-alih menghilangkannya.	`false`
Ekspor Nilai Sebagai Teks	Boolean	Paksa semua nilai menjadi string. `false` Melestarikan tipe asli.	`false`
Nama Keluaran Data Biner***	String	Slot biner menyimpan serialisasi JSON (PDF4me pengembalian JSON byte).	`document`

Keluaran

Parameter Keluaran

Parameter	Jenis	Keterangan	Contoh
kesuksesan	Boolean	PDF4me status operasi - Boolean Bendera yang menunjukkan keberhasilan atau kegagalan proses ekstraksi 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-baris tersebut diekstrak	`First Worksheet`
hasHeaderRow	Boolean	Status baris header - Menunjukkan apakah baris pertama diperlakukan sebagai header. `true` jika header digunakan, `false` jika tidak	`true`
Baris pertama	Nomor	Indeks baris pertama (berbasis 0) - Indeks berbasis 0 dari baris pertama yang diekstrak	`0`
baris terakhir	Nomor	Indeks baris terakhir (berbasis 0) - Indeks berbasis 0 dari baris terakhir yang diekstrak. `-1` menunjukkan ekstraksi ke baris data terakhir	`2`
Kolom pertama	Nomor	Indeks kolom pertama (berbasis 0) - Indeks berbasis 0 dari kolom pertama yang diekstrak (0 = kolom A)	`0`
kolom terakhir	Nomor	Indeks kolom terakhir (berbasis 0) - Indeks berbasis 0 dari kolom terakhir yang diekstrak. `-1` menunjukkan ekstraksi ke kolom data terakhir	`-1`
kecualikanBarisKosong	Boolean	Pengecualian baris kosong - Menunjukkan apakah baris kosong telah dikecualikan. `true` jika dikecualikan, `false` jika disertakan	`true`
mengecualikanBarisTersembunyi	Boolean	Pengecualian baris tersembunyi - Menunjukkan apakah baris tersembunyi telah dikecualikan. `true` jika dikecualikan, `false` jika disertakan	`true`
kecualikanKolomTersembunyi	Boolean	Pengecualian kolom tersembunyi - Menunjukkan apakah kolom tersembunyi telah dikecualikan. `true` jika dikecualikan, `false` jika disertakan	`true`
eksporNilaiSebagaiTeks	Boolean	Mode ekspor teks - Menunjukkan apakah nilai diekspor sebagai teks. `true` jika dipaksa menggunakan senar, `false` jika tipe asli dipertahankan	`false`
eksporSelKosong	Boolean	Ekspor sel kosong - Menunjukkan apakah sel kosong diekspor. `true` jika disertakan dengan string kosong, `false` jika dihilangkan	`false`
eksporSebagaiObjek	Boolean	Mode ekspor objek - Menunjukkan apakah data diekspor dalam format objek	`false`
hyperlinkFormat	String	Format hyperlink - Format yang digunakan untuk hyperlink dalam data yang diekstrak. Nilai: "Teks", "URL", dll.	`Text`
budaya	String	Kode Budaya/Lokal - Kode budaya yang digunakan untuk ekstraksi data (misalnya, "en-US", "de-DE", "fr-FR")	`en-US`
baris yang diekstrak	Nomor	Jumlah baris yang diekstrak - Jumlah total baris yang berhasil diekstrak	`1`
Data yang diekstrak	Object	Objek data yang diekstrak - Objek bersarang yang berisi data baris yang diekstrak dengan array rowData	`{"rowData": [{"Column1": 1, "First Name": "Dulce"}]}`
pesan	String	Pesan operasi - Pesan deskriptif yang menunjukkan hasil operasi ekstraksi baris, termasuk jumlah baris yang diekstrak dan nama lembar kerja.	`Successfully extracted 1 row(s) from worksheet 'First Worksheet'`

N8N Tindakan dan Respons

Yang PDF4me Ekstrak baris dari lembar kerja Excel 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:

[
{
"success": true,
"originalFileName": "myExcelFile.xlsx",
"worksheetName": "First Worksheet",
"hasHeaderRow": true,
"firstRow": 0,
"lastRow": 2,
"firstColumn": 0,
"lastColumn": -1,
"excludeEmptyRows": true,
"excludeHiddenRows": true,
"excludeHiddenColumns": true,
"exportValuesAsText": false,
"exportEmptyCells": false,
"exportAsObject": false,
"hyperlinkFormat": "Text",
"culture": "en-US",
"rowsExtracted": 1,
"extractedData": {
"document": null,
"fileName": null,
"success": true,
"errorMessage": null,
"rowData": [
{
"Column1": 1,
"First Name": "Dulce",
"Last Name": "Abril",
"Gender": "Female",
"Country": "United States",
"Age": 32,
"Date": "15/10/2017",
"Id": 1562
},
{
"Column1": 2,
"First Name": "Mara",
"Last Name": "Hashimoto",
"Gender": "Female",
"Country": "Great Britain",
"Age": 25,
"Date": "16/08/2016",
"Id": 1582
}
]
},
"message": "Successfully extracted 1 row(s) from worksheet 'First Worksheet'"
}
]

Tampilan Tabel

Data respons dalam format tabel terstruktur:

Parameter	Nilai
kesuksesan	`true`
namafileasli	`myExcelFile.xlsx`
Nama lembar kerja	`First Worksheet`
hasHeaderRow	`true`
Baris pertama	`0`
baris terakhir	`2`
Kolom pertama	`0`
Kolom terakhir	`-1`
kecualikanBarisKosong	`true`
mengecualikanBarisTersembunyi	`true`
kecualikanKolomTersembunyi	`true`
eksporNilaiSebagaiTeks	`false`
eksporSelKosong	`false`
eksporSebagaiObjek	`false`
hyperlinkFormat	`Text`
budaya	`en-US`
baris yang diekstrak	`1`
Data yang diekstrak	Objek yang berisi array rowData
pesan	`Successfully extracted 1 row(s) from worksheet 'First Worksheet'`

Objek Data yang Diekstrak:

Parameter	Nilai
dokumen	`null`
nama file	`null`
kesuksesan	`true`
pesan kesalahan	`null`
data baris	Array objek baris yang diekstrak

Catatan: rowData berisi objek baris yang diekstrak sebagai array dengan header kolom sebagai kunci.

Tampilan Skema

Struktur data dan tipe respons:

1 item
success: ☑ true
originalFileName: T myExcelFile.xlsx
worksheetName: T First Worksheet
hasHeaderRow: ☑ true
firstRow: # 0
lastRow: # 2
firstColumn: # 0
lastColumn: # -1
excludeEmptyRows: ☑ true
excludeHiddenRows: ☑ true
excludeHiddenColumns: ☑ true
exportValuesAsText: ☑ false
exportEmptyCells: ☑ false
exportAsObject: ☑ false
hyperlinkFormat: T Text
culture: T en-US
rowsExtracted: # 1
extractedData: {} Object
document: null
fileName: null
success: ☑ true
errorMessage: null
rowData: [] Array
[0]: {} Object
Column1: # 1
First Name: T Dulce
Last Name: T Abril
Gender: T Female
Country: T United States
Age: # 32
Date: T 15/10/2017
Id: # 1562
[1]: {} Object
Column1: # 2
First Name: T Mara
Last Name: T Hashimoto
Gender: T Female
Country: T Great Britain
Age: # 25
Date: T 16/08/2016
Id: # 1582
message: T Successfully extracted 1 row(s) from worksheet 'First Worksheet'

Indikator Tipe:

T = String (Teks)
# = Angka
☑ = Boolean
[] = Array
{} = Object
null = Nilai null

Tampilan Data Biner

Data yang diekstrak dikembalikan sebagai JSON dalam respons. Akses data baris secara langsung dari extractedData.rowData array:

extractedData
─────────────────────────────
rowData: Array of row objects
success: true
errorMessage: null

Akses Data:

Array Data Baris: $json.extractedData.rowData
Baris Individual: $json.extractedData.rowData[0]
Nilai Kolom: $json.extractedData.rowData[0]["First Name"]
JSON TanggapanTersedia dalam bentuk terstruktur. JSON di dalam n8n tanggapan

Kasus Penggunaan

API memberi makanEkstrak baris yang difilter dan dorong langsung ke REST titik akhir atau konsumen webhook.
Pengambilan data dari basis dataUbah laporan Excel menjadi terstruktur. JSON setiap malam sebelum dimasukkan ke dalam penyimpanan SQL/NoSQL.
Validasi & QA: Ambil rentang data untuk pemeriksaan aturan, kirim peringatan, atau perkaya alur kerja lainnya tanpa perlu mengekspor secara manual.

Dapatkan Bantuan

n8n Integration Guide n8n Sample Getting Started

Pengaturan​

Parameter​

Keluaran​

Parameter Keluaran​

N8N Tindakan dan Respons​

Kasus Penggunaan​

Dapatkan Bantuan​