Archivo de importación de Resumen de vacaciones

De un vistazo

Nombre de archivo: VacationSummary-[AAMMDD][HHMM]. xml, Donde [YYMMDD] es la fecha en el formato AAMMDD y [HHMM] es la hora en el formato HHMM.

Tipo de archivo: XML

Los archivos de importación de datos de Resumen de vacaciones permiten importar los elementos de vacaciones o tiempo libre de los agentes a IEX WFM Integrated. Esto es útil si tiene un sistema de terceros, como una base de datos de recursos humanos, del que desea extraer información sobre las vacaciones o días libres personales de los agentes. El uso de archivos de importación de Resumen de vacaciones también puede ayudar a reducir el tiempo de introducción de datos para definir los agentes durante la configuración inicial de un nuevo sistema IEX WFM Integrated.

Datos clave sobre los archivos de datos de importación de Resumen de vacaciones

Los registros del archivo de datos se pueden clasificar en cualquier orden.
Siga las especificaciones generales de XML para el contenido de los archivos y las mejores prácticas de XML.
Cada archivo debe contener los elementos descritos en la Definición de tipo de documento y cumplir con los criterios descritos en esta sección.
Las etiquetas de los elementos distinguen entre mayúsculas y minúsculas.
Los elementos de fecha y hora deben utilizar su zona horaria de IEX WFM Integrated.
La longitud de campo para todos los nombres de entidad y elementos de datos definidos por el usuario es de 64 caracteres, a menos que se indique lo contrario.
Limite los nombres de archivo a 30 caracteres.
El tamaño máximo del archivo es de 5 MB.
Todos los números deben ser enteros. No se admiten valores decimales.
Algunos elementos utilizados en los archivos de importación de datos de Resumen de vacaciones tienen nombres heredados.
Si se producen errores durante el procesamiento del archivo, es posible que los datos no se importen correctamente. Compruebe el formato del archivo antes de ponerse en contacto con su representante de cuenta de IEX WFM Integrated.

Tipos de ingresos

La información sobre los tipos de ingresos no se incluye en los archivos de importación de datos de Resumen de vacaciones. Para tener en cuenta los tipos de ingresos, la importación de datos suma los valores de los ingresos de cada agente para los códigos de actividad que pertenecen al mismo tipo de ingresos. El valor total de los ingresos se almacena como el valor de ingresos del tipo de ingresos.

En Classics, Inc. las vacaciones y el tiempo personal pertenecen al tipo de ingresos de tiempo libre personal. Minnie May Barry tiene actualmente 48 horas de tiempo libre personal. Si el archivo de datos de Resumen de vacaciones incluye 40 horas de Vacaciones y 16 horas de Tiempo Personal para Minnie May, su tiempo de Tiempo libre personal en IEX WFM Integrated será de 56 horas una vez completada la importación.

Para importar información de tiempo libre para cualquier código (incluyendo Lista de espera), el código debe tener asignado un tipos de ingresos. Si un código no tiene un tipo de ingresos, la importación fallará.

Información general de procesamiento

La importación de datos borra el valor existente en la base de datos de IEX WFM Integrated cuando un elemento:

Contiene un valor en blanco.
Se omite en el archivo de importación de Resumen de vacaciones.

Si el archivo de importación Resumen de vacaciones contiene un registro que no tiene un registro correspondiente en la base de datos de IEX WFM Integrated, la importación de datos crea un registro en la base de datos. Agrega al registro los datos contenidos en el archivo de importación, incluido el agente, el grupo de vacaciones, el año de vacaciones y el tipo de vacaciones.

Si el archivo de importación Resumen de vacaciones contiene un registro que ya existe en la base de datos de IEX WFM Integrated, la importación de datos sobrescribe el registro. Si se omite un elemento secundario del elemento vacaciones del archivo de importación, la importación de datos no modifica el registro existente. El elemento vacYear debe ser una regla de tiempo libre con una unidad de cálculo de HH:MM. La importación de datos no admite reglas de tiempo libre con una unidad de cálculo de Días.

