Registrar registros associados no cache off-line

  • Versão de lançamento: Xanadu
  • Atualizado 1 de ago. de 2024
  • 2 min. de leitura
  • Os administradores podem configurar o modo off-line para incluir registros associados no cache off-line quando um usuário executa uma ação no modo on-line em seu Mobile Agent.

    Antes de Iniciar

    Função necessária: admin

    Por Que e Quando Desempenhar Esta Tarefa

    Quando sua instância ServiceNow tiver o modo off-line habilitado, você poderá configurar a instância para incluir registros adicionais no cache off-line. Esses registros adicionais estarão disponíveis quando o usuário final estiver no modo off-line.

    Importante:
    Este recurso é compatível somente com ações de write-back com script.

    Você deve configurar um item de ação antes de usar as etapas a seguir para registrar registros associados no cache off-line. Consulte Configurar itens de ação e etapas de ação no modo off-line para obter informações sobre como configurar um item de ação.

    Você deve usar scripts para configurar esta tarefa, o que requer o uso de uma API.

    Procedimento

    1. Navegar até Todos > Sistema Móvel > Construtor de apps para celular.
      O Construtor de apps para celular abre em uma nova guia do navegador e exibe a tela de seleção do escopo da aplicação.
    2. Pesquise o escopo da aplicação em que você está trabalhando e selecione o nome do escopo da aplicação.
      A tela inicial de Construtor de apps para celular categorias é exibida.
    3. Selecione Todos os registros móveis no menu.
    4. No campo Tipo de registro, selecione Item de ação [sys_sg_write_back_action_item]e selecione o item de ação que você criou.
    5. No campo Tipo, selecione Script.
    6. No campo Script de execução, adicione o script de sincronização.
      Por exemplo, o script a seguir cria automaticamente uma tarefa de ordem de serviço quando uma ordem de serviço é criada enquanto o usuário final está on-line. Em seguida, a tarefa de ordem de serviço fica disponível para o usuário final quando ele está no modo off-line:
      (function WriteBackAction(input) {
          //Register additional record for offline mode
          actionResult.addRecordForSync("work-order-task","ef1a8b34df113100dca6a5f59bf26327")
      })(input);
      Em que "work-order-task" é a tabela a ser incluída na seção de dados do documento da resposta de write-back e "ef1a8b34df113100dca6a5f59bf26327" é o sys_id na tabela.
      Nota:
      • Esta API pode ser chamada várias vezes para registrar vários registros em tabelas diferentes ou na mesma tabela.
      • Para especificar o registro que você deseja incluir no banco de dados off-line, use o nome da tabela (cadeia de caracteres) e o sys_id (cadeia de caracteres) do registro.
      • O registro especificado por sys_id e seus campos associados aparecem na seção de dados do documento da resposta de write-back.
      • O registro especificado por sys_id é então sincronizado com o banco de dados off-line.
      • Os dados adicionados com esta API devem ser encapsulados no documento atualizado ou no documento de destino da resposta de write-back. Para garantir que pelo menos um documento atualizado ou de destino esteja presente em sua resposta de write-back, você pode configurar uma tela de destino no botão que invoca essa API. Quando você configura uma tela de destino no botão que invoca essa API, é garantido que seus dados serão incluídos no documento de destino.
    7. Selecione Salvar.