Skip to main content

Criar e configurar trabalhos

Objetivos de aprendizagem

Após concluir esta unidade, você estará apto a:

  • Listar três tarefas que você pode executar com o módulo Trabalhos.
  • Criar um trabalho.
  • Atribuir recursos a um trabalho.
  • Adicionar uma etapa de trabalho a um ou mais fluxos.
  • Criar um parâmetro global.

Introdução

Agora que Linda entende sobre trabalhos e sabe sobre etapas de trabalho do sistema e personalizadas, é hora dela criar e configurar um trabalho. Ela precisa de acesso ao módulo Trabalhos do Business Manager para fazer isso. O módulo Trabalhos permite que ela crie e agende trabalhos, configure notificações por e-mail para falhas de trabalho e use recursos de trabalho para evitar conflitos.

Para acessar o Business Manager, você tem de ter uma implementação do B2C Commerce. Neste módulo, pressupomos que você seja um administrador do B2C Commerce com as devidas autorizações para executar essas tarefas. Se você não for um administrador do B2C Commerce, tudo bem. Continue lendo para saber como seu administrador executaria essas etapas em uma instância de preparação. Não tente seguir nossas etapas em seu Trailhead Playground. O B2C Commerce não está disponível no Trailhead Playground. Se você tem uma instância de preparação do B2C Commerce, pode experimentar essas etapas em sua instância. Se você não tem uma instância de preparação, pergunte ao seu gerente se existe alguma que possa usar.

Criar o trabalho

Linda cria um trabalho para importar um catálogo conforme descrito a seguir.

  1. Abra o Business Manager.
  2. Selecione Administração > Operações > Trabalhos.
  3. Clique em New Job (Novo trabalho) (1).

Página de Trabalhos do Business Manager

  1. Digite cloudkicks-catálogo-dados como a ID (1) e Dados de catálogo para a Cloud Kicks como a Descrição (2).
  2. Clique em Create (Criar) (3).

Página Novo trabalho de Trabalhos no Business Manager

  1. Clique na guia Planificação e histórico.
  2. Selecione Habilitado para executar o trabalho conforme um agendamento. Se o trabalho não estiver habilitado, você ainda pode acioná-lo manualmente.
  3. Selecione Uma vez para acionar o trabalho para executar uma vez ou selecione Intervalo recorrente.
  4. Para trabalhos que você deseja executar em um intervalo recorrente, use o ícone de calendário para selecionar uma data no passado. Se você não agendar uma data no passado, você tem que esperar a data que especificou para o trabalho ser executado. Você também pode selecionar um dia da semana, uma hora, um intervalo e o número de vezes que o trabalho deve ser executado.

Bloquear recursos

Linda pode bloquear um recurso para evitar que outro usuário ou trabalho altere este recurso enquanto seu trabalho opera nele. Por exemplo, enquanto ela atualiza seu catálogo, ela não quer que outros trabalhos ou usuários atualizem ou alterem o catálogo, as categorias ou os produtos. Vejamos como ela faz o bloqueio.

  1. Clique na guia Recursos (1).
  2. Clique em Selecionar (2).
  3. Selecione Recurso do sistema (3).
  4. Adicione os objetos que o trabalho altera ou atualiza como recursos (por exemplo, pedido).
  5. Clique em Selecionar (4).

Página de Recursos do trabalho

Adicionar a etapa de trabalho a um fluxo

