Intelligent Media Management:Convertir des formats de document

Scénarios

• Optimisation de l'aperçu en ligne : les utilisateurs téléchargent des documents dans divers formats, tels que PDF, Word, Excel et PPT, vers OSS. Pour permettre aux utilisateurs de prévisualiser ces documents directement dans des applications web ou mobiles sans les télécharger, appelez l'API de conversion de documents fournie par le service IMM. Cette opération convertit les documents en images adaptées à l'affichage en ligne.

• Compatibilité multiplateforme : différents appareils et systèmes d'exploitation prennent en charge différents formats de fichiers. Le service de conversion de documents garantit que tous les utilisateurs peuvent consulter les documents sans interruption, quel que soit l'appareil qu'ils utilisent.

Facturation

L'utilisation du service de conversion de format de document entraîne les frais suivants :

• Frais de traitement des documents : ces frais sont facturés en fonction du nombre d'appels. Pour plus d'informations, consultez Traitement des documents.

• Frais de trafic : vous êtes facturé pour le trafic Internet sortant en fonction de la taille des fichiers traités. Pour plus d'informations, consultez Frais de trafic.

Fonctionnalités

Notes d'utilisation

Le temps nécessaire à la conversion du format de document dépend de facteurs tels que la taille du document, le nombre de pages et le nombre de mots. Dans les cas typiques, une requête est traitée en quelques secondes. Toutefois, les fichiers volumineux ou contenant de nombreuses pages et mots peuvent prendre jusqu'à plusieurs dizaines de secondes. Pour réduire les temps d'attente de l'application, IMM fournit l'opération d'API asynchrone CreateOfficeConversionTask pour la conversion de format de document.

Exemples de contenu de sortie

Les exemples suivants montrent le contenu de sortie lorsque le préfixe du chemin de sortie TargetURIPrefix est défini sur le chemin OSS oss://test-bucket/target/ dans la requête.

• Si le document d'entrée est une feuille de calcul, le chemin de sortie est au format suivant.

  oss://test-bucket/target/{sheetname}_{sheetindex}_{sheetsubindex}.{autoext}

• Si le document d'entrée n'est pas une feuille de calcul, le chemin de sortie est au format suivant.

  oss://test-bucket/target/{index}.{autoext}

• Le tableau suivant décrit les paramètres associés.

Variable	Description	Valeur d'exemple
index	L'index de sortie. La valeur commence à 1. Si le fichier d'entrée est un fichier Word, PDF ou PPT, cette variable indique le numéro de page. Si le fichier d'entrée est un fichier Excel, cette variable indique sheetindex_sheetsubindex. sheetindex : l'index de la feuille. La valeur commence à 1. sheetsubindex : l'index de l'image pour la feuille actuelle. La valeur commence à 1. Une feuille peut être convertie en plusieurs images.	6_12
sheetname	Si le fichier d'entrée est un fichier Excel, cette variable indique le nom de la feuille.	sheet1
autoext	L'extension du fichier de sortie.	jpg

Format du message de notification asynchrone

Si vous définissez le paramètre de rappel de message dans la requête, la notification asynchrone contient le nombre de fichiers convertis (TargetFileCount) et les informations personnalisées (UserData).

• Pour utiliser les notifications de messages asynchrones, définissez le paramètre de rappel de message Notification lorsque vous initiez une requête.

• Les paramètres du message renvoyé sont décrits dans l'exemple suivant :

{
    "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.
}

Références

• Conversion de format de document