'Conversor XLS'

O que é uma Linha de Comando?

O ‘Conversor XLS’ pode rodar sem uma interface de usuário, com argumentos de linha de comando em um modo muito parecido com os bons e velhos tempos do DOS. Alternativamente, você pode iniciar a execução da linha de comando através do 'prompt de comando' do sistema operacional ou, no Windows, através da digitação do comando na janela da sequência INICIAR-EXECUTAR. A interface de linha de comando também pode ser usada através de arquivos batch (arquivos com extensão *.BAT). 

Existem duas abordagens de utilização da linha de comando:

     A)  Especificar um 'Job de Conversão' que foi criado através da Interface Gráfica de Usuário (GUI); ou

     B)   Especificar uma 'Tarefa de Conversão' em detalhes a partir da linha de comando.

Especificar um 'Job de Conversão' é muito simples, já que tudo o que você precisa fazer é indicar ao ‘Conversor XLS ’ onde encontrar o 'Job de Conversão' (*.SII) que você criou através da interface gráfica do produto.  Todos os detalhes associados à tarefa são incluídos na execução. Especificar uma 'Tarefa de Conversão' a partir do zero é um trabalho muito mais tedioso, mas não requer a criação prévia do job de conversão através da GUI. Ambas as abordagens são discutidas em detalhes abaixo.

Importante: Para obter sucesso na utilização da linha de comando, você precisa seguir uma das regras básicas abaixo:

A) Incluir o ConvertXLS.EXE na path das suas variáveis de ambiente ; ou,

B) Copiar o ConvertXLS.EXE para a mesma pasta do arquivo batch.

Caso não faça isso, receberá a seguinte mensagem de erro: 
"'ConvertXLS' não é reconhecido como um comando interno ou externo, um programa operável ou um arquivo em lotes."

Especificando um 'Job de Conversão' (Conversion Job)

Após criar o job de conversão através da interface de usuário (GUI), a sintaxe para especificar tal 'Job de Conversão' é:

 ConvertXLS /J{Arquivo de Job de Conversão}  [/V] [/L{Arquivo de Log}] [/B{Arquivo de log em Job}] [/W{senha}] [/X{senha}] [/Y{senha}] [/Z{senha}]

Itens descritos em colchetes "[ ]" são opcionais, todas as outras 'chamadas' são requeridas. Assim, /J deve ser sempre especificado na linha de comando.

 Exemplo:

Para executar o 'Job de Conversão' especificado no arquivo "C:\MeusJobs\PerasLaranjas.SII" digite o seguinte conteúdo no 'Prompt de Comando':

 ConvertXLS /J"C:\MeusJobs\PerasLaranjas.SII"

Você pode incluir ou excluir espaços entre argumentos e parâmetros. Por exemplo, "/C6" é o mesmo que "/C 6". No caso de nomes longos de arquivos pode ser requerido que você use aspas duplas. Por exemplo: /S"C:\Arquivos de Programas\MeuApp\MeuDoc.DOC".

Especificando uma 'Tarefa de Conversão' (Conversion Task)

A sintaxe da linha de comando para especificar uma tarefa de conversão é:

ConvertXLS /S{Arquivo(s) Original(is)} /T{Arquivo(s) de Destino} /F# /C# [/M#][/N"{Planilha^Intervalo^Caractere Delimitador}"] [/G] [/V] [/R] [/L{Arquivo de Log}] [/B{Arquivo de Log em Job}][/U] [/W{senha}] [/X{senha}] [/Y{senha}] [/Z{senha}]

Itens descritos em colchetes "[ ]" são opcionais, todas as outras 'chamadas' são requeridas. Assim, /S, /T, /C# devem ser sempre especificados na linha de comando. Existe somente uma exceção; quando o /G (Salvar no diretório original) é especificado, o parâmetro /T torna-se desnecessário.

Você pode incluir ou excluir espaços entre argumentos e parâmetros. Por exemplo, "/C6" é o mesmo que "/C 6". No caso de nomes longos de arquivos pode ser requerido que você use aspas duplas. Por exemplo: /S"C:\Arquivos de Programas\MeuApp\MeuDoc.DOC".

/S{Arquivo(s) Original(is)} é usado para especificar os arquivos a serem convertidos. Você pode especificar um único arquivo ou, em alguns casos, um conjunto de arquivos através da sintaxe 'coringa' (ex: "C:\Meusarquivos\*.XLS"). /T{Arquivo(s) de destino} deve ser sempre diferente de /S{Arquivo(s) Original(is)}.

Observação Adicional: Qualquer arquivo que possa ser aberto pelo MS Excel é considerado válido para a sintaxe /S{Arquivo Original}.

/T{Arquivo(s) de Destino} é usado para especificar o caminho de destino do(s) arquivo(s) convertido(s). Você pode especificar um único arquivo ou, em alguns casos, um conjunto de arquivos através da sintaxe 'coringa' (ex:"C:\Meusarquivos\*.XLS") /T{Arquivo(s) de destino} deve ser sempre diferente de /S{Arquivo(s) Original(is)}.

/F# informa ao 'Conversor XLS' qual o tipo de arquivo do (/S{Arquivo Original}). Este parâmetro só é requerido quando for utilizado o método /M2 de conversão do 'Conversor XLS'. Para uma lista das constantes, consulte Constantes para tipos de arquivos.

/C# informa ao 'Conversor XLS' qual o tipo de arquivo para converter o(s) /T{Arquivo(s) de destino}. Para uma lista das constantes, consulte Constantes para tipos de arquivos.

[/M#] Especifica o método de conversão a ser usado (caso esteja convertendo). Os seguintes valores são válidos:

1 = MS Excel (Valor Padrão)

2 = 'Conversor XLS' 

        Este parâmetro não é necessário caso você esteja utilizando o método 'Conversor XLS'.

[/N{"Planilha^Intervalo^CaractereDelimitador"}] é usado somente na conversão de/para um arquivo Excel. Especifica quais planilhas converter e qual caractere de delimitação/separação usar. A sintaxe deste parâmetro é crítica, os 3 itens são separados por um acento circunflexo "^". Caso não declare Planilha, Intervalo ou Caractere delimitador, o padrão será todas as planilhas, todos os intervalos usados e a vírgula será adotada como caratere delimitador. Note que as aspas duplas devem sempre demarcar o início e o fim deste parâmetro.

Utilize "*" ou "" para determinar todas as planilhas. Você pode utilizar os nomes ou o índice numérico das planilhas. Caso utilize índices numéricos, você pode especificar intervalos de planilhas (ex. "1,4,10-20" e "4-10,9" etc.). Intervalo e Caractere Delimitador são opcionais.

Por exemplo, para especificar as planilhas "Peras" e "Laranjas", com um intervalo de "A2:B20" e usando a tab (valor decimal ASCII igual a 9) como caractere separador, a sintaxe a ser usada é:

/N"Peras,Laranjas^A2:B20^9"

[/G] Salvar os arquivos em suas pastas originais. Utilize este parâmetro ao invés do /T para alocar os arquivos convertidos na mesma pasta do arquivo original. Não pode ser usado quando estiver convertendo um único arquivo de uma pasta específica. Neste caso, use o parâmetro /T.

[/V] Modo detalhado. Especifique este parâmetro para forçar a exibição de uma caixa de mensagem contendo informações sobre a conversão. Veja também o parâmetro /L

[/R] Busca e inclui todos os arquivos encontrados nos subdiretórios especificados no parâmetro /S. Subdiretórios recursivos. Você pode declarar este parâmetro caso esteja processando diretórios inteiros de arquivos. Consulte /S, /T e /G para maiores detalhes sobre a seleção de diretórios inteiros a serem convertidos.

[/L{Arquivo de Log}] Nome e caminho do arquivo de Log (ex. d:\meuslogs\WCE.LOG) Caso este parâmetro seja especificado, um arquivo de log com o nome e o caminho especificados será criado e onde o resultado da conversão será gravado. Consulte também /V.

[/B{Arquivo de Log em Job}] Salva o arquivo de log no formato de 'Job de Conversão' SOMENTE CASO OCORRAM ERROS. Este parâmetro é útil caso os arquivos em que ocorreram problemas possam ser executados posteriormente e/ou refeitos através de outro método. O /B é diferente do /L, já que o arquivo gerado através do /B não inclui comentários irrelevantes não permitidos em um arquivo de 'Job de Conversão'. Salve como um arquivo .SII para permitir que seja executado como um job.

[/U] Caso esteja convertendo um arquivo XLS com múltiplas planilhas especificadas, o parâmetro /U gerará arquivos múltiplos ao invés de um arquivo único.

[/W{Senha para abrir o(s) arquivo(s) original(is)}]   Senha para acessar o arquivo original.

[/X{Senha para gravar o(s) arquivo(s) original(is)}]  Senha que permite a gravação do arquivo original.

[/Y{Senha para abrir o(s) arquivo(s) de destino}]   Senha para acessar o arquivo de destino.

[/Z{Senha para gravar o(s) arquivo(s) de destino}]  Senha que permite a gravação do arquivo de destino.

 

Consulte também:
Documentação Online que inclui exemplos de utilização via linha de comando.

 

Tipos de arquivos suportados pelo 'Conversor XLS', itens em negrito podem ser utilizados sem que o MS Excel esteja instalado.

Texto, CSV, e HTML (incluindo diversos formatos de bases de dados) são apenas alguns dos muitos formatos com os quais você pode utilizar este conversor Excel de E para. Converta arquivos Excel com o 'Conversor XLS'!