• Artigo

Converter arquivos binários do Office usando o OFC (Office File Converter) e o VET (Version Extraction Tool)

 

Aplica-se a: Office 2010

Tópico modificado em: 2015-03-09

O OMPM (Office Migration Planning Manager) inclui duas ferramentas para ajudá-lo a gerenciar arquivos binários do Office durante uma migração para O Microsoft Office 2010. É possível usar o OFC (Office File Converter) para converter arquivos binários em massa para o formato OpenXML usado pelo Office 2010 e pelo 2007 Office system. Use a VET (Version Extraction Tool) para extrair múltiplas versões salvas de um único documento do Word 97–2003 para arquivos individuais. Ambas as ferramentas são normalmente usadas com os resultados de exame gerados pelo OMPM.

Converta arquivos em massa usando o OFC

Antes de usar o OFC, revise as seguintes diretrizes de uso.

  • O Microsoft Office Compatibility Pack precisa estar instalado nos computadores que contêm os arquivos que você deseja converter. Para obter mais informações, consulte Microsoft Office Compatibility Pack for Word, Excel and PowerPoint File Formats (https://www.microsoft.com/downloads/pt-br/details.aspx?familyid=941b3470-3ae9-4aee-8f43-c6bb74cd1466).

  • O OFC converte arquivos .doc binários para o formato de arquivo .docx usado pelo Word 2007. Como resultado, quando um usuário abre um arquivo .docx convertido em Word 2010, o arquivo é aberto no modo de compatibilidade do Word 2007. O OFC não suporta a conversão de arquivos .doc para o formato .docx do Word 2010. Os usuários pode converter os arquivos individualmente para o formato .docx do Word 2010 clicando na guia Arquivo e clicando em Converter.

  • O OFC pode converter até o máximo de 10 pastas de profundidade. Por exemplo, DestinationPathTemplate=I:\Converted\*1\*2\*3\*4\*5\*6\*7\*8\*9\ funciona corretamente. No entanto, DestinationPathTemplate=I:\Converted\*1\*2\*3\*4\*5\*6\*7\*8\*9\*10\ não funciona. Para solucionar esse problema, use comandos como net use ou subst para encurtar o caminho.

Antes de executar o Office File Converter, edite o arquivo ofc.ini para definir os parâmetros apropriados.

Para converter arquivos

  1. Em um prompt de comando, navegue até a pasta onde o OFC está instalado.

  2. Digite o seguinte comando:

    ofc <ofc.ini>

O parâmetro para esse comando é o seguinte.

Parâmetro Descrição

ofc.ini

O local do arquivo ofc.ini. Se nenhum caminho for especificado, o OFC procurará no mesmo diretório que o executável. Opcional.

Observação

Se você definir FileListFolder e FoldersToConvert como o mesmo conjunto de arquivos, o conjunto de arquivos será convertido duas vezes.

Configurações de Ofc.ini

A tabela a seguir mostra as configurações e valores em ofc.ini.

Configuração Descrição Possíveis valores Se o valor não estiver presente Se o valor não for válido

[Run]

A seção lista a identificação exclusiva e a descrição dessa conversão. Necessário.

A conversão é interrompida e aparece uma mensagem de erro.

Erro: cabeçalho da seção [Run] inválido ou ausente em OFC.INI.

RunID

Número de controle para a Conversão atual. Use isso para agrupar as Conversões de computadores diferentes na Ferramenta de Relatório. Necessário.

Precisa ser numérico

A conversão é interrompida e aparece uma mensagem de erro.

Erro: valor de RunID inválido ou ausente em OFC.INI.

Descrição

Texto usado para descrever a execução da conversão atual. Opcional.

Texto livre, truncado em 255 caracteres

Ignorar.

Não aplicável.

LogDestinationPath

Local para o arquivo de log gerado quando a configuração FileList é usada. Necessário.

Essa configuração não gera arquivos de log que capturam o texto exibido na janela Prompt de comando durante a conversão. Use o comando ">" (por exemplo, ofc.exe > C:\Log.txt) para salvar qualquer saída de shell de comando em um arquivo de texto.

Unidade física ou mapeada ou UNC. Por exemplo: c:\Conversion\logs

\\server\vba\logs

Variáveis do ambiente também são suportadas.

A conversão é interrompida e aparece uma mensagem de erro.

Erro: valor de ‘LogDestinationPath’ inválido ou ausente em OFC.INI.

[ConversionOptions]

Cabeçalho da seção de uma parte do arquivo .INI que lida com as opções de conversão. Necessário, a menos que não haja opções de conversão especificadas no arquivo .ini.

A conversão é interrompida e aparece uma mensagem de erro.

Erro: cabeçalho da seção [ConversionOptions] inválido ou ausente em OFC.INI.

DoNotCab

Permite que os usuários desativem a criação de arquivos CAB de arquivos de log. Opcional.

Os valores válidos são

1 – desativa a criação de arquivos CAB de arquivos de log

0 – ativa a criação de arquivos CAB de arquivos de log

A conversão é interrompida e aparece uma mensagem de erro.

Erro: valor de DoNotCab inválido ou ausente em OFC.INI.

MacroControl

Determina se o conversor inclui quaisquer projetos de macro durante a conversão. Uma configuração com o valor de 1 faz com que o OFC produza formatos de documentos OpenXML livres de macros (como .docx, xlsx, pptx). O código Macro/VBA nos documentos originais não será migrado. Opcional.

Os valores válidos são

1 – desconsiderar o VBA na conversão

0 – corresponder o estado da macro do documento de origem.

Assume o padrão de 0.

Erro: valor de ‘MacroControl’ inválido em OFC.INI.

[FoldersToConvert]

A seção lista os diretórios para conversão em operação independente. FileList será ignorado. Opcional.

Lista de pastas.

Ignorado se o arquivo de entrada passar.

Erro: seção [FoldersToConvert] inválida em OFC.INI.

ConvertSubfolders

Se as subpastas forem especificadas, uma configuração com o valor de 1 fará com que o OFC examine as subpastas, convertendo todos os documentos XL e PPT do Word. Opcional.

0 ou 1

Assume o padrão de 0.

Erro: valor de ‘ConvertSubfolders’ inválido em OFC.INI.

[ConversionInfo]

A seção lista as informações sobre o arquivo de entrada e sobre o destino. Necessário.

[ConvertedFolders]

A conversão é interrompida e aparece uma mensagem de erro.

Erro: cabeçalho da seção [ConversionInfo] inválido ou ausente em OFC.INI.

FileList

Caminho para FileList. Opcional.

Ocorrerá erro se não estiver presente e [FoldersToConvert] estiver vazio.

SourcePathTemplate

Uma sequência de *\ que determina quantos diretórios do caminho de origem serão capturados. É possível usar caracteres curinga de modo que um asterisco (*) represente um único segmento do caminho. Opcional.

Quando você executa SourcePathTemplate localmente, ele inclui informações de caminho de rede. Por exemplo, um arquivo em C:\Documents\file.doc é especificado como *1\=machinename, *2\=C:\, *3\=Documents e *4\=file.doc

Qualquer unidade física ou mapeada ou UNC. * ou ‘.’

Erro: valor de ‘SourcePathRoot’ inválido em OFC.INI.

DestinationPathTemplate

Usado para determinar o local do arquivo convertido. É possível usar caracteres curinga de modo que um asterisco (*) e um número representem um único segmento do caminho. Consulte os exemplos abaixo desta tabela. Opcional.

Qualquer unidade física ou mapeada ou UNC. * ou ‘.’

Erro: valor de ‘DestinationPathRoot’ inválido em OFC.INI.

Os exemplos abaixo mostram como é possível usar as configurações SourcePathTemplate e DestinationPathTemplate.

Exemplo 1

Neste exemplo, os arquivos de origem estão localizados em \\userfiles\<user name>\docs\ e a saída desejada ocorre em \\newserver\docs\<user name>\.

Para conseguir esse resultado, as configurações SourcePathTemplate e DestinationPathTemplate devem aparecer da seguinte maneira:

SourcePathTemplate = *\*\*\
DestinationPathTemplate = \\newserver\*3\*2

Nesse caso, DestinationPathTemplate atribui um número a cada segmento de diretório representado por um asterisco em SourcePathTemplate, de modo que:

*1 = userfiles

*2 = <nome do usuário>

*3 = docs

A tabela abaixo mostra exemplos de locais do arquivo de origem e os locais resultantes dos arquivos convertidos com as configurações exibidas acima.

Origem Destino 
\\userfiles\Cliff\docs\notes.doc
 
\\newserver\docs\Cliff\notes.docx
 
\\userfiles\Bob\docs\Personal\Rept1.doc
 
\\newserver\docs\Bob\Personal\Rept1.docx
 
\\userfiles\James\docs\New Folder\Schedule.doc
 
\\newserver\docs\James\New Folder\Schedule.docx

Exemplo 2

Neste exemplo, os arquivos de origem estão localizados nas pastas Meus Documentos nos computadores locais dos usuários. O caminho UNC é \\<nome do computador>\<letra da unidade>$\Documents and Settings\<nome de usuário>\Meus Documentos\. A saída desejada ocorre em \\DocServer\docs\<nome de usuário>\.

Para conseguir esse resultado, defina as configurações SourcePathTemplate e DestinationPathTemplate da seguinte maneira:

SourcePathTemplate = *\*\*\*\*\
DestinationPathTemplate = \\DocServer\*4\

Nesse caso, DestinationPathTemplate atribui um número a cada segmento de diretório representado por um asterisco no SourcePathTemplate de modo que:

*1 = <nome do computador> (por exemplo, DESKTOP3)

*2 = <letra da unidade>$ (por exemplo, c$)

*3 = Documents and Settings

*4 = <nome de usuário> (por exemplo, bobsmith)

*5 = Meus Documentos

A tabela abaixo mostra exemplos de locais do arquivo de origem e os locais resultantes dos arquivos convertidos com as configurações acima.

Origem Destino 
\\DESKTOP3\c$\Documents and Settings\bobsmith\My Documents\Plans.doc
 
\\DocServer\bobsmith\Plans.docx
 
LPTP4\d$\Documents and Settings\James\My Documents\Reports\q1.xls
 
\\DocServer\James\Reports\q1.xlsx

Use o VET para extrair versões de arquivos do Word

É possível usar o VET (Version Extraction Tool) incluído no OMPM para extrair versões de arquivos dos arquivos do Word criados no Office 2000, Office XP e no Office 2003 contendo controle de versão. Ao usar essa ferramenta, é possível usar a lista de arquivos gerada pelo utilitário de relatório do OMPM.

Observação

O VET exige o Microsoft .NET Framework 2.0 ou mais recente (https://msdn.microsoft.com/pt-br/netframework/aa569263) e Microsoft Word 2003.

Para extrair versões de arquivos do Word

  1. Em um prompt de comando, navegue até a pasta onde o VET está instalado.

  2. Digite:

    vet <diretório da lista de arquivos do OMPM> <diretório de saída>

Os parâmetros para esse comando são os seguintes:

Parâmetro Descrição

Diretório da lista de arquivos do OMPM

Local da lista de arquivos gerada pelo OMPM. Necessário.

diretório de saída

O diretório no qual você deseja copiar todas as versões dos arquivos Word. Necessário.

Por exemplo, para usar as listas de arquivos contidas no diretório c:\ompm\filelists e extrair as versões para o diretório c:\ompm\output, digite:

vet c:\ompm\filelists c:\ompm\output

Mensagens de erro do VET

A tabela abaixo mostra as mensagens de erro gravadas pelo VET no arquivo de log e de ação.

Mensagem de Erro Descrição

IDDaQuestão 9090: não foi possível abrir o documento <nome do documento>.

O documento original sinalizado como tendo versões não abriu no Word.

IDDaQuestão 9096: não foi possível obter o número de versões para o documento <nome do documento>.

O VET não foi capaz de consultar o documento em busca do número das versões no documento nomeado. O comando do modelo do objeto Versions.Count falhou.

IDDaQuestão 9091: não foi possível excluir a pasta da versão existente <caminho da pasta>.

Há uma pasta de versões existente para um arquivo específico e o VET não foi capaz de exclui-la e não pôde criar uma nova pasta para os arquivos da nova versão.

IDDaQuestão 9092: não foi possível criar um diretório para armazenar as versões do <nome do diretório>.

O VET não foi capaz de criar um diretório para armazenar as versões extraídas de um documento específico.

IDDaQuestão 9093: falha ao acessar o item da versão.

O VET não foi capaz de acessar a versão usando o comando do modelo de objeto do Word Versions.Item(i).

IDDaQuestão 9094: falha ao abrir a versão <número da versão> do <nome do arquivo>.

O VET não foi capaz de abrir a versão especificada usando o comando do modelo de objeto do Word Versions.Item(i).Open().

IDDaQuestão 9095: falha ao salvar a versão <número da versão> de <nome do arquivo> para <nome da pasta de versão>.

O VET não foi capaz de salvar a versão especificada do documento para a pasta de versões.