Bu makale, ham JSON verilerini .NET uygulaması içinde sunulabilir ve kolay anlaşılır bir rapor biçimine biçimlendirme sorununu ele almaktadır. Basit şablonlar kullanarak JSON verilerini C# dilinde PDF ve DOCX raporlarına dönüştüreceğiz.
Rapor Oluşturma için .NET API
GroupDocs.Assembly for .NET, .NET uygulamaları için rapor oluşturma ve belge otomasyonu API’sidir. JSON, XML veya CSV gibi çeşitli formatlarda bulunan verilerden ve Word belgesi, elektronik tablo, sunum veya metin formatı gibi birçok farklı formattaki şablondan raporlar oluşturmanıza olanak tanır. Ayrıca madde işaretleri, numaralı listeler, çizelgeler, tablolar, resimler, barkodlar vb. birçok rapor biçimlendirme özelliğini destekler.
İndirilenler bölümünden DLL’leri veya MSI yükleyicisini indirebilir veya NuGet aracılığıyla .NET uygulamanıza API’yi yükleyebilirsiniz.
PM> Install-Package GroupDocs.Assembly
C# dilinde JSON Verilerinden PDF Raporu Oluşturun
JSON verilerini C#’ta biçimlendirilmiş PDF raporuna dönüştürmenize yol açacak adımlarla başlayalım.
- JSON veri kaynağını al
- Şablonu JSON verilerine göre tanımlayın
- Rapor oluşturma için basit C# koduna JSON veri kaynağı ve şablonu sağlayın.
JSON Verileri
İlk olarak, aşağıdaki örnek JSON verileri, yöneticileri ve ilgili müşterilerini ve ayrıntılarını gösteren PDF raporu oluşturmak için kullanılır.
\[
{
"Name":"John Smith","Contract":\[
{"Client":{"Name":"A Company"},"Price":1200000},
{"Client":{"Name":"B Ltd."},"Price":750000},
{"Client":{"Name":"C & D"},"Price":350000}\]
},
{
"Name":"Tony Anderson","Contract":\[
{"Client":{"Name":"E Corp."},"Price":650000},
{"Client":{"Name":"F & Partners"},"Price":550000}\]
},
{
"Name":"July James","Contract":\[
{"Client":{"Name":"G & Co."},"Price":350000},
{"Client":{"Name":"H Group"},"Price":250000},
{"Client":{"Name":"I & Sons"},"Price":100000},
{"Client":{"Name":"J Ent."},"Price":100000}\]
}
\]
Şablon
İkinci olarak, aşağıdaki şablonu TXT, DOCX veya gerekli biçimde tanımlayın. Bu, Yöneticilerin verilerinin ve ilgili Müşterilerinin ve ayrıntılarının yinelenmesine izin verir. Bundan sonra, rapor oluşturmak için koda atlayabilirsiniz.
<<foreach [in managers]>>Manager: <<[Name]>>
Contracts:
<<foreach [in Contract]>>- <<[Client.Name]>> ($<<[Price]>>)
<</foreach>>
<</foreach>>
JSON’u PDF Raporuna Dönüştürmek için C# Adımları
Aşağıdaki C# kodu adımları, JSON verilerinin tanımlanan şablona göre PDF raporuna dönüştürülmesini otomatikleştirir.
- JSON verilerini, şablon dosyasını ve PDF çıktı raporu dosyası yollarını tanımlayın.
- JSON veri dosyasıyla JsonDataSoure örneğini oluşturun.
- Tanımlı JsonDataSource ile DataSourceInfo oluşturun.
- Sağlanan JSON verilerinden ve tanımlı şablondan PDF raporu oluşturmak için DocumentAssembler sınıfının AssembleDocument yöntemini çağırın.
// GroupDocs.Assembly API ile C# dilinde TXT şablonunu kullanarak JSON verilerinden PDF Raporu oluşturun
// Veri kaynağı, şablon ve çıktı raporu dosyalarını tanımlayın.
const string strDataSource = "dataPath/ManagerData.json";
const string strDocumentTemplate = "templatePath/template.txt";
const string strDocumentReport = "reportsPath/reportFromJSON.pdf";
// JSON veri kaynağının örneğini oluşturun
JsonDataSource dataSource = new JsonDataSource(CommonUtilities.GetDataSourceDocument(strDataSource));
// Rapor oluştur
DocumentAssembler assembler = new DocumentAssembler();
assembler.AssembleDocument(CommonUtilities.GetSourceDocument(strDocumentTemplate),
CommonUtilities.SetDestinationDocument(strDocumentReport),
new DataSourceInfo(dataSource, "managers"));
Kod, yukarıdaki şekilde gösterildiği gibi PDF raporunu üretecektir. Ayrıca GitHub deposundan test ve üstü ve benzeri örnekleri de inceleyebilirsiniz.
C# dilinde JSON verilerinden MS Word Raporu oluşturun
Benzer şekilde, yukarıdaki PDF raporunu oluşturmak gibi, aşağıdaki adımları izleyerek DOCX raporunu da oluşturabilirsiniz:
- Aynı şablonu DOCX biçiminde tanımlama.
- Çıktı raporu belge biçimini DOCX olarak ayarlayın.
- JSON verilerinden MS Word DOCX raporu oluşturmak için kodun geri kalanı aynı kalacaktır.
// GroupDocs.Assembly API ile C# dilinde DOCX şablonunu kullanarak JSON verilerinden Word Raporu oluşturun
// Veri kaynağı, şablon ve çıktı raporu dosyalarını tanımlayın.
const string strDataSource = "dataPath/ManagerData.json";
const string strDocumentTemplate = "templatePath/template.docx";
const string strDocumentReport = "reportsPath/reportFromJSON.docx";
// JSON veri kaynağının örneğini oluşturun
JsonDataSource dataSource = new JsonDataSource(CommonUtilities.GetDataSourceDocument(strDataSource));
// Rapor oluştur
DocumentAssembler assembler = new DocumentAssembler();
assembler.AssembleDocument(CommonUtilities.GetSourceDocument(strDocumentTemplate),
CommonUtilities.SetDestinationDocument(strDocumentReport),
new DataSourceInfo(dataSource, "managers"));
Daha fazla ayrıntı, seçenek ve örnek için dokümantasyon ve GitHub deposunu ziyaret edin. Daha fazla sorgu için forumda ücretsiz destekle iletişime geçin.
Çözüm
Bu makalede, JSON verilerinizi C# kullanarak .NET uygulamanızda PDF raporuna dönüştürmeyi öğrendiniz. Ayrıca, CSV ve XML gibi diğer veri kaynaklarını kullanarak DOCX gibi diğer formatlarda raporlar oluşturabilirsiniz. Rapor oluşturucu .NET uygulamanızı oluşturmaya başlarken kendinizi rahat hissedeceğinizi umuyorum.