Linda quer adicionar etapas de trabalho.

  1. Em um novo trabalho, clique na guia Etapas de trabalho. Um fluxo vazio já está configurado. Este primeiro fluxo é representado na página Etapas de trabalho como um retângulo cinza (1). Guia Etapas de trabalho com um fluxo de trabalho
  2. Clique em Configurar uma etapa para criar uma nova etapa no fluxo.
  3. No painel Selecionar e configurar etapa, escolha a etapa de trabalho do sistema ou personalizada que deseja adicionar ao fluxo. Linda seleciona ImportCatalog.
  4. Especifique os parâmetros da etapa de trabalho. Cada etapa de trabalho tem seus próprios parâmetros exclusivos. Passe o mouse sobre um nome de parâmetro para obter mais informações sobre o parâmetro. Aqui estão os parâmetros para a etapa de trabalho ImportCatalog em nosso exemplo.
    1. Digite uma ID de etapa única.
    2. Adicione uma descrição. Ela é visível no fluxo de trabalho e no trabalho.
    3. Especifique a pasta de trabalho. Ela contém os arquivos de catálogo que você deseja importar em relação a IMPEX/src. Se você não definir esse valor, o B2C Commerce usará IMPEX/src como pasta de trabalho.
    4. Digite o FileNamePattern. Este é o nome do arquivo que você quer importar. Use uma expressão regular (regex) para especificar vários arquivos. Se você não definir esse valor, o Salesforce B2C Commerce importa todos os arquivos na pasta de trabalho.
    5. Especifique NoFilesFoundHandling, para o que acontece se o B2C Commerce não encontrar nenhum arquivo para importar.
    6. Especifique ImportFailedHandling, para o que acontece se a importação falhar.
    7. Especifique AfterImportFileHandling, para o que acontece com o(s) arquivo(s) após a importação.
    8. Especifique a ArchiveFolder. Se estiver definida como Arquivo ou Arquivo compactado, esta configuração define onde o B2C Commerce armazena arquivos relativos ao diretório IMPEX. Se não for definida, o B2C Commerce arquiva os arquivos em IMPEX/archive.
    9. Selecione o modo de importação:
      • Excluir: exclui o objeto.
      • Mesclar: cria o objeto se ele não existir e, em seguida, faz uma atualização.
      • Substituir: recria o objeto com os dados fornecidos.
      • Atualizar: atualiza um objeto existente.
    1. Selecione Sempre executar na reinicialização se quiser que o B2C Commerce reinicie o trabalho se este falhar. Esta etapa deve ser sempre incluída na execução, mesmo que o B2C Commerce complete o trabalho antes da reinicialização.
    2. Especifique Tratamento de erros para como o sistema deve responder a erros de trabalho.
  1. Para Escopo, deixe o valor padrão de Organização. A etapa de trabalho ImportCatalog deve ser executada com um escopo de Organização.

Adicionar um novo fluxo

Quando Linda cria um trabalho, já existe um fluxo configurado para ela. Ela pode adicionar todas as suas etapas de trabalho a esse fluxo. Ela também pode criar até quatro fluxos irmãos, que o Business Manager representa lado a lado na guia Etapas de trabalho. Ela pode configurar os fluxos irmãos para serem executados sequencialmente ou em paralelo.

No entanto, como você aprendeu anteriormente, se não houver recursos suficientes para execução paralela ou se um tipo de etapa não suportar uma execução paralela, o B2C Commerce executa os fluxos irmãos sequencialmente.

O gráfico a seguir mostra as opções de fluxo na guia Trabalhos.

  1. Adicione um fluxo irmão.
  2. Alterne entre o processamento sequencial e paralelo dos fluxos irmãos.
  3. Adicione um novo fluxo sequencial

Opções de fluxo na guia Etapas de trabalho

Definir configurações de solução de problemas

Linda quer definir as configurações de solução de problemas para ajudar a isolar problemas. Ela segue as etapas a seguir.

  1. Clique na guia Tratamento de falhas e selecione uma regra de falha. O B2C Commerce invoca a regra se uma etapa de trabalho usar Tratamento de erros no ERRO e especificar Ação de tratamento de erros como INTERROMPER.
  2. Clique na guia Notificação se quiser ser notificado sobre o status de um trabalho.
    1. Selecione Habilitado.
    2. Selecione sobre quais eventos você quer receber notificações.
    3. Insira as informações de e-mail necessárias.
    4. Selecione Habilitado em Detecção de tempo de execução longo e digite o limite de tempo de execução.

Executar um trabalho manualmente

Linda recebe, às vezes, uma solicitação de um trabalho importante/emergencial ou precisa executar um trabalho manualmente ao solucionar problemas. Acompanhe-a nesse processo.

  1. Abra o Business Manager.
  2. Selecione Administração > Operações > Trabalhos.
  3. Selecione o trabalho que deseja executar.
  4. Clique em Executar agora.
  5. Examine a seção de histórico na parte inferior da página para ver se há erros ou problemas com o trabalho.
  6. Você também pode selecionar Administração > Operações > Histórico do trabalho para monitorar o status dos trabalhos.

