Arquivo de importação de mudanças na agenda

Num relance

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

Tipo de arquivo: XML

Os arquivos de dados de importação de mudanças na agenda permitem atualizar as agendas dos agentes no IEX WFM Integrated. Você também pode adicionar ou substituir uma agenda existente, criar ou excluir registros de atividade futura ou excluir registros de eventos de agendamento. As mudanças na agenda vêm de um sistema de RVI, um navegador da web, uma plataforma de terceiros, entre outros.

Fatos importantes sobre arquivos de importação de dados de mudanças na agenda

  • Utilize as mudanças na agenda Definição do tipo de documento e siga as práticas recomendadas para XML padrão.

  • Atualize as agendas dos agentes adicionando um código de atividade para a data e hora especificadas.

  • Os elementos de data e hora devem usar o fuso horário da MU do agente.

  • Alguns elementos usados nos arquivos de importação de mudanças na agenda têm nomes legados.

  • 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.

  • StopTime pode ser anterior a StartTime. Isso acontece quando o intervalo de tempo ultrapassa a meia-noite. O intervalo de tempo da meia-noite até StopTime aplica-se à agenda indicada pela [StartTime].

    Anne Shirley, agente da Classics Inc., trabalha das 20:00 de quarta-feira às 6:00 de quinta-feira. Há um registro para ela com um intervalo de tempo de 01:00 - 03:00 na quinta-feira. Mesmo o intervalo de tempo de 01:00 - 03:00 tendo ocorrido na quinta-feira, ele é aplicado à agenda com a data de quarta-feira.

    Jane Andrews não estava escalada para trabalhar na segunda-feira. Ela estava escalada para quinta-feira, das 3:00 às 12:00. Jane concordou em cobrir parte do turno de Gilbert Blythe, então ela chegou cedo e trabalhou das 23:00 de segunda-feira às 05:00 de terça-feira, quando se desconectou para um intervalo. Isso significa que ela tem um registro com data de segunda-feira para o intervalo de horário das 23:00 às 05:00. Esse registro não será processado. A data de registro é segunda-feira, então esse intervalo de tempo só se aplicaria a uma agenda de segunda-feira. Como Jane não foi escalada para segunda-feira, não há registro de segunda-feira ao qual esse intervalo possa ser aplicado.

Mapeamento de código de atividade

Você deve mapear um evento de agendamento em um arquivo de dados de mudanças na agenda para um atributo de código de atividade no IEX WFM Integrated. Isso permite que a importação de dados aplique eventos de agendamento ao código de atividade correto no IEX WFM Integrated.

  1. Defina um atributo de código de atividade no IEX WFM Integrated.

    1. Em Administrador, clique em Atributos do código de atividade.

    2. Crie um Atributo de código de atividade para cada partição de cliente em cada servidor IEX WFM Integrated.  É possível nomear o atributo do código de atividade como SchedExImport ou usar um nome personalizado.
    3. Para cada evento de agendamento incluído no arquivo de importação, adicione um Valor de atributo ao Atributo de código de atividade que você criou. Por exemplo, se o arquivo de importação tiver eventos agendados que sejam treinamentos, reuniões e férias, você adicionaria os valores Treinamento, Reunião e Férias. Não atribua um valor ao código de atividade Não agendada.

  2. Atribua valores de atributo aos códigos de atividade no IEX WFM Integrated.

    1. Em Administrador, clique em Atribuição de atributos.
    2. Selecione um código de atividade para cada atributo que você definiu.

Tipo de atividade

O IEX WFM Integrated determina qual é exibido para uma atividade futura importada com base no tipo de atividade. Ele determina o tipo de atividade da seguinte forma:

  • Dia parcial: se starttime e endtime forem fornecidos e o campo ou elemento otcreatesched for omitido.

  • Início agend. dia parcial: se endtime for fornecido e starttime não for fornecido.

  • Término agend. dia parcial: se starttime for fornecido e endtime não for fornecido.

  • Dia inteiro: se starttime e endtime não forem fornecidos.

  • Dia parcial OT: se starttime e endtime forem fornecidos e o campo otcreatesched estiver presente.

  • OT antes do agend.: sem suporte.

  • OT após o agend.: sem suporte.

Informações gerais de processamento

Horas de início e parada

StartTime e EndTime são opcionais.

  • Se StartTime for omitido, a atividade será aplicada desde o início da programação até o EndTime fornecido.

  • Se EndTime for omitido, a atividade será aplicada desde o StartTime indicado até o fim da programação.

  • Se StartTime e EndTime forem omitidos, a exceção será aplicada a toda a programação para a data fornecida. As prioridades de códigos de atividade ainda serão honradas.

Quando as horas de início ou término no registro importado ficam parcialmente fora do intervalo de horário de início e término programado do agente, apenas a parte do registro que se sobrepõe ao horário agendado existente é processada.

Diana Barry está escalada das 8:00 às 17:00, e o registo importado indica um intervalo de tempo das 7:00 às 10:00. Somente a parte que se sobrepõe ao horário de agendamento existente é importada (neste caso, das 8:00 às 10:00).

Quando as horas de início ou término no registro importado ficam completamente fora do intervalo de horário de início e término programado do agente, o registro não é processado.

O IEX WFM Integrated usa a presença ou ausência de hora de início e parada para determinar o tipo de atividade de cada registro.

Prioridades de códigos de atividade

A importação de dados respeita as prioridades de códigos de atividade. Ela substitui atividades de prioridade igual e inferior, mas não atividades de prioridade mais alta. Este processamento difere do método de processamento Aplicar atividades futuras. Esse método é revertido para um ID interno como desempate ao tentar substituir uma atividade por outra de mesma prioridade.

Os registros parciais serão aplicados. Por exemplo, se o registro indicar uma atividade Atrasada das 8:00 às 10:00, mas já existir uma atividade de prioridade mais alta das 9:00 às 10:00, apenas 8:00 às 9:00 será substituído pela atividade Atrasada.

Reduzir ou estender registros

As programações não podem ser reduzidas ou estendidas quando os registros contêm uma atividade Não agendada. Se um arquivo de dados contiver registros que reduziriam ou estenderiam a programação com uma atividade Não agendada, a importação de dados não aplicará o registro. Outras atividades, como Folga ou Reunião, reduzirão ou estenderão a programação.

A importação de dados não cria programações em dias onde não existem programações para a MU de um agente. Se a data de um registro não estiver dentro do intervalo de programação válido para a MU associada ao agente nesse registro, a importação de dados não processará o registro.

O agente não tem programação para a data especificada

Se um agente não tiver uma programação para a data especificada, a importação de dados não processará o registro.

Processamento especial para atividades em aberto e não agendadas

As atividades em aberto e não agendadas exigem processamento especial. Isso se refere ao código de atividade Em aberto, e não a atividades com o atributo open. As atividades não agendadas indicam a ausência de uma atividade.

Condição

Tipo de atividade

Detalhes do processamento
Aplicar um registro cujo campo Atividade é mapeado para a atividade Em aberto Abrir

O código de atividade Em aberto sempre será a exceção de prioridade mais alta quando aplicado a uma programação. Se o registro aplicado for a atividade Em aberto, ele substituirá qualquer outra atividade na programação, exceto atividades Não agendadas.

Por exemplo, se uma programação tiver uma atividade Reunião das 15:00 às 17:00 e um registro com a atividade Em aberto das 16:00 às 17:00, a atividade Em aberto substituirá a atividade Reunião, independentemente da prioridade da atividade Reunião.
Não programado

Não permitida. A importação de dados não processa o registro.
Aplicar um registro a uma programação que contém a atividade Em aberto Abrir

Quando o registro existente contém uma atividade Em aberto, a atividade importada sempre substitui a atividade Em aberto existente.

Por exemplo, se uma programação tiver uma atividade Em aberto da 1:00 às 5:00 e a programação importada tiver uma atividade Tempo pessoal das 4:00 às 5:00, a atividade Em aberto na programação existente será substituída, independentemente da prioridade da atividade Tempo pessoal.
Não programado

Os registros importados não substituem o horário não agendado. Isso se aplica ao horário não agendado antes e depois dos turnos normais e divididos, e ao horário não agendado entre turnos em um turno dividido.

O IEX WFM Integrated armazena apenas o horário não agendado entre turnos em um turno dividido. Ele não armazena o tempo antes e depois dos turnos normais ou divididos.

Quando o horário do registro importado se sobrepõe ao horário não agendado e agendado para um turno dividido, apenas a parte do registro que se sobrepõe ao horário agendado é processada. Por exemplo, se as partes de um turno dividido forem das 8:00 às 12:00 e das 18:00 às 00:00 da noite, e o registro importado indicar um intervalo de tempo de atividade das 10:00 às 14:00, apenas o horário das 10:00 às 12:00 é aplicado ao registro existente.

Desde que um registro de importação seja válido, a importação de dados cria registros de Atividades futuras para todas as atividades no registro de importação. Ela os cria mesmo que uma atividade contida no registro não possa ser adicionada à agenda do agente. As atividades podem ser válidas, mas a importação de dados não pode importá-las por motivos como o agente não ter uma programação para o intervalo de tempo listado na atividade ou porque a atividade existente tem uma prioridade mais alta que a importada.

Elementos em registros de atividade futura

