REST API’yi kullanarak son derece özelleştirilmiş raporlar oluşturmak için Python kütüphanesi
Ücretsiz Denemeye BaşlayınGroupDocs.Assembly Cloud SDK for Python, geliştiricilerin sözleşmeler, faturalar, sevkiyat raporları, satış teklifleri, envanterler ve diğer birçok kritik iş ürünü gibi zengin biçimlendirilmiş belgelerin oluşturulmasını otomatikleştirmelerini sağlar. Çözüm tamamen bulut tabanlıdır ve bir REST API aracılığıyla erişilebilir; bu da HTTP istekleri gönderebilen herhangi bir Python uygulamasının, sunucu tarafı yazılım veya üçüncü taraf araçlar yüklemeden isteğe bağlı olarak belge oluşturabileceği anlamına gelir.
Platform, özünde özel yer tutucu alanlar ve programlama yapıları içeren belge şablonlarıyla çalışır. Bu yer tutucular, LINQ tarzı bir ifade sözdizimi kullanılarak bir veri kaynağından (XML veya JSON) alınan değerlerle otomatik olarak değiştirilir. Bu güçlü yaklaşım, resim, grafik ve barkod yerleştirmenize, HTML çıktısı için arka plan renkleri ayarlamanıza, dizi verilerinden dinamik tablolar ve listeler oluşturmanıza ve belgenin bölümlerini dahil etmek veya hariç tutmak için koşullu mantık uygulamanıza olanak tanır. SDK çok çeşitli girdi ve çıktı biçimlerini desteklediğinden, ek dönüştürme adımlarına gerek kalmadan bir DOCX şablonundan PDF oluşturabilir, HTML raporları hazırlayabilir veya OpenDocument dosyaları çıktısı alabilirsiniz.
Python’daki tipik iş akışı üç basit adımdan oluşur:
1️⃣ Şablon oluşturun – Word, Excel, PowerPoint veya desteklenen herhangi bir Office/OpenOffice dosyası tasarlayın ve yer tutucu alanlar ve oluşturma kuralları ekleyin.
2️⃣ Veri kaynağı hazırlayın – verilerinizi şablonda tanımlanan yer tutucularla eşleşen XML veya JSON biçiminde sağlayın.
3️⃣ Birkaç satır Python kodu yazın – şablonu GroupDocs Bulut Depolama’ya yüklemek için groupdocsassemblycloud paketini kullanın, veri kaynağını istenen çıktı biçimiyle birlikte iletin ve AssembleDocument işlemini başlatın. API, birleştirilmiş belgeyi doğrudan yanıtta döndürür veya daha sonra geri almak üzere Bulut’ta depolar.
Tüm etkileşimler SSL/TLS şifrelemesiyle güvence altına alınır ve kimlik doğrulaması kişisel Uygulama SID’niz ve Uygulama Anahtarınız aracılığıyla gerçekleştirilir. Bu, belgelerinizin ve verilerinizin bulutta işlenirken korunmasını sağlar. SDK’nın platformlar arası yapısı, belge oluşturmayı web servislerine, toplu işlere, masaüstü uygulamalarına veya sunucusuz işlevlere entegre etmenize olanak tanır; yazdırılabilir, web’e veya e-postaya hazır belgeleri anında ve güvenilir bir şekilde sunar.
Bu Python örneği, GroupDocs Assembly Cloud SDK’sını kullanarak bir şablonun nasıl yükleneceğini, bir veri dosyasının nasıl bağlanacağını ve bir çıktı belgesinin nasıl oluşturulacağını göstermektedir.
Adımlar
AssemblyApiyi başlatın.TemplateFileInfo ve AssembleOptions öğelerini oluşturun.assemble_document öğesini çağırın.import groupdocsassemblycloud
# API istemcisini başlat (kimlik bilgilerinizle değiştirin)
assembly_api = groupdocsassemblycloud.AssemblyApi('......##', '......##')
# 1️⃣ Şablonu yükle
file_name = 'Input1.docx'
with open(file_name, 'rb') as request_file_content:
upload_request = groupdocsassemblycloud.models.requests.UploadFileRequest(
file_content=request_file_content,
path=file_name
)
assembly_api.upload_file(upload_request)
# 2️⃣ Veri kaynağını yükle (XML, JSON veya DOCX olabilir)
data_file = 'Input2.docx'
with open(data_file, 'rb') as data:
template_info = groupdocsassemblycloud.models.TemplateFileInfo(dosya_adı)
# 3️⃣ Derleme seçeneklerini ayarlayın (çıktı biçimi: docx)
assemble_options = groupdocsassemblycloud.models.AssembleOptions(
template_info,
"docx",
data
)
# 4️⃣ Belgeyi birleştirin
request = groupdocsassemblycloud.models.requests.AssembleDocumentRequest(assemble_options)
result = assembly_api.assemble_document(request)
print("Belge başarıyla oluşturuldu:", result.path)