Satır Ekle - Excel API
PDF4me Satır Ekle eklemenizi sağlar JSON verileri satırlar halinde Excel Tablo tabanlı veya koordinat tabanlı ekleme modlarına sahip belgeler. API Bu hizmet, otomatik tür dönüştürme (dizelerden sayılara/tarihlere), kültüre özgü ayrıştırma, özelleştirilebilir tarih ve sayı biçimlendirme ve boş değer işleme özelliklerini destekler. API alır Excel belge içeriği ve JSON veri yoluyla REST API aramalar, kullanarak Base64 Güvenli iletim için kodlama. Bu çözüm, otomatik veri doldurma, rapor oluşturma ve veritabanından Excel'e veri aktarım iş akışları için idealdir.
Kimliğinizi Doğrulama API Rica etmek
Lütfen şunları ekleyin: API Kimlik doğrulaması için istekte belirtilen anahtarı girin. PDF4me REST API.
Başlıca Özellikler
- Çift Ekleme ModlarıTablo tabanlı (başlık eşleştirme) veya koordinat tabanlı (tam satır/sütun konumlandırma)
- JSON Veri DesteğiTek nesneleri veya nesne dizilerini şu şekilde ekleyin: Excel satırlar
- Otomatik Tip Dönüştürme: Dönüştürmek JSON dizeler Excel sayılar ve tarihler
- Biçim Özelleştirme: Özel tarih ve sayı biçimlendirme kalıpları uygulayın
- Kültür DesteğiTarihleri ve sayıları belirtilen kültür kodlarına göre ayrıştırın.
- Boş Değer İşlemeBoş değerleri atla veya boş hücre olarak ekle
REST API Uç nokta
- Yöntem: POST
- Uç nokta:
office/ApiV2Excel/ExcelAddRows
REST API Parametreler
Önemli: Yıldız (*) ile işaretlenmiş parametreler zorunludur. Tüm istekler bu parametreleri kullanır. belge, belge içeriği, Ve addRowsToExcelActionİşleme özgü parametreler (jsonInput, worksheetName, vb.) işlem nesnesinin özellikleridir.
Gerekli Parametreler (kök düzey)
| Parametre | Tip | Tanım | Örnek |
|---|---|---|---|
| belge* | Object | Belge referansı ile İsim (Excel dosya adı) | { "Name": "data.xlsx" } |
| belge içeriği* | String (Base64) | Excel belge içeriği kodlanmıştır Base64 | UEsDBBQABgAIAAAA... |
| addRowsToExcelAction* | Object | Eylem yapılandırması. İçermelidir. jsonGirişi (sicim): JSON Veriler, nesne dizisi veya tek bir nesne olarak ifade edilebilir. | Aşağıda yük örneğini inceleyin. |
İsteğe bağlı parametreler (addRowsToExcelAction içinde)
| Parametre | Tip | Tanım | Örnek |
|---|---|---|---|
| çalışma sayfası adı | String | Hedef çalışma sayfası adı. Varsayılan: "Sheet1" | Sheet1 |
| tabloAdı | String | Excel Tablo tabanlı mod için tablo adı; boş = koordinat tabanlı mod | SalesTable |
| excelRowNumber | Sayı (tam sayı) | Tabloda 1 tabanlı pozisyon (sadece tablo modunda) | 5 |
| Satırdan ekle | Sayı (tam sayı) | 1 tabanlı başlangıç satırı (yalnızca koordinat modu) | 10 |
| Sütundan ekle | Sayı (tam sayı) | 1 tabanlı başlangıç sütunu (yalnızca koordinat modu) | 3 |
| Sayısal ve Tarihe Dönüştür | Boolean | Otomatik tür dönüştürme. Varsayılan: true | true |
| tarihForma | String | Excel Tarih formatı kalıbı. Varsayılan: "yyyy-MM-dd" | MM/dd/yyyy |
| sayısalFormat | String | Excel Sayısal biçim kalıbı. Varsayılan: "N2" | #,##0.00 |
| Boş değerleri yok say | Boolean | Boş değerleri atla. Varsayılan: false | false |
| Öznitelik Başlıklarını yok say | Boolean | Büyük/küçük harf duyarlılığı olmayan başlık eşleştirme. Varsayılan: false | true |
| kültürAdı | String | Tarih/sayı ayrıştırma için dil seçeneği. Varsayılan: "en-US" | en-US |
Çıktı
O API geri döner Excel belge olarak Base64-kodlanmış dize içinde JSON format (belge, dosya adı, başarı, hata mesajı).
Talep Örneği
Başlık
Content-Type: application/json
Authorization: Basic YOUR_BASE64_ENCODED_API_KEY
Yük (Temel)
{
"document": { "Name": "data.xlsx" },
"docContent": "UEsDBBQABgAIAAAA...",
"addRowsToExcelAction": {
"jsonInput": "[{\"Name\":\"John\",\"Age\":30}]"
}
}