სტრუქტურული XML გადაყვანა დამუშავებულ PDF დოკუმენტში ხშირად საჭიროა ანგარიშებისა და არქივის სისტემებში. Aspose.OCR Cloud SDK for .NET იძლევა ძლიერი ღრუბლოვანი ბიბლიოთეკა, რომელიც .NET დეველოპერებს აძლევს OCR‑თან დაკავშირებული დავალებების შესრულება და დოკუმენტების გენერირება, არითვირთის მძიმე კომპონენტების ინსტალაციის გარეშე. ამ გიდში ჩვენ იმპორტებთ XML მონაცემებს PDF-ში C#-ის გამოყენებით SDK-ს, გავატარებთ სრულ კოდის მაგალითს და გავაჩვენებთ, როგორ მივიღოთ იგივე შედეგი REST API‑ის საშუალებით cURL‑ით. თქვენ ასევე გაიგებთ საჭირო დაყენებას, საუკეთესო პრაქტიკას დიდი XML პელოდების დამუშავებაში, და როგორ მიიღოთ დროებითი ლიცენზია ტესტირებისთვის.

სრული კოდის მაგალითი: XML მონაცემების იმპორტირება PDF-ში C#-ით

ეს მაგალითი აჩვენებს, როგორ იმპორტირდეს XML მონაცემები PDF-ში C#-ის გამოყენებით Aspose.OCR Cloud SDK for .NET.

using System;
using System.IO;
using System.Xml;
using Aspose.Pdf;
using Aspose.Pdf.Text;
using Aspose.OCR.Cloud;

namespace XmlToPdfDemo
{
    class Program
    {
        static void Main(string[] args)
        {
            // Paths
            string xmlPath = "input.xml";
            string pdfPath = "output.pdf";

// Initialize Aspose.OCR Cloud client (credentials placeholder)
            var ocrClient = new OcrApi("YOUR_CLIENT_ID", "YOUR_CLIENT_SECRET");

// Parse XML efficiently using XmlReader
            var documentTitle = string.Empty;
            var documentContent = string.Empty;

try
            {
                using (XmlReader reader = XmlReader.Create(xmlPath))
                {
                    while (reader.Read())
                    {
                        if (reader.NodeType == XmlNodeType.Element)
                        {
                            switch (reader.Name)
                            {
                                case "Title":
                                    documentTitle = reader.ReadElementContentAsString();
                                    break;
                                case "Content":
                                    documentContent = reader.ReadElementContentAsString();
                                    break;
                            }
                        }
                    }
                }

// Create PDF document
                var pdfDoc = new Document();
                var page = pdfDoc.Pages.Add();

// Add title with larger font
                var titleFragment = new TextFragment(documentTitle)
                {
                    Position = new Position(0, page.PageInfo.Height - 50),
                    TextState = new TextState
                    {
                        FontSize = 20,
                        FontStyle = FontStyles.Bold,
                        ForegroundColor = Color.Black
                    }
                };
                page.Paragraphs.Add(titleFragment);

// Add content with normal font
                var contentFragment = new TextFragment(documentContent)
                {
                    Position = new Position(0, page.PageInfo.Height - 100),
                    TextState = new TextState
                    {
                        FontSize = 12,
                        FontStyle = FontStyles.Regular,
                        ForegroundColor = Color.Black
                    }
                };
                page.Paragraphs.Add(contentFragment);

// Save PDF
                pdfDoc.Save(pdfPath);
                Console.WriteLine($"PDF generated successfully at '{Path.GetFullPath(pdfPath)}'.");
            }
            catch (XmlException xmlEx)
            {
                Console.Error.WriteLine($"XML parsing error: {xmlEx.Message}");
            }
            catch (IOException ioEx)
            {
                Console.Error.WriteLine($"File I/O error: {ioEx.Message}");
            }
            catch (Exception ex)
            {
                Console.Error.WriteLine($"Unexpected error: {ex.Message}");
            }
            finally
            {
                // Dispose OCR client if it implements IDisposable (placeholder)
                if (ocrClient is IDisposable disposableClient)
                {
                    disposableClient.Dispose();
                }
            }
        }
    }
}

