Crie uma definição de tarefa remota em Central de controle de serviços Para provedores

  • Versão de lançamento: Zurich
  • Atualizado 31 de jul. de 2025
  • 9 min. de leitura

    • Como provedor, crie definições de tarefa remota (RTD) que acionam a atribuição de uma tarefa remota.

    Antes de Iniciar

    Função necessária: administrador

    Por Que e Quando Desempenhar Esta Tarefa

    Antes de criar uma tarefa remota, você deve primeiro criar um RTD. Uma tarefa remota é gerada com base no RTD que você define. Para saber mais sobre como o RTD e a tarefa remota funcionam, consulte Tarefas remotas.

    Procedimento

    1. Navegar até Tudo > Provedor da Central de controle de serviços > Administração > Definições de tarefa remota.
    2. Selecione Novo.
    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 da tarefa remota. Quando você cria uma definição de tarefa remota, este campo é definido como Rascunho estado.
      Nota:
      Este campo é atualizado automaticamente quando você publica, arquiva ou desativa uma definição de tarefa remota.
      Tabela do provedor Qualquer tabela de tarefas que você selecionar na lista. Por exemplo, você pode escolher uma tabela de caso ou uma tabela de incidente.
      Tabela do consumidor Qualquer tabela de tarefas que você selecionar na lista. Por exemplo, você pode escolher uma tabela de caso ou uma tabela de incidente.
      Compatibilidade Este campo é preenchido por padrão. Ele mostra o. Central de controle de serviços versão que está sendo usada pelo provedor. Se o consumidor estiver usando um compatível Central de controle de serviços, os dados podem ser sincronizados entre as instâncias do provedor e do consumidor. Mas se o consumidor não estiver usando uma versão compatível, as novas definições de tarefa remota não poderão ser ativadas até o correspondente Central de controle de serviços a versão foi atualizada.
      Enviar anexos Se esta caixa de seleção estiver marcada, se um anexo for adicionado ao registro primário, ele será enviado para a tarefa remota.
      Descrição resumida Breves informações sobre esta definição de tarefa remota.
      Descrição Informações mais detalhadas sobre esta definição de tarefa remota.
    4. Selecione Enviar.
    5. Abra este novo registro de definição de tarefa remota.
    6. Em Campos de entrada guia relacionado, selecione Novo .
      A partir de Central de controle de serviços versão 2,2.x, um registro de campo de saída é criado com os campos de origem e destino definidos como comentários. Este registro habilita mapeamentos comentário a comentário para seu RTD.
    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 do campo que aparece no formulário de tarefa remota.
      Nome do campo Nome do campo usado no fluxo de tarefas remotas 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 no registro primário da tarefa remota diretamente. 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 é atualizado, as mudanças sã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 selecionado Virtual caixa de seleção 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 outro ServiceNow instância.

      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 ServiceNow instâncias. 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 Provedor que você selecionou ao criar a definição de tarefa remota.
      Campo de destino Campo da tabela de destino que é enviado para outro ServiceNow instância.
      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 de 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 Crie uma transformação em Central de controle de serviços ou usando UpdateVirtualField API.
    8. Clique em Enviar.
    9. Em Campos de saída guia relacionado, clique em Novo .
      A partir de Central de controle de serviços versão 2,2.x, um registro de campo de saída é criado com os campos de origem e destino definidos como comentários. Este registro habilita mapeamentos comentário a comentário para seu RTD.
    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 tarefas remotas 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 essa 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 no registro primário da tarefa remota diretamente. 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.
      Sincronizar entradas pré-existentes Opção para habilitar a sincronização de todos os comentários existentes com a tarefa de destino quando uma conexão é estabelecida. Se habilitado, todos os comentários feitos antes da conexão serão incluídos no processo de sincronização quando uma tarefa remota for criada.
      Nota:
      Este recurso está disponível em Central de controle de serviços versão 2,2.x.
      Guia Mapeamento de origem Esta guia não será exibida se você tiver selecionado Virtual caixa de seleção para definir um mapeamento de campo virtual.
      Tabela de origem (somente leitura) A tabela Provedor que você selecionou ao criar a definição de tarefa remota.
      Campo de origem Campo da tabela de origem que é enviado para outro ServiceNow instância.

      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 ServiceNow instâncias. 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.

      Nota:
      De Central de controle de serviços versão 2,2.x, você pode criar
      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 outro ServiceNow instância.
      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 de 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 Saída virtual descrita em Crie uma transformação em Central de controle de serviços ou usando API updateVirtualField .
    11. Clique em Enviar.
    12. Em Critérios do consumidor guia relacionado, clique em Novo .
    13. No formulário, preencha os campos.
      Os critérios do consumidor permitem gerenciar quais consumidores podem usar essas definições de tarefa remota.
      Tabela 4. Formulário Critérios do consumidor
      Campo Descrição
      Condição do consumidor Conta ou empresa do cliente à qual você deseja que esta definição de tarefa remota tenha direito.
      Definição de tarefa remota Nome deste registro de definição de tarefa remota. Este nome é preenchido automaticamente.

      Para obter mais detalhes sobre os 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 dos 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 é sincronizado com a instância do seu cliente e agora está com ativação pendente na instância do seu consumidor. . Definição de tarefa remota de ativação automática o campo foi habilitado pelo consumidor, a definição de tarefa remota é 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: