Cara menggunakan fitur konversi format dokumen - Intelligent Media Management

Fitur konversi format dokumen dari Intelligent Media Management (IMM) memungkinkan Anda memproses berbagai jenis dokumen, mengonversinya ke format keluaran yang diinginkan, dan menyimpan hasilnya ke jalur Object Storage Service (OSS) yang ditentukan.

Skenario

Optimasi pratinjau online: Pengguna mengunggah dokumen dalam berbagai format—seperti PDF, Word, Excel, dan PPT—ke OSS. Untuk memungkinkan pratinjau langsung di aplikasi web atau seluler tanpa perlu mengunduh, Anda dapat memanggil API konversi dokumen yang disediakan oleh layanan IMM guna mengonversi dokumen menjadi citra yang sesuai untuk ditampilkan secara online.
Kompatibilitas lintas platform: Perangkat dan sistem operasi yang berbeda mendukung format file yang beragam. Layanan konversi dokumen memastikan bahwa semua pengguna dapat melihat dokumen dengan lancar, terlepas dari perangkat yang digunakan.

Penagihan

Penggunaan layanan konversi format dokumen dikenai biaya sebagai berikut:

Biaya pemrosesan dokumen: Dikenakan berdasarkan jumlah panggilan. Untuk informasi selengkapnya, lihat Document processing.
Biaya lalu lintas: Anda dikenai biaya lalu lintas Internet keluar berdasarkan ukuran file yang diproses. Untuk informasi selengkapnya, lihat Traffic fees.

Fitur

Jenis konversi yang didukung

Tabel berikut menjelaskan jenis konversi yang didukung untuk konversi format dokumen.

Jenis dokumen masukan	Jenis dokumen keluaran	Deskripsi
Word, Excel, PPT	PDF	Menghasilkan file PDF yang terdiri dari citra.
Word, Excel, PPT, PDF	PNG, JPEG	Tidak ada
Word, Excel, PPT	TXT	Tidak ada
JPEG	PDF	Tidak ada

Jenis file masukan yang didukung

Jenis file	Ekstensi file
Word	doc, docx, wps, wpss, docm, dotm, dot, dotx, html
PPT	pptx, ppt, pot, potx, pps, ppsx, dps, dpt, pptm, potm, ppsm, dpss
Excel	xls, xlt, et, ett, xlsx, xltx, csv, xlsb, xlsm, xltm, ets
PDF	pdf

Catatan

Konten keluaran bervariasi tergantung pada format dokumen keluaran yang Anda tentukan dalam permintaan. Untuk contoh konten keluaran, lihat Contoh konten keluaran.
Untuk format keluaran JPEG dan PNG, konten keluaran berbeda tergantung pada apakah dokumen masukan merupakan spreadsheet (Excel).
- Jika dokumen masukan adalah spreadsheet (Excel), sebuah folder dibuat untuk setiap sheet, dan beberapa file dihasilkan berdasarkan ukuran halaman pratinjau.
- Jika dokumen masukan bukan spreadsheet—misalnya dokumen Word atau PPT—satu file dihasilkan untuk setiap halaman dokumen.
Untuk format keluaran PDF dan TXT, hanya satu file yang dihasilkan, terlepas dari jenis dokumen masukan (termasuk spreadsheet).
Anda dapat menggunakan parameter TargetURI untuk menentukan jalur keluaran. Parameter ini mendukung rendering variabel. Untuk informasi selengkapnya, lihat Templat TargetURI. Anda juga dapat menggunakan parameter TargetURIPrefix untuk menentukan awalan jalur keluaran. Informasi tentang jalur keluaran default tersedia di Contoh konten keluaran.
Anda hanya dapat mengonversi file DOC atau DOCX ke format PDF, citra, atau TXT. Konversi antara format DOC dan DOCX tidak didukung.

Catatan penggunaan

Waktu yang diperlukan untuk konversi format dokumen bergantung pada faktor seperti ukuran dokumen, jumlah halaman, dan jumlah kata. Dalam kasus umum, permintaan selesai dalam hitungan detik. Namun, file besar atau file dengan banyak halaman dan kata mungkin memerlukan waktu hingga puluhan detik. Untuk mengurangi waktu tunggu aplikasi, IMM menyediakan Operasi API asinkron CreateOfficeConversionTask untuk konversi format dokumen.

Penting

Setelah tugas dimulai, informasinya hanya disimpan selama tujuh hari. Gunakan salah satu metode berikut untuk segera mengambil informasi tugas:

Panggil operasi GetTask atau ListTasks untuk mengambil TaskId yang dikembalikan dan melihat informasi tugas.
Aktifkan Message Service (MNS) di Wilayah yang sama dengan IMM dan konfigurasikan langganan untuk segera menerima notifikasi informasi tugas. Untuk format pesan notifikasi asinkron, lihat Format pesan notifikasi asinkron. Informasi selengkapnya tentang kit pengembangan perangkat lunak (SDK) MNS tersedia di Langkah 4: Menerima dan menghapus pesan.
Aktifkan RocketMQ di Wilayah yang sama dengan IMM, lalu buat instans RocketMQ 4.0, topik, dan kelompok untuk segera menerima notifikasi informasi tugas. Untuk format pesan notifikasi asinkron, lihat Format pesan notifikasi asinkron. Informasi selengkapnya tentang cara menggunakan RocketMQ tersedia di Gunakan SDK untuk HTTP guna mengirim dan menerima pesan biasa.
Aktifkan dan hubungkan ke EventBridge di Wilayah yang sama dengan IMM untuk menerima notifikasi informasi tugas secara real time. Untuk informasi selengkapnya, lihat Event Intelligent Media Management (IMM).
Jika resolusi dokumen berkurang setelah konversi, Anda dapat menyesuaikan parameter ImageDPI untuk mengontrol resolusi saat memanggil operasi CreateOfficeConversionTask. Nilai ImageDPI yang lebih besar menghasilkan citra yang lebih jelas.

Contoh konten keluaran

Contoh berikut menunjukkan konten keluaran ketika awalan jalur keluaran TargetURIPrefix diatur ke jalur OSS oss://test-bucket/target/ dalam permintaan.

Jika dokumen masukan adalah spreadsheet, jalur keluaran memiliki format berikut:
oss://test-bucket/target/{sheetname}_{sheetindex}_{sheetsubindex}.{autoext}
Jika dokumen masukan bukan spreadsheet, jalur keluaran memiliki format berikut:
oss://test-bucket/target/{index}.{autoext}
Tabel berikut menjelaskan parameter terkait.

Variabel	Deskripsi	Nilai contoh
index	Indeks keluaran. Nilainya dimulai dari 1. Jika file masukan adalah file Word, PDF, atau PPT, variabel ini menunjukkan nomor halaman. Jika file masukan adalah file Excel, variabel ini menunjukkan sheetindex_sheetsubindex. sheetindex: Indeks sheet. Nilainya dimulai dari 1. sheetsubindex: Indeks citra untuk sheet saat ini. Nilainya dimulai dari 1. Satu sheet dapat dikonversi menjadi beberapa citra.	6_12
sheetname	Jika file masukan adalah file Excel, variabel ini menunjukkan nama sheet.	sheet1
autoext	Ekstensi file keluaran.	jpg

Format pesan notifikasi asinkron

Jika Anda mengatur parameter callback pesan dalam permintaan, notifikasi asinkron berisi jumlah file yang dikonversi (TargetFileCount) dan informasi kustom (UserData).

Untuk menggunakan notifikasi pesan asinkron, atur parameter callback pesan Notification saat menginisiasi permintaan.
Parameter dalam pesan yang dikembalikan dijelaskan dalam contoh berikut:

{
    "ProjectName": "immtest", // Nama proyek.
    "DatasetName": "",  // Nama set data.
    "RequestId": "A1DA7436-768B-061D-833C-****", // ID permintaan.
    "StartTime": "2023-01-04T05:03:40.928Z", // Waktu mulai tugas.
    "EndTime": "2023-01-04T05:03:41.444Z", // Waktu akhir tugas.
    "UserData": "test", // Informasi kustom.
    "TaskType": "OfficeConversion", // Jenis tugas.
    "TaskId": "OfficeConversion-ed315cab-7736-4ad8-8c56-****", // ID tugas konversi.
    "Status": "Succeeded", // Status konversi.
    "Code": "", // Nilai kosong menunjukkan tugas berhasil.
    "Message": "",// Pesan kesalahan jika tugas gagal.
    "TargetFileCount": 5 // Jumlah file yang dikonversi.
}

Referensi

Konversi Format Dokumen