Criar definições de tarefa remota em Central de controle de serviços para provedores

  • Versão de lançamento: Yokohama
  • Atualizado 30 de jan. de 2025
  • 8 min. de leitura
  • Como um provedor, crie definições de tarefa remota que acionam a atribuição de uma tarefa remota.

    Antes de Iniciar

    Função necessária: administrador

    Procedimento

    1. Navegar até Tudo > Provedor da Central de controle de serviços > Administração > Definições de tarefa remota.
    2. Clique em Nova.
    3. No formulário, preencha os campos.
      Tabela 1. Formulário Definição de tarefa remota
      Campo Descrição
      Nome Nome do registro de definição de tarefa remota.
      Aplicação Este é um campo somente leitura e é definido por padrão com base no escopo da aplicação.
      Estado Mostra o status da definição de tarefa remota. Quando você cria uma definição de tarefa remota, este campo é definido para o estado Rascunho.
      Nota:
      Este campo é atualizado automaticamente quando você publica, arquiva ou desativa uma definição de tarefa remota.
      Tabela do provedor Qualquer tabela de tarefas selecionada na lista. Por exemplo, você pode escolher uma tabela de casos ou uma tabela de incidentes.
      Tabela do consumidor Qualquer tabela de tarefas selecionada na lista. Por exemplo, você pode escolher uma tabela de casos ou uma tabela de incidentes.
      Compatibilidade Este campo é preenchido por padrão. Ele mostra a versão Central de controle de serviços que está sendo usada pelo provedor. Se o consumidor estiver usando uma versão Central de controle de serviços compatível, os dados poderão ser sincronizados entre as instâncias do provedor e do consumidor. Mas se o consumidor não estiver usando uma versão compatível, nenhuma nova definição de tarefa remota poderá ser ativada até que a versão Central de controle de serviços correspondente seja atualizada.
      Manter SysID Se este campo estiver marcado, o identificador exclusivo, SysID, associado ao primário que criou a tarefa remota será usado e atribuído à tarefa primária criada para a tarefa remota na instância do consumidor.
      Enviar anexos Se estiver selecionado, se um anexo for adicionado ao registro primário, ele será enviado para a tarefa remota.
      Copiar anexo ao primário Se um anexo estiver incluído em uma tarefa remota, uma cópia será enviada para o registro primário.
      Descrição resumida Informações resumidas sobre esta definição de tarefa remota.
      Descrição Informações mais detalhadas sobre esta definição de tarefa remota.
    4. Clique em Enviar.
    5. Abra este novo registro de definição de tarefa remota.
    6. Na guia relacionada Campos de entrada, clique em Novo.
    7. No formulário, preencha os campos.
      Os campos de entrada permitem que você receba dados da instância do consumidor quando uma tarefa remota é criada ou atualizada.
      Nota:
      Se os valores do campo de entrada forem atualizados, as informações atualizadas serão mostradas em uma anotação de trabalho no registro primário.
      Tabela 2. Formulário de campo de entrada
      Campo Descrição
      Rótulo do campo Rótulo de campo que aparece no formulário de tarefa remota.
      Nome do campo Nome do campo usado no fluxo de tarefa remota e no script.
      Comprimento máximo Tamanho máximo do nome do campo de origem.
      Sincronizar quando Permite que você especifique quando um campo de destino no registro primário da tarefa remota é atualizado diretamente. Você pode selecionar:
      • Inserir: atualiza o campo de destino no registro primário da tarefa remota somente quando a tarefa remota é inserida inicialmente.
      • Inserir ou atualizar: atualiza o campo de destino no registro primário da tarefa remota sempre que a tarefa remota é atualizada.
      • Nunca: o campo de entrada nunca atualiza um campo de destino diretamente no registro primário da tarefa remota. Por exemplo, você pode usar este campo para mapeamento de estado em que um fluxo é usado para converter o valor de entrada antes de atualizar o campo de destino.
      Nota:
      Independentemente da opção selecionada aqui, sempre que um campo de entrada for atualizado, as mudanças serão refletidas em uma anotação de trabalho no registro primário.
      Guia Mapeamento de origem Esta guia não será exibida se você tiver marcado a caixa de seleção Virtual para definir um mapeamento de campo virtual.
      Tabela de origem (somente leitura) A tabela Consumidor que você selecionou ao criar a definição de tarefa remota.
      Campo de origem Campo da tabela de origem que é enviado para outra instância ServiceNow.

      Os campos de origem permitem referência com pontos para dados em tabelas relacionadas, o que é útil quando os dados de referência não estão disponíveis entre instâncias ServiceNow. Por exemplo, você pode criar vários mapeamentos de entrada para incidentes de mudança (ICs) para incluir o nome, a classe, o endereço IP e a etiqueta do ativo.

      Guia Mapeamento de destino Exibido somente nas seguintes condições:
      • Sincronizar quando: você seleciona Inserir ou Inserir ou atualizar.
      • Virtual: marque esta caixa de seleção para habilitar o mapeamento de campo virtual.
      Tabela de destino (somente leitura) A tabela do provedor que você selecionou ao criar a definição de tarefa remota.
      Campo de destino Campo da tabela de destino que é enviado para outra instância ServiceNow.
      Nota:
      Se você estiver definindo um mapeamento de campo virtual, o campo selecionado na tabela de destino não estará presente na tabela de origem.
      Ativo Este campo está habilitado por padrão.
      Virtual

      Marque esta caixa de seleção para habilitar o mapeamento do campo de entrada virtual. Um campo virtual é um campo que está presente na tabela de destino, mas não existe na tabela de origem.

      Quando uma tabela de origem não contém um campo que existe em uma tabela de destino, o campo é configurado como um campo virtual. Os valores especificados para o campo virtual são passados da instância de origem para a instância de destino. O consumidor pode criar uma tarefa remota para sincronizar dados e atualizar o valor do campo virtual no registro de tarefa de destino associado.

      O campo de destino pode ser atualizado usando a opção de entrada virtual descrita em Criar uma transformação em Central de controle de serviços ou usando a API updateVirtualField.

    8. Clique em Enviar.
    9. Na guia relacionada Campos de saída, clique em Novo.
    10. No formulário, preencha os campos.
      Os campos de saída permitem que você envie dados para a instância do consumidor quando uma tarefa remota é criada ou atualizada.
      Tabela 3. Formulário de campo de saída
      Campo Descrição
      Rótulo do campo Nome do rótulo do campo que aparece no formulário de tarefa remota.
      Nome do campo Nome do campo usado no fluxo de tarefa remota e no script.
      Comprimento máximo Tamanho máximo do nome do campo.
      Sincronizar quando sugestão Permite que você (o provedor) sugira ao consumidor quando um campo de destino no registro primário da tarefa remota deve ser atualizado diretamente. O consumidor pode mudar esta configuração antes de ativar a definição
      • Inserir: atualiza o campo de destino no registro primário da tarefa remota somente quando a tarefa remota é inserida inicialmente.
      • Inserir ou atualizar: atualiza o campo de destino no registro primário da tarefa remota sempre que a tarefa remota é atualizada.
      • Nunca: o campo de entrada nunca atualiza um campo de destino diretamente no registro primário da tarefa remota. Por exemplo, você pode usar este campo para mapeamento de estado em que um fluxo é usado para converter o valor de entrada antes de atualizar o campo de destino.
      Guia Mapeamento de origem Esta guia não será exibida se você tiver marcado a caixa de seleção Virtual para definir um mapeamento de campo virtual.
      Tabela de origem (somente leitura) A tabela do provedor que você selecionou ao criar a definição de tarefa remota.
      Campo de origem Campo da tabela de origem que é enviado para outra instância ServiceNow.

      Os campos de origem permitem referência com pontos para dados em tabelas relacionadas, o que é útil quando os dados de referência não estão disponíveis entre instâncias ServiceNow. Por exemplo, você pode criar vários mapeamentos de entrada para incidentes de mudança (ICs) para incluir o nome, a classe, o endereço IP e a etiqueta do ativo.

      Guia Mapeamento de destino Exibido somente nas seguintes condições:
      • Sincronizar quando: você seleciona Inserir ou Inserir ou atualizar.
      • Virtual: marque esta caixa de seleção para habilitar o mapeamento de campo virtual.
      Tabela de destino (somente leitura) A tabela Consumidor que você selecionou ao criar a definição de tarefa remota.
      Campo de destino Campo da tabela de destino que é enviado para outra instância ServiceNow.
      Nota:
      Se você estiver definindo um mapeamento de campo virtual, o campo selecionado na tabela de destino não estará presente na tabela de origem.
      Ativo Este campo está habilitado por padrão.
      Virtual

      Marque esta caixa de seleção para habilitar o mapeamento do campo de entrada virtual. Um campo virtual é um campo que está presente na tabela de destino, mas não existe na tabela de origem.

      Quando uma tabela de origem não contém um campo que existe em uma tabela de destino, o campo é configurado como um campo virtual. Os valores especificados para o campo virtual são passados da instância de origem para a instância de destino.

      O campo de destino pode ser atualizado usando a opção de saída virtual descrita em Criar uma transformação em Central de controle de serviços ou usando a API updateVirtualField.

    11. Clique em Enviar.
    12. Na guia relacionada Critérios do consumidor, clique em Novo.
    13. No formulário, preencha os campos.
      Os critérios do consumidor permitem que você gerencie quais consumidores podem usar essas definições de tarefa remota.
      Tabela 4. Formulário de critérios do consumidor
      Campo Descrição
      Condição do consumidor Empresa ou conta do cliente à qual você deseja que esta definição de tarefa remota seja atribuída.
      Definição de tarefa remota Nome deste registro de definição de tarefa remota. Este nome é preenchido automaticamente.

      Para obter mais detalhes sobre critérios do consumidor, consulte Criando direitos em Central de controle de serviços para provedores.

    14. Clique em Publicar.

      As variáveis de tarefa remota são criadas automaticamente quando você publica uma definição de tarefa remota. Essas variáveis são as variáveis de dados para os campos de entrada exibidos e podem ser acessadas nas tarefas remotas.

    Resultado

    Um registro de definição de tarefa remota é criado em sua instância. Este registro também está sincronizado com a instância do seu cliente e agora está com ativação pendente na instância do seu consumidor. Se o campo Ativar automaticamente a definição de tarefa remota tiver sido habilitado pelo consumidor, a definição de tarefa remota será ativada automaticamente na instância do consumidor.

    O que Fazer Depois

    Você pode criar várias revisões de configuração desta definição de tarefa remota publicada. Para obter detalhes sobre como criar uma revisão de configuração, consulte Criar revisões de configuração. Você também pode executar as seguintes operações: