Ana içeriğe geç

Satır Ekle Excel içinde Power Automate: JSON ile Excel ile PDF4me

PDF4me Excel - Satır Ekle bir Power Automate bir ekleyen eylem JSON nesne veya diziyi yeni satırlar olarak bir Excel Bu çalışma kitabını, otomatik başlık eşleştirmeli tablo tabanlı modda veya tam hücre konumlandırmalı koordinat tabanlı modda kullanabilirsiniz. Veritabanı sorgu sonuçlarını, form gönderimlerini veya API yanıtları doğrudan bir Excel rapor.

Bu eylemin yaptığı şey

PDF4me Excel - Satır Ekle yazıyor JSON Satır verilerini mevcut bir çalışma kitabına ekler, Tablo Adı ayarlandığında başlıklarla eşleşen özelliklere sahip verileri ekler veya boş bırakıldığında tam koordinatlara yerleştirir. Sayısal ve Tarih Dönüştürme, Tarih Biçimi Kalıbı, Sayısal Biçim Kalıbı ve Kültür Adı, eklenen değerlerin nasıl yazılacağını ve biçimlendirileceğini kontrol eder.

İ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ğimi nasıl doğrularım? Power Automate Akış?

Her PDF4me eylemde Power Automate Geçerli bir bağlantı gerektirir. Bağlantı bilgilerinizi içeren bir bağlantı oluşturun veya seçin. PDF4me API akışın kimlik doğrulamasını yapabilmesi için anahtar. Excel Satır ekleme isteklerini güvenli bir şekilde gerçekleştirir.

Kaçırmamanız Gereken Önemli Bilgiler

Tablo Adı, mod değiştirme anahtarıdır.
Tablo Adı boş bırakılmadığında, başlık eşleştirmesi ve konum için Excel Satır Numarası kullanılarak tablo tabanlı ekleme etkinleştirilir. Bunun yerine Satırdan Ekle ve Sütundan Ekle seçeneklerini kullanarak koordinat tabanlı ekleme için boş bırakın. Her iki parametre kümesinin tek bir çağrıda karıştırılması hataya neden olur.
Veri alanı etiketlenmiştir. JSON Satır Verileri
Tek bir seçeneği kabul eder. JSON Tek bir satır için nesne veya tek bir çağrıda birden fazla satır eklemek için nesne dizisi. Özellik adları, tablo modunda başlık eşleştirmesini yönlendirir.
Tür dönüştürme için geçiş düğmesinin açık olması gerekiyor.
Tarih Biçimi Kalıbı, Sayısal Biçim Kalıbı ve Kültür Adı yalnızca Sayısal ve Tarih Değerlerini Dönüştür seçeneği etkinleştirildiğinde geçerlidir. Bu seçenek devre dışı bırakıldığında, her değer düz metin olarak yazılır.
Power Automate PDF4me Excel - Dosya İçeriği, Dosya Adı, JSON Satır Verileri, Çalışma Sayfası Adı Sheet1, 6. Satırdan Ekle, 2. Sütundan Ekle ve Gelişmiş parametreler Sayısal ve Tarih Dönüştürme, Tarih Biçimi Kalıbı yyyy-MM-dd ve Sayısal Biçim Kalıbı N2 ile yapılandırılmış Satır Ekleme eylemi.

Dosya içeriğini ve dosya adını eşleştirin, JSON satır verilerini ayarlayın, bir tablo adı seçin veya satırdan/sütundan ekleyin, ardından tür dönüştürme ve biçimlendirme için Gelişmiş parametreleri genişletin.

Parametreler

Gerekli: Dosya İçeriği, Dosya Adı ve JSON Satır Verileri her zaman belirtilmelidir. Tablo Adı ve Excel Satır Numarası yalnızca tablo tabanlı eklemeler için geçerlidir. Satırdan Ekle ve Sütundan Ekle seçenekleri yalnızca koordinat tabanlı eklemeler için geçerlidir ve Tablo Adı da belirtilmişse reddedilir.