შენიშვნა: ეს კოდის მაგალითი აჩვენებს ძირითად ფუნქციას. თქვენს პროექტში მისი გამოყენებამდე დარწმუნდით, რომ განაახლეთ ყველა ფაილის ბილიკი და კონფიგურაციის მნიშვნელობები, რომ ისინი შეესაბამებოდეს თქვენს რეალურ გარემოს, გადამოწმეთ, რომ ყველა საჭირო დამოკიდებულება სწორად დაინსტალირებულია, და კარგად დატესტეთ თქვენი განვითარების გარემოში. თუ რაიმე პრობლემის შეგხვდებათ, გთხოვთ მიმართოთ ოფიციალურ დოკუმენტაციას ან დაუკავშირდეთ მხარდაჭერის გუნდს დახმარებისთვის.

XML-ის PDF-ში გადაყვანა REST API-ის გამოყენებით cURL-ით

თუ თქვენ უპირატესობას აძლევთ სუფთა REST მიდგომას, იგივე ოპერაცია შეიძლება შესრულდეს cURL მოთხოვნებით Aspose.OCR Cloud API-ის წინააღმდეგ. ეს აჩვენებს XML მონაცემების იმპორტს PDF Rest-ში .NET სამუშაო ნაკადში, C# კოდის დაწერის გარეშე.

  1. ავთენტიკაცია და წვდომის ტოკენის მიღება
   curl -X POST "https://api.aspose.cloud/connect/token" \
        -H "Content-Type: application/x-www-form-urlencoded" \
        -d "grant_type=client_credentials&client_id=YOUR_CLIENT_ID&client_secret=YOUR_CLIENT_SECRET"
  1. ატვირთეთ XML წყაროს ფაილი
curl -X PUT "https://api.aspose.cloud/v3.0/ocr/storage/file/input.xml" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -H "Content-Type: application/xml" \
     --data-binary @input.xml
  1. შეასრულეთ XML მონაცემების PDF-ში იმპორტის ოპერაცია
curl -X POST "https://api.aspose.cloud/v3.0/ocr/xmlpdf" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -H "Content-Type: application/json" \
     -d '{
           "inputFile": "input.xml",
           "outputFile": "output.pdf"
         }'
  1. გადმოწერეთ გენერირებული PDF
curl -X GET "https://api.aspose.cloud/v3.0/ocr/storage/file/output.pdf" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -o output.pdf

მოთხოვნის პარამეტრებისა და დამატებითი შესაძლებლობების შესახებ მეტი დეტალებისთვის, იხილეთ ოფიციალური API დოკუმენტაცია.

C#-ში XML მონაცემების PDF-ში იმპორტის პროცესის გაგება

ზემოთ მოცემული კოდის მაგალითი ადვილი პროცესი მიჰყოლება XML მონაცემების იმპორტირებას PDF-ში C#-ში, Aspose.OCR Cloud SDK for .NET-ის გამოყენებით. ქვემოთ მოცემულია ყველაზე მნიშვნელოვანი განყოფილებების ნაბიჯ‑ნაბიჯ განყოფილება.

  1. OCR კლიენტის ინიციალიზაცია
var ocrClient = new OcrApi("YOUR_CLIENT_ID", "YOUR_CLIENT_SECRET");

OcrApi კლასი (იხილეთ API reference) აუტენტიფიკაციას მართავს და OCR‑თან დაკავშირებული ოპერაციების მეთოდებს იძლევა.

  1. XML ფაილის დამუშავება XmlReader-ით
using (XmlReader reader = XmlReader.Create(xmlPath))
{
    // reading logic
}

XmlReader ნაკადის სახით იკითხავს XML-ს, რაც იდეალურია დიდი ფაილებისთვის და მეხსიერების მოხმარება ნაკლებად დატვირთავს.

  1. ახალი PDF დოკუმენტის შექმნა
var pdfDoc = new Document();
var page = pdfDoc.Pages.Add();

Document კლასი Aspose.PDF‑დან ქმნის PDF კონტეინერს; პირველ გვერდს დაემატება შინაარსის დასამზადებლად.

  1. დაამატეთ სათაური და შინაარსი როგორც TextFragment ობიექტები
var titleFragment = new TextFragment(documentTitle) { /* styling */ };
var contentFragment = new TextFragment(documentContent) { /* styling */ };
page.Paragraphs.Add(titleFragment);
page.Paragraphs.Add(contentFragment);

TextFragment საშუალებას იძლევა ტექსტის ზუსტი მდებარეობის განსაზღვრა და ფონტის სტილის გადატარება.

  1. PDF ფაილის შენახვა
pdfDoc.Save(pdfPath);

გენერირებული PDF ფაილი დისკზე ჩაიწერება, მზადაა შემდეგი დამუშავებისთვის ან ჩამოტვირთვისთვის.

