Kurulum

Paket PyPI’de mevcut‘dir ve aşağıdaki komut çalıştırılarak pip aracılığıyla kurulabilir:

pip install groupdocs-assembly-cloud

Gereksinimler

• Python 3.4+
• pip paket yöneticisi
• GroupDocs Cloud kimlik bilgileri — Kontrol Panelinden İstemci Kimliği ve İstemci Sırrı

Bağımlılıklar

SDK aşağıdaki paketleri otomatik olarak yükler:

Belge Otomasyonu Python Bulut REST API’si

GroupDocs.Assembly Cloud SDK for Python geliştiricilerin raporlar, faturalar ve sunumlar gibi karmaşık belgelerin oluşturulmasını sorunsuz bir şekilde otomatikleştirmesine olanak tanır. Ölçeklenebilir ve güvenli bir bulut ortamında şablonlardan yararlanın, JSON veya XML kaynaklarından verileri birleştirin, zengin biçimlendirme uygulayın ve barkodlar ve grafikler oluşturun. Bu API, belge iş akışlarını kolaylaştırır, üretkenliği artırır ve Python web uygulamalarınıza, komut dosyalarınıza ve otomasyon iş akışlarınıza zahmetsiz entegrasyon için platformlar arası uyumluluk sağlar.

Temel Özellikler

Şablon Odaklı Belge Oluşturma - Şablonlardan karmaşık Word, Excel, PowerPoint, PDF belgeleri oluşturun.
Dinamik Veri Birleştirme - Özelleştirilmiş raporlar için şablonları JSON veya XML verileriyle doldurun.
Zengin Biçimlendirme ve Şekillendirme - Gösterişli belgeler için metinlere, tablolara ve grafiklere gelişmiş biçimlendirme uygulayın.
Koşullu İçerik Kontrolü - Verilere dayalı dinamik içerik oluşturmak için koşullu mantığı kullanın.
Liste ve Tablo Otomasyonu - Verilere göre otomatik olarak güncellenen dinamik listeler, tablolar ve grafikler oluşturun.

Gelişmiş Özellikler

Barkod Oluşturma - Barkodları doğrudan belgelere yerleştirin.
Köprü Ekleme - Harici kaynaklara veya belgenin içine tıklanabilir bağlantılar ekleyin.
Yer İşareti Oluşturma - Kolay gezinme için yer imleri oluşturun.
Onay Kutusu Düzenleme - Onay kutusu değerlerini verilere göre dinamik olarak ayarlayın.
Adres-Posta Birleştirme İşlevselliği - Geniş ölçekte kişiselleştirilmiş e-postalar ve ekler oluşturun.
Formül Hesaplamaları - Dinamik sonuçlar için e-tablolarda hesaplamalar yapın.

Verilerle Çalışmak

Veri Filtreleme - Raporlar için belirli veri alt kümelerini seçmek amacıyla filtreler uygulayın.
Veri Sıralama - Verileri ölçütlere göre belirli bir sıraya (artan/azalan) göre düzenleyin.
Veri Gruplandırma - Daha kolay analiz ve sunum için verileri gruplar halinde düzenleyin.
Veri Biçimlendirme - Raporlardaki verilerin görünümünü (ör. sayı, tarih, metin biçimlendirmesi) kontrol edin.
Değişkenleri Kullanma - Verimli işleme için değerleri bir şablonda saklayın ve yeniden kullanın.
Uzantı Yöntemlerini Kullanma - Şablonlar içindeki karmaşık işlemler için yerleşik işlevlerden yararlanın.

Listeler, Tablolar ve Grafiklerle Çalışmak

Dinamik Liste Oluşturma - Dinamik içeriğe sahip paragraf içi, madde işaretli, numaralı listeler oluşturun.
Dinamik Tablo Oluşturma - Dinamik içeriğe, hesaplamalara ve biçimlendirmeye sahip tablolar oluşturun.
Grafik Oluşturma - Dinamik verilerle çizgi, sütun, çubuk, pasta, dağılım, kabarcık grafikleri oluşturun.
Grafik Özelleştirme - İfadeler aracılığıyla grafik başlıklarını, serileri, eksen başlıklarını ve açıklamaları özelleştirin.
Koşullu Grafik Serisi - Koşullara bağlı olarak grafik serilerini koşullu olarak dahil edin/hariç tutun.