ParametreGerekliNe işe yarar?Örnek
File ContentRequiredBase64 content of the source Excel workbook, mapped from SharePoint, OneDrive, or another prior action.[File Content from Get File]
File NameRequiredExcel filename including extension (.xlsx or .xls), used for processing and output identification.data.xlsx
JSON Row DataRequiredJSON object or array of objects to insert. Each object becomes one row, property names match table headers in table mode.[{"Name":"John","Age":30}]
Worksheet NameOptionalName of the worksheet to insert into. Defaults to Sheet1 if left blank.Sheet1
Table NameOptionalName of an Excel table for table-based insertion. Leave empty to use coordinate-based insertion instead.SalesTable
Excel Row NumberConditional1-based position within the table, table mode only. Ignored in coordinate mode.5
Insert From RowConditional1-based worksheet row where insertion starts, coordinate mode only. Errors if Table Name is also set.10
Insert From ColumnConditional1-based worksheet column where insertion starts, coordinate mode only. Errors if Table Name is also set.3
Convert Numeric And DateOptionalEnables automatic conversion of JSON numbers to Excel numeric values and date-like strings to Excel dates. Default true.true
Date Format PatternOptionalExcel date format applied when Convert Numeric And Date is enabled. Default yyyy-MM-dd.MM/dd/yyyy
Numeric Format PatternOptionalExcel numeric format applied when Convert Numeric And Date is enabled. Default N2.#,##0.00
Ignore Null ValuesOptionalSkips inserting a value for any JSON property that is null when enabled. Default false, which inserts nulls as empty cells.false
Ignore Attribute TitlesOptionalMakes JSON property name matching case-insensitive against table headers when enabled. Default false.true
Culture NameOptionalCulture code used to parse incoming date and number strings before conversion. Default en-US.en-US

Çıkış Alanları

AlanTipİçeriğinde neler var?
documentBase64The Excel workbook with the new rows inserted.
SuccessBooleantrue if insertion completed, false if the action failed.
ErrorMessageStringError description, null when Success is true.
ErrorsArrayDetailed error objects with Code and Message, empty when Success is true.

Sıkça Karşılaşılan Hata Mesajları Ne Anlama Geliyor?

Hata MesajıNedenÇözüm
JSON input is requiredJSON Row Data is null or empty.Provide a valid JSON object or array.
Invalid JSON structureMalformed JSON syntax.Fix the JSON formatting before mapping it in.
Worksheet not foundThe named worksheet does not exist in the workbook.Use an existing worksheet name or leave it blank for the first sheet.
Table not foundThe named table does not exist, table mode only.Use an existing Excel table name.
ExcelRowNumber must be greater than 0Excel Row Number is less than 1 in table mode.Set Excel Row Number to 1 or higher.
InsertFromRow and InsertFromColumn are ignored when TableName is specifiedCoordinate parameters were set alongside Table Name.Clear Table Name for coordinate mode, or clear the coordinate fields for table mode.
No valid data found in JSON inputJSON Row Data was an empty array or had no parseable objects.Provide at least one valid object in the JSON payload.

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

  1. Eklemek PDF4meExcel - Satır Ekle senin Power Automate akış.
  2. Harita Dosya İçeriği Ve Dosya adı önceki bir eylemden (SharePoint, OneDrive(veya bir veritabanı bağlantısı).
  3. Ayarlamak JSON Satır Verileri Nesnenize veya nesne dizinize.
  4. Ayarlamak Masa Adı Tablo tabanlı ekleme için veya boş bırakıp ayarlayın. Satırdan Ekle / Sütundan Ekle Koordinat tabanlı ekleme için.
  5. Genişletmek Gelişmiş parametreler etkinleştirmek için Sayısal ve Tarihsel Verileri Dönüştürme ve biçimlendirmeyi ayarlayın. Akışı çalıştırın, güncellenmiş çalışma kitabı şu şekilde geri döner: belge.

Tipik Kurulumlar

İş Akışı ÖrnekleriCommon Power Automate flow patterns using Add Rows.
Günlük satış verilerinin içe aktarılması (tablo modu)
  1. Planlanmış bir tetikleyici, günün satış kayıtlarını almak için bir SQL sorgusu çalıştırır.
  2. Sonuçlar, satış tablosunun sütun başlıklarıyla eşleşen bir JSON dizisine dönüştürülür.
  3. Dosya Al seçeneği, Tablo Adı "GünlükSatışlar" olan satış raporu şablonunu getirir.
  4. Satır Ekle seçeneği, Sayısal ve Tarih Dönüştürme özelliği etkinleştirilmiş ve para birimi için Sayısal Biçim Kalıbı ayarlanmış şekilde diziyi ekler.
  5. Güncellenmiş rapor satış yöneticilerine e-posta ile gönderilir.
Form yanıtı kaydı (koordinat modu)
  1. Microsoft Forms üzerinden yapılan bir gönderim, akışı tetikler.
  2. Bu senaryo, gönderilen yanıtlardan bir JSON nesnesi oluşturur.
  3. Get File işlevi, yanıt günlüğü çalışma kitabını alır.
  4. "Add Rows" seçeneği, "Insert From Row" ve "Insert From Column" seçeneklerini kullanarak bir sonraki boş satıra satır ekler; "Table Name" ise boş bırakılır.
  5. Güncellenen kayıt dosyası tekrar kaydedilir. SharePoint.
CRM fırsatı ihracatı
  1. Haftalık tetikleyici, yeni fırsatları sorgular. CRM bağlantı elemanı.
  2. Kayıtlar, esnek alan adlarına sahip bir JSON dizisine dönüştürülür.
  3. "Satır Ekle" işlevi, büyük/küçük harf duyarlılığı olmayan başlık eşleştirmesi için "Öznitelik Başlıklarını Yoksay" seçeneği etkinleştirilmiş olarak "Fırsatlar" tablosuna satır ekler.
  4. Hazırlanan rapor satış ekibine dağıtılır.

Pratik İpuçları

Never set Table Name and Insert From Row together
The two parameter sets belong to different insertion modes. Setting both returns an error, clear one set before running.
JSON Row Data accepts a single object or an array
A bare object inserts one row, an array inserts one row per object. Choose the shape that matches how many rows you are writing.
Excel Row Number is 1-based within the table
Row 1 in table mode is the first data row after the header, not the header itself. Set it accordingly when targeting a specific position.
Culture Name affects parsing, not just display
Set Culture Name to match how your source data formats dates and decimals (for example de-DE for comma decimals), otherwise conversion can misread values.
Ignore Attribute Titles solves case-mismatch headaches
If your JSON property names differ in case from the Excel table headers, enable Ignore Attribute Titles instead of renaming every header or every JSON key.

Kopya Kağıdı

AlanDeğer
ActionExcel - Add Rows
Mode switchTable Name set = table mode, empty = coordinate mode
JSON Row Data shapeSingle object or array of objects
Default worksheetSheet1
Type conversion toggleConvert Numeric And Date = true (default)
Default date/numeric formatyyyy-MM-dd / N2
Default cultureen-US
Outputdocument (Base64 workbook) + Success + ErrorMessage + Errors

Sıkça Sorulan Sorular

How do I insert JSON data into Excel in Power Automate?+
Add the PDF4me Excel - Add Rows action, map File Content and File Name from a prior action, set JSON Row Data to your JSON payload, then choose Table Name for table-based insertion or Insert From Row and Insert From Column for coordinate-based insertion.
What is the difference between table-based and coordinate-based insertion?+
Table-based insertion is used when Table Name is provided, JSON property names are matched to the Excel table headers and Excel Row Number sets the position within the table. Coordinate-based insertion is used when Table Name is empty, Insert From Row and Insert From Column set the exact worksheet cell where insertion starts, with no header matching.
Can I insert more than one row at once?+
Yes. Pass a JSON array of objects in JSON Row Data and every object becomes its own inserted row. A single JSON object inserts exactly one row.
What happens if I mix table-based and coordinate-based parameters?+
Setting Insert From Row or Insert From Column while Table Name is also set returns an error, since the two parameter sets belong to different insertion modes. Use one mode's parameters at a time.
How does automatic type conversion work?+
With Convert Numeric And Date enabled, JSON numbers become Excel numeric values formatted with Numeric Format Pattern, and date-like strings become Excel DateTime values formatted with Date Format Pattern. Culture Name controls how the incoming values are parsed before conversion. See <a href="https://learn.microsoft.com/en-us/dotnet/standard/base-types/standard-numeric-format-strings" target="_blank" rel="noopener noreferrer">Microsoft's numeric format string reference</a> and <a href="https://learn.microsoft.com/en-us/connectors/pdf4meconnect/" target="_blank" rel="noopener noreferrer">the PDF4me Power Automate connector reference</a> for details.

Sektör Kullanım Örnekleri ve Uygulamaları

  • Satış Süreci RaporlarıCRM fırsat verilerini Excel satış süreçlerine ekle
  • Potansiyel Müşteri TakibiFormlardan gelen yeni potansiyel müşteri bilgilerini Excel takip sayfalarına ekleyin.
  • Kampanya AnaliziPazarlama kampanyası sonuçlarını analiz API'lerinden alarak doldurun.
  • Müşteri ListeleriVeritabanlarından müşteri verilerini Excel müşteri listelerine aktarın.

İlgili Eylemler

Diğer Platformlarda Aynı Görev

Yardım Alın