/DumpConfigToFiles <directorio de volcado> [-Extension <nombre de extensión>]
[-AllExtensions] [-formato] [-actualizar][-forzar][-obtenerCambios <nombre de archivo>]
[-configDumpInfoForChanges <nombre de archivo>][-configDumpInfoOnly]
[-Servidor][-Archivo <nombre de archivo>]
[-listFile <nombre de archivo>][-ignorarReferenciasNoResueltas]
Realiza un volcado de una configuración a archivos XML. Al exportar una configuración, se crea un archivo de versión (ConfigDumpInfo.xml). Los siguientes parámetros están disponibles:
<directorio de volcado>. Un directorio al que se volcará la configuración.
-Extension <nombre de extensión>. Exporta una extensión con el nombre especificado. Si la extensión se procesa correctamente, se devuelve 0. De lo contrario (si la extensión con el nombre especificado no existe o se produce un error), se devuelve 1.
-AllExtensions. Exporta solo extensiones (todas). Se creará un directorio con el nombre de la extensión para cada extensión. Puede usarse con el parámetro archivo <nombre de archivo>.
-Formato. Un formato de exportación de archivos. Por defecto, los archivos se exportan en formato jerárquico:
Jerárquico. Exporta archivos en formato jerárquico. Se crea una estructura de directorios en el directorio especificado que coincide con la estructura de objetos de configuración.
Plano. Exporta archivos en formato plano. Todos los archivos se exportarán al mismo directorio.
IMPORTANTE! El formato de exportación plano está obsoleto. Se recomienda utilizar el formato jerárquico para la exportación.
-actualizar. Actualiza la exportación (exporta solo archivos cuya versión difiere de la exportada anteriormente).
El archivo de versión (ConfigDumpInfo.xml) se recibirá del directorio de volcado actual. Si la versión actual del formato de exportación no coincide con una versión de formato en el archivo de versión o no se encuentra el archivo de versión, se generará un error. Después de completar la exportación, se actualiza el archivo de versión.
Puede usar este parámetro junto con los siguientes parámetros:-forzar . Si la versión actual del formato de exportación no coincide con la del archivo de versión, los archivos se exportarán por completo.
–configDumpInfoForChanges. Si el directorio de exportación actual no está vacío antes de que se inicie la exportación, se generará un error. La aplicación no verifica si la versión actual del formato de exportación y la del archivo de versión coinciden. Se genera un nuevo archivo de versión durante la exportación. El archivo especificado en el parámetro –configDumpInfoForChanges no cambia.-forzar. Se exportan completamente los archivos si un intento de actualización de exportación revela que la versión actual del formato de exportación no coincide con la especificada en el archivo ConfigDumpInfo.xml. Puede usarse con los parámetros -actualizar y -archivo <nombre de archivo>. En todos los demás casos, se ignora. Puede usarse con el parámetro archivo <nombre de archivo>.
-obtenerCambios <nombre de archivo>. Un archivo al que la aplicación escribirá los cambios actuales de configuración en comparación con la exportación cuyo directorio se especifica antes de este parámetro. Los cambios se calculan en relación con el archivo de versión en el directorio de volcado actual. Debe especificarse el nombre del archivo.
Nota. Este parámetro puede usarse junto con el parámetro configDumpInfoForChanges. Los cambios se calcularán en relación con el archivo de versión pasado. Si se utiliza el parámetro configDumpInfoForChanges y no se encuentra el archivo de versión, se generará un error.-configDumpInfoForChanges <nombre de archivo de versión>. Un archivo de versión que se utilizará para comparar cambios. Debe especificarse el nombre del archivo de versión.
Nota. Este parámetro solo se puede usar con los parámetros -actualizar y -obtenerCambios.-configDumpInfoOnly. Si se especifica el parámetro, solo se exportará el archivo de estado de configuración ConfigDumpInfo.xml. Se utiliza solo con el parámetro -formato. En este caso, se genera el archivo ConfigDumpInfo.xml para el formato respectivo. Si no se especifica el formato, se utilizará el formato jerárquico de forma predeterminada.
Puede usarse con el parámetro archivo <nombre de archivo>.-Servidor. Volcado multihilo en el servidor 1C:Enterprise. Puede usarse con los siguientes parámetros:
-JobsCount N. Número de trabajos en segundo plano al volcar una configuración a archivos. Número predeterminado: 0. La plataforma define automáticamente el número en función del número de núcleos del procesador en el servidor 1C:Enterprise.
Ejemplo:
1cv8.exe DESIGNER /S "localhost/BaseName" /DumpConfigToFiles c:/xml -Server -JobsCount 5-Archivo <nombre de archivo>. Si se especifica (se requiere un nombre de archivo), el volcado resultará en un archivo ZIP que contiene archivos XML de la configuración. Puede usarse durante un volcado de un solo hilo y multihilo (usando el parámetro -Servidor). El parámetro se puede usar en los siguientes modos:
- volcado completo (-forzar)
- volcado parcial (-listFile <nombre del archivo con la lista de objetos a exportar>)
- exportar solo el archivo de estado de configuración actual (-configDumpInfoOnly)
- exportar solo un archivo de (todas) las extensiones (-AllExtensions)
Ejemplos:
1cv8.exe DESIGNER /DisableStartupDialogs /F “e:\base\demo” /N Administrator /DumpConfigToFiles “d:\demo” -archivo dumpinfo.zip -configDumpInfoOnly
1cv8.exe DESIGNER /S “localhost/BaseName” /DumpConfigToFiles c:/xml -Server -Archivo configfiles.zip
-listFile <nombre del archivo con la lista de objetos a exportar>. Un archivo que contiene la lista de objetos de metadatos y/o propiedades externas que se exportarán independientemente de si han cambiado o no. Debe especificarse el nombre del archivo.
Los objetos de la lista se exportarán con todas las propiedades externas, excluyendo los objetos subordinados que son objetos de desarrollo separados. Para exportar dichos objetos subordinados, especifíquelos en la lista de manera distinta:
- Configuration. Si este alias no va seguido del nombre del objeto de configuración raíz, apuntará al nombre completo del objeto de configuración raíz durante la exportación. Esto significa que Configuration.Help es equivalente a Configuration.ConfigurationName.Help.
- Puede usar nombres tanto con la palabra “Configuration” como con el nombre completo del objeto de configuración raíz. Al exportar dos propiedades externas del objeto de configuración raíz (por ejemplo, Help y Splash) al formato XML, el contenido del archivo puede verse de la siguiente manera:
Configuration.Help
Configuration.ConfigurationName.Splash
Si un objeto de la lista tiene objetos subordinados que no son objetos de desarrollo separados pero tienen propiedades externas, estas propiedades externas también se exportan.
Nota. Puede usarse con el parámetro -archivo <nombre de archivo>.-ignorarReferenciasNoResueltas. Al volcar una configuración, no se exportan las referencias a objetos inaccesibles, que se eliminaron en una de las versiones anteriores de la configuración.
Cuando se volca una configuración ignorando las referencias a objetos inaccesibles, ocurre lo siguiente:
- Las referencias inaccesibles a comandos en formularios gestionados se reemplazan por la referencia predeterminada.
- No se exportan las referencias inaccesibles a grupos de comandos en formularios gestionados.
- No se exportan las rutas inaccesibles a datos de formulario.
- No se exportan las referencias inaccesibles a elementos predefinidos.
- No se exportan las referencias inaccesibles en filtros por referencias de objetos de metadatos.
- No se exportan las referencias inaccesibles en filtros por tipo de objeto de metadatos.
- No se exportan las referencias inaccesibles a comandos en la interfaz de comandos del subsistema.
- Las referencias inaccesibles a grupos de comandos en la interfaz de comandos del subsistema se reemplazan por NavigationPanelOrdinary.
Si se borra por completo la interfaz de comandos del subsistema, la importación posterior de dicho archivo XML a la configuración borrará la propiedad externa en el respectivo objeto de metadatos. Por lo tanto, cuando exporte a XML la próxima vez, faltará el archivo de propiedad externa.
El resultado de comparar la configuración de origen y la configuración cargada desde archivos XML puede contener cambios en los objetos de configuración. El resultado puede no contener detalles de cambios. Estas configuraciones se exportan con la casilla de verificación seleccionada para ignorar las referencias a objetos inaccesibles.