Köprüler, Yer İmleri ve Barkodlarla Çalışmak

Köprü Bağlantıları Ekle - Word’e, e-postaya, e-tabloya ve sunum belgelerine köprüler ekleyin.
Dinamik Yer İşareti Ekleme - Dokümanlara/e-postalara yer imleri ekleyin ve gezinme için adlar tanımlayın.
Onay Kutusu Durum Kontrolü - Onay etiketini kullanarak Word belgelerinde onay kutularını işaretli/işaretsiz olarak ayarlayın.
Barkod Görüntüsü Oluşturma - QR, DataMatrix, UPC, EAN, ISBN, PDF417 ve diğer birçok barkod türünü oluşturun ve ekleyin.

Geliştirici Dostu Özellikler

REST API Mimarisi - Kolay entegrasyon ve ölçeklenebilirlik için REST’ten yararlanın.
Kapsamlı Belgeler - Ayrıntılı API referanslarına, kod örneklerine ve eğitimlere erişin.
Aktif Topluluk Desteği - Aktif topluluk forumundan ve özel destekten yardım alın.
Bulut Tabanlı Esneklik - Bulut tabanlı işlemenin ölçeklenebilirliğinin ve güvenilirliğinin keyfini çıkarın.
JWT Kimlik Doğrulaması - JWT kimlik doğrulamasıyla verileri ve API isteklerini güvenli hale getirin.

Lisanslama ve Kimlik Doğrulama

Değerlendirme Modu - API’yi ücretsiz deneme hesabıyla deneyin.
Güvenli Kimlik Doğrulama - Güvenli API erişimi için İstemci Kimliğini ve İstemci Sırrını kullanın.
MIT Lisansı - Python SDK, MIT Lisansı kapsamında lisanslanmıştır.

Desteklenen Dosya Formatları

GroupDocs.Assembly Cloud, çok çeşitli belge türlerinde şablon odaklı oluşturmayı ve dönüştürmeyi destekler:

• Kelime İşleme: DOC, DOCX, DOCM, DOT, DOTX, DOTM, RTF, ODT, OTT, HTML, MD, TXT, MHTML, MHT
• E-tablolar: XLS, XLSX, XLSM, XLTX, XLTM, XLSB, ODS
• Sunumlar: PPT, PPTX, PPTM, PPS, PPSX, PPSM, POT, POTX, POTM, ODP, OTP
• E-posta: MSG, EML, EMLX
• Web ve Diğer: PDF, EPUB, XPS, OXPS, TIFF, SVG, XAML

Desteklenen çıktı formatları kaynak şablon türüne göre değişir. Format matrisinin tamamı için belgelere bakın.

Hızlı Başlangıç

API kimlik bilgilerinizi alın

GroupDocs.Assembly Cloud’u kullanmak için, GroupDocs.Cloud Dashboard adresinden kaydolun ve Müşteri Kimliğinizi ve Müşteri Sırrınızı alın.

API’yi başlat

Python için GroupDocs.Assembly Cloud SDK’yı kullanmaya başlamak için aşağıdaki kodu kullanın:

import groupdocsassemblycloud

# Get your ClientId and ClientSecret at https://dashboard.groupdocs.cloud
client_id = "YourClientId"
client_secret = "YourClientSecret"

# Create instance of the Assembly API
assembly_api = groupdocsassemblycloud.AssemblyApi(client_id, client_secret)
assembly_api.api_client.configuration.host = "https://api.groupdocs.cloud"

Belgeyi şablondan ve JSON verilerinden birleştirin

Başlatıldıktan sonra, bir şablondan ve JSON veri kaynağından bir belge oluşturmak için bu temel örneği kullanın:

import groupdocsassemblycloud
from groupdocsassemblycloud.models import requests

client_id = "YourClientId"
client_secret = "YourClientSecret"

