Ayuda sobre productos BOLD:
Importación vía Excel
Para importar datos a BOLD vía Excel, clicar en el menú Utilidades y seleccionar la opción Importar datos por Excel.
A partir del formulario generado, seleccionar el tipo de datos que se quieren cargar mediante el selector de Importación de documentos,
y, a continuación, clicar en Descargar plantilla para obtener el Excel de carga en donde se cumplimentarán los datos a importar a BOLD en la pestaña correspondiente.
Una vez guardado el Excel cumplimentado, clicar en Seleccionar archivo para proceder a su subida al formulario. Automáticamente en el apartado Documento se visualizarán los datos del Excel, como se muestra en el siguiente ejemplo:
Para realizar una simulación de la carga de datos, se debe clicar en , mientras que si se está segura de la correcta importación de datos entonces, directamente, debe clicar en .
Finalmente, en el apartado Resultados se puede comprobar el estado de la importación.
Identificar objeto a actualizar
En el caso que el dato a cargar o actualizar no estuviera en la plantilla Excel se debe tener en cuenta que el formato de este fichero es básico para su funcionamiento , siendo fundamentales los nombres de las columnas a importar y el tipo de datos que contiene.
Para propiedades de tipo numérico o cadena de texto, el nombre de la columna ha de ser el correspondiente al nombre interno de la clase de objeto que se está tratando de importar. Por ejemplo, la propiedad «Nombre completo» de la persona empleada debe importarse mediante una columna en el excel que se llame FullName. La lista de clases y sus propiedades se pueden consultar en el artículo listado de clases y atributos.
Para que el sistema detecte sobre qué objeto se desea aplicar la importación de Excel (en caso de que éste no sea un nuevo objeto) es necesario proporcionar una columna clave. Las columnas que se pueden utilizar como clave son: identificador interno (ID), código (Name), descripción (Description) y código externo (ExtCode).
El formulario de importación a través del excel, permite escoger el tipo de identificación que se desea utilizar.
Sufijos y nombres especiales para las columnas
– Propiedades con valor y unidad
Los atributos que sean de tipo propiedad «boldProperty» necesitan la columna con el valor correspondiente, más otra columna indicando el nombre de la unidad en la que se expresa ese valor. Esta columna adicional ha de tener el mismo nombre que la propiedad añadiendo el sufijo _U.
Ejemplo: Si deseamos importar el atributo Coste del objeto contrato, necesitaremos dos columnas para este atributo: Cost donde indicaremos el valor de coste para cada contrato y Cost_U donde pondremos el valor eur para indicar que la propiedad está en euros. En el siguiente artículo podemos encontrar el identificador de cada tipo de propiedad tipos de propiedades.
– Propiedades de tipo RefObj (referencias a otros objetos)
Para asignar valores de tipo referencia, se puede utilizar el valor numérico correspondiente con el ID del objeto referenciado. También mediante el nombre correspondiente con el código y añadiendo el sufijo _Ref al nombre de la columna en el Excel. O, también mediante el nombre correspondiente al Código externo y añadiendo el sufijo _Ext al nombre de la columna en el Excel
– Propiedades de tipo enumerado
Para asignar valores de tipo enumerado, se puede utilizar su valor numérico, en cuyo caso no es necesario añadir ningún sufijo especial al nombre de la columna en el excel. También se puede hacer referencia a los valores mediante el nombre del enumerado correspondiente. Si se desea utilizar este tipo de importación, el nombre de la columna ha de contener el sufijo _Enum .
– Propiedades de tipo color
Para asignar valores de tipo color TColor se tiene que convertir del formato RGB a decimal. Ejemplo: el funcionamiento es, si R=67, G=A2 y B=12 todos en hexadecimal, construyes el número hexadecimal: 12A267. Utilizando la calculadora lo conviertes a decimal y el valor obtenido es el que hay que importar.
– Propiedades especiales
Algunos tipos de propiedades, no figuran en el artículo listado de clases y atributos, pues son parametrizables y diferentes en cada instalación. Estas propiedades pueden ser:
- Propiedades automáticas de sistema: El nombre de la columna ha de ser el nombre interno del atributo, precedido por SystemProps__. Ejemplo: SystemProps__FechaAlta
- En caso de propiedades anidadas bajo un Nodo, hay que separar la propiedad del Nodo mediante un punto. Ejemplo para contratos con varias necesidades preferentes con un ciclo asociado a cada una de ellas sería: SystemProps__SpecialScheduleByPreferentNeed.ScheduleRefByPrefNeed_Ref SystemProps__SpecialScheduleByPreferentNeed.ScheduleRefByPrefNeed2_Ref
Nota: para importar SystemProps tipo double negativas el formato de la celda Excel ha de ser de tipo texto y el valor ha de estar en el formato 99.99, con un punto para separar los decimales.
- Propiedades automáticas personalizadas: El nombre de la columna ha de ser el nombre interno del atributo, precedido por CustomProps__. Ejemplo: CustomProps__FechaAlta
- Custom Properties (CP). Para importar CustomProperties, el nombre de la columna a importar será CustomProperties y en cada fila escribiremos una expresión del tipo:<CustomProperties><PropBoolean KeyName=»ControlExterno»>0</PropBoolean></CustomProperties> donde el nombre de la propiedad a importar sería ControlExterno y el valor en este caso sería 0. Podemos importar más de una CP a la vez sólo hay que tener precaución de marcar en el cuadro de diálogo de importación la opción de No borrar propiedades porque con cada carga se borrarían las anteriores.
– Importación de Formularios de permisos
Para importar formularios de permisos además del código/nombre o ID hay que indicarle los siguientes campos, SubClassType (5), LinkedClass (39), CustomProps__CaseID, CustomProps__SubType (0)
– Propiedades especiales de contratos y necesidades
Las propiedades del contrato ciclo y ciclo de guardia (CYCLEREF e Id_DutySeqSchedule respectivamente) pueden definirse de forma directa con la definición del ciclo horario correspondiente utilizando las propiedades: CycleCompactDef y DutyCycleCompactDef respectivamente. Esta utilidad te permite definir ciclos horarios directamente sin necesidad de cargar previamente su definición con una importación de horarios semana.
El Excel de ejemplo , sería el siguiente:
Name | CycleCompactDef | ScheduleCycleType | StartPositionCycle | DutyCycleCompactDef | StartPositionDutyCycle |
000001_2014-01-01 | LXV 10-22 # MJS 22-10 # L-J 8-14:30;16-18 V 8-15 | 1 | 2 | D 8-22 ### | 3 |
000002_2016-04-22 | LXV 14-22 # # L-J 8-14:30;16-18 V 8-15 | 1 | 1 | 0 |
El primer registro asociaría como ciclo ordinario un ciclo de tres semanas donde la primera trabajaría los lunes, miércoles y viernes de 10 a 22, la segunda los martes, jueves y sábado de 22 a 10 y la tercera de lunes a jueves de 8 a 14:30 y de 16 a 18 y los viernes de 8 a 15. Por otra parte el ciclo de guardia sería de 4 semanas, donde la primera indicaría que se trabaja el domingo de 8 a 22 y las tres semanas siguientes serían nulas. Recordar que es necesario incluir (si el contrato es nuevo o en las versiones anteriores no se había indicado ya) el parámetro de ScheduleCycleType.
Para aquellos casos en los que se ha definido ciclo de asignación por necesidad, también es factible asignar esos ciclos a través de una definición compacta. Los nombres de las propiedades de estos ciclos son los siguientes: FirstNeedCycleCompactDef, SecondNeedCycleCompactDef, ThirdNeedCycleCompactDef,DutyNeedCycleCompactDef
Versión cliente Windows
Desde el menú Integración, visible en la pantalla principal, se pueden importar datos en WorkPlanner desde un fichero Excel.