การแปลงแผนภูมิ 3D ที่ซับซ้อนจากเวิร์กบุ๊ก Excel ไปเป็นไฟล์ PDF ที่พกพาเป็นความต้องการที่พบบ่อยสำหรับการรายงานและการแชร์ข้อมูลภาพ Aspose.Cells Cloud SDK for Java ให้ไลบรารีคลาวด์ที่ทรงพลังซึ่งทำให้ภารกิจนี้ง่ายขึ้นสำหรับนักพัฒนา Java ในคู่มือนี้ เราจะเดินผ่านกระบวนการแปลง 3D เป็น PDF ใน Java ทั้งหมด ตั้งแต่การเตรียมสภาพแวดล้อมจนถึงการดึงเอกสารขั้นสุดท้าย คุณจะได้เห็นการอธิบายโค้ดอย่างละเอียด ตัวอย่างครบถ้วน และคำสั่ง cURL ที่เทียบเท่าสำหรับการรวม REST API

การตั้งค่า Aspose.Cells Cloud SDK สำหรับ Java

ก่อนที่คุณจะเริ่มต้น, ตรวจสอบให้แน่ใจว่าคุณมีสิ่งต่อไปนี้:

  • Java 17 หรือใหม่กว่า ติดตั้งแล้ว
  • Maven หรือ Gradle สำหรับการจัดการ dependencies
  • บัญชี 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 ที่มีแผนภูมิ 3 มิติ. FilesApi จะจัดการการอัปโหลด.

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

ขั้นตอนที่ 2: เตรียมตัวเลือกการบันทึก PDF

ปรับแต่งผลลัพธ์ PDF อย่างละเอียดโดยเปิดใช้งานการแคชฟอนต์, การบีบอัดภาพ, และการเพิ่มประสิทธิภาพหน่วยความจำ ตัวเลือกเหล่านี้ช่วยให้ขนาดไฟล์ PDF ต่ำลงในขณะที่ยังคงคุณภาพภาพ 3 มิติไว้.

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

ขั้นตอนที่ 3: แปลง Workbook เป็น PDF

Call the postWorkbookSaveAs method of 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);

การทำงานเต็มรูปแบบของ Java สำหรับการแปลง 3D เป็น PDF - ตัวอย่างโค้ดเต็ม

ตัวอย่างต่อไปนี้แสดงการแปลงจากต้นจนจบของเวิร์กบุ๊ก Excel 3D เป็น PDF โดยใช้ 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, ฯลฯ) ให้ตรงกับตำแหน่งไฟล์จริงของคุณ ตรวจสอบว่าขึ้นตอนการพึ่งพาที่จำเป็นทั้งหมดได้ถูกติดตั้งอย่างถูกต้อง และทดสอบอย่างละเอียดในสภาพแวดล้อมการพัฒนา หากคุณพบปัญหาใด ๆ โปรดดูที่ เอกสารอย่างเป็นทางการ หรือ ติดต่อทีม ทีมสนับสนุน เพื่อขอความช่วยเหลือ.

การแปลง 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 เป็น PDF ใน Java โดยไม่ต้องเขียนโค้ด Java ใด ๆ สำหรับรายละเอียดเพิ่มเติม ดูที่ เอกสาร API อย่างเป็นทางการ.

สรุป

โดยทำตามขั้นตอนข้างต้น คุณสามารถแปลงสมุดงาน Excel แบบ 3D ให้เป็นไฟล์ PDF คุณภาพสูงได้อย่างมั่นใจโดยใช้ Aspose.Cells Cloud SDK for Java ไลบรารีจัดการการเรนเดอร์แผนภาพ 3D อย่างเต็มที่ ในขณะที่ตัวเลือกการบันทึก PDF ช่วยให้คุณควบคุมขนาดและประสิทธิภาพได้ จำไว้ว่าต้องจัดหาลิขสิทธิ์ที่เหมาะสมสำหรับการใช้งานในผลิตภัณฑ์; รายละเอียดราคาอยู่ในหน้าผลิตภัณฑ์และคุณสามารถรับลิขสิทธิ์ชั่วคราวได้จาก หน้าลิขสิทธิ์ชั่วคราว. ด้วยความรู้นี้ คุณพร้อมที่จะรวมการแปลง 3D เป็น PDF เข้าไปในแอปพลิเคชัน Java ของคุณและส่งมอบรายงานที่เรียบหรูให้กับผู้ใช้ปลายทาง.

คำถามที่พบบ่อย

  • ฉันจะทำการแปลง 3D เป็น PDF ใน Java ด้วย Aspose.Cells อย่างไร?
    ใช้ SDK เพื่ออัปโหลดไฟล์ XLSX ของคุณ, กำหนดค่า PdfSaveOptions, เรียก postWorkbookSaveAs และดาวน์โหลด PDF ที่ได้. ตัวอย่างโค้ดเต็มในบทความนี้แสดงลำดับขั้นตอนที่แน่นอน.

  • มีวิธีใดบ้างที่สามารถทำการแปลง PDF ของแผนภาพ 3D ใน Java โดยไม่ต้องเขียนโค้ด?
    ใช่, REST API และคำสั่ง cURL ที่ให้มาช่วยให้คุณสามารถบรรลุผลลัพธ์เดียวกันจากแพลตฟอร์มใดก็ได้ที่สามารถทำการร้องขอ HTTP ได้.

  • ความแตกต่างระหว่างการแปลง PDF ด้วย 3D Visualization กับการแปลง Excel เป็น PDF ปกติคืออะไร?
    การแสดงผล 3D ต้องการการเรนเดอร์วัตถุแผนภูมิเพิ่มเติม ซึ่ง SDK จะจัดการโดยอัตโนมัติ การแปลงแบบปกติอาจข้ามขั้นตอนการเรนเดอร์ 3D นี้ ทำให้กราฟิกหายไป.

  • ฉันสามารถใช้เวิร์กโฟลว์เดียวกันสำหรับการแปลง Excel เป็น PDF ของ Java สำหรับเวิร์กบุ๊กที่ไม่ใช่ 3D ได้หรือไม่?
    แน่นอน. การเรียก API เดียวกันทำงานกับไฟล์ Excel ใดก็ได้; คุณเพียงแค่ละเว้นหรือปรับตัวเลือกเฉพาะ 3D หากไม่จำเป็น.

อ่านเพิ่มเติม