Ana içeriğe geç

Bir tabloya satır ekle Excel Çalışma sayfası n8n

Satır Ekle bir PDF4me düğüm eylemi n8n yazan JSON kayıtları bir Excel Çalışma sayfası. Bunu kullanarak baskı yapın. API Sonuçları bir rapora dönüştürün, webhook yüklerini paylaşılan bir çalışma kitabına kaydedin veya ekleyin. CRM Sayılar ve tarihlerle birlikte takip sayfasına aktarılır, gerçek veriler olarak kaydedilir. Excel Metin yerine değerler.

Bu düğüm ne işe yarıyor?

PDF4me Excel: Satır Ekle mevcut bir şeyi alır .xlsx çalışma kitabı artı bir JSON dizi içinde JSON Satır Verilerive her nesne için bir satır yazar. iki yerleştirme modu: bir tabloya isim ver Hedef Excel Masa ve anahtarlar başlıklara eşleştirilir veya boş bırakılabilir. Satırdan Ekle artı Sütundan Ekle Başlangıç hücresini tam olarak ayarlayın. Sıfırdan bir çalışma kitabı oluşturmak yerine, sağladığınız bir çalışma kitabını düzenler.

İlgili Blog Yazıları
Bu özellik için henüz bir blog yazısı yok — yakında yayınlanacak.
Bu arada, her platforma yönelik eğitimler ve iş akışları için PDF4me bloguna göz atın.
Blogu ziyaret edin

Kimliğinizi Doğrulama API Rica etmek

Her PDF4me düğümde n8n geçerli bir belge gerektirir Bağlantı kurmak için kimlik bilgisi. İçeriğinizi barındıran birini oluşturun veya seçin. PDF4me API Bu sayede iş akışı, elektronik tablo isteklerini güvenli bir şekilde doğrulayabilir.

Kaçırmamanız Gereken Önemli Bilgiler

Hedef Excel Tablo, modu belirler.
Bu alanı doldurmak, düğümü başlık eşleştirmesine geçirir. Boş bırakmak ise koordinat yerleştirmesine geçirir. Satırların nasıl yerleştirileceğine dair diğer her şey bu tek alandan kaynaklanır.
O JSON düz olmalı
Her nesne bir satır, her anahtar ise bir sütun olur. İç içe geçmiş bir nesne veya dizinin işgal edebileceği tek bir hücre yoktur, bu nedenle veri bu düğüme ulaşmadan önce düzleştirilir.
Koordinat modu geçersiz kılabilir
"Satırdan Ekle" ve "Sütundan Ekle" seçeneklerinin varsayılan değerleri 1'dir, yani sol üst hücre. Mevcut içeriği değiştirmeyi düşünmüyorsanız, bu seçenekleri boş bir bölgeye yönlendirin.
n8n'deki PDF4me Excel düğümü, İşlem olarak Satır Ekle, Excel Dosyası Giriş Yöntemi olarak Önceki Düğümden, JSON Satır Verilerinde bir JSON dizisi, Satırdan Ekle ve Sütundan Ekle değerleri 1 olarak ayarlanmış ve Sayısal ve Tarih Değerlerini Dönüştür seçeneği açık konumda olacak şekilde ayarlanmıştır.

JSON Satır Verileri şunları içerir: JSON Düz nesnelerden oluşan dizi. Hedef Excel Tablo burada boş, bu nedenle "Satırdan Ekle" ve "Sütundan Ekle" seçenekleri verileri A1 hücresine yerleştiriyor.

Tablo Modu ve Koordinat Modu

SoruTablo moduKoordinat modu
How you switch to itName a table in Target Excel TableLeave Target Excel Table blank
How columns are matchedJSON keys matched against table headersValues written in key order from the start cell
Does column order matterNo, headers drive placementYes, position drives placement
Which fields control itTarget Excel Table and Excel Row NumberInsert From Row and Insert From Column
Best forStructured sheets that already have a tableBlank sheets or a fixed reporting layout
Overwrite riskLower, rows follow the table structureHigher, the start cell is written to directly

Satır Ekleme İşlevi Hangi Parametrelere İhtiyaç Duyar?