assembly_api = groupdocsassemblycloud.AssemblyApi(client_id, client_secret)
assembly_api.api_client.configuration.host = "https://api.groupdocs.cloud"

# Upload the template file to cloud storage
with open("template.docx", "rb") as template_file:
    upload_request = requests.UploadFileRequest(template_file, path="template.docx")
    assembly_api.upload_file(upload_request)

# Read JSON data source
with open("data.json") as f:
    data = f.read()

template_file_info = groupdocsassemblycloud.TemplateFileInfo("template.docx")
options = groupdocsassemblycloud.AssembleOptions(template_file_info, save_format="docx", report_data=data)
request = requests.AssembleDocumentRequest(options)
result = assembly_api.assemble_document(request)

print("Generated document size = " + str(len(result)))

Bu hızlı başlangıç ​​kılavuzuyla, Python uygulamalarınızda GroupDocs.Assembly Cloud’u kullanarak belge oluşturmayı otomatikleştirmeye başlamaya hazırsınız. Daha fazla ayrıntı için belgeleri ziyaret edin.

Belgeyi PDF’ye Birleştir

OpenDocument şablonundan ve JSON verilerinden bir PDF raporu oluşturun.

import groupdocsassemblycloud
from groupdocsassemblycloud.models import requests

client_id = "YourClientId"
client_secret = "YourClientSecret"

assembly_api = groupdocsassemblycloud.AssemblyApi(client_id, client_secret)
assembly_api.api_client.configuration.host = "https://api.groupdocs.cloud"

filename = "TableFeatures.odt"
remote_name = "GroupDocs.Assembly/TableFeatures.odt"

with open("TableData.json") as f:
    data = f.read()

with open(filename, "rb") as template_file:
    upload_request = requests.UploadFileRequest(template_file, remote_name)
    assembly_api.upload_file(upload_request)

template_file_info = groupdocsassemblycloud.TemplateFileInfo(remote_name)
assemble_data = groupdocsassemblycloud.AssembleOptions(template_file_info, "pdf", data)
request = requests.AssembleDocumentRequest(assemble_data)
result = assembly_api.assemble_document(request)

print("Generated document size = " + str(len(result)))

Desteklenen Dosya Formatlarını Alın

Montaj API’si aracılığıyla kullanılabilen desteklenen dosya biçimlerinin tam listesini alın.

import groupdocsassemblycloud
from groupdocsassemblycloud.models import requests

client_id = "YourClientId"
client_secret = "YourClientSecret"

assembly_api = groupdocsassemblycloud.AssemblyApi(client_id, client_secret)
assembly_api.api_client.configuration.host = "https://api.groupdocs.cloud"

result = assembly_api.get_supported_file_formats(requests.GetSupportedFileFormatsRequest())

for fmt in result.formats:
    print(fmt.file_format)

GitHub’daki Örnek Projeler

GroupDocs.Assembly Cloud Python SDK deposu, çalıştırılmaya hazır birim testleri ve aşağıdakileri kapsayan örnekler içerir:

Örnekler nasıl çalıştırılır

1. SDK deposunu kopyalayın veya indirin
2. Settings/servercreds.json‘i düzenleyin ve AppSid ile AppKey ayarlarınızı yapın
3. Bağımlılıkları yükleyin: pip install groupdocs-assembly-cloud -U
4. Testleri depo kökünden çalıştırın: python -m unittest discover -s test

Daha fazla ayrıntı için Başlarken adresini ziyaret edin.

Tags

Document Automation | Python Cloud API | GroupDocs.Assembly Cloud | REST API | Document Generation | Template-Driven | Dynamic Data Merging | Rich Formatting | Conditional Content Control | List Automation | Table Automation | Barcode Generation | Hyperlink Insertion | Bookmark Creation | Checkbox Manipulation | Mail Merge | Formula Calculations | Chart Generation | Data Filtering | Data Sorting | Data Grouping | JWT Authentication | Microsoft Word | Microsoft Excel | Microsoft PowerPoint | Report Generation | Cloud-Based Flexibility | Secure API Access | Cross-platform API