Criar definições de tarefa remota em Service Bridge para provedores
Como 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
- Navegar até Todos > Provedor do Service Bridge > Administração > Definições de tarefa remota.
- Clique em Nova.
-
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. 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. Enviar anexos Se esta opção for selecionada, 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 com uma tarefa remota, uma cópia será enviada para o registro primário. Descrição resumida Breve informação sobre esta definição de tarefa remota. Descrição Informações mais detalhadas sobre esta definição de tarefa remota. - Clique em Enviar.
- Abre este novo registro de definição de tarefa remota.
- Na guia relacionada Campos de entrada, clique em Novo.
-
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 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 pela primeira vez.
- 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 do 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 a 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 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 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 Criar uma transformação em Service Bridge ou usando a API updateVirtualField.
- Clique em Enviar.
- Na guia relacionada Campos de saída, clique em Novo.
-
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 pela primeira vez.
- 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 a 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 do 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 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 de saída virtual descrita em Criar uma transformação em Service Bridge ou usando a API updateVirtualField.
- Clique em Enviar.
- Na guia relacionada Critérios do consumidor, clique em Novo.
-
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 Service Bridge para provedores.
-
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.
Nota:- Clique em Desativar para desativar uma definição de tarefa remota que não seja mais necessária. As tarefas remotas existentes podem continuar a usar a definição de tarefa remota descontinuada, mas você não pode usá-la para criar novas tarefas remotas.
- Clique em Excluir para excluir uma definição de tarefa remota descontinuada se ela não for mais necessária.
- Para editar uma definição de tarefa remota publicada, clique em Editar. Modifique a definição de tarefa remota conforme necessário e clique em Publicar.
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.