Arquivo de importação de aberturas de MU

Num relance

Nome do arquivo: MUOpens-[YYMMDD][HHMM].xml, onde [MMDDYY] é a data no formato MMDDAA e [HHMM] é a hora no formato HHMM.

Tipo de arquivo: XML

Os arquivos de importação de aberturas de MU permitem importar valores de agenda aberta da MU baseadas em intervalo para o IEX WFM Integrated. Isso é útil quando você coleta e exibe dados de abertura agendada de fontes de terceiros e não precisa ver as agendas específicas reais do agente que geram valores de intervalo para abertura agendada.

Fatos importantes sobre os arquivos de importação de dados de aberturas de MU

  • Cada arquivo deve conter os elementos descritos na Definição do tipo de documento. Siga as especificações gerais de XML para o conteúdo do arquivo e as práticas recomendadas para XML.

  • Você pode importar dados de vários MUs no mesmo arquivo de importação de aberturas de MU.

  • Os valores importados são armazenados como aberturas externas. Eles são separados dos valores de abertura agendada derivados das agendas dos agentes do IEX WFM Integrated.

  • Você pode visualizar os valores de abertura externa em algumas telas da MU. A soma das aberturas externas e aberturas agendadas derivadas das agendas dos agentes do IEX WFM Integrated é mostrada nas telas do CT.

  • Os elementos date e time devem usar o fuso horário da MU.

  • Se ocorrerem erros durante o processamento do arquivo, talvez os dados não sejam importados corretamente. Verifique a formatação do arquivo antes de entrar em contato com o seu representante da conta do IEX WFM Integrated.

  • Os nomes dos arquivos devem ter 30 caracteres ou menos.

  • A importação de dados lê os dados existentes do seu sistema IEX WFM Integrated. Depois, ele faz e salva alterações de acordo com as informações do seu arquivo de importação. Os dados existentes não são bloqueados. Portanto, os dados do sistema poderiam ser modificados entre o momento em que a importação de dados os lê e o momento em que a importação de dados salva as alterações. Se isso acontecer, ocorrerá um erro e os dados não serão salvos.
  • Se os usuários estiverem vendo dados no IEX WFM Integrated durante a importação de dados e esses dados forem alterados, os usuários não poderão alterar os mesmos dados. Eles devem recuperar os dados novamente primeiro. Se eles tentarem salvar uma alteração, o salvamento falhará e eles verão uma mensagem dizendo que os dados estão sendo modificados por outra pessoa. Essa é a mesma mensagem mostrada se outro usuário modificar os dados. O usuário pode atualizar a tela e fazer as alterações novamente.

Informações gerais de processamento

  • Cada elemento muOpens contém todos os dados de aberturas para uma MU, CT e data.
  • Os períodos para os quais o valor de abertura é 0 podem ser incluídos. Eles não são necessários. Qualquer período na data para a qual nenhum dado for incluído será definido como 0.
  • Os dados para programações que ultrapassam a meia-noite podem ser incluídos na data de início da programação ou nos dados da data seguinte. A exportação de aberturas de MU do IEX WFM Integrated inclui dados que ultrapassam a meia-noite com a data da programação.

  • Este arquivo de importação foi concebido para agendamentos atualizados com aberturas de MU externas. Ao efetuar alterações a uma agendamento, lembre-se de executar novamente as importações das aberturas de MU. Isso garante que as aberturas de MU sejam aplicadas aos seus agendamentos revisados.

Definição do tipo de documento de aberturas de MU

DTD (definição de tipo de documento) é um modelo para compilar arquivos de importação XML. Você não precisa criar um DTD no seu ambiente.

<!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>

Considerações sobre o tipo de elemento DTD

Quando usar a definição de tipo de documento (DTD) para criar um arquivo, lembre-se destas considerações sobre declarações de tipo de elemento:

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

Quando um elemento é definido com uma lista de elementos secundários separados por vírgulas, os elementos secundários devem aparecer na mesma ordem no arquivo de importação. Caso contrário, o elemento não será válido.

<!ELEMENT elementName (#PCDATA)>

Os elementos com o tipo #PCDATA podem conter qualquer string de texto. A importação de dados de dados valida o texto conforme necessário.

Qualificadores de atributos

O DTD usa qualificadores de elemento XML padrão:

  • ? -Elementos com este qualificador não são necessários. Se incluí-los, você pode apenas especificá-los uma vez por elemento.
  • *-Elementos com este qualificador não são necessários. Você pode incluir mais de um desses para cada elemento.
  • +-Pelo menos um dos elementos com esse qualificador é necessário. Você pode incluir mais de um de cada elemento.
  • [sem qualificador]-Elementos não marcados com um qualificador são necessários e você só pode especificá-los uma vez por elemento.

Conteúdo do arquivo: especificações de campos

Esta seção inclui todos os elementos para uso em arquivos de importação de aberturas de MU. Use o DTD muOpens  como modelo para estruturar os dados no seu arquivo de importação.

Elemento raiz

O elemento raiz é opens. Esse elemento pode conter zero ou mais elementos muOpens secundários.

Elementos secundários

Os elementos são recusados com base no nível deles no DTD.

Elemento

Elemento OU atributo secundário

Descrição

Valores válidos
muOpens  

Contém todos os dados de aberturas de uma única MU, CT e data.

Deve incluir um muID secundário, um ctID secundário (opcional), um date secundário, zero ou mais elementos openValue secundários.

  
muID  

ID da MU. Se a MU não for baseada em competências, ela deve pertencer ao CT especificado no elemento ctID (nesse caso, ctID não pode ficar em branco ou ser -1). Se a MU for baseada em competências, o CT especificado deve pertencer ao mesmo grupo de entidades (EG) da MU, ou o CT deve ficar em branco ou ser -1.

  
ctID  

ID do CT. Pode ficar em branco ou pode conter um valor -1. Em qualquer caso, -1 será armazenado.

  
data  

Data para qual o valor aberto será armazenado. Deve ser uma data válida, usando os elementos secundários day, month e year. A importação de dados só altera o período de agendamento da MU se a MU pertencer a um EG na nova data E se estas validações forem aprovadas:

  • Validações da data de início:
    • Não pode ser mais de 581 dias antes da data atual.
    • Devem existir dados de planejamento/previsão para a MU na data de início.
  • Validações da data de término:
    • Deve ser igual ou posterior à data de início do registro SchedRange.
    • Devem existir dados de planejamento/previsão para a MU pelo menos 2 dias após a data de término.
 
  dia Dia do mês para qual o valor aberto será armazenado. 1-31
  month Mês para qual o valor aberto será armazenado. 1-12
  year Ano para qual o valor aberto será armazenado.

Qualquer ano
openValue   Número de agentes abertos para a MU e o CT na data e período especificados. Você pode especificar até quatro casas decimais. 0,0000-9999,0000(inteiros ou flutuante)
  tempo Atributo do elemento openValue. Hora de início do período de 15 minutos durante o qual o valor aberto será armazenado. Presume-se que isso esteja no fuso horário da MU. O formato de 24 horas, em incrementos de 15 minutos, deve ser 00:00-23:45

Exemplo de arquivo 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>