ParametreGerekliNe işe yarar?Örnek
Credential to connect withRequiredThe PDF4me API credential the node authenticates with.PDF4me API
OperationRequiredThe action this node performs. Select Add Rows.Add Rows
Excel File Input MethodRequiredHow the workbook reaches the node: from the previous node as binary data, as a Base64 string, or from a URL.From Previous Node (Binary Data)
Binary Data Property NameConditionalName of the binary property holding the .xlsx. Appears when the workbook comes from the previous node.data
Worksheet NameRequiredSheet the rows are written to. Match the sheet tab name exactly.Sheet1
JSON Row DataRequiredJSON array of flat objects. Each object becomes one row and each key maps to a column.[{"Date":"2024-01-15","Amount":1500.00}]
Insert From RowConditionalRow number the data starts at, counting from 1. Used in coordinate mode when no table is named.1
Insert From ColumnConditionalColumn number the data starts at, counting from 1 for column A. Used in coordinate mode.1
Target Excel TableOptionalName of an existing table to write into. Filling this in switches the node to header matching instead of coordinates.Table1
Excel Row NumberConditionalRow index inside the named table where insertion begins. Used in table mode.1
Convert Numeric and Date ValuesOptionalToggle that turns numeric and date strings into real Excel values rather than text. Ships enabled.enabled
Date Format PatternOptionalPattern applied to converted dates. Match it to the shape of the dates in your JSON.yyyy-MM-dd
Numeric Format PatternOptionalFormat applied to converted numbers, such as two decimal places.N2
Skip JSON Property NamesOptionalToggle that omits the JSON keys, writing only values. Ships disabled so headers are included.disabled
Skip Null ValuesOptionalToggle that leaves cells untouched where a JSON value is null instead of clearing them. Ships disabled.disabled
Culture and Language SettingsOptionalCulture code used when parsing numbers and dates, which decides separator handling.en-US
Output File NameOptionalFilename of the returned workbook. Keep a valid Excel extension.excel_with_rows.xlsx

Çıktı

AlanTipİçeriğinde neler var?
fileNameStringName of the returned workbook after the rows were written.
fileSizeNumberSize of the returned workbook in bytes.
successBooleanWhether the insertion completed. Branch on this so failures surface as alerts.
originalFileNameStringName of the input workbook as supplied to the node.
worksheetNameStringThe worksheet the rows were written to.
rowsAddedNumberHow many rows were inserted. The most useful verification signal the node returns.
insertFromRowNumberStarting row used, echoed back when running in coordinate mode.
insertFromColumnNumberStarting column used, echoed back when running in coordinate mode.
tableNameStringThe table written into, or null when coordinate mode was used.
excelRowNumberNumberRow index inside the table where insertion began, in table mode.
convertNumericAndDateBooleanWhether numeric and date conversion was applied.
dateFormatStringThe date pattern applied during conversion.
numericFormatStringThe numeric format applied during conversion.
cultureNameStringThe culture code used to parse numbers and dates.
messageStringHuman-readable summary, including the row count and worksheet name.

Güncellenen çalışma kitabı, depolama alanına yazılmaya, e-postaya eklenmeye veya başka bir işleme aktarılmaya hazır ikili veri olarak döndürülür. Excel adım.

Satır Ekleme İşlemini Nasıl Kurarım? n8n?

  1. Ekle PDF4me Excel düğümü iş akışınıza ekleyin ve ayarlayın. Operasyon ile Satır Ekle.
  2. Seçiminizi yapın PDF4me veya bir tane oluşturup oraya yapıştırabilirsiniz. API anahtar.
  3. Birini seçin Excel Dosya Giriş Yöntemi ve çalışma kitabını altında görünen alandan yükleyin.
  4. Ayarlamak Çalışma Sayfası Adı Tam olarak yazmakta olduğunuz sayfa sekmesine gidin.
  5. Bir tane koyun JSON düz nesneler dizisi JSON Satır VerileriHer satırda bir nesne.
  6. Tablo modunu kullanmak için tablo adını girin. Hedef Excel Masa ve ayarla Excel Sıra NumberKoordinatları kullanmak için tabloyu boş bırakın ve ayarlayın. Satırdan Ekle Ve Sütundan Ekle.
  7. Ayrılmak Sayısal ve Tarih Değerlerini Dönüştürme etkinleştirildiyse, ayarlayın. Tarih Biçimi Şablonu, Sayısal Biçim Kalıbı, Ve Kültür ve Dil Ortamları Verilerinize uyacak şekilde.
  8. Ayarlamak Çıktı Dosya AdıDüğümü çalıştırın ve kontrol edin. rowsAdded Çalışma kitabının bir sonraki aşamaya yönlendirilmesinden önce verilen yanıtta.