იგივე ლოგიკას შეიძლება გამოვიყენოთ Import XML Data to PDF Rest .NET საბოლოო წერტილის საშუალებით, რაც აძლიერებს Import XML Data to PDF Rest C# ინტეგრაციის სცენარს მხოლოდ ღრუბლურ განთავსებებსთვის.

მოთხოვნები და დაყენება

დაწყებამდე, დარწმუნდით, რომ გაქვთ მოქმედ Aspose.OCR Cloud ანგარიში და .NET SDK დაყენებულია.

  1. დააყენეთ SDK NuGet-ის საშუალებით
dotnet add package Aspose.OCR-Cloud

თქვენ ასევე შეგიძლიათ ჩამოტვირთოთ უახლესი პაკეტი ჩამოტვირთვების გვერდიდან.

  1. დამატეთ საჭირო სახელთა სივრცეები
using Aspose.Pdf;
using Aspose.Pdf.Text;
using Aspose.OCR.Cloud;
  1. კონფიგურაცია თქვენი კლიენტის ავტორიზაციის დეტალები

შეცვალეთ YOUR_CLIENT_ID და YOUR_CLIENT_SECRET თქვენი Aspose Cloud ცხრილიდან მიღებული მნიშვნელობებით. ეს ავტორიზაციის დეტალები გამოიყენება REST მოთხოვნებისთვის წვდომის ტოკენის მიღებაში.

  1. დაყენეთ დროებითი ლიცენზია ტესტირებისთვის (ნებაყოფლობითი, თუმცა რეკომენდირებულია)
   // No explicit license code required for the cloud library; use the temporary license page if needed.

პროდუქციის გამოყენებისთვის, შეიძინეთ სრულ ლიცენზიას დროებითი ლიცენზიის გვერდიდან.

დასკვნა

თქვენ ახლა გაიგეთ, როგორ იმპორტიროთ XML მონაცემები PDF-ში C#-ში Aspose.OCR Cloud SDK for .NET-ის გამოყენებით, როგორც ადგილობრივ კოდით, ასევე REST API-ის საშუალებით cURL-ით. მაგალითი აჩვენებს, როგორ გავაანალიზოთ XML ეფექტურად, დავამუშავოთ PDF-ის გამოტანა სტილით და დავამუშავოთ შეცდომები გლუვად. გახსოვდეთ, რომ დაიცავით თქვენი კლიენტის ავტორიზაციის დეტალები, გამოიყენეთ დროებითი ლიცენზია განვითარებისთვის და განაახლეთ სრულ ლიცენზიაზე, როდესაც გადადის პროდუქციის გარემოზე. ნებისმიერი კითხვისთვის Aspose-ის საზოგადოებრივი ფორუმები და ოფიციალური მხარდაჭერის არხები ყოველთვის მზად არიან დაგეხმაროთ.

კითხვები, რომლებიც შეიძლება გაქვთ

  • როგორ შემიტანოთ XML მონაცემები PDF-ში C#-ით კოდის გარეშე?
    თქვენ შეგიძლიათ გამოიყენოთ XML მონაცემების PDF-ში იმპორტის Rest .NET endpoint, რომელიც აღწერილია cURL განყოფილებაში. უბრალოდ ატვირთეთ თქვენი XML ფაილი, გამოიძახეთ /xmlpdf endpoint, და გადმოწერეთ მიღებული PDF.

  • შეიძლება მრავალ XML ფაილების PDF-ებად გადაყვანა ერთ მოთხოვნაში?
    API ამჟამად თითო მოთხოვნაზე ერთი ფაილი პროცესს აკეთებს, თუმცა შეგიძლიათ C#-ში ან შელ-სკრიპტში ციკლი დაწეროთ, რათა ბაჩები ეფექტურად დამუშავოთ.

  • PDF-ის გამოტანისას რომელი ფაილის ფორმატებია მხარდაჭერილი?
    SDK ყოველთვის ქმნის სტანდარტულ PDF ფაილს. თუ გჭირდებათ სხვა ფორმატები, განიხილეთ Aspose.PDF Cloud SDK for .NET-ის გამოყენება PDF-ის უფრო მეტი კონვერტაციისთვის.

  • შეგიძლია PDF‑ში გენერირებულ შრიფტებსა და ფერებს მორგება?
    დიახ, TextState თვისებების რეგულირებით TextFragment ობიექტებში შეგიძლიათ განსაზღვროთ შრიფტის ზომა, სტილი და ფერი. იხილეთ API მითითება სრულ დეტალებზე.

მეტი წაკითხვა