Os elementos a seguir são específicos para registros de Atividades futuras. Eles não afetam as alterações feitas nas agendas, salvo indicação em contrário. Esses elementos são opcionais.

  • modifiedBy
  • note (você pode usar note para mudanças na agenda e atividades futuras)
  • otcreatesched
  • requestedBy
  • timeRequested
  • vacationGroup

  • vacationYear

Atividades futuras de férias

Os elementos vacationGroup ou vacationYear devem aparecer juntos nos registros. Se você usar um, deverá incluir o outro também. Se você incluir apenas um desses elementos, a importação de dados não processará o registro.

Uma atividade futura de férias também não pode ser uma atividade de horas extras. Se os elementos vacationGroup e vacationYear forem incluídos em um registro junto com otcreatesched, a importação de dados não criará o registro de atividade futura.

Quando a importação de dados cria ou exclui um registro de atividade futura que contém vacationGroup e vacationYear, ela atualiza automaticamente a tela Licitação de Férias.

Excluir registros de eventos agendamento e atividades futuras

Você só pode excluir eventos de agendamento e atividades futuras quando usar arquivos delimitados por barras verticais. Inclua o campo delete no registro que você quer excluir.

Registros de evento de agendamento

Quando a importação de dados exclui um evento de agendamento, ela substitui o código de atividade especificado no registro importado pelo código de agendamento base. O código de atividade deve existir na agenda do agente para que a exclusão funcione. A atividade pode estar presente durante qualquer parte do intervalo de tempo especificado. O horário em que o código de agendamento base é colocado na agenda do agente não será necessariamente o intervalo de tempo exato especificado no registro de importação.

Registros de atividade futura

A importação de dados excluirá os registros de atividade futura se todas estas condições forem atendidas:

  • Você inclui o elemento delete em um arquivo de importação para uma atividade futura.
  • O registro de atividade futura existe para o agente e o código de atividade para o intervalo de tempo exato especificado no registro de importação.

Se uma ou mais destas condições não forem atendidas, ou se a importação de dados não encontrar uma correspondência exata para o registro de importação, a importação de dados não excluirá os registos de atividade futura. Para determinar se um registro é uma correspondência exata, a importação de dados usa estes critérios:

  • O elemento otcreatesched não precisa corresponder à configuração de Criar agenda de horas extras do registro de atividade futura para a atividade futura ser excluída.

  • Se um registro de importação de atividade futura não tiver um starttime especificado, a importação de dados vai considerar um registro de atividade futura existente como uma correspondência exata se não tiver uma configuração definida para Hora de Início.

  • Se um registro de importação de atividade futura não tiver um endtime especificado, a importação de dados vai considerar um registro de Atividade futura existente como uma correspondência exata se não tiver uma configuração definida para Hora de Término.

Ver registros de atividade futura importados

Você pode ver registros de atividade futura na tela Atividade futura do agente. Quando estiver vendo os registros, observe que:

  • O ícone é determinado pelo código de exceção para o qual o IEX WFM Integrated mapeia o registro importado, usando o atributo de código de exceção que você especifica.

  • O tipo de atividade é determinado pela combinação dos elementos starttime, endtime e otcreatesched.

  • Para os campos Data de Início e Data de Término, a data pode ultrapassar a meia-noite se você importou o registro usando um arquivo delimitado por barras verticais.

  • Os campos Duração das horas extras, Desvio de horas extras e Limite de horas extras ficarão vazios.

  • O campo Criar agenda de horas extras será ativado se starttime e endtime forem fornecidos, e o elemento otcreatesched estiver presente.

Arquivo de bloqueio para registros de importação não processados

A importação de dados cria um arquivo de bloqueio no mesmo diretório do arquivo de entrada e copia os registros que não puderam ser processados devido a tabelas bloqueadas para o arquivo de bloqueio. Ela tenta processar os registros no arquivo de bloqueio até atingir o tempo limite. O tempo limite padrão é de 120 minutos.

O arquivo de bloqueio tem o mesmo nome do arquivo de importação original, mas a extensão é LCK. O conteúdo do arquivo é o mesmo do arquivo original, exceto que ele contém apenas os registros que a importação de dados não conseguiu processar. O arquivo de bloqueio está sempre no formato XML, mesmo que o arquivo original esteja no formato delimitado por barras verticais.

Definição de tipo de documento

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.

<?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)>

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 muOpens. Use o DTD de mudanças na agenda como modelo para estruturar os dados no seu arquivo de importação.

Elemento raiz

O elemento raiz é agentScheduleList. Esse elemento pode conter zero ou mais elementos agent 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
agente   Identifica cada agente e a mudança na agenda do agente.  
  id

ID do agente.

0-999999999
  schedule Contém os seguintes elementos secundários e um ou mais elementos exception: schedid, day, month, year.  
  schedid Pode ser usado para atribuir um ID exclusivo ao registro de importação.  
  dia Dia do mês em que ocorre a programação. 1-31
  month Mês do ano em que ocorre a programação. 1-12
  year Ano em que ocorre a programação. Qualquer ano de 4 dígitos
  exception

Haverá um ou mais elementos exception para indicar a mudança necessária na agenda do agente. Cada um conterá os elementos secundários: startdate, endtime e code.

  
  startdate Data em que a atividade começa. Contém os elementos secundários day, month e year.  
  dia Dia do mês em que a atividade começa. 1-31
  month Mês do ano em que a atividade começa. 1-12
  year Ano em que a atividade começa. Qualquer ano de 4 dígitos
  starttime A hora em que a atividade começa. Se omitido, será utilizado Início da programação e o sistema identificará o horário de início da programação do agente. Contém os elementos secundários hour e min.  
  hora Hora em que a atividade começa. 0-23

Formato de 24 horas
  min Minuto em que a atividade começa. 0-59
  endtime Hora em que a atividade termina. O endtime é a hora de parada do relógio e, portanto, exclui o minuto de parada. Por exemplo, se uma atividade de Almoço existir ao meio-dia por uma hora, o endtime será 01:00, não 12:59. Se omitido, será utilizado Término da programação e o sistema identificará o horário de parada da programação do agente. Contém os elementos secundários hour e min.  
  hora Hora em que a exceção termina. 0-23

Formato de 24 horas
  min Minuto em que a exceção termina. 0-59
  code

Contém o nome do código de atividade do evento agendado.

Equivalente ao campo exception em arquivos de entrada delimitados por barras verticais.

  
  vacationGroup

O ID do grupo de folga para o qual o registro de atividade futura será armazenado.

Nenhuma validação será realizada para determinar se o agente está atribuído ao grupo de folga especificado.

Somente disponível com arquivo de entrada XML. Não pode ser usado com entrada delimitada por barra vertical.

 1-2147483647

 

Um grupo de folga deve ser definido no IEX WFM Integrated com esse ID.
  vacationYear

O nome de quatro caracteres da regra de folga para a qual o registro de atividade futura será armazenado.

Deve existir uma regra de folga com esse nome para o grupo de folga especificado.

Em branco ou qualquer caractere ASCII imprimível, exceto | & e \.

O tamanho máximo é 4.

Diferenciar maiúsculas de minúsculas
  Nota

Nota armazenada com a atividade futura ou evento agendado.

Somente disponível com arquivos de entrada XML. Não pode ser usado com entrada delimitada por barra vertical.

Em branco ou qualquer caractere ASCII imprimível, exceto | & e \.

O tamanho máximo é 255.
  agentAllowedViewNote Indica se o agente pode ver a nota. Se o elemento note for usado e agentAllowedViewNote estiver ausente ou incluído com um valor diferente de false (incluindo nenhum valor), o agente poderá ver a nota.

True

False
  modifiedBy

O nome de login do supervisor que modificou pela última vez o registro de atividade futura.

Somente disponível com arquivos de entrada XML. Não pode ser usado com entrada delimitada por barra vertical.

Em branco ou qualquer caractere ASCII imprimível, exceto |, & e \.

O tamanho máximo é 256.

Diferencia maiúsculas de minúsculas
  requestedBy

Nome de login do supervisor que enviou inicialmente a solicitação de férias para o agente. Um valor em branco indica que a solicitação foi feita pelo agente.

Somente disponível com arquivos de entrada XML. Não pode ser usado com entrada delimitada por barra vertical.

Em branco ou qualquer caractere ASCII imprimível, exceto |, & e \.

O tamanho máximo é 256.

Diferenciar maiúsculas de minúsculas
  timeRequested

Data e hora em que a solicitação de férias foi enviada inicialmente.

Somente disponível com arquivos de entrada XML. Não pode ser usado com entrada delimitada por barra vertical.

 Em branco ou qualquer data e hora usando os elementos secundários day, month,year, hour e min.
  dia Dia do mês em que a atividade foi solicitada. 1-31
  month Mês em que a atividade foi solicitada. 1-12
  year Ano em que a atividade foi solicitada. qualquer ano de 4 dígitos
  hora Hora em que a atividade foi solicitada. 0-23

Formato de 24 horas
  min Minuto em que a atividade foi solicitada. 0-59
  excluir

Não contém dados. Indica que a importação de dados deve excluir a atividade (e substituí-la pelo código de agendamento base).

  
  otcreatesched

Não contém dados. Indica que a importação de dados deve criar uma atividade futura de horas extras.

Cria uma atividade futura e define o sinalizador Criar programação para o registro de atividade futura. O tipo de atividade futura depende se startTime ou endTime estão incluídos no registro.

Não pode ser usado com exceções futuras relacionadas a férias.