Ir para o conteúdo principal
Documentação
Documentação
Administrator Guide
Última atualização: 2024-12-13
Definir entrega de integração

Definir entrega de integração

Segurança: estes domínios na área funcional System:
  • Administração de processos de negócios
    .
  • Gerenciar: definições de processo de negócios
    .
Configure um processo de negócios que possa entregar um ou mais arquivos de integração para um local externo configurando uma etapa
de serviço
de entrega de documentos
 . A etapa descreve as opções de seleção, transporte e criptografia do arquivo de integração. Você pode adicionar essa etapa à definição de processo de negócios
Evento de processo de integração
 para o sistema de integração. Exemplo: como método de entrega em um EIB de saída. Como alternativa, você pode adicionar essa etapa a outro processo de negócios (como
Evento de liberação de pagamento
) que inclua um ou mais subprocessos de negócios
Evento de processo de integração
 . A opção que você seleciona depende de como você usa sua integração:
  • Evento de processo de integração
    : adicione a etapa aqui se:
    • A definição de negócios não faz parte de um processo de negócios maior.
    • A configuração de entrega (como o servidor de arquivos de destino) é exclusiva para esse sistema de integração.
    • Você quer ter acesso fácil à mensagem de erro de integração para este sistema de integração.
  • Processo de negócios principal (não integração): adicione a etapa aqui se o processo de negócios principal incluir vários
    Eventos de processo de integração
     que compartilham a configuração de entrega. Nesse caso, a etapa coleta todos os arquivos de saída de integração gerados pelos subprocessos de negócios. A etapa então os entrega ao mesmo destino como uma única ação.
  1. Acesse a definição de processo de negócios à qual você quer adicionar a etapa.
  2. Adicione uma etapa
    de serviço
    de entrega de documentos
     ao processo de negócios se a definição de processo de negócios ainda não tiver uma.
  3. Selecione
    Configurar entrega de documentos
    .
  4. Na seção
    Documento(s)
     , selecione a origem do documento que você quer entregar:
    Opção Descrição
    Deste processo de integração
    Fornece documento gerado pelo sistema de integração neste processo de negócios.
    Derivado usando
    Selecione um campo de relatório que especifique qual combinação de arquivos do sistema de integração ou de seu processo de negócios deve ser entregue. As opções são:
    • Documentos entregáveis
      : fornece documentos de saída marcados como
      entregues
       pelo sistema de integração.
    • Non-Deliverable Documents
      : fornece arquivos de comprovação, como relatórios ou arquivos de registro.
    • Documentos de saída
      : fornece todos os arquivos gerados pela integração.
  5. Na seção
    Filtro(s) de documento
     , especifique as etiquetas que o Workday deve usar para filtrar quando selecionar os documentos a serem entregues. As etiquetas disponíveis são específicas para o modelo de integração.
  6. Na seção
    Configurações de entrega
     , especifique a configuração de entrega:
    Opção Descrição
    Tentativas de entrega
    (Somente para protocolo de transporte SFTP) Especifique quantas vezes quer repetir a entrega de arquivos antes de interromper. O Workday ignora o valor
    de Tentativas de entrega
     para todos os outros protocolos de transporte.
    Para o protocolo de transporte HTTPS, o Workday executa até cinco tentativas automaticamente, com períodos de espera de três segundos cada, se o transporte encontra um código de resposta HTTP 302. Se o transporte encontra um código de resposta HTTP diferente de 302, o transporte não faz mais tentativas.
    Para o transporte do Google Cloud Storage (GCS):
    • Se o transporte encontra um código de resposta HTTP 5xx (exemplo: 503), o Workday tenta um mecanismo de repetição de retirada exponencial automaticamente. O Workday executa até cinco tentativas, com períodos de espera de 1, 2, 4, 8 e 16 segundos.
    • Se o Workday encontra um código de resposta HTTP diferente de 5xx durante a nova tentativa de retirada exponencial, ele muda automaticamente para o mecanismo de nova tentativa HTTP normal. Esse mecanismo consiste em até cinco tentativas com períodos de espera de três segundos cada.
    Transporte existente de
    Selecione um serviço de entrega de integração existente.
    Derivar transporte usando
    Especifique um campo de relatório que defina qual serviço de entrega de integração o Workday usa.
    Definir transporte explicitamente
    Selecione essa tarefa para definir o transporte nas seções
    Transporte
    ,
    Carga útil
    e
    Restrições de ambiente
     .
  7. Na seção
    Transporte
     , selecione e configure um protocolo de transporte:
    Protocolo de transporte
    Observações
    Amazon Simple Storage Service (S3)
    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 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.
    AS2
    Para especificar um número de porta, adicione-o ao final do URL no campo
    Ponto de extremidade AS2
     . Quando você não especifica um número de porta, o Workday usa o valor por padrão.
    E-mail
    • Separe vários endereços de e-mail com ponto e vírgula.
    • 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
       . Quando você não criptografa a saída, pode salvar o EIB, mas precisa da aprovação do administrador de segurança para executá-lo. Quando o administrador de segurança substitui esse requisito, você pode executar o EIB (Enterprise Interface Builder) um número ilimitado de vezes. Se você editar o EIB posteriormente, seu administrador de segurança deverá aprovar a substituição novamente.
    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, que o Workday renomeia com o nome correto quando a transferência de dados é concluída. 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, que o Workday renomeia com o nome correto quando a transferência de dados é concluída. Essa opção evita que scripts automáticos recuperem o arquivo do servidor FTP antes da conclusão da transferência de dados.
    Google Cloud Storage
    • Conecta-se a um bucket específico do Google Cloud Storage. O bucket já deve existir no Google Cloud Storage. Este transporte não pode gerenciar baldes.
    • Requer chave privada codificada com PEM para autenticação.
    O ponto de extremidade para esse protocolo é um serviço de armazenamento baseado em nuvem que não faz parte do serviço Workday. O uso que você faz dos produtos e serviços do Google está sujeito aos termos aplicáveis fornecidos pelo Google. A Workday recomenda que você se familiarize com o Acordo de nível de serviço (SLA) e os Termos de serviço do Google Cloud Storage.
    HTTPS
    • Para especificar um número de porta, adicione-o ao final do URL no campo
      Endereço HTTP
       . Quando você não especifica um número de porta, o Workday usa o valor por padrão.
    • Tipos de invocação de serviço Web:
      • Basic Auth
        : autenticação de acesso básico que codifica o nome de usuário e a senha.
      • Sem segurança
        : indica que você confia na conexão e que ela não precisa de segurança.
      • OAuth 2.0
        : autoriza o acesso usando tokens Bearer. Entre em contato com seu provedor de serviços OAuth para obter valores de token.
        Quando o
        token de acesso
         expira, o Workday usa os valores de
        ID do cliente
        ,
        chave secreta do cliente
        e
        token de atualização
         para acessar o
        URL do token de atualização
         e gerar um novo token de acesso. O Workday então usa o novo token de acesso para entregar os arquivos.
      • WS-Security User Id/Password
        : aplica segurança às mensagens de serviço Web por meio do protocolo Web Services Security.
    • Quando você usa um EIB de saída com HTTP e seleciona
      WS-Security User Id/Password
       ou
      No Security
      , considere:
      • Quando você configura uma transformação XSLT, ela deve agrupar a carga usando um envelope SOAP.
      • Quando você usa um relatório personalizado e a saída não é XML, adicione uma transformação XSLT para agrupar a carga usando um envelope SOAP.
    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, que o Workday renomeia com o nome correto quando a transferência de dados é concluída. 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.
  8. (Opcional) Para entregar o arquivo de saída em formato ZIP, marque a caixa de seleção
    Compactado
     .
  9. (Opcional) Para criptografar o arquivo de saída usando Pretty Good Privacy (PGP), selecione um certificado na
    lista de opções Criptografar usando
     e especifique os detalhes de criptografia na seção
    Carga
     :
    Opção Descrição
    ASCII Armored
    Para criptografar o arquivo de saída em caracteres ASCII para impressão, marque essa caixa de seleção.
    Contém verificação de integridade
    Para verificar se o arquivo criptografado não foi alterado ou corrompido durante o transporte, marque essa caixa de seleção.
    Nome do arquivo descriptografado
    Insira um nome para o arquivo de saída descriptografado. Se você deixa esse campo em branco, o nome do arquivo descriptografado corresponde ao nome do arquivo original.
    Compatível com PGP 26
    Para criar um arquivo de saída criptografado que ofereça suporte a chaves públicas geradas com o PGP versão 2.6 ou anterior, marque essa caixa de seleção.
    Modo de texto
    Para usar a criptografia PGP com modo de texto, marque essa caixa de seleção. A criptografia PGP com modo de texto deve incluir as terminações de linha CRLF.
  10. (Opcional) 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 pode ter apenas um protocolo de transporte. Para evitar o envio inadvertido de dados de teste de ou para um ponto de extremidade que não é 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
 entregará os arquivos de saída selecionados a um servidor externo com base nestas instruções.