კომპლექსური 3D გრაფიკების Excel სამუშაო ფაილიდან პორტაბელურ PDF ფაილში გადაყვანა ხშირად საჭიროა ანგარიშგებისთვის და ვიზუალური მონაცემების გაზიარებისთვის. Aspose.Cells Cloud SDK for Java პროვაიდებს ძლიერი ღრუბლოვანი ბიბლიოთეკა, რომელიც ამოცანა მარტივად აძლიერებს Java დეველოპერებისთვის. ამ გიდში ჩვენ გავატარებთ სრულ 3D‑დან PDF‑ში გადაყვანის პროცესს Java-ში, გარემოს მომზადებიდან საბოლოო დოკუმენტის მიღებამდე. თქვენ ნახავთ დეტალურ კოდის მიმოხილვას, სრულ მაგალითს და შესაბამის cURL ბრძანებებს REST API ინტეგრაციისთვის.

Aspose.Cells Cloud SDK for Java-ის დაყენება

დაწყებამდე, დარწმუნდით, რომ გაქვთ შემდეგი:

  • Java 17 ან უფრო ახალი დაყენებულია.
  • Maven ან Gradle დამოკიდებულებების მართვისთვის.
  • Aspose Cloud ანგარიშის Client Id და Client Secret.
  • ინტერნეტის წვდომა ღრუბლოვანი ზარებისთვის.

დაამატეთ SDK თქვენს პროექტში Maven‑ის დამოკიდებულებით, რომელიც ქვემოთაა ნაჩვენები, და გადმოწერეთ უახლესი JAR ოფიციალურ ჩამოტვირთვის გვერდიდან.

<dependency>
    <groupId>com.aspose</groupId>
    <artifactId>aspose-cells-cloud</artifactId>
    <version>26.7</version>
</dependency>

თქვენ ასევე შეგიძლიათ ბიბლიოთეკა პირდაპირ მიიღოთ გადმოწერის URL-დან.

დააყენეთ კლიენტი თქვენი ავტორიზაციის დეტალებით. ეს სნიპეტი პირდაპირ სრულ მაგალითიდან აღებულია.

Configuration config = new Configuration();
config.setClientId("YOUR_CLIENT_ID");
config.setClientSecret("YOUR_CLIENT_SECRET");
// Optional: config.setBasePath("https://api.aspose.cloud"); // default

კონფიგურაცია სწორად დაყენებულია, თქვენ მზად ხართ დაწყება კონვერსიის სამუშაო ნაკადის.

3D-დან PDF-ის გადაყვანა Java-ში - ნაბიჯნაბიჯ მიმოხილვა

ნაბიჯი 1: Excel სამუშაო წიგნის ატვირთვა ღრუბლოვანი შენახვაში

ჯერ ატვირთეთ XLSX ფაილი, რომელიც შეიცავს 3D დიაგრამებს. FilesApi ატვირთვას მართავს.

FilesUploadResult uploadResult = filesApi.uploadFile("", new File(localInputPath));
if (uploadResult == null || uploadResult.getUploaded().isEmpty()) {
    System.err.println("Upload failed.");
    return;
}

ნაბიჯი 2: PDF შენახვის პარამეტრების მომზადება

PDF-ის გამოტანის გასწორება ფონტის ქეშის, გამოსახულებების შეკუმშვის და მეხსიერების ოპტიმიზაციის ჩართვით. ეს პარამეტრები ხელს უწყობს PDF-ის ზომის შემცირებას, ხოლო 3D ვიზუალური ხარისხის შენარჩუნებას.

PdfSaveOptions pdfOptions = new PdfSaveOptions();
pdfOptions.setCacheFont(true);
pdfOptions.setCompressImages(true);
pdfOptions.setImageQuality(80);
pdfOptions.setEnableMemoryOptimization(true);

ნაბიჯი 3: სამუშაო წიგნის PDF-ში გადაყვანა

გამოიყენეთ postWorkbookSaveAs მეთოდი CellsApi-ისგან კონვერტაციის შესასრულებლად. ამ მეთოდის API დოკუმენტაცია ხელმისაწვდომია Aspose.Cells API Reference.

WorkbookResponse convertResponse = cellsApi.postWorkbookSaveAs(
        remoteInputName,          // source workbook name
        "pdf",                    // target format
        remoteOutputName,         // output path in cloud storage
        pdfOptions,               // save options
        "",                       // folder (root)
        null);                    // storage (default)

ნაბიჯი 4: გადმოწერეთ მიღებული PDF

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

byte[] pdfBytes = filesApi.downloadFile(remoteOutputName);
try (FileOutputStream fos = new FileOutputStream(new File(localOutputPath))) {
    fos.write(pdfBytes);
}
System.out.println("Conversion completed successfully. PDF saved to " + localOutputPath);

ნაბიჯი 5: ნებაყის გასუფთავება

მოაცილეთ დროებით ფაილები ღრუბლოვან შენახვიდან, რათა თქვენი ანგარიში იყოს სუფთა.

filesApi.deleteFile(remoteInputName, null, null);
filesApi.deleteFile(remoteOutputName, null, null);

3D-დან PDF-ში გადაყვანის სრულ Java განხორციელება - სრულყოფილი კოდის მაგალითი

შემდეგი მაგალითი აჩვენებს 3D Excel სამუშაო წიგნის საწყისიდან ბოლომდე გადაყვანას PDF ფორმატში, using Aspose.Cells Cloud SDK for Java.

import com.aspose.cloud.cells.api.CellsApi;
import com.aspose.cloud.cells.api.FilesApi;
import com.aspose.cloud.cells.client.ApiException;
import com.aspose.cloud.cells.client.Configuration;
import com.aspose.cloud.cells.model.PdfSaveOptions;
import com.aspose.cloud.cells.model.FilesUploadResult;
import com.aspose.cloud.cells.model.WorkbookResponse;

import java.io.File;
import java.io.FileOutputStream;
import java.io.IOException;

public class AsposeCells3DToPdfExample {
    public static void main(String[] args) {
        // -------------------- Configuration --------------------
        Configuration config = new Configuration();
        config.setClientId("YOUR_CLIENT_ID");
        config.setClientSecret("YOUR_CLIENT_SECRET");
        // Optional: config.setBasePath("https://api.aspose.cloud"); // default

// -------------------- API Instances --------------------
        CellsApi cellsApi = new CellsApi(config);
        FilesApi filesApi = new FilesApi(config);

// -------------------- Local & Remote Paths --------------------
        String localInputPath = "input.xlsx";      // Excel file containing 3D charts
        String remoteInputName = "input.xlsx";     // Name used in cloud storage
        String remoteOutputName = "output.pdf";    // Desired PDF name in cloud storage
        String localOutputPath = "output.pdf";     // Where to save the downloaded PDF

try {
            // -------------------- Upload Excel to Cloud --------------------
            FilesUploadResult uploadResult = filesApi.uploadFile("", new File(localInputPath));
            if (uploadResult == null || uploadResult.getUploaded().isEmpty()) {
                System.err.println("Upload failed.");
                return;
            }

// -------------------- Prepare PDF Save Options (Performance) --------------------
            PdfSaveOptions pdfOptions = new PdfSaveOptions();
            pdfOptions.setCacheFont(true);                     // Cache fonts for faster processing
            pdfOptions.setCompressImages(true);               // Compress images to reduce size
            pdfOptions.setImageQuality(80);                   // Balance quality and size
            pdfOptions.setEnableMemoryOptimization(true);     // Reduce memory footprint

// -------------------- Convert Workbook to PDF --------------------
            WorkbookResponse convertResponse = cellsApi.postWorkbookSaveAs(
                    remoteInputName,          // source workbook name
                    "pdf",                    // target format
                    remoteOutputName,         // output path in cloud storage
                    pdfOptions,               // save options
                    "",                       // folder (root)
                    null                      // storage (default)
            );

if (convertResponse == null || convertResponse.getCode() != 200) {
                System.err.println("Conversion failed.");
                return;
            }

// -------------------- Download Resulting PDF --------------------
            byte[] pdfBytes = filesApi.downloadFile(remoteOutputName);
            try (FileOutputStream fos = new FileOutputStream(new File(localOutputPath))) {
                fos.write(pdfBytes);
            }

System.out.println("Conversion completed successfully. PDF saved to " + localOutputPath);
        } catch (ApiException | IOException e) {
            e.printStackTrace();
        } finally {
            // -------------------- Optional Cleanup --------------------
            try {
                filesApi.deleteFile(remoteInputName, null, null);
                filesApi.deleteFile(remoteOutputName, null, null);
            } catch (ApiException ignored) {
            }
        }
    }
}

შენიშვნა: ეს კოდის მაგალითი აჩვენებს ძირითად ფუნქციას. პროექტში მისი გამოყენებამდე დარწმუნდით, რომ განაახლეთ ფაილის გზები (input.xlsx, output.pdf, ა.შ.) თქვენი რეალური ფაილების მდებარეობებთან, გადაამოწმეთ, რომ ყველა საჭირო დამოკიდებულება სწორად დაინსტალირებულია, და სრულად ტესტირეთ თქვენი განვითარების გარემოში. თუ რაიმე პრობლემის kanssa შეხვდეთ, გთხოვთ მიმართოთ ოფიციალურ დოკუმენტაციას ან დაუკავშირდეთ მხარდაჭერის გუნდს დახმარებისთვის.

REST API კონვერსია cURL-ის გამოყენებით Aspose.Cells Cloud

თუ თქვენ უპირატესია ენისგან დამოუკიდებელი მიდგომა, იგივე გადაყვანა შეიძლება შესრულდეს მარტივი cURL ბრძანებების საშუალებით Aspose.Cells Cloud REST API-ის წინააღმდეგ.

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"

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

2. ატვირთეთ წყარო XLSX ფაილი

curl -X PUT "https://api.aspose.cloud/v3.0/cells/storage/file/input.xlsx" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -H "Content-Type: application/octet-stream" \
     --data-binary "@input.xlsx"

3. სამუშაო წიგნის PDF-ში გადაყვანა

curl -X POST "https://api.aspose.cloud/v3.0/cells/input.xlsx/saveAs/pdf?outputPath=output.pdf" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -H "Content-Type: application/json" \
     -d '{
           "CacheFont": true,
           "CompressImages": true,
           "ImageQuality": 80,
           "EnableMemoryOptimization": true
         }'

4. გენერირებული PDF-ის ჩამოტვირთვა

curl -X GET "https://api.aspose.cloud/v3.0/cells/storage/file/output.pdf" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -o output.pdf

ეს ბრძანებები ახორციელებენ იგივე 3D to PDF conversion in Java სამუშაო ნაკადს Java კოდის დაწერის გარეშე. მეტი დეტალებისთვის იხილეთ ოფიციალური API დოკუმენტაცია.

დასკვნა

ზემოთ აღნიშნული ნაბიჯების მიყოლით, თქვენ შეგიძლიათ საიმედოდ გადაყვანა 3D Excel სამუშაო წიგნაკებიდან მაღალი ხარისხის PDF ფაილებზე, Aspose.Cells Cloud SDK for Java-ის გამოყენებით. ბიბლიოთეკა განისაზღვრება 3D დიაგრამების რენდერის რთული პროცესის შესრულებით, ხოლო PDF შენახვის პარამეტრები საშუალებას გაძლევენ კონტროლировать ზომა და შესრულება. გახსოვდეთ, რომ პროდუქციის გამოყენებისთვის საჭიროა შესაბამისი ლიცენზია; ფასის დეტალები ხელმისაწვდომია პროდუქტის გვერდზე, ხოლო დროებით ლიცენზია შეიძლება მიიღოთ დროებით ლიცენზიის გვერდი. ამ ცოდნის მქონეობით, თქვენ მზად ხართ ინტეგრირებისთვის 3D‑ის PDF-ში გადაყვანა თქვენს Java აპლიკაციებში და სრულყოფილი ანგარიშების მიწოდება საბოლოო მომხმარებლებს.

ხშირად დასმული კითხვები

  • როგორ შევასრულო 3D-დან PDF-ში გადაყვანა Java-ით Aspose.Cells-ის გამოყენებით?
    გამოიყენეთ SDK თქვენი XLSX ფაილის ატვირთვისთვის, კონფიგურირეთ PdfSaveOptions, გამოიძახეთ postWorkbookSaveAs და გადმოწერეთ მიღებული PDF. ამ სტატიის სრული კოდის მაგალითი აჩვენებს ზუსტად თანმიმდევრულობას.

  • Java-ში კოდის დაწერის გარეშე 3D დიაგრამის PDF კონვერსიის ჩატარება შესაძლებელია?
    დიახ, მოწოდებული REST API და cURL ბრძანებები საშუალებას გაძლევთ მიიღოთ იგივე შედეგი ნებისმიერი პლატფორმისგან, რომელიც HTTP მოთხოვნებს შეძლებს.

  • რა განსხვავებაა 3D ვიზუალიზაციის PDF კონვერტაციასა და სტანდარტულ Excel‑დან PDF კონვერტაციას შორის?
    3D ვიზუალიზაციებს საჭიროებს დამატებით გრაფიკების ობიექტების რენდერირებას, რაც SDK‑ის მიერ ავტომატურად შესრულდება. სტანდარტული კონვერტაცია შეიძლება გამოტოვოს ეს 3D რენდერირების ნაბიჯები, რაც შეიძლება გამოიწვიოს გრაფიკების ნაკლულობა.

  • შეიძლება იგივე სამუშაო ნაკადის გამოყენება java Excel‑დან PDF-ზე გადაყვანისთვის არა‑3D სამუშაო წიგნების შემთხვევაში?
    აბსოლუტურად. იგივე API‑ის გამოძახებები მუშაობენ ნებისმიერი Excel ფაილისთვის; უბრალოდ გამოტოვეთ ან შეცვალეთ 3D‑მომხმარებელზე დამოკიდებული პარამეტრები, თუ ისინი საჭირო არაა.

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