Archivo de importación Cambios de programación

De un vistazo

Nombre de archivo: ScheduleChanges-[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 datos de importación de Cambios de programación permiten actualizar las programaciones de los agentes en IEX WFM Integrated. También puede agregar o sobrescribir una programación existente, crear o eliminar registros de Actividad futura o eliminar registros de Evento de programación. Los cambios de programación pueden provenir de un sistema IVR, un navegador web, una plataforma de terceros, etc.

Datos clave sobre los archivos de datos de importación de cambios de programación

Use la Definición de tipo de documento de cambios de programación y siga las prácticas recomendadas estándar para XML.
Actualice las programaciones de agente agregando un Códigos de actividad para la fecha y hora especificadas.
Los elementos de fecha y hora deben usar la zona horaria de la unidad de administración, MU, del agente.
Algunos elementos usados en los archivos de importación de Cambios de programación 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.
Los nombres de archivo deben tener 30 caracteres o menos.
StopTime puede ser anterior a StartTime. Esto ocurre cuando el período de tiempo pasa la medianoche. El período de tiempo desde medianoche hasta StopTime se aplica a la programación indicada por [StartTime].

Anne Shirley, agente de Classics Inc, trabaja desde las 20:00 del miércoles hasta las 6:00 del jueves. Existe un registro para ella con un período de tiempo de 01:00 - 03:00 del jueves. Aunque la franja horaria de 01:00 - 03:00 se produjo el jueves, se aplica a la programación con la fecha del miércoles.

Jane Andrews no estaba programada para trabajar el lunes. Estaba programada para el martes desde las 3:00 hasta las 12:00. Jane aceptó cubrir parte del turno de Gilbert Blythe, por lo que llegó temprano y trabajó desde las 23:00 del lunes hasta las 05:00 del martes, cuando se desconectó para tomar un descanso. Esto significa que tiene un registro con la fecha del lunes para el período de tiempo de 23:00 a 05:00. Este registro no se procesará. La fecha del registro es el lunes, por lo que este período de tiempo sólo se aplicaría a una programación de lunes. Dado que Jane no estaba programada para el lunes, no hay ningún registro del lunes al que se pueda aplicar este rango.

Mapeo de códigos de actividad

Debe asignar un evento de programación en un archivo de datos de cambios de programación a un atributo de código de actividad en IEX WFM Integrated. Esto permite que la importación de datos aplique los evento de programación al código de actividad correcto en IEX WFM Integrated.

Defina un atributo de código de actividad en IEX WFM Integrated.
1. En Administrador, haga clic en Atributos de código de actividad.
2. Cree un Atributo de código de actividad para cada partición de cliente en cada servidor IEX WFM Integrated. Puede nombrar el atributo de código de actividad SchedExImport o puede usar un nombre personalizado.
3. Para cada evento de planificación incluido en el archivo de importación, agregue Valor de atributo al Atributo de código de actividad que creó. Por ejemplo, si el archivo de importación tiene eventos programados que son capacitaciones, reuniones y vacaciones, agregaría valores de Capacitación, Reunión, y Vacaciones. No asigne un valor para el código de actividad No programado.
Asigne valores de atributo a los códigos de actividad en IEX WFM Integrated.
1. En Administrador, haga clic en Asignación de atributo.
2. Seleccione un Código de actividad para cada valor de atributo que haya definido.

Tipo de actividad

IEX WFM Integrated determina qué icono mostrar para una actividad futura importada en función del tipo de actividad. Determina el tipo de actividad de la siguiente manera:

Día parcial: Si se suministran starttime y endtime y el campo o elemento otcreatesched se omite.
Inicio de programación de día parcial: Si se suministra endtime y no se suministra starttime.
Fin de programación de día parcial: Si se suministra starttime y no se suministra endtime .
Todo el día: Si no se suministra starttime ni endtime.
OT día parcial: Si se suministran starttime y endtime y el campo otcreatesched está presente.
OT antes de programación: No compatible.
OT después de programación: No compatible.

Información general de procesamiento

Horas de inicio y fin

StartTime y EndTime son opcionales.

Si se omite StartTime, la actividad se aplica desde el inicio de la programación hasta EndTime suministrada.
Si se omite EndTime la actividad se aplica desde la StartTime indicada hasta el final de la programación.
Si se omiten StartTime y EndTime la excepción se aplica a toda la programación para la Fecha indicada. Las prioridades del Código de actividad se siguen respetando.

Cuando las horas de inicio o finalización del registro importado quedan parcialmente fuera del periodo de tiempo de inicio y finalización programadas del agente, sólo se procesa la parte del registro que se solapa con la hora programada existente.

Diana Barry está programada de 8:00 de la mañana a 5:00 de la tarde, y el registro importado indica un periodo de tiempo de 7:00 a 10:00. Sólo se importa la parte que se solapa con la hora programada existente (en este caso, de 8:00 a 10:00).

Cuando las horas de inicio o parada en el registro importado caen completamente fuera del rango de horas de inicio y parada programadas del agente, el registro no se procesa.

IEX WFM Integrated usa la presencia o ausencia de horas de inicio y parada para determinar cada tipo de actividad del registro.

Prioridades de los códigos de actividad

La importación de datos respeta las prioridades de los códigos de actividad. Sobrescribe las actividades de igual o menor prioridad, pero no las de mayor prioridad. Este procesamiento difiere del método de procesamiento Aplicar actividades futuras. Este método se revierte a un ID interno como criterio de desempate cuando se intenta sobrescribir una actividad con otra de igual prioridad.

Se aplicarán los registros parciales. Por ejemplo, si el registro indica una actividad de Retraso de 8:00 a 10:00 de la mañana, pero ya existe una actividad de mayor prioridad de 9:00 a 10:00, sólo se sobrescribirá la actividad de Retraso de 8:00 a 9:00.

Acortar o ampliar registros

Las programaciones no pueden acortarse o ampliarse cuando los registros contienen una actividad No programada. Si un archivo de datos contiene registros que acortarían o extenderían la programación con una actividad No programada, la importación de datos no aplica el registro. Otras actividades, como Tiempo libre o Reunión, acortarán o ampliarán una programación.

La importación de datos no crea programaciones en días en los que no existen programaciones para la MU (Unidad de administración) de un agente. Si la fecha de un registro no está dentro del rango de programación válido para la MU asociada al agente en ese registro, la importación de datos no procesa el registro.

El agente no tiene una programación para la fecha especificada

Si un agente no tiene una programación para la fecha especificada, la importación de datos no procesa el registro.

Procesamiento especial para actividades abiertas y no programadas

Las actividades abiertas y no programadas requieren un procesamiento especial. Esto se refiere al código de actividad predefinido Abierto, no a las actividades con el atributo abierto. Las actividades no programadas indican la ausencia de una actividad.

Condición	Tipo de actividad	Detalles del procesamiento
Aplicar un registro cuyo campo Actividad corresponde a la actividad Abierto	Abierto	El código de actividad Abierto siempre será la excepción de mayor prioridad cuando se aplique a una programación. Si el registro que se aplica es la actividad Abierto, sobrescribe cualquier otra actividad de la programación excepto las actividades No programadas. Por ejemplo, si un horario tiene una actividad Reunión de 15:00 a 17:00, y un registro con la actividad Abierto de 16:00 a 17:00, la actividad Abierto sobrescribe la actividad Reunión independientemente de la prioridad de la actividad Reunión.
	No programado	No permitido. La importación de datos no procesa el registro.
Aplicación de un registro a una programación que contiene la actividad Abierto	Abierto	Cuando el registro existente contiene una actividad Abierto, la actividad importada siempre sobrescribe la actividad Abierto existente. Por ejemplo, si una programación tiene una actividad Abierto de 13:00 a 17:00 y el horario importado tiene una actividad de Tiempo personal de 16:00 a 17:00, la actividad Abierto de la programación existente se sobrescribe, independientemente de la prioridad de la actividad de Tiempo personal.
	No programado	Los registros importados no sobrescriben el tiempo no programado. Esto se aplica al tiempo no programado antes y después de los turnos normal y divididos, y al tiempo no programado entre turnos en un turno dividido. IEX WFM Integrated sólo almacena el tiempo no programado entre turnos en un turno dividido. No almacena el tiempo antes y después de turnos normales o divididos. Cuando el tiempo del registro importado se superpone con el tiempo no programado y programado de un turno dividido, sólo se procesa la parte del registro que se superpone con el tiempo programado. Por ejemplo, si las partes de un turno dividido son de 8:00 a 12:00 y de 18:00 a 00:00, y el registro importado indica un rango de tiempo de actividad de 10:00 a 14:00, sólo se aplica al registro existente el tiempo de 10:00 a 12:00.

Mientras un registro de importación sea válido, la importación de datos crea registros de Actividad futura para todas las actividades del registro de importación. Los crea incluso si una actividad contenida en el registro no se puede agregar a la programación del agente. Las actividades pueden ser válidas pero la importación de datos no puede importarlas debido a razones tales como que el agente no tiene una programación para el período de tiempo listado en la actividad o porque la actividad existente tiene una prioridad más alta que la importada.

Elementos de los registros de Actividad futura

Los siguientes elementos son específicos de los registros de Actividad futura. No afectan a los cambios realizados en las programaciones a menos que se indique lo contrario. Estos elementos son opcionales.

modifiedBy
note (puede usar note tanto para los cambios de programación como para las actividades futuras)
otcreatesched
requestedBy
timeRequested
vacationGroup
vacationYear

Actividades futuras de vacaciones

Los elementos vacationGroup o vacationYear deben aparecer juntos en los registros. Si usa uno, debe incluir también el otro. Si sólo incluye uno de estos elementos, la importación de datos no procesará el registro.

Una Actividad futura de vacaciones no puede ser también una actividad de horas extra. Si los elementos vacationGroup y vacationYear se incluyen en un registro junto con otcreatesched, la importación de datos no creará el registro de Actividad futura.

Cuando la importación de datos crea o elimina un registro de Actividad futura que contiene vacationGroup y vacationYear, actualiza automáticamente la pantalla de Oferta de vacaciones.

Eliminar registros de evento de programación y actividad futura

Solo puede eliminar evento de programación y actividades futuras cuando usa archivos delimitado por barras verticales. Incluya el campo delete en el registro que desea eliminar.

Registros de evento de programación

Cuando la importación de datos elimina un evento de programación, reemplaza el código de actividad especificado en el registro importado con el códigos de programación base. El código de actividad debe existir en la programación del agente para que la eliminación funcione. La actividad puede estar presente durante cualquier parte del período de tiempo especificado. El momento en que se coloca el códigos de programación base en la programación del agente no necesariamente será el período de tiempo exacto especificado en el registro de importación.

Registros de Actividad futura

La importación de datos eliminará registros de Actividad futura si se cumplen todas estas condiciones:

Incluye el elemento delete en un archivo de importación para una actividad futura.
El registro de Actividad futura existe para el agente y el código de actividad para el período de tiempo exacto especificado en el registro de importación.

Si no se cumplen una o más de estas condiciones, o si la importación de datos no encuentra una coincidencia exacta para el registro de importación, la importación de datos no eliminará ningún registro de Actividad futura. Al determinar si un registro es una coincidencia exacta, la importación de datos usa estos criterios:

El elemento otcreatesched no tiene que coincidir con la configuración de Crear programación Horas extra del registro de Actividad futura para que se elimine la actividad futura.
Si un registro de importación de Actividad futura no tiene una starttime especificada, la importación de datos considerará un registro de Actividad futura existente como una coincidencia exacta si no tiene una configuración de Hora de inicio definida.
Si un registro de importación de Actividad futura no tiene una endtime especificada, la importación de datos considerará una Actividad futura existente como una coincidencia exacta si no tiene una configuración de Hora de finalización definida.

Ver registros importados de Actividad futura

Puede ver los registros de importados de Actividad futura en la pantalla de Actividad futura del agente. Al ver los registros, tenga en cuenta que:

El icono se determina por el Código de excepción al que IEX WFM Integrated asigna el registro importado, usando el atributo Código de excepción que especifique.
El Tipo de actividad se determina por la combinación de los elementos starttime, endtime, y otcreatesched.
Para los campos Fecha de inicio y Fecha de finalización, la fecha puede cruzar la medianoche si importó el registro utilizando un archivo delimitado por barras verticales.
Los campos Duración de horas extra, Desplazamiento de horas extra, y Límite de horas extra estarán vacíos.
El campo Crear programación Horas extra se habilitará si se proporcionan starttime y endtime y el elemento otcreatesched está presente.

Archivo de bloqueo para registros de importación sin procesar

La importación de datos crea un archivo de bloqueo en el mismo directorio que el archivo de entrada y copia en él los registros que no ha podido procesar debido a tablas bloqueadas en el archivo de bloqueo. Intenta procesar los registros del archivo de bloqueo hasta que se agota el tiempo límite. El tiempo límite predeterminado es de 120 minutos.

El archivo de bloqueo tiene el mismo nombre que el archivo de importación original, pero la extensión es LCK. El contenido del archivo es el mismo que el del archivo original, salvo que sólo contiene los registros que la importación de datos no ha podido procesar. El archivo de bloqueo siempre está en formato XML, incluso si el archivo original estaba en formato delimitado por barras verticales.

Definición del tipo de documento

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 agentScheduleList (agent+)> <!ELEMENT agent (id, schedule)> <!ELEMENT schedule (schedid?, day, month, year, (exception+ | offexception))> <!ELEMENT exception (startdate, starttime?, endtime?, code, vacationGroup?, vacationYear?, note?, agentAllowedViewNote?, modifiedBy?, requestedBy?, timeRequested?, delete?, otcreatesched?)> <!ELEMENT offexception EMPTY> <!ELEMENT startdate (day, month, year)> <!ELEMENT starttime (hour, min)> <!ELEMENT endtime (hour, min)> <!ELEMENT id (#PCDATA)> <!ELEMENT schedid (#PCDATA)> <!ELEMENT code (#PCDATA)> <!ELEMENT vacationGroup (#PCDATA)> <!ELEMENT vacationYear (#PCDATA)> <!ELEMENT note (#PCDATA)> <!ELEMENT agentAllowedViewNote (#PCDATA)> <!ELEMENT modifiedBy (#PCDATA)> <!ELEMENT requestedBy (#PCDATA)> <!ELEMENT timeRequested (day, month, year, hour, min)> <!ELEMENT delete EMPTY> <!ELEMENT otcreatesched EMPTY> <!ELEMENT day (#PCDATA)> <!ELEMENT month (#PCDATA)> <!ELEMENT year (#PCDATA)> <!ELEMENT hour (#PCDATA)> <!ELEMENT min (#PCDATA)>

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 muOpens. Use el DTD de cambios de programación como plantilla para estructurar los datos en su archivo de importación.

Elemento raíz

El elemento raíz es agentScheduleList. Este elemento puede contener cero o más elementos secundarios agent.

Elementos secundarios

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

Elemento	Elemento secundario o atributo	Descripción	Valores válidos
agente		Identifica cada agente y el cambios de programación del agente.
	id	El ID del agente.	0-999999999
	schedule	Contiene los siguientes elementos secundarios y uno o más elementos de exception: schedid, day, month, year .
	schedid	Puede utilizarse para asignar un ID único al registro de importación.
	día	Día del mes en el que se produce la programación.	1-31
	month	Mes del año en el que se produce la programación.	1-12
	year	Año en el que se produce la programación.	Cualquier año de 4 dígitos
	exception	Habrá uno o más elementos exception para indicar el cambio requerido en la programación del agente. Cada uno tendrá: elementos secundarios startdate, endtime, y code.
	startdate	Fecha de inicio de la actividad. Contiene los elementos secundarios day, month, y year.
	día	Día del mes en que comienza la actividad.	1-31
	month	Mes del año en el que comienza la actividad.	1-12
	year	Año de inicio de la actividad.	Cualquier año de 4 dígitos
	starttime	Hora a la que comienza la actividad. Si se omite, se utilizará Inicio de programación y el sistema identificará la hora de inicio de la programación del agente. Contiene los elementos secundarios hour y min.
	hora	Hora de inicio de la actividad.	0-23 formato de 24 horas
	mín	Minuto en el que comienza la actividad.	0-59
	endtime	Hora a la que finaliza la actividad. El endtime es la hora de fin del reloj, y por lo tanto excluye el minuto de parada. Por ejemplo, si una actividad de Almuerzo existe al mediodía por una hora, endtimeserá 01:00, no 12:59. Si se omite, se utilizará Fin de programación y el sistema identificará la hora de fin de la programación del agente. Contiene los elementos secundarios hour y min.
	hora	Hora a la que finaliza la excepción.	0-23 formato de 24 horas
	mín	Minutos a la que finaliza la excepción.	0-59
	code	Contiene el nombre del código de actividad para el evento de programación. Igual que el campo exception en los archivos de entrada delimitados por barras verticales.
	vacationGroup	ID del grupo de tiempo libre para el que se almacenará el registro de actividad futura. No se realizarán validaciones para determinar si el agente está asignado al Grupo de tiempo libre especificado. Sólo disponible con archivo de entrada XML. No se puede utilizar con entrada delimitada por barras verticales.	1-2147483647 Se debe definir un Grupo de tiempo libre en IEX WFM Integrated con este ID.
	vacationYear	Nombre de cuatro caracteres de la Regla de tiempo libre para la que se almacenará el registro de Actividad futura. Debe existir una Regla de tiempo libre con este nombre para el Grupo de tiempo libre especificado.	En blanco o cualquier carácter ASCII imprimible excepto \| &y \. La longitud máxima es 4. Distinguir mayúsculas y minúsculas
	note	Nota almacenada con la actividad futura o el evento programado. Sólo disponible con archivos de entrada XML. No se puede utilizar con entrada delimitada por barras verticales.	En blanco o cualquier carácter ASCII imprimible excepto \| &y \. La longitud máxima es 255.
	agentAllowedViewNote	Indica si el agente puede ver la nota. Si se utiliza el elemento note y agentAllowedViewNote está ausente o se incluye con cualquier valor distinto de false (incluido ningún valor), el agente puede ver la nota.	Verdadero Falso
	modifiedBy	Nombre de usuario del supervisor que modificó por última vez el registro de actividad futura. Sólo disponible con archivos de entrada XML. No se puede utilizar con entrada delimitada por barras verticales.	En blanco o cualquier carácter ASCII imprimible excepto \|, &, y \. La longitud máxima es 256. Distingue entre mayúsculas y minúsculas
	requestedBy	Nombre de usuario del supervisor que presentó inicialmente la solicitud de vacaciones para el agente. Un valor en blanco indica que la solicitud fue realizada por el agente. Sólo disponible con archivos de entrada XML. No se puede utilizar con entrada delimitada por barras verticales.	En blanco o cualquier carácter ASCII imprimible excepto \|, &, y \. La longitud máxima es 256. Distinguir mayúsculas y minúsculas
	timeRequested	Fecha y hora en que se envió inicialmente la solicitud de vacaciones. Sólo disponible con archivos de entrada XML. No se puede utilizar con entrada delimitada por barras verticales.	En blanco o cualquier fecha y hora, que usa elementos secundarios day, month,year, hour, y min
	día	Sólo disponible con archivos de entrada XML.	1-31
	month	Mes en el que se solicitó la actividad.	1-12
	year	Año en que se solicitó la actividad.	Cualquier año de 4 dígitos
	hora	Hora en que se solicitó la actividad.	0-23 formato de 24 horas
	mín	Minuto en que se solicitó la actividad.	0-59
	borrar	No contiene datos. Indica que la importación de datos debe eliminar la actividad (y sustituirla por el Código de programación base).
	otcreatesched	No contiene datos. Indica que la importación de datos debe crear una Actividad futura de horas extra. Crea una actividad futura y define el indicador Crear programación para el registro de la actividad futura. El tipo de actividad futura depende si startTime o endTime se incluyen en el registro. No puede usarse Excepciones futuras relacionadas con vacaciones.