Intelligent Media Management:Converter formatos de documento

Cenários

• Otimização de pré-visualização online: usuários fazem upload de documentos em vários formatos, como PDF, Word, Excel e PPT, para o OSS. Para permitir a pré-visualização direta desses documentos em aplicações web ou móveis sem download, chame a API de conversão de documentos do serviço IMM. Essa operação converte os documentos em imagens adequadas para exibição online.

• Compatibilidade entre plataformas: diferentes dispositivos e sistemas operacionais aceitam formatos de arquivo distintos. O serviço de conversão de documentos garante que todos os usuários visualizem os documentos sem problemas, independentemente do dispositivo utilizado.

Faturamento

O uso do serviço de conversão de formato de documento gera as seguintes taxas:

• Taxas de processamento de documentos: cobradas com base no número de chamadas. Para mais informações, consulte Processamento de documentos.

• Taxas de tráfego: cobrança aplicada sobre o tráfego de saída para a Internet com base no tamanho dos arquivos processados. Para mais informações, consulte Taxas de tráfego.

Recursos

Notas de uso

O tempo necessário para a conversão de formato de documento depende de fatores como tamanho do arquivo, número de páginas e contagem de palavras. Em casos típicos, uma solicitação é concluída em segundos. No entanto, arquivos grandes ou com muitas páginas e palavras podem levar dezenas de segundos. Para reduzir o tempo de espera da aplicação, o IMM fornece a operação de API assíncrona CreateOfficeConversionTask para conversão de formatos de documento.

Exemplos de conteúdo de saída

Os exemplos a seguir mostram o conteúdo de saída quando o prefixo do caminho de saída TargetURIPrefix está definido como o caminho do OSS oss://test-bucket/target/ na solicitação.

• Quando o documento de entrada é uma planilha, o caminho de saída segue o formato abaixo.

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

• Caso o documento de entrada não seja uma planilha, o caminho de saída adota o seguinte formato.

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

• A tabela a seguir descreve os parâmetros relacionados.

Variável	Descrição	Valor de exemplo
index	O índice de saída. O valor começa em 1. Se o arquivo de entrada for Word, PDF ou PPT, esta variável indica o número da página. Se o arquivo de entrada for Excel, esta variável indica sheetindex_sheetsubindex. sheetindex: O índice da aba. O valor começa em 1. sheetsubindex: O índice da imagem para a aba atual. O valor começa em 1. Uma aba pode ser convertida em várias imagens.	6_12
sheetname	Se o arquivo de entrada for Excel, esta variável indica o nome da aba.	sheet1
autoext	A extensão do arquivo de saída.	jpg

Formato da mensagem de notificação assíncrona

Se você definir o parâmetro de callback de mensagem na solicitação, a notificação assíncrona conterá o número de arquivos convertidos (TargetFileCount) e informações personalizadas (UserData).

• Para usar notificações de mensagens assíncronas, defina o parâmetro de callback de mensagem Notification ao iniciar uma solicitação.

• Os parâmetros na mensagem retornada são descritos no exemplo a seguir:

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

Referências

• Conversão de formato de documento