La función de conversión de formatos de documentos de Intelligent Media Management (IMM) le permite procesar diversos tipos de documentos. Convierta los documentos al formato de salida que necesite y guarde el resultado en una ruta específica de Object Storage Service (OSS).
Escenarios
Optimización de la vista previa en línea: los usuarios cargan documentos en varios formatos a OSS, como PDF, Word, Excel y PPT. Para que puedan previsualizarlos directamente en aplicaciones web o móviles sin descargarlos, llame a la API de conversión de documentos del servicio IMM. Esta convierte los documentos en imágenes adecuadas para su visualización en línea.
Compatibilidad multiplataforma: cada dispositivo y sistema operativo admite distintos formatos de archivo. El servicio de conversión de documentos garantiza que todos los usuarios consulten los archivos sin problemas, sin importar qué dispositivo utilicen.
Facturación
El uso del servicio de conversión de formatos de documentos genera los siguientes cargos:
Cargos por procesamiento de documentos: se cobran según el número de llamadas. Para obtener más información, consulte Document processing.
Cargos por tráfico: se cobra el tráfico saliente de Internet con base en el tamaño de los archivos procesados. Para obtener más información, consulte Traffic fees.
Funciones
Tipos de conversión compatibles
A continuación se describen los tipos de conversión compatibles para la conversión de formatos de documentos.
|
Tipo de documento de entrada |
Tipo de documento de salida |
Descripción |
|
Word, Excel, PPT |
|
Genera un archivo PDF compuesto por imágenes. |
|
Word, Excel, PPT, PDF |
PNG, JPEG |
Ninguna |
|
Word, Excel, PPT |
TXT |
Ninguna |
|
JPEG |
|
Ninguna |
Tipos de archivo de entrada compatibles
|
Tipo de archivo |
Extensión de archivo |
|
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 |
|
|
|
Notas
El contenido de salida varía según el formato de documento de salida que especifique en la solicitud. Para ver ejemplos del contenido de salida, consulte Output content examples.
-
En los formatos de salida JPEG y PNG, el contenido resultante cambia dependiendo de si el documento de entrada es una hoja de cálculo (Excel).
Si el documento de entrada es una hoja de cálculo (Excel), se crea una carpeta por cada hoja. Después, se generan varios archivos según el tamaño de la página de vista previa.
Si el documento de entrada no es una hoja de cálculo, como un archivo de Word o PPT, se genera un archivo por cada página del documento.
Para los formatos de salida PDF y TXT, solo se genera un archivo, sin importar si el documento de entrada es una hoja de cálculo.
Use el parámetro
TargetURIpara especificar la ruta de salida. Este parámetro admite la representación de variables. Para obtener más información, consulte TargetURI template. También puede usar el parámetroTargetURIPrefixpara especificar el prefijo de la ruta de salida. Para conocer la ruta de salida predeterminada, consulte Output content examples.Los archivos DOC o DOCX solo se pueden convertir a los formatos PDF, imagen o TXT. No se admite la conversión entre los formatos DOC y DOCX.
Notas de uso
El tiempo necesario para convertir formatos de documentos depende de factores como el tamaño del archivo, el número de páginas y la cantidad de palabras. En casos habituales, una solicitud se completa en segundos. Sin embargo, los archivos grandes o aquellos con muchas páginas y palabras pueden tardar hasta decenas de segundos. Para reducir los tiempos de espera de la aplicación, IMM proporciona la operación de API asíncrona CreateOfficeConversionTask para la conversión de formatos de documentos.
Una vez que inicia una tarea, su información se guarda únicamente durante siete días. Utilice los siguientes métodos para recuperar la información de la tarea de manera oportuna:
Llame a la operación GetTask o ListTasks para recuperar el valor
TaskIddevuelto y consulte la información de la tarea.Active Message Service (MNS) en la misma región que IMM y configure una suscripción para recibir oportunamente las notificaciones con la información de la tarea. Para conocer el formato del mensaje de notificación asíncrona, consulte Asynchronous notification message format. Para obtener más información sobre el kit de desarrollo de software (SDK) de MNS, consulte Step 4: Receive and delete messages.
Active RocketMQ en la misma región que IMM. Luego, cree una instancia, un tema y un grupo de RocketMQ 4.0 para recibir oportunamente las notificaciones con la información de la tarea. Para conocer el formato del mensaje de notificación asíncrona, consulte Asynchronous notification message format. Para obtener más información sobre cómo usar RocketMQ, consulte Use an SDK for HTTP to send and receive normal messages.
Active y conecte EventBridge en la misma región que IMM para recibir las notificaciones con la información de la tarea en tiempo real. Para obtener más información, consulte Intelligent Media Management (IMM) events.
Si la resolución del documento disminuye después de la conversión, ajuste el parámetro ImageDPI para controlar la resolución cuando llame a la operación CreateOfficeConversionTask. Un valor mayor en el parámetro ImageDPI produce una imagen más nítida.
Ejemplos de contenido de salida
A continuación se muestran ejemplos del contenido de salida cuando el prefijo de la ruta de salida TargetURIPrefix se establece en la ruta de OSS oss://test-bucket/target/ dentro de la solicitud.
-
Si el documento de entrada es una hoja de cálculo, la ruta de salida tiene el siguiente formato.
oss://test-bucket/target/{sheetname}_{sheetindex}_{sheetsubindex}.{autoext} -
Si el documento de entrada no es una hoja de cálculo, la ruta de salida tiene el siguiente formato.
oss://test-bucket/target/{index}.{autoext} En la siguiente tabla se describen los parámetros relacionados.
Si el archivo de entrada es de Word, PDF o PPT, esta variable indica el número de página.
Si el archivo de entrada es de Excel, esta variable indica sheetindex_sheetsubindex.
sheetindex: índice de la hoja. El valor comienza desde 1.
sheetsubindex: índice de la imagen correspondiente a la hoja actual. El valor comienza desde 1. Una hoja se puede convertir en varias imágenes.
Variable | Descripción | Valor de ejemplo |
index | Índice de salida. El valor comienza desde 1. | 6_12 |
sheetname | Si el archivo de entrada es de Excel, esta variable indica el nombre de la hoja. | sheet1 |
autoext | Extensión del archivo de salida. | jpg |
Formato del mensaje de notificación asíncrona
Si establece el parámetro de devolución de llamada de mensajes en la solicitud, la notificación asíncrona incluye el número de archivos convertidos (TargetFileCount) e información personalizada (UserData).
Para usar las notificaciones asíncronas de mensajes, establezca el parámetro de devolución de llamada de mensajes
Notificationcuando inicie una solicitud.En el siguiente ejemplo se describen los parámetros del mensaje devuelto:
{
"ProjectName": "immtest", // The name of the project.
"DatasetName": "", // The name of the dataset.
"RequestId": "A1DA7436-768B-061D-833C-****", // The request ID.
"StartTime": "2023-01-04T05:03:40.928Z", // The start time of the task.
"EndTime": "2023-01-04T05:03:41.444Z", // The end time of the task.
"UserData": "test", // The custom information.
"TaskType": "OfficeConversion", // The task type.
"TaskId": "OfficeConversion-ed315cab-7736-4ad8-8c56-****", // The ID of the conversion task.
"Status": "Succeeded", // The status of the conversion.
"Code": "", // An empty value indicates that the task is successful.
"Message": "",// The error message if the task failed.
"TargetFileCount": 5 // The number of converted files.
}