Archivo de importación MU Opens

De un vistazo

Nombre de archivo: MUOpens-[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 MU Opens permiten importar valores de apertura programada de MU basados en intervalos a IEX WFM Integrated. Esto es útil cuando se recopilan y muestran datos de apertura programada de fuentes de terceros, y no es necesario ver las programaciones específicas reales de los agentes que generan los valores de intervalo de la apertura programada.

Datos clave sobre los archivos de importación de datos de MU Opens

Cada archivo debe tener los elementos descritos en la Definición de tipo de documento. Siga las especificaciones generales de XML para el contenido de los archivos y las mejores prácticas de XML.
Puede importar datos de múltiples MU en el mismo archivo de importación de MU Opens.
Los valores importados se almacenan como Aperturas externas. Son independientes de los valores de apertura programa derivados de las programaciones de los agentes de IEX WFM Integrated.
Puede ver los valores de aperturas externas en algunas pantallas de MU. La suma de las aperturas externas y las aperturas programadas derivadas de las programaciones de agente de IEX WFM Integrated se muestra en las pantallas de CT.

Los elementos date y time deben utilizar la zona horaria de MU.
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 deberían tener 30 caracteres o menos.
La importación de datos lee los datos existentes de su sistema IEX WFM Integrated. A continuación, realiza y guarda los cambios de acuerdo con la información del archivo de importación. Los datos existentes no se bloquean. Por lo tanto, los datos del sistema podrían modificarse entre el momento en que la importación de datos los lee y el momento en que la importación de datos guarda los cambios. Si esto ocurre, se producirá un error y los datos no se guardarán.
Si los usuarios están visualizando datos en IEX WFM Integrated durante la importación de datos, y esos datos se modifican, los usuarios no podrán modificar los mismos datos. Primero deben volver a recuperar los datos. Si intentan guardar un cambio, la operación de guardado fallará y verán un mensaje indicando que los datos han sido modificados por otra persona. Es el mismo mensaje que aparece si otro usuario modifica los datos. El usuario puede actualizar la pantalla y volver a realizar los cambios.

Información general de procesamiento

Cada elemento de muOpens contiene todos los datos de aperturas para una única MU, CT y fecha.
Pueden incluirse los periodos para los que el valor de apertura es 0. No son obligatorios. Cualquier periodo en la fecha para el que no se incluyan datos se definirá a 0.
Los datos de las programaciones que pasan la medianoche pueden incluirse con la fecha en la que comienza la programación o con los datos de la fecha siguiente. La IEX WFM Integrated exportación de MU Opens incluye los datos que pasan la medianoche con la fecha de la programación
Este archivo de importación está diseñado para actualizar las programaciones con importaciones MU Opens externas. Cuando aplique cambios a una programación, recuerde volver a ejecutar sus importaciones MU Opens. Esto garantiza que las importaciones MU Opens se apliquen a sus programaciones modificadas.

Definición del tipo de documento de MU Opens

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.

<!ELEMENT opens (muOpens*) > <!ELEMENT muOpens (muID, ctID?, date, openValue*)> <!ELEMENT muID (#PCDATA)> <!ELEMENT ctID (#PCDATA)> <!ELEMENT date (day, month, year)> <!ELEMENT openValue (#PCDATA)> <!ELEMENT day (#PCDATA)> <!ELEMENT month (#PCDATA)> <!ELEMENT year (#PCDATA)> <!ATTLIST openValue time CDATA #REQUIRED>

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

Elemento raíz

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

Elementos secundarios

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

Elemento	Elemento secundario atributo OR	Descripción	Valores válidos
muOpens		Contiene todos los datos de aperturas de una única MU, CT y fecha. Debe incluir un elemento secundario muID, un elemento secundario ctID (opcional), un elemento secundario date, y cero o más elementos secundarios openValue.
muID		ID de MU (Unidad de gestión) Si la MU no está basada en habilidades, debe pertenecer al CT especificado en el elemento ctID (en este caso, ctID no puede estar en blanco o ser -1). Si la MU está basada en habilidades, el CT especificado debe pertenecer al mismo Grupo de entidades (EG) que la MU, o el CT debe estar en blanco o ser -1.
ctID		ID de TC. Puede estar en blanco o tener un valor -1. En cualquier caso, se almacenará -1.
fecha		Fecha para la que se almacenará el valor de apertura. Este debe ser una fecha válida, usando los elementos secundarios day, month, y year. La importación de datos sólo cambia el intervalo de fechas de programación de la MU si la MU pertenece a un EG en la nueva fecha Y si pasan estas validaciones: Validaciones de fecha de inicio: No puede ser más de 581 días anterior a la fecha actual. Deben existir datos de planificación/previsión para la MU en la fecha de inicio. Validaciones de fecha de finalización: Debe ser igual o posterior a la fecha de inicio del registro SchedRange. Deben existir datos de planificación/previsión para la MU al menos 2 días después de la fecha de finalización.
	día	Día del mes para el que se almacenará el valor de apertura.	1-31
	month	Mes para el que se almacenará el valor de apertura.	1-12
	year	Año para el que se almacenará el valor de apertura.	Cualquier año
openValue		Número de agentes abiertos para la MU y el CT en la fecha y periodo de tiempo especificados. Puede especificar hasta cuatro decimales.	0.0000-9999.0000(0.0000-9999.0000(enteros o decimales)
	tiempo	Atributo del elemento openValue. Hora de inicio del periodo de 15 minutos para el que se almacenará el valor de apertura. Se supone que está en la zona horaria de la MU.	Formato de 24 horas, en incrementos de 15 minutos, debe ser 00:00-23:45

Ejemplo de archivo de entrada

<?xml version="1.0" encoding="UTF-8?> <opens> <muOpens> <muID>28</muID> <ctID>27</ctID> <date><day>17</day><month>5</month><year>2005</year></date> <openValue time=”08:00”>12.00</openValue> <openValue time=”08:15”>12.00</openValue> <openValue time=”08:30”>12.00</openValue> <openValue time=”08:45”>12.00</openValue> <openValue time=”09:00”>12.00</openValue> <openValue time=”09:15”>12.00</openValue> <openValue time=”09:30”>12.00</openValue> </muOpens> <muOpens> <muID>28</muID> <ctID>28</ctID> <date><day>17</day><month>5</month><year>2005</year></date> <openValue time=”08:00”>54.00</openValue> <openValue time=”08:15”>52.00</openValue> <openValue time=”08:30”>55.00</openValue> <openValue time=”08:45”>57.00</openValue> <openValue time=”09:00”>59.00</openValue> <openValue time=”09:15”>59.00</openValue> <openValue time=”09:30”>62.00</openValue> <openValue time=”09:45”>60.00</openValue> </muOpens> <muOpens> <muID>28</muID> <ctID>-1</ctID> <date><day>17</day><month>5</month><year>2005</year></date> <openValue time=”08:00”>2.00</openValue> <openValue time=”08:15”>1.00</openValue> <openValue time=”08:30”>0.00</openValue> <openValue time=”08:45”>1.00</openValue> <openValue time=”09:00”>3.00</openValue> <openValue time=”09:15”>2.00</openValue> <openValue time=”09:30”>4.00</openValue> <openValue time=”09:45”>5.00</openValue> </muOpens> <muOpens> <muID>28</muID> <ctID>27</ctID> <date><day>18</day><month>5</month><year>2005</year></date> <openValue time=”08:00”>5.00</openValue> <openValue time=”08:15”>5.00</openValue> <openValue time=”08:30”>4.00</openValue> <openValue time=”08:45”>5.00</openValue> <openValue time=”09:00”>6.00</openValue> <openValue time=”09:15”>6.00</openValue> <openValue time=”09:30”>9.00</openValue> <openValue time=”09:45”>9.00</openValue> </muOpens> ... </opens>