Tipik Kurulumlar

İş Akışı ÖrnekleriCommon n8n workflow patterns using Add Rows.
Webhook yüklerini bir çalışma kitabına kaydedin.
  1. Bir webhook, form gönderimini şu şekilde alır: JSON.
  2. Satır Ekle, bu satırı paylaşılan çalışma kitabındaki adlandırılmış bir tabloya ekler.
  3. Ekip, verilerin yeniden girilmesine gerek kalmadan kağıdı okuyor.
İtmek API sonuçları bir rapora dönüştürün
  1. Planlanmış bir HTTP Bu istek, dahili bir sistemden kayıtları çekiyor. API.
  2. Bir Kod düğümü, yanıtı düz bir diziye dönüştürür.
  3. "Satır Ekle" işlevi, veriyi raporlama şablonuna sabit koordinatlarda yazar.
Gecelik bir ekleme yapın CRM ihracat
  1. Gece vardiyasında çalışmak yeni fırsatlar sunar çünkü JSON.
  2. Tablo modu, anahtarları mevcut başlıklara eşleştirir.
  3. Kaynak dosyadaki sütun sırası değişiklikleri tabloyu bozmaz.
Dağıtımdan önce yazma işlemini doğrulayın.
  1. Satır Ekle işlevi, çalışma kitabına eklenen satır sayısını döndürür.
  2. Bir IF düğümü, bunu giriş dizisinin uzunluğuyla karşılaştırır.
  3. Uyumsuzluk durumunda kısa bir rapor göndermek yerine uyarı verilir.

Pratik İpuçları

Flatten the JSON first
A Set or Code node that removes nesting is cheaper than debugging why a column arrived empty or full of object text.
Prefer table mode when a table exists
Header matching survives column reordering in the source system, which fixed coordinates cannot.
Check rowsAdded, not just success
A run can succeed while inserting fewer rows than you sent. Comparing the count to your array length catches silent shortfalls.
Match culture to the data, not the reader
Culture drives how decimal and thousands separators are parsed. Set it to the format the JSON arrives in.
Point coordinates at empty cells
Insert From Row and Insert From Column both default to 1, so an unchanged run writes over the top-left of the sheet.
Keep a template workbook
This action edits an existing file. Storing a clean template that the workflow copies each run avoids gradual drift.

Kopya Kağıdı

AlanDeğer
OperationAdd Rows
Excel File Input MethodFrom Previous Node (Binary Data)
Binary Data Property Namedata
Worksheet NameSheet1
JSON Row Data[{"Date":"2024-01-15","Amount":1500.00}]
Insert From Row / Column1 / 1
Target Excel TableTable1
Excel Row Number1
Convert Numeric and Date Valuesenabled
Date Format Patternyyyy-MM-dd
Numeric Format PatternN2
Culture and Language Settingsen-US
Output File Nameexcel_with_rows.xlsx

Sıkça Sorulan Sorular

What JSON format does Add Rows expect?+
A JSON array of flat objects, where each object is one row and each key is a column. Nested objects and arrays have no natural cell to land in, so flatten the structure first, for example with an n8n Code node. The array shape itself follows the ordinary JSON data model.
What is the difference between table mode and coordinate mode?+
Naming a table in Target Excel Table puts the node in table mode, where JSON keys are matched against the table headers so column order in your data does not matter. Leaving it blank uses coordinate mode, where Insert From Row and Insert From Column decide the exact starting cell and values are written in key order.
Why did my numbers and dates arrive as text?+
That happens when Convert Numeric and Date Values is turned off, or when the culture does not match the incoming data. The toggle ships enabled, and Date Format Pattern, Numeric Format Pattern, and Culture and Language Settings control how the strings are parsed and formatted on the way in.
Does Add Rows overwrite existing data?+
In coordinate mode the node writes starting at the row and column you name, so pointing it at occupied cells replaces what is there. Target an empty region, or use table mode so rows follow the table structure rather than a fixed address.
Can I add rows to several sheets in one run?+
Not in a single execution, because Worksheet Name takes one sheet. Chain a second Add Rows node fed by the first node output, or loop the workbook through the node once per sheet, so each pass writes to its own worksheet.

İlgili Eylemler

Diğer Platformlarda Aynı Görev

Yardım Alın