Importación de incidencias

Las incidencias asociadas a una persona empleada se pueden importar en WorkPlanner de forma independiente a los datos básicos de la propia ficha del empleado o empleada. Para su carga de forma masiva, se puede realizar vía Excel o bien mediante fichero XML.

Importación de incidencias desde Excel

La importación de incidencias vía Excel, se realiza siguiendo el procedimiento estándar (ver Importación vía Excel).

Es posible realizar la importación de incidencias desde Excel siguiendo diferentes formatos. Es imprescindible proporcionar en el documento una columna que sirva para identificar a la persona empleada a modificar. Esta columna puede ser Name (clave estándar), ID (clave por identificador), ExtCode (clave por código externo) o bien Description (clave por descripción). Además, se necesitará especificar en cada fila la incidencia que deseamos importar. Para ello utilizaremos uno de los siguientes formatos:

Formato 1

Name	Period	Attribute-Date	Attribute-IdType
0001225	07-18	2013-03-29T00:00:00	127
0001225	00-24	2013-03-25T00:00:00	122

Formato 2

Name	Period	Attribute-StartD	Attribute-EndD	Attribute-IdType
0001225		2013-03-29T09:00:00	2013-03-29T17:00:00	127
0001225		2013-03-25T08:00:00	2013-03-25T12:00:00	122
0001225	00-24	2013-03-25T00:00:00	2013-03-31T00:00:00	122

Importación de incidencias mediante fichero XML

Descripción de campos

• Name (clave): Nombre identificador de la persona empleada
• IncidenceList: Contiene la lista de incidencias a actualizar de la persona empleada.
• dateFormat (atributo): este atributo, cuando está presente indica que las fechas de definición de la incidencia serán en formato ISO, indicando el inicio y fin de la misma (StartD, EndD, StartT, EndT)
• TTimePeriod: Define el periodo de la incidencia y sus propiedades:
  • Quantity: siempre es 1
  • PeriodType: siempre es 2 para periodos de tipo incidencia
  • IdType: referencia el ID interno de la incidencia según este definida en WorkPlanner
  • StartD: la fecha de inicio de la incidencia en formato ISO
  • EndD: la fecha de fin
  • StartT: cuando la incidencia está definida como “de horas”, indica la hora y minuto de inicio en formato HHMM o bien HH:MM.
  • EndT: cuando la incidencia está definida como “de horas”, indica la hora y minuto de fin en formato HHMM o bien HH:MM. En caso de incidencia en horas que afecte a más de un día, se aplicará dicha incidencia sobre todo el rango de días indicado entre las horas proporcionadas.

Ejemplo en formato XML en donde se permite configurar qué incidencias actualmente en WP serán sobreescritas totalmente por la información proporcionada en el documento:

<?xml version="1.0" encoding="ISO-8859-1"?>
<IntContainerVector>
  <UpdateFields UpdateOnly="1" COLNAME0="IncidenceList" />
  <CustomParams UseExtCodeAsKeyField="1">
    <IncidenceList Start="2012-10-01T00:00:00" End="2100-01-02T00:00:00">
      <Incidence Nombre="EX" IdType="30" />
      <Incidence Nombre="EV" IdType="47" />
      <Incidence Nombre="IT" IdType="50" ITEndException="1"/>
    </IncidenceList>
  </CustomParams>
  <Worker>
    <ExtCode value="test01" />
    <IncidenceList dateFormat="1">
      <TTimePeriod StartD="2012-10-24T00:00:00" EndD="2012-10-26T00:00:00" PeriodType="2" Quantity="1" IdType="47" />
      <TTimePeriod StartD="2012-10-24T00:00:00" EndD="2012-10-24T00:00:00" StartT="1022" EndT="1222" PeriodType="2" Quantity="1" IdType="47" />
    </IncidenceList>
  </Worker>
</IntContainerVector>

En el documento de importación anterior, se está indicando lo siguiente:

• La identificación de qué objeto Worker del sistema se va a actualizar vendrá indicada por el valor del campo ExtCode (UseExtCodeAsKeyField=1). Por defecto la identificación se realiza por el campo Name.
• Sólo se van a actualizar las incidencias de los objetos Worker que se identifiquen. En caso contrario no se hará nada (no se crearán los Worker). Concretamente, sólo se va a actualizar el campo IncidenceList del mismo.

Otras consideraciones:

• Se indica que el intervalo de tratamiento se va a restringir a aquellas incidencias que se reportan dentro del documento entre las fechas Start y End: 01/10/2012 y 02/01/2100 (esta fecha representa indefinido en BOLD). Las incidencias que incluya el documento fuera de este intervalo se van a ignorar.
• El proceso de importación tratará de forma “especial” las incidencias con códigos EX, EV y IT en los nodos Incidence , ya que considerará que la información respecto de estos códigos es total respecto del intervalo de importación para estas incidencias. Por tanto, el proceso va a eliminar del empleado o empleada todas las incidencias de este tipo antes de empezar y únicamente lo actualizará con la información del documento de entrada.
• El atributo ITEndException asociado con la incidencia de código IT indica que en caso de solapamiento o conflicto entre los datos sobre incidencias con este código presentes en el documento de importación y los datos en BOLD, se respetarán los datos en BOLD y tan solo se indicará un aviso. Por ejemplo: si en BOLD aparece una incidencia IT en el intervalo de sincronización y no aparece en el documento de importación no se eliminará. Si en el documento XML aparece una incidencia IT que solapa con otra ya existente en BOLD se dará un aviso sin modificar la de BOLD.
• Atributo KeepWPData (en nodos CustomParams): si vale 1 indica que, en caso de solapes, se deben conservar siempre los datos que tenga en BOLD. La única excepción es si el código de incidencia es el mismo y la fecha de inicio también. En este caso se cambiará la fecha de fin que exista en WorkPlanner por la que venga indicada en el documento que se está importando.

Versión cliente Windows

Para realizar la importación de estos documentos, desde el cliente Windows, debemos ir al menú Integración > Importar incidencias de empleados

Was this article helpful?

0 out Of 5 Stars

5 Estrellas		0%
4 Estrellas		0%
3 Estrellas		0%
2 Estrellas		0%
1 Estrellas		0%

5 Enviar

How can we improve this article?

How Can We Improve This Article?

Submit