Configuración de organización
La configuración de la organización permite sobrescribir configuraciones del usuario o definir un comportamiento especial. Estas configuraciones pueden aplicarse a distintas áreas: a la configuración general de ModPlus o a la configuración de complementos.
La configuración de la organización es un archivo XML con una estructura específica:
donde:
- ModPlus – nodo raíz del archivo XML.
- Node – nodo del área de configuración. En la mayoría de los casos, el nodo lleva el nombre único del complemento. Solo se permiten las áreas descritas más abajo en esta ayuda.
- Property – nodo de propiedad. Solo se permiten las propiedades descritas más abajo en esta ayuda.
- Value – valor de la propiedad. Los valores deben respetar los límites definidos más abajo en esta ayuda.
El archivo de configuración debe incluir únicamente las áreas necesarias. Las configuraciones se aplican solo si el área correspondiente existe y está correctamente definida.
El archivo XML debe guardarse con el nombre orgConfig.mpcf y ubicarse en la carpeta de configuración del usuario: %appdata%\ModPlus Data\UserData (ruta completa: %appdata%\ModPlus Data\UserData\orgConfig.mpcf). El archivo puede ser copiado o actualizado por los administradores de la organización.
El archivo de configuración de la organización es de solo lectura para el software.
Los datos del archivo se leen al momento del acceso (por ejemplo, al iniciar un complemento), lo que permite su actualización sin cerrar el producto compatible (AutoCAD, Revit, etc.).
¡Se pueden agregar nuevas áreas y configuraciones a solicitud!
Plantilla actual del archivo de configuración de la organización – abrir.
Nodos permitidos del archivo de configuración
Para las configuraciones de organización que sobrescriben el archivo de almacenamiento de configuraciones (en las que solo se especifica la propiedad ConfigurationFile), se proporciona un sistema de bloqueo que funciona de la siguiente manera:
1. Un usuario que originalmente tiene acceso para editar el archivo de configuración inicia el complemento
2. El archivo de configuración se bloquea, es decir, otros usuarios no pueden realizar cambios en él
3. Junto al archivo de configuración se crea (si no existe) o actualiza un archivo de texto con el nombre NombreDelComplemento.lock.txt, en el que se guarda el nombre de usuario del sistema de quien bloqueó el archivo
4. Al cerrar el complemento, el archivo de configuración se libera y el nombre del usuario se elimina del archivo de texto
Es decir, el archivo de configuración permanece ocupado por el usuario hasta que el complemento se cierre
Mientras el archivo esté ocupado, otros usuarios que tengan acceso para editarlo verán en el complemento el nombre del usuario que lo tiene ocupado en ese momento
La configuración de organización para el menú permite sobrescribir el menú de la cinta en AutoCAD o Revit, así como interrumpir la carga de ModPlus en AutoCAD, Revit o Renga.
El nodo debe llamarse Menu.
El nodo puede contener las propiedades AutoCAD y/o Revit. En cada propiedad se especifica la ruta al archivo XML que contiene la instrucción para construir el menú.
Si se especifica una ruta a un archivo de menú ubicado en una unidad de red local, la ruta debe especificarse en formato UNC.
Para crear el archivo del menú, utilice el Configurador: en la pestaña "Adaptación", cree el menú y expórtelo a un archivo XML usando el botón correspondiente 
.
¡Importante! No cree ni edite el archivo del menú manualmente – esto puede causar errores al iniciar AutoCAD o Revit.
Si el menú del usuario está sobrescrito mediante la configuración de organización, ese usuario no podrá editar el menú correspondiente en el Configurador.
El nodo puede contener las siguientes propiedades para interrumpir la carga de ModPlus:
| Propiedad | Descripción | Valores permitidos | Valor por defecto |
| LoadInAutoCAD | Controla la carga de ModPlus en AutoCAD. Importante: los comandos incluidos en las bibliotecas de trabajo estarán disponibles a través de la línea de comandos. | True, False | True |
| LoadInRevit | Controla la carga de ModPlus en Revit | True, False | True |
| LoadInRenga | Controla la carga de ModPlus en Renga | True, False | True |
Si falta alguna propiedad o se indica incorrectamente, pero el nodo Menu existe, se utilizarán los valores predeterminados.
Ejemplo de configuración:
Configuración de todos los parámetros del Módulo de actualización.
El nodo debe llamarse AutoUpdater.
El nodo puede contener las siguientes propiedades:
| Propiedad | Descripción | Valores permitidos | Valor predeterminado |
| GetStandardCui | Reconstruir el menú al instalar nuevos complementos | True, False | True |
| ShowProgressDialog | Mostrar diálogo de progreso al descargar e instalar actualizaciones | True, False | True |
| ShowResultDialog | Mostrar diálogo con resultados de actualizaciones o instalación | True, False | True |
| UpdateCheckTime | Intervalo de comprobación de actualizaciones | Entero de 0 a 4 0 – 30 minutos 1 – 1 hora 2 – 2 horas 3 – 4 horas 4 – 8 horas |
3 |
| DoubleMouseClick | Doble clic en el icono de la bandeja | 0 o 1 0 – abrir configuración del módulo 1 – abrir el Configurador |
0 |
| NotShowNotificationsForUnimportantUpdates | No mostrar notificaciones para actualizaciones poco importantes | True, False | True |
| ShowHtmlExceptionMessage | Mostrar contenido de errores HTML | True, False | True |
| AutoInstallNewPlugins | Instalar automáticamente nuevos complementos | True, False | False |
| ShowNews | Controlar la visualización de noticias independientemente de la configuración de notificaciones | True, False | True |
Si falta alguna propiedad o está especificada incorrectamente pero el nodo AutoUpdater existe, se usarán los valores predeterminados.
El Módulo de actualización comprueba cada 30 minutos si las configuraciones de la organización están activadas o desactivadas, lo que permite modificarlas sin reiniciar el módulo.
Ejemplo de configuración:
Resultado:
La configuración del servidor de licencias permite especificar la dirección del Servidor de Licencias LAN o la clave única del Servidor de Licencias Web, así como indicar qué servidor está activo.
El nodo debe llamarse LicenseServer.
La configuración para el Servidor de Licencias LAN consta de tres propiedades:
| Propiedad | Descripción | Valores permitidos |
| IsLocalLicenseServerEnable | Indica si este servidor de licencias está activo | True, False |
| LocalLicenseServerIpAddress | Dirección IP del servidor de licencias | No se valida |
| LocalLicenseServerPort | Puerto del servidor de licencias | Número entero entre 0 y 65535 |
La configuración del Servidor de Licencias Web consta de dos propiedades:
| Propiedad | Descripción | Valores permitidos |
| IsWebLicenseServerEnable | Indica si este servidor de licencias está activo | True, False |
| WebLicenseServerGuid | Clave única del servidor de licencias | Cadena convertible a un GUID |
En el nodo solo es necesario agregar la configuración del servidor de licencias utilizado en la organización.
En el caso del Servidor de Licencias Web, ¡el correo electrónico para la identificación del usuario no se configura mediante los ajustes de la organización!
Ejemplo de configuración del Servidor de Licencias LAN:
Resultado:
Ejemplo de configuración del Servidor de Licencias Web:
Resultado:
Configuración del servicio de guardado automático.
El nodo debe llamarse AutoSaveService.
¡Las configuraciones organizacionales para el servicio de guardado automático se tienen en cuenta al cargar Revit!
El nodo puede contener las siguientes propiedades:
| Propiedad | Descripción | Valores permitidos |
| IsEnabledAutosave | Si el servicio de guardado automático está activo. No afecta al traslado de archivos y carpetas de respaldo | True, False |
| AutosaveDocument | Tipo de documento donde opera el servicio | Project, Family, ProjectAndFamily |
| Interval | Intervalo de guardado automático en minutos | Entero de 5 a 60 |
| RemindIfNotSavedDocument | Notificar si el archivo no está guardado | True, False |
| MoveBackupFiles | Mover archivos de respaldo | True, False |
| BackupsCount | Cantidad de copias de seguridad guardadas | Entero de 1 a 100 |
| MoveBackupFolders | Mover carpetas de respaldo | True, False |
| BackupDirectory | Carpeta para copias de seguridad | Ruta a una carpeta existente en la computadora del usuario |
| CreateBackupDirectory | Crear carpeta para copias de seguridad | True, False |
La propiedad BackupDirectory soporta el uso de variables de entorno de Windows como %appdata%, %homedrive%, %temp%, etc. Si la carpeta indicada en BackupDirectory no existe y la propiedad CreateBackupDirectory tiene valor True, se intentará crear la carpeta. Los errores durante este intento serán ignorados.
Si alguna propiedad no está especificada o es incorrecta, se usarán las configuraciones del usuario.
Ejemplo de configuraciones:
Ejemplo de la pestaña «Guardado automático» en la ventana de configuraciones:
Configuración del servicio de notificaciones de sincronización.
El nodo debe llamarse SyncNotifierService.
Las configuraciones organizativas para el servicio de notificaciones de sincronización se aplican al cargar Revit y también después de cerrar la ventana de configuraciones.
El nodo puede contener las siguientes propiedades:
| Propiedad | Descripción | Valores permitidos |
| GreenNotifierInterval | Intervalo en minutos para las notificaciones de nivel verde | Entero de 5 a 120 |
| OrangeNotifierInterval | Intervalo en minutos para las notificaciones de nivel naranja | Entero de 5 a 120 |
| RedNotifierInterval | Intervalo en minutos para las notificaciones de nivel rojo | Entero de 5 a 120 |
Si cualquiera de las tres propiedades tiene un valor válido (de 5 a 120), se considera que la configuración del servicio de notificaciones de sincronización está establecida por la configuración organizacional.
Ejemplo de configuración:
Ejemplo de la pestaña «Sincronización» en la ventana de configuraciones:
La configuración de la organización para los complementos con configuraciones permite sobrescribir la ruta al archivo de almacenamiento de configuraciones. De forma predeterminada, la configuración personalizada se guarda en la carpeta UserData (%appdata%\ModPlus Data\UserData\) en un archivo XML con el nombre clave del complemento (ver la tabla a continuación).
El nodo debe nombrarse según el nombre clave del complemento:
| Complemento | Nombre clave |
| Revit. Nivel de referencia | mprBaseLevel |
| Revit. Selección por filtro | mprFilterSelection |
| Revit. Tipología de apartamentos | mprApartmentBuildingLayout |
| Revit. Acabado de habitaciones | mprRoomFinishing |
| Revit. Parametrización | mprParametrization |
| Revit. Subproyectos | mprWorksets |
| Revit. Cotas a lo largo de la línea | mprDimByLine |
| Revit. Coloración de elementos | mprColorizer |
| Revit. Conectar elementos | mprJoin |
| Revit. Fases | mprPhases |
El nodo puede contener las siguientes propiedades:
| Propiedad | Descripción | Valores permitidos |
| ConfigurationFile | Ruta al archivo de configuración. No es necesario si se usa la propiedad ConfigurationsFolder | Ruta de archivo en formato UNC |
| ConfigurationsFolder | Ruta a la carpeta que contiene varios archivos de configuración | Ruta de carpeta en formato UNC |
| CanUseUserConfigurationFile | Permite a los usuarios utilizar un archivo de configuración personalizado | True, False |
Si se especifica una ruta a un archivo o carpeta en una unidad de red de la red local, la ruta debe indicarse en formato UNC!
Las propiedades se pueden combinar. Si al usar las propiedades (ConfigurationsFolder o ConfigurationsFolder + ConfigurationFile, o ConfigurationFile + CanUseUserConfigurationFile, o ConfigurationFile + ConfigurationsFolder + CanUseUserConfigurationFile) se obtienen varios archivos de configuración, en el bloque de información aparecerá una lista desplegable para seleccionar el archivo de configuración. Si la propiedad CanUseUserConfigurationFile tiene el valor True, en la lista de archivos se añadirá la opción “Archivo de configuración de usuario”.
Los archivos ubicados en la carpeta indicada en la propiedad ConfigurationsFolder deben contener datos válidos para el complemento. ¡No se realiza verificación de contenido! ¡Los archivos XML incorrectos pueden provocar errores!
Ejemplo de configuración:
Ejemplo de ventana del complemento con esta configuración:
El acceso a los archivos de configuración se puede restringir mediante el servicio Active Directory. Si el usuario no tiene permiso de escritura sobre el archivo de configuración, en la ventana del complemento se mostrará un aviso correspondiente y todas las funciones de edición quedarán deshabilitadas. El archivo de configuración se utilizará solo en modo de lectura.
La configuración de la organización para el complemento Parámetros permite especificar la ruta al almacenamiento de los presets corporativos.
El nodo debe llamarse mprParameters.
La configuración consta de una única propiedad – Storage –, cuyo valor indica la ruta al almacenamiento (directorio donde se guardan los presets). La ruta debe apuntar a un directorio existente.
Si se especifica una ruta a un directorio de configuración ubicado en una unidad de red de la red local, la ruta debe indicarse en formato UNC!
Ejemplo de configuración:
Los presets del almacenamiento corporativo se muestran en color amarillo en la ventana de carga de presets:
Si el usuario tiene permiso para crear archivos en el almacenamiento corporativo de presets, en el cuadro de diálogo de guardado de preset se podrá elegir el almacenamiento de destino:
El acceso al almacenamiento de presets puede restringirse mediante el servicio Active Directory.
Las carpetas anidadas en el almacenamiento, que dividen los presets por tipo de sección, se crean automáticamente por el complemento al guardar presets.
La configuración de la organización para el complemento Exportar planos permite establecer reglas para aplicar marcas de agua al exportar a PDF, así como la máscara de nombre del archivo exportado y la máscara de nombre del archivo combinado.
El nodo debe llamarse mprSheetExport.
La configuración de la máscara de nombre de archivo puede contener las siguientes propiedades:
| Propiedad | Descripción | Valores permitidos |
| FileNameMask | Define la máscara de nombre del archivo exportado | Máscara de nombre según las reglas definidas en la configuración del complemento |
| MergedFileNameMask | Define la máscara de nombre del archivo combinado | Máscara de nombre según las reglas definidas en la configuración del complemento |
Si la propiedad no existe o no tiene valor, se utilizarán los ajustes de la configuración del usuario.
En la máscara de nombre de archivo, el símbolo < debe sustituirse por < y el símbolo > por >!
Ejemplo de configuración más abajo.
La configuración de la marca de agua consta de 4 propiedades obligatorias:
| Propiedad | Descripción | Valores permitidos |
| Watermark | Indica si está activada la adición de marcas de agua | True, False |
| WatermarkText | Contenido de la marca de agua | Cualquiera |
| WatermarkExclude | Ruta a un archivo de texto (.txt) que contiene las excepciones para documentos | Ruta de archivo. Si la ruta apunta a un archivo en la red local, debe estar en formato UNC |
| WatermarkRules | Ruta a un archivo de texto (.txt) que contiene las reglas de colocación de marcas de agua según el nombre del cajetín | Ruta de archivo. Si la ruta apunta a un archivo en la red local, debe estar en formato UNC |
Ejemplo de configuración:
En el archivo de excepciones (propiedad WatermarkExclude) se indican los nombres de los documentos a los que no se debe añadir una marca de agua, incluso si la opción está activada (Watermark = True). Cada valor debe escribirse en una nueva línea del archivo. Se puede indicar solo una parte del nombre. Por ejemplo, si el documento de Revit se llama RAC_basic_sample_project y en el archivo aparece el valor RAC_ o _sample_, no se añadirá marca de agua al exportar a PDF.
En el archivo de reglas (propiedad WatermarkRules) se añaden las reglas de colocación de marcas de agua. Cada regla debe estar en una nueva línea. Si la línea comienza con el símbolo #, el complemento la ignorará. Cada regla consta de 7 propiedades separadas por comas. Los espacios iniciales y finales de cada propiedad son ignorados por el complemento. Las propiedades deben indicarse en el siguiente orden:
| Propiedad | Descripción | Valores permitidos |
| Valor contenido en el nombre del cajetín | Si el nombre completo del cajetín contiene este valor, se aplicará la regla | Se puede usar un asterisco (*). La regla con asterisco se aplicará a todos los planos que no coincidan con ninguna otra regla |
| Margen derecho | Distancia del punto inferior izquierdo de la marca de agua al borde derecho del plano, en milímetros | Números enteros |
| Margen inferior | Distancia del punto inferior izquierdo de la marca de agua al borde inferior del plano, en milímetros | Números enteros |
| Ángulo de rotación | Ángulo de rotación respecto al punto inferior izquierdo de la marca de agua | Entero de 0 a 359 |
| Color | Color de la marca de agua | Valores permitidos (sensibles a mayúsculas): WHITE LIGHT_GRAY GRAY DARK_GRAY BLACK RED ORANGE YELLOW GREEN MAGENTA CYAN BLUE |
| Tamaño del texto | Tamaño del texto de la marca de agua en milímetros | Números enteros mayores que 0 |
| Nombre del archivo de fuente | Nombre del archivo de fuente de la marca de agua (no sensible a mayúsculas) | Nombres de archivos de fuentes existentes en la carpeta Windows/Fonts del equipo. Si no se encuentra la fuente especificada, se usará arial.ttf |
Si ninguna regla del archivo coincide con el nombre del cajetín (o el archivo no tiene reglas), el complemento usará la regla “,185,65,0,RED,5,isocpeur.ttf”.
Ejemplo de archivo de reglas:
