Registre registros associados no cache off-line

  • Versão de lançamento: Zurich
  • Atualizado 31 de jul. de 2025
  • 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 no Mobile Agent.

    Antes de Iniciar

    Função necessária: administrador

    Por Que e Quando Desempenhar Esta Tarefa

    . ServiceNow a instância tem o modo off-line habilitado. você pode configurar a instância para incluir registros adicionais no cache off-line. Em seguida, esses registros adicionais ficam disponíveis quando o usuário final está 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 Configure 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é Tudo > Sistema Móvel > Construtor de apps para celular.
      . 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.
      . Construtor de apps para celular a tela inicial de categorias é exibida.
    3. Selecione Todos os registros móveis no menu.
    4. Em Tipo de registro campo, selecione Item de ação [sys_sg_write_back_action_item] e selecione o item de ação que você criou.
    5. Em Tipo campo, selecione Script .
    6. Em 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 estará disponível para o usuário final quando ele estiver no modo off-line:
      (function WriteBackAction(input) {
          //Register additional record for offline mode
          actionResult.addRecordForSync("work-order-task","ef1a8b34df113100dca6a5f59bf26327")
      })(input);
      Onde "tarefa-ordem-de-serviço" é a tabela a ser incluída na seção de dados do documento da resposta de write-back e "ef1a8b34df113100dca6a5f59bf26327" 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 é sincronizado com o banco de dados off-line.
      • Os dados que você adiciona 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 esta API. Quando você configura uma tela de destino no botão que invoca esta API, seus dados são garantidos para serem incluídos no documento de destino.
    7. Selecione Save (Salvar).