Ir para o conteúdo principal
Documentação
Documentação
Administrator Guide
Última atualização: 2023-07-14
Definir recuperação de integração

Definir recuperação de integração

Segurança: domínios
Business Process Administration
 e
Manage: Business Process Definitions
 na área funcional System.
Para recuperar um documento de integração de um local externo, adicione uma etapa
de serviço
de recuperação de documentos
 ao processo de negócios de integração. A etapa descreve as opções de seleção, transporte e descriptografia de arquivo para o arquivo de integração.
A recuperação de documentos também permite que você recupere a saída de um relatório personalizado. Nesse caso, a recuperação de documentos:
  • Recupera os dados de dentro do Workday.
  • Armazena a saída do relatório no repositório Meus relatórios para uso em uma etapa de integração subsequente.
  1. Acesse a definição de processo de negócios à qual você quer adicionar a etapa.
  2. Adicione uma etapa
    de serviço
    de recuperação de documentos
     ao processo de negócios se a definição de processo de negócios ainda não tiver uma.
  3. Selecione
    Configurar recuperação de documentos
    .
  4. No campo
    Política de retenção de documentos
     , insira o número de dias que o Workday armazena os arquivos importados pelo processo de negócios.
  5. Na seção
    Etiquetas de documento
     , selecione todas as etiquetas de documento que você quer que o Workday aplique aos arquivos de entrada.
  6. Na seção
    Configurações de recuperação
     , especifique a configuração de recuperação:
    Opção Descrição
    Grupo para anexar manualmente os arquivos
    Para anexar um ou mais arquivos manualmente para importação, especifique um grupo de segurança de segmento que recebe uma solicitação de processo de negócios.
    Recuperar arquivo(s) de local externo
    Selecione um serviço de entrega de integração existente.
  7. Selecione a
    Opção de nome de arquivo
     para a recuperação:
    Opção Descrição
    Nome do arquivo/Padrão
    Permite que o Workday pesquise arquivos com um padrão de nome específico em um ponto de extremidade remoto.
    Gerador de sequências
    Permite que o Workday pesquise arquivos com um padrão de nome de arquivo sequencial específico em um ponto de extremidade remoto.
  8. (Somente Nome/Padrão de arquivo) Na seção
    Arquivo(s)
     :
    1. Insira o nome de arquivo, ou o padrão de nome de arquivo como uma expressão regular (regex), para o arquivo que você carregará no Workday a partir de um ponto de extremidade externo.
      Esse campo diferencia maiúsculas de minúsculas. O Workday não oferece suporte à sintaxe de expressão regular completa para recuperação de arquivos. O Workday só oferece suporte aos caracteres (*) e (?) como caracteres curinga no padrão de nome de arquivo.
      Para Amazon Simple Storage Service (S3), o Workday aceita (*) e (?).
      Para transportes do S3, você pode recuperar arquivos de pastas usando o formato:
      pasta1/pastaN/nomedoarquivo.format
      .
    2. Na seção
      Arquivo(s)
      , especifique o tipo MIME usando a lista de
      opções Tipo de conteúdo comum
       , especifique um
      Tipo de conteúdo personalizado
      ou selecione
      Nenhuma das opções anteriores
      .
      O Workday aplica o tipo MIME especificado a todos os arquivos recuperados pelo sistema de integração.
  9. (Somente gerador de sequências) Especifique opções de sequência de nomes de arquivo.
    Se um processo gera várias solicitações para o próximo número de sequência muito próximas, o Workday tenta gerar os números de sequência. Esse processo pode resultar em números não consecutivos e ignorados.
    Opção Descrição
    Incrementar ID de sequência em
    Insira um valor diferente de zero pelo qual o número de sequência aumenta cada vez que o Workday gera uma nova ID.
    Preenchimento
    Use
    Preenchimento
     para indicar o número de dígitos presentes na sequência. Insira um valor de preenchimento grande o suficiente para que a sequência não encontre uma condição de estouro. A Workday recomenda um valor de preenchimento de pelo menos 6. Se a sequência exceder o número de dígitos inseridos aqui, a configuração
    Comportamento para excesso de IDs de sequência
     determinará o próximo número na sequência. Quando você insere 0 ou não insere um valor no campo
    Preenchimento
     :
    • O número de sequência aumenta indefinidamente.
    • O Workday preenche
      o Comportamento de excesso de IDs de sequência
       com
      Ignorar preenchimento automaticamente
      .
    Formato de ID de sequência
    Especifique um formato para o identificador.
    Você pode usar qualquer cadeia de caracteres de texto com essas quatro variáveis especiais. Os valores relacionados à data representam a data em que a tarefa gera a ID.
    • [seq] - O número de sequência. Aumenta pelo valor especificado no campo
      Incrementar ID de sequência por
       , com o número de dígitos especificados no campo
      Preenchimento
       . O Workday usa uma sequência separada para cada definição de ID que usa essa variável.
    • [day] - dia do mês no formato de dois dígitos, 01 - 31.
    • [month] - mês no formato de dois dígitos, de 01 a 12.
    • [year] - Ano no formato de quatro dígitos. Exemplo: 2020.
    Se você definir o intervalo
    Frequência de reinicialização
     , certifique-se de que o número de sequência gerado seja exclusivo, incluindo o período específico no formato. Exemplo: se o período da
    Frequência de reinicialização
     for
    Mês
    , inclua
    [month]
     e
    [year]
     no formato. Certifique-se de que o valor de preenchimento seja grande o suficiente para que o gerador de sequências não encontre uma condição de estouro durante o período.
    Por exemplo, você pode definir o formato do nome de arquivo inserindo:
    • Uma constante de cadeia de caracteres.
    • Um padrão para a data e a hora
    • Um padrão de número de sequência.
    • A extensão do arquivo.
    O Workday pode gerar dinamicamente apenas valores de data e um número de sequência para uso no nome de arquivo. Todos os outros valores são estáticos; são idênticos para todos os arquivos gerados pela integração. Posicione o cursor sobre esse campo para ver a lista completa de geradores de sequências e padrões de data/hora válidos.
    Frequência de reinicialização
    (Opcional) Para redefinir o valor de [seq] como um valor inicial em intervalos regulares, especifique com que frequência o Workday redefine os números de sequência.
    As opções são
    Dia
    ,
    Mês
    ou
    Ano
    ; deixe o campo em branco se quiser que [seq] seja exclusivo dentro desta definição de ID. Os dias começam à 0h01. Os meses começam à 00h01 do primeiro dia desse mês. Os anos começam à 00h01 do dia 1º de janeiro.
    Reiniciar número
    (Opcional) Para redefinir o valor de [seq] como um valor inicial em intervalos regulares, especifique o número que o Workday deve usar quando reiniciar os números de sequência. Você pode usar esse campo com o campo
    Frequência de reinicialização
     .
    Uso do fuso horário
    Um fuso horário alternativo no qual se baseia o intervalo especificado no campo
    Frequência de reinicialização
     .
    Esse valor não indica quando a geração da ID realmente ocorre. O Workday o usa apenas para localizar a data no fuso horário especificado. Se você não especificar um fuso horário, o Workday usará o Horário padrão do Pacífico/Horário de verão do Pacífico (PST/PDT).
    Comportamento de excesso de IDs de sequência
    Configure como você quer que o Workday lide com possíveis condições de estouro. Durante o preenchimento do campo, considere:
    • Permitir estouro com sequências truncadas
       - O Workday trunca o dígito mais significativo do número de sequência quando ocorre uma condição de estouro. Exemplo: com um valor de
      Preenchimento
       igual a 3, o próximo número de sequência após 999 é 1000, mas o 1 fica truncado, portanto, o próximo valor é exibido como 000.
    • Ignorar preenchimento automaticamente
       - O gerador de sequências ignora o valor de
      Preenchimento
       quando ocorre uma condição de estouro. Exemplo: com um valor de
      Preenchimento
       igual a 3, o próximo número de sequência após 999 é 1000. Se o valor
      de Preenchimento
       é 0, o Workday seleciona automaticamente essa opção.
    Grupo de notificações de excesso de substituição de definição de locatário
    Especifique grupos de segurança para substituir o
    Grupo de notificações de excesso de definição de locatário por padrão
    . O Workday envia automaticamente uma notificação para os grupos de segurança de notificação de estouro quando a sequência se aproxima do limite imposto pelo valor de
    Preenchimento
     . Se você não seleciona grupos de segurança nesse campo, o Workday envia essas notificações de estouro para:
    • Os grupos de segurança que você seleciona no campo
      Grupo de notificação de gerador de sequências por padrão
       na tarefa
      Editar definição de locatário - Sistema
       .
    • Os grupos de segurança por padrão que o Workday especifica para notificações de excesso quando você não seleciona grupos de segurança de notificação de excesso por padrão na tarefa
      Editar definição de locatário - Sistema
       .
    Grupo de notificações de excesso de definição de locatário por padrão
    Exibe o
    grupo de notificações de excesso de definição de locatário por padrão
    . O Workday envia automaticamente uma notificação para os grupos de segurança de notificação de estouro quando a sequência se aproxima do limite imposto pelo valor de
    Preenchimento
     .
    Última sequência usada
    Define manualmente o último número de sequência. Essa opção é útil se:
    • Você já usou outro aplicativo de geração de IDs.
    • Você quer continuar de onde a ID terminou.
    Quando você define o número, o número de sequência inicial será seu número mais o valor
    Incrementar ID de sequência
     .
    Data do último uso
    Especifique essa data, mais um intervalo em
    Frequência de reinicialização
     para determinar se a data é anterior ou posterior ao último intervalo de reinicialização. O Workday então define o número de sequência com base na data.
    Baixo volume
    (Opcional) Selecione essa opção para garantir que as sequências geradas pelo gerador não tenham intervalos. Use essa opção quando você passar por estas duas situações:
    • Você não está usando a sequência em transações de alto volume.
    • Há intervalos indesejados na sequência gerada.
  10. Na seção
    Transporte
     , selecione e configure um protocolo de transporte:
    Transporte
    Observações
    Amazon Simple Storage Service
    Para transportes S3, adicione uma etiqueta ao seu usuário do IAM com uma chave do
    tipo workday
     e um valor de
    Integration
    . Essa etiqueta diferencia maiúsculas de minúsculas e não ignora espaços em branco.
    • Insira o nome do seu bucket do S3 no campo
      Bucket
       . Você não pode especificar uma pasta neste campo.
    • Insira um alias de chave para a criptografia do lado do cliente do AWS KMS.
    • A criptografia Pretty Good Privacy (PGP) não é configurável para EIBs que usam o Amazon Simple Storage.
    • Marque a caixa de seleção
      Habilitar aceleração de transferência
       para aumentar a velocidade de transferência.
    • Quando você seleciona uma opção na lista de opções
      Classe de armazenamento de objeto
       , não é necessário atualizar a classe de armazenamento manualmente no Amazon Simple Storage Service.
    Relatório personalizado
    • Todos os relatórios personalizados habilitados como serviço Web são exibidos na lista de
      opções Relatório personalizado
       .
    • Valor e tipo
      de valor
      :
      • Especifique o Valor
        . Insira o valor que você quer que o Workday use como critério de integração sempre que for executado.
      • Determinar valor em tempo de execução
        . Selecione o campo que você quer que o Workday use para determinar o valor sempre que for executado.
      • Usar valor por padrão do sistema
         usa o valor configurado na definição do Enterprise Interface.
    FTP
    • Insira o endereço usando este formato (quando você não especifica um número de porta, o Workday usa o valor por padrão):
      ftp://xxxx:port-number
      .
    • Esse protocolo de transporte requer que você criptografe o arquivo de saída selecionando um certificado de chave pública PGP na lista de opções
      Criptografar usando
       .
    • Os nomes de diretórios diferenciam maiúsculas de minúsculas. Inclua uma barra (/) à esquerda somente para um caminho completo, não um caminho relativo.
    • Marque a caixa de seleção
      Usar arquivo temporário
       para gravar a saída em um arquivo com nome aleatório. O Workday renomeia o arquivo com o nome correto quando conclui a transferência de dados. Essa opção evita que scripts automáticos recuperem o arquivo do servidor FTP antes da conclusão da transferência de dados.
    FTP/SSL
    • Use estes formatos:
      • SSL implícito:
        ftpsi://xxxx:port-number
      • SSL explícito:
        ftpse://xxxx:port-number
    • Quando você não especifica um número de porta, o Workday usa a porta 990 para SSL implícito e a porta 21 para SSL explícito.
    • Os nomes de diretórios diferenciam maiúsculas de minúsculas. Inclua uma barra (/) à esquerda somente para um caminho completo, não um caminho relativo.
    • Marque a caixa de seleção
      Usar arquivo temporário
       para gravar a saída em um arquivo com nome aleatório. O Workday renomeia o arquivo com o nome correto quando conclui a transferência de dados. Essa opção evita que scripts automáticos recuperem o arquivo do servidor FTP antes da conclusão da transferência de dados.
    REST
    Insira o nome do host ou o endereço do servidor neste formato:
    http://www.example.com/rest/
    .
    SFTP
    • Insira o endereço usando este formato (quando você não especifica um número de porta, o Workday usa o valor por padrão):
      sftp://xxxx:port-number
      .
    • Os nomes de diretórios diferenciam maiúsculas de minúsculas. Inclua uma barra (/) à esquerda somente para um caminho completo, não um caminho relativo.
    • Marque a caixa de seleção
      Usar arquivo temporário
       para gravar a saída em um arquivo com nome aleatório. O Workday renomeia o arquivo com o nome correto quando conclui a transferência de dados. Essa opção evita que scripts automáticos recuperem o arquivo do servidor FTP antes da conclusão da transferência de dados. Você também pode especificar uma
      Impressão digital da chave do host
       para indicar a chave de criptografia que o servidor FTP usa para comunicações SSH.
    • Defina o
      Tamanho do bloco
       como um tamanho de bloco com suporte no ponto de extremidade SFTP. Se não for especificado, o Workday usará
      32K
      . Aumentar o tamanho do bloco pode melhorar o desempenho da entrega. Se o ponto de extremidade não oferece suporte ao tamanho de bloco selecionado, a entrega da integração falha. A Workday recomenda enfaticamente que você teste o tamanho do bloco usando a funcionalidade Testar transporte. Depois de encontrar o tamanho de bloco ideal, atualize sua configuração de entrega de documentos para usar esse tamanho de bloco.
  11. (Obrigatório apenas para Transporte
    de relatório personalizado
     ) Na seção
    Opções de relatório
     , selecione o usuário cujas credenciais o Workday usa para executar o relatório personalizado.
    O Workday exibe a lista de opções
    Executar relatório(s) como usuário
     na seção
    Opções de relatório
     somente se você selecionou Relatório personalizado na etapa anterior.
  12. Na seção
    Utilitários de arquivo
     , especifique uma ou mais das seguintes opções:
    Opção Descrição
    Excluir após recuperação
    Se o Workday não conseguir excluir o arquivo do servidor S/FTP/S de origem, a recuperação do documento falhará.
    Descompactar
    Selecione essa opção para descompactar o arquivo recebido.
    Descriptografar usando
    (Somente FTP, FTP/SSL e SFTP) Se você quer descriptografar o arquivo carregado usando Pretty Good Privacy (PGP), selecione a chave privada PGP do par de chaves que você gerou para descriptografar o arquivo de integração de entrada.
    Quando você usa os protocolos FTP, FTP/SSL ou SFTP para criptografar um arquivo de integração de saída, você também pode:
    • Inclua uma verificação de integridade dos dados no arquivo.
    • Assine o arquivo digitalmente.
    Forçar verificação de integridade
    (Somente FTP, FTP/SSL e SFTP) Para verificar se o arquivo criptografado não foi alterado ou corrompido durante o transporte, marque essa caixa de seleção.
    Validação de assinatura digital usando
    (Somente FTP, FTP/SSL e SFTP) Para verificar a origem do arquivo de entrada criptografado, selecione uma chave pública PGP fornecida por seu parceiro comercial.
  13. (Opcional) Na seção
    Restrições de ambiente
     , na lista de
    opções Restrito a
     , selecione o ambiente de destino para esse protocolo de transporte.
    Se você deixa esse campo em branco, o Workday aplica o protocolo de transporte a cada ambiente em que a integração é executada. Cada ambiente (Produção, Sandbox, Implementação e assim por diante) pode ter apenas um protocolo de transporte. Para evitar carregar inadvertidamente dados de teste de ou para um ponto de extremidade que não seja de teste, a Workday recomenda enfaticamente que você:
    • Crie um transporte separado para cada ambiente.
    • Restrinja cada transporte ao ambiente pretendido.
Após a execução da integração, o Evento de processo de integração recuperará os arquivos selecionados de um servidor externo com base nestas instruções.