Definición del tipo de documento de Resumen de vacaciones

La definición de tipo de documento (DTD) es una plantilla para crear archivos de importación XML. No es necesario crear una DTD en su entorno.

<?xml version="1.0" encoding="UTF-8" ?> <!ELEMENT agentVacationSummary (agentVacation+)>   <!ELEMENT agentVacation (agent, vacation+)>   <!ELEMENT agent (agentID, vacGroup, vacYear)> <!ELEMENT vacation (from?, to?, earned?, credited?, debited?, selected?, taken?, minFullWeeks?, maxPartialHours?, coFrom?, coTo?)>   <!ELEMENT agentID (#PCDATA)> <!ELEMENT vacGroup (#PCDATA)> <!ELEMENT vacYear (#PCDATA)>   <!ELEMENT from (day, month, year)> <!ELEMENT to (day, month, year)> <!ELEMENT earned (#PCDATA)> <!ELEMENT credited (#PCDATA)> <!ELEMENT debited (#PCDATA)> <!ELEMENT selected (#PCDATA)> <!ELEMENT taken (#PCDATA)> <!ELEMENT minFullWeeks (#PCDATA)> <!ELEMENT maxPartialHours (#PCDATA)> <!ELEMENT coFrom (#PCDATA)> <!ELEMENT coTo (#PCDATA)>   <!ELEMENT day (#PCDATA)> <!ELEMENT month (#PCDATA)> <!ELEMENT year (#PCDATA)>   <!ATTLIST vacation type CDATA #REQUIRED> <!ATTLIST agentID acdID CDATA #IMPLIED>

Consideraciones sobre los tipos de elementos DTD

Cuando utilice la definición de tipo de documento (DTD) para crear un archivo, tenga en cuenta estas consideraciones sobre las declaraciones de tipo de elemento:

<!ELEMENT elementName (childElement, childElement, ...)>

Cuando se define un elemento con una lista de elementos secundarios separados por comas, los elementos secundarios deben aparecer en el mismo orden en el archivo de importación. De lo contrario, el elemento no será válido.

<!ELEMENT elementName (#PCDATA)>

Los elementos de tipo #PCDATA pueden contener cualquier cadena de texto. La importación de datos valida el texto según sea necesario.

Calificadores de atributos

La DTD utiliza calificadores de elementos XML estándar:

?-Los elementos con este calificador no son obligatorios. Si los incluye, sólo puede especificarlos una vez por elemento.
*-Los elementos con este calificador no son obligatorios. Puede incluir más de uno para cada elemento.
+-Se requiere al menos uno de los elementos con este calificador. Puede incluir más de uno de cada elemento.
[sin calificador]-Los elementos no marcados con un calificador son obligatorios y solo se pueden especificar una vez por elemento.

Contenido del archivo: Especificaciones de campo

Esta sección incluye todos los elementos para usar en archivos de importación Resumen de vacaciones. Use el DTD de resumen de vacaciones como plantilla para estructurar los datos en su archivo de importación. Si un elemento se puede editar en la interfaz de usuario de IEX WFM Integrated, la columnaDescripciónhace referencia a la pantalla de IEX WFM Integrated en la que se puede editar.

Elemento raíz

El elemento raíz es agentVacationSummary. Este elemento debe contener uno o más elementos secundarios agentVacation.

Elementos secundarios

Los elementos se encuentran indentados según su nivel en la DTD.

Elemento	Elemento secundario o atributo	Descripción	Valores válidos
agentVacation		Contiene toda la información de vacaciones de un solo agente para un grupo de tiempo libre y una regla de tiempo libre. Este elemento contiene un solo elemento secundario agent y uno o más elementos secundarios vacation. Si necesita importar información de un agente para múltiples grupos de tiempo libre o reglas de tiempo libre, use elementos agentVacation separados para cada grupo de tiempo libre o regla para ese agente.
	agente	Debe incluir un agentID, un vacGroup, y un vacYear.
	AgentID	Identificador usado para encontrar el agente para modificar en IEX WFM Integrated. El valor que se usa determina los requisitos de la información que rellena el elemento agentID. El valor predeterminado es T. Puede editarse en pantalla: Definición de agente.	Valor S: 64 caracteres alfanuméricos Valor T: 1-999999999 Valor A: Cualquier carácter ASCII imprimible excepto \| & y \. La longitud máxima es 64. Valor E: Cualquier carácter ASCII imprimible excepto \| & y \. La longitud máxima es 256.
	acdID	Atributo de agentID. La importación de datos hace coincidir agentID con el agente en IEX WFM Integrated que está asignado a acdID especificado en la fecha actual (en función de la zona horaria de IEX WFM Integrated). Puede editarse en pantalla: Definición de agente.	1-2147483647
vacGroup		ID del Grupo de tiempo libre del agente. Debe existir un registro para el agente en AgentMap cuyo campo vac_group_id coincida con este ID. Puede editarse en pantalla: Definición de agente.	1-2147483647
vacYear		Nombre del año de tiempo libre para el que se va a importar la información de resumen del agente. Debe existir un registro en VacYear cuyo vac_group_id coincida con el ID en el elemento vacGroup y cuyo campo vac_year_name coincide con la cadena en el elemento vacYear. El ID del año de vacaciones no se especificará en el archivo de importación. Debe ser una regla de tiempo libre con una unidad de cálculo de HH:MM. La importación de datos no admite reglas de tiempo libre con una unidad de cálculo de Días. Puede editarse en pantalla: Reglas de tiempo libre.	Cualquier cadena. Se debe definir una regla de tiempo libre con este nombre para el Grupo de tiempo libre
vacation		Contiene toda la información de vacaciones del agente para vacGroup y vacYear especificados. Este elemento tendrá un atributo type para indicar el tipo de vacaciones que se están importando, así como los siguientes elementos secundarios opcionales: from, to, earned, debited,credited, selected, taken, minFullWeeks, maxPartialHours, coFrom y coTo.
	type	Atributo del elemento vacation. Descripción del código de actividad para el que se añadirá o actualizará el registro VacSummary. Si esta cadena es Lista de espera, el registro VacSummary con el código -1 se actualizará o añadirá. De lo contrario, debe existir un registro en la tabla Excepto cuya Descripción coincida con esta cadena (se distingue entre mayúsculas y minúsculas) y debe existir un registro en VacType para vacGroup y vacYear especificados para este código de actividad. Puede editarse en pantalla: Reglas de tiempo libre.	Cualquier carácter ASCII imprimible excepto \| y \. Distingue entre mayúsculas y minúsculas
	de	La fecha más temprana para la que el agente puede hacer solicitudes para este tipo de vacaciones. Debe ser una fecha válida, usando los elementos secundarios day, month, y year. Debe estar comprendida entre las fechas de inicio y fin del año de vacaciones y debe ser igual o anterior a la fecha to especificada (o a la fecha toDate del registro existente si se excluye el elemento to). Esta fecha se almacenará en el campo fromDate en VacSummary. Puede editarse en pantalla: Resumen de tiempo libre del agente.
	día	Día del elemento from.	1-31
	month	Mes del elemento from.	1-12
	year	Año del elemento from.	Cualquier año
	Para	La fecha límite para la que el agente puede hacer solicitudes para este tipo de vacaciones. Debe ser una fecha válida, usando los elementos secundarios day, month, y year. Debe estar comprendida entre las fechas de inicio y fin del año de vacaciones y debe ser igual o posterior a la fecha from especificada (o a la fecha fromDate del registro existente si se excluye el elemento to). Esta fecha se almacenará en el campo toDate en VacSummary. Puede editarse en pantalla: Resumen de tiempo libre del agente
	día	Día del elemento to.	1-31
	month	Mes del elemento to.	1-12
	year	Año del elemento to.	Cualquier año
	obtenido	Cantidad de tiempo, en minutos, que el agente ha acumulado para el tipo de vacaciones en el año de vacaciones. Este valor se almacenará en el campo Obtenido en VacSummary. Puede editarse en pantalla: Resumen de tiempo libre del agente	0-479520 (999 días de 8 horas)
	credited	Cantidad de tiempo acreditado, en minutos para el tipo de vacaciones. Este valor se almacenará en el campo acreditado en VacSummary. El tiempo acreditado se añade al tiempo acumulado del agente en el Gestor de tiempo libre. Puede editarse en pantalla: Resumen de tiempo libre del agente	0-479520 (999 días de 8 horas)
	debited	Cantidad de tiempo debitado, en minutos para el tipo de vacaciones. Este valor se almacenará en el campo previouslyUsed en VacSummary. El tiempo debitado se cuenta como tiempo tomado en el Gestor de tiempo libre. Puede editarse en pantalla: Resumen de tiempo libre del agente	0-479520 (999 días de 8 horas)
	seleccionado	No se importó. Se basa en actividades futuras ingresadas en IEX WFM Integrated.
	tomado	No se importó. Se basa en programaciones en IEX WFM Integrated.
	minFullWeeks	Número mínimo de semanas que el agente debe tomar en incrementos de semanas completas. Puede editarse en pantalla: Resumen de tiempo libre del agente	0-78
	maxPartialHours	Cantidad máxima de tiempo que el agente puede tomar en incrementos de días parciales. Si se permite a los agentes tomar todo su tiempo libre en incrementos de días parciales, este valor debe ser el mismo que el valor earned. Puede editarse en pantalla: Resumen de tiempo libre del agente	Debe ser menor o igual al valor earned del registro.
	coFrom	Cantidad de tiempo, en minutos, que el agente transfirió desde el año anterior para el tipo de vacaciones. Este valor se almacenará en el campo coFromLastYr en VacSummary. Puede editarse en pantalla: Resumen de tiempo libre del agente	0-479520 (999 días de 8 horas)
	coTo	Cantidad de tiempo, en minutos, que el agente transfirió al año próximo para el tipo de vacaciones. Este valor se almacenará en el campo coToNextYr en VacSummary. Puede editarse en pantalla: Resumen de tiempo libre del agente	0-479520 (999 días de 8 horas)

Ejemplo de archivo de importación

<?xml version="1.0" encoding="UTF-8" ?> <agentVacationSummary> <agentVacation> <agent> <agentID>270</agentID> <vacGroup>10</vacGroup> <vacYear>2007</vacYear> </agent> <vacation type=”PTO”> <earned>2400</earned> </vacation> <vacation type=”Personal Time”> <earned>960</earned> </vacation> <vacation type=”Wait List”> <earned>2400</earned> </vacation> </agentVacation> <agentVacation> <agent> <agentID>275</agentID> <vacGroup>10</vacGroup> <vacYear>2007</vacYear> </agent> <vacation type=”PTO”> <from> <day>1</day> <month>1</month> <year>2007</year> </from> <to> day>29</day> <month>3</month><year>2008</year> </to> <earned>2400</earned> <credited>480</credited> <debited>0</debited> <coFrom>1440</coFrom> <coTo>0</coTo> </vacation> <vacation type=”Personal Time”> <from> <day>1</day> <month>1</month>< year>2007</year> </from> <to> <day>29</day> <month>3</month> <year>2008</year> </to> <earned>0</earned> <credited>0</credited> <debited>0</debited> <coFrom>0</coFrom> <coTo>0</coTo> </vacation> <vacation type=”Wait List”> <from> <day>1</day> <month>1</month> <year>2007</year> </from> <to> <day>29</day> <month>3</month> <year>2008</year> </to> <earned>3360</earned> <credited>0</credited> <debited>0</debited> <coFrom>0</coFrom> <coTo>0</coTo> </vacation> </agentVacation> </agentVacationSummary>