Criar um parâmetro de trabalho

Linda pode criar um parâmetro de trabalho para usar em diferentes etapas de trabalho. Por exemplo, ela pode criar um parâmetro para ReplicationProcessID e configurá-lo para a ID de um processo de replicação específico. Ela pode usar o parâmetro em diferentes etapas de trabalho. Se ela precisar usar um processo de replicação diferente, ela pode alterar o valor do parâmetro e o B2C Commerce atualiza todas as etapas que incluem o parâmetro.

Depois que ela configura um parâmetro de trabalho, ela pode reutilizá-lo apenas para parâmetros de etapa que são definidos exatamente da mesma maneira que o parâmetro original.

Exemplos:

  • Linda cria um parâmetro de trabalho para um parâmetro de etapa que requer um valor booleano de verdadeiro/falso. Ela não pode usá-lo para um parâmetro de etapa que requer sequências de caracteres.
  • Duas etapas têm um parâmetro de sequência de caracteres FileName com uma restrição de padrão *.xml. Ela pode definir um parâmetro de trabalho para ambas as etapas.
  • Uma etapa tem um parâmetro de sequência de caracteres FileName com uma restrição de padrão .xml e outra etapa tem um parâmetro de sequência de caracteres FileName com uma restrição de padrão .txt. Ela não pode definir um parâmetro de trabalho para usar em ambas as etapas.

Se você quiser definir etapas de trabalho personalizadas com o mesmo parâmetro de trabalho, os parâmetros da etapa devem ter definições de tipo idênticas no arquivo steptypes.json. Em outras palavras, todos os atributos do parâmetro devem ser definidos de forma idêntica. Por exemplo, Linda não pode usar o mesmo parâmetro de trabalho para definir os dois parâmetros de etapa personalizados a seguir, porque o atributo @type para MyParameter1 é "long" e o atributo @type para MyParameter2 é "double".

{
 "@name":"MyParameter1",
 "@type":"long",
 "@required":"false",
 "description":"An optional long parameter. The default value is 10 when not defined.",
 "default-value":"10"
},
 "@name":"MyParameter2",
 "@type":"double",
 "@required":"true",
 "@trim":"true",
 "description":"A required double parameter were the raw
  value is trimmed, value must be between -10 and +10.",
 "min-value":"-10",
 "Max-value":"10"
},

Criar um parâmetro de trabalho

Linda quer criar um parâmetro de trabalho. Acompanhe-a nesse processo.

  1. Crie uma etapa de trabalho ou selecione uma já existente.
  2. Clique no campo para o qual você quer criar um parâmetro.
  3. Clique em Parâmetros de trabalho.
  4. Clique em Adicionar parâmetro de trabalho.
  5. Insira um nome exclusivo para o parâmetro.
  6. Insira o valor para o parâmetro.
  7. Clique em Salvar.
  8. Clique em Atribuir.
  9. Para usar o parâmetro em outra etapa de trabalho:
    1. Clique no campo para o qual você quer usar o parâmetro.
    2. Clique em Parâmetros de trabalho.
    3. Selecione o parâmetro a ser usado.
    4. Clique em Atribuir.

Modificar um parâmetro de trabalho

Para modificar um parâmetro de trabalho:

  1. Selecione Parâmetros de trabalho na guia Etapas de trabalho.
  2. Selecione o parâmetro que você quer alterar e insira o novo valor.
  3. Clique em Salvar.

Próximas etapas

Nesta unidade Linda aprendeu a agendar, criar e configurar trabalhos. Em seguida, ela vai aprender como se recuperar de falhas no trabalho.

Recursos

Compartilhe seu feedback do Trailhead usando a Ajuda do Salesforce.

Queremos saber sobre sua experiência com o Trailhead. Agora você pode acessar o novo formulário de feedback, a qualquer momento, no site Ajuda do Salesforce.

Saiba mais Continue compartilhando feedback