Línea de Comandos de ‘ Conversor XLS ’

Explicación de la Línea de Comandos

'Convertir XLS' se puede ejecutar sin precisar de una interfaz de usuario mediante instrucciones en la línea de comandos como en los viejos tiempos del DOS. Esta alternativa permite iniciar la ejecución desde la línea de comandos accediendo al 'prompt' del sistema operativo, en el caso Windows, accediendo a éste desde menú INICIO-EJECUTAR. Por último, la interfaz de línea de comandos se puede utilizar a partir de archivos batch (archivos con extensión *.BAT).

Existen dos alternativas a la hora de utilizar la línea de comandos:

     A)   Planificar un 'Job de Conversión' mediante interfaz gráfica de usuario (GUI); o bien

     B)   Ejecutar una 'Tarea de Conversión' directamente desde la línea de comandos.

Planificar un 'Job de Conversión' es muy sencillo, puesto que sólo es necesario informar a 'Convertir XLS' la ubicación del 'Job  de Conversión' *.SII asociado, y que ha sido previamente creado mediante la interfaz gráfica de usuario. Todas tareas asociadas serán entonces ejecutadas de una vez.

Especificar una "Tarea de Conversión" es mucho más laborioso, pero no requiere la creación previa de un "Job de Conversión". A continuación se muestra una valoración con mayor detalle de cada una de las alternativas.

Importante: Para utilizar la línea de comandos con éxito debe realizarse alguna de las siguientes acciones:

A) Fijar la ruta del ejecutable ConvertXLS.EXE en las variables de entorno del sistema; o,

B) Copiar el ejecutable ConvertXLS.EXE en la misma carpeta que el fichero batch.

En caso contrario, se obtendrá el siguiente error: 
"'ConvertXLS' is not recognized as an internal or external command, operable program or batch file." - "' ConvertXLS no se reconoce como un comando interno o externo, un programa operable o un archivo batch."

 

Planificando un 'Job de Conversión'

Una vez que el 'Job de Conversión' ha sido creado en la interfaz gráfica de usuario, la sintaxis para planificar el 'Job de Conversión' es la siguiente:

 ConvertXLS /J{ArchivoDelJobDeConversion}  [/V] [/L{FicheroLog}] [/B{LogDelJobDeConversión}] [/W{pw}] [/X{pw}] [/Y{pw}] [/Z{pw}]

Los argumentos presentados entre corchetes “[ ]” son opcionales, el resto son obligatorios.  Por lo tanto /J debería siempre estar especificado en la línea de comandos.

Ejemplo:

Para ejecutar un 'Job de Conversión' creado en "C:\MisJobs\ManzanasNaranjas.SII" será necesario escribir el siguiente código en la línea de comandos:

 ConvertXLS /J"C:\MisJobs\ManzanasNaranjas.SII"

Pueden incluirse o excluirse los espacios entre argumentos y parámetros. Por ejemplo,  "/C6" equivale a "/C  6".  En caso de ficheros con nombres largos, será necesario el uso de comillas dobles.  Por ejemplo /J"C:\Program Files\MisAplicaciones\MiDoc.DOC".

Ejecutando una 'Tarea de Conversión'

La sintaxis para especificar una 'Tarea de Conversión' desde la línea de comandos es la siguiente:

ConvertXLS /S{Fichero(s) Fuente} /T{Fichero(s) Destino} /F# /C# [/M#][/N"{Página^Rango^CaracterDelimitador}"] [/G] [/V] [/R] [/L{FicheroLog}] [/B{FicheroLogDelJob}][/U] [/W{pw}] [/X{pw}] [/Y{pw}] [/Z{pw}]

Los argumentos presentados entre corchetes “[ ]” son opcionales, el resto son obligatorios.  Por lo tanto /S, /T, /C# deberán estar siempre especificados en la línea de comandos. Existe, sin embargo, una excepción, que se da cuando se especifica el parámetro /G (Guardar en la carpeta original) lo cual produce que deje de ser obligatorio el parámetro /T.

Pueden incluirse o excluirse los espacios entre argumentos y parámetros. Por ejemplo,  "/C6" equivale a "/C  6".  En caso de ficheros con nombres largos, será necesario el uso de comillas dobles.  Por ejemplo /J"C:\Program Files\MisAplicaciones\MiDoc.DOC".

/S{Fichero(s) Fuente} es utilizado para indicar cuáles son los ficheros a convertir. Puede especificarse un fichero único o bien un conjunto de ficheros mediante la sintaxis clásica de la línea de comandos (es decir, "C:\MisFicheros\*.XLS"). /T{Fichero(s) Destino} siempre deberá ser distinto a /S{Fichero(s) Fuente}.

Nota adicional: Cualquier tipo de fichero que pueda ser abierto con MS Excel tendrá un formato válido como /S {Fichero(s) Fuente}.

/T{Fichero(s) Destino} es utilizado para especificar dónde se deberán guardar los ficheros ya convertidos. Puede especificarse un fichero único o bien un conjunto de ficheros mediante la sintaxis clásica de la línea de comandos (es decir, "C:\MisFicheros\*.XLS"). /T{Fichero(s) Destino} siempre deberá ser distinto a /S{Fichero(s) Fuente}.

/F# indica a 'Convertir XLS' el tipo de los ficheros fuente (/S{Fichero(s) Fuente}). Este argumento únicamente es obligatorio cuando se usa el método de conversión /M2. Para todas las constantes ver el Ficheros de Tipo de Constantes.

/C# indica a 'Convertir XLS' el tipo de los ficheros destino /T{Fichero(s) Destino}. Para todas las constantes ver el Ficheros de Tipo de Constantes.

[/M#] indica el método de conversión a utilizar (en el caso de querer convertir).  Los valores válidos para este argumento son los siguientes:

1 = MS Excel (Valor por defecto).

2 = 'Convertir XLS'.

          Este argumento no es necesario cuando se utiliza el 'Convertir XLS'.

[/N{"Hoja^Rango^CaracterDelimitador"}] es utilizado únicamente cuando se convierte a/desde un fichero Excel. Sirve para especificar las hojas a convertir, los rangos a convertir, y el carácter delimitador para indicar las separaciones entre las celdas. La sintaxis para este parámetro es crítica, al respecto de los tres elementos separados por el carácter "^". En caso de no incluir la Hoja, Rango o CaracterDelimitador, se incluirán por defecto todas las hojas, todos los rangos, y se usará la coma como carácter delimitador. Además, las comillas dobles deberán delimitar siempre enmarcar este parámetro.

Se usará "*" o "" para indicar todas las hojas. Para concretar algunas en particular se podrán usar sus nombres o bien índices numéricos. En tal caso, se podrán especificar rangos de hojas (es decir, "1,4,10-20" y "4-10,9" etc.). Los parámetros Rango y CaracterDelimitador son opcionales.

Por ejemplo, para especificar las hojas "Manzanas" y "Naranjas", con el Rango "A2:B20" y utilizando el tabulador como separación (su valor decimal en código ASCII es 9) la sintaxis sería la siguiente:

/N"Manzanas,Naranjas^A2:B20^9"

[/G] Salvar ficheros en sus directorios originales. Se utilizará este parámetro en lugar de /T para almacenar los ficheros ya convertidos en la misma carpeta donde estaban los originales. Este parámetro no puede ser utilizado al convertir un único fichero dentro de un directorio. En su lugar deberá utilizarse /T.

[/V] Modo Detalle. Mediante este parámetro se mostrará un cuadro de texto que informará de cómo se ha llevado a cabo la conversión. Ver también /L.

[/R] Buscar y aplicar sobre todos los ficheros hallados en los directorios especificados en el parámetro /S. Deberá utilizarse este parámetro cuando se procesen directorios enteros con ficheros. Ver también /S, /T y /G para obtener más detalles acerca de cómo seleccionar directorios para la conversión.

[/L{FicheroLog}] Ruta y nombre del fichero log - histórico - (p. ej. d:\MisLogs\WCE.LOG). Si este parámetro está informado, se creará un fichero log en la ruta introducida y con el nombre indicado donde serán escritos los resultados de la conversión. Ver también /V.

[/B{FicheroLogDelJob}] Guardar el fichero log como 'Job de Conversión' ÚNICAMENTE CUANDO TENGAN LUGAR ERRORES. Esto resulta útil si los ficheros problemáticos pueden ser procesados en un instante futuro, o mediante otro método. /B es distinto a /L, ya que el fichero generado con /B no incluirá comentarios extraños no permitidos en el fichero de un 'Job de Conversión'. Para que pueda ser cargado como un Job deberá guardarse como un fichero de tipo .SII.

[/U] En caso de convertir un fichero XLS con múltiples hojas seleccionadas, el parámetro /U hará que se generen varios ficheros por cada una de ellas en lugar de uno único.

[/W{ContraseñaParaAbrirFichero(s)Fuente}] Se indicará la contraseña para poder abrir el fichero o los ficheros fuente.

[/X{ContraseñaParaEscribirFichero(s)Fuente}] Se indicará la contraseña para permitir la escritura en el fichero o los ficheros fuente.

[/Y{ContraseñaParaAbrirFichero(s)Destino}] Se indicará la contraseña para poder abrir el fichero o los ficheros destino.

[/Z{ContraseñaParaEscribirFichero(s)Destino}] Se indicará la contraseña para permitir la escritura en el fichero o los ficheros destino.

 

Ver también:
Documentación Web, que incluye ejemplos acerca de cómo usar la línea de comandos.

 

Tipos de ficheros soportados por 'Convertir XLS', los elementos en negrita pueden ser convertidos sin necesidad de tener instalado MS Excel.

Texto, CSV, y HTML (incluyendo otros formatos de bases de datos) son sólo algunos de los muchos formatos para los cuales se puede utilizar este conversor de Excel. ¡Utilice 'Convertir XLS' para convertir ficheros Excel!