Ativar ou desativar a atualização automática de apps

  • Versão de lançamento: Yokohama
  • Atualizado 30 de jan. de 2025
  • 4 min. de leitura
  • Use a propriedade móvel clientRefresh em sua instância ServiceNow para ativar ou desativar a atualização automática de seus aplicativos para celular. Você também pode usar a propriedade clientRefresh para ajustar o escopo da atualização no seu aplicativo para celular.

    Antes de Iniciar

    Função necessária: administrador

    Por Que e Quando Desempenhar Esta Tarefa

    A propriedade móvel clientRefresh está habilitada por padrão no servidor da plataforma ServiceNow. Os aplicativos para celular gerenciados por San Diego e versões posteriores da instância do servidor são atualizados automaticamente depois que um usuário final executa itens de ação que mudam dados em registros. A mudança de dados fica imediatamente visível para o usuário. Os usuários não precisam atualizar seus aplicativos para celular. A imagem da Nova atualização não aparece mais para solicitar uma atualização do app quando este recurso está habilitado. Este recurso não causa nenhum impacto no desempenho do aplicativo para celular. Os aplicativos para celular atualizam somente as telas que foram visitadas anteriormente. Se você quiser desativar esse comportamento, use as etapas descritas nesta tarefa.

    As propriedades móveis são configuradas como registros na tabela sys_sg_properties no servidor da plataforma ServiceNow. A instância ServiceNow envia a propriedade móvel para aplicativos para celular após a autenticação. Em seguida, a propriedade ativa ou desativa um recurso no aplicativo para celular. A propriedade móvel clientRefresh é configurada usando scripts JSON.

    A propriedade clientRefresh é um objeto JSON com duas chaves: isEnabled e refreshScope, que são descritas no novo formulário de registro de propriedades móveis.
    Importante:
    A partir da versão San Diego do servidor ServiceNow, para desativar o comportamento de atualização, você deve criar um novo objeto JSON clientRefresh e definir a chave isEnabled como falsa na definição da propriedade móvel.

    Procedimento

    1. Navegar até Tudo > sys_sg_properties.list.
      A lista Propriedades móveis é exibida.
    2. Na lista Propriedades móveis, selecione Novo.
      O formulário Propriedades móveis é exibido.
    3. No formulário, preencha os campos.
      Tabela 1. Novo formulário de registro de propriedades móveis
      Campo Descrição
      Nome Nome do registro de propriedade móvel. Insira clientRefresh para tornar o recurso de atualização automática de apps configurável. Embora este recurso esteja ativado por padrão, você deve criá-lo para configurá-lo. Ele não fica visível na instância até que você o crie.
      Nota:
      O nome do registro faz distinção entre maiúsculas e minúsculas e deve ser inserido como clientRefresh.
      Aplicação Escopo da aplicação em que a propriedade móvel é aplicada. Para selecionar um escopo da aplicação diferente, selecione o ícone de globo ( Ícone de globo.) na faixa da instância. Em seguida, selecione Escopo da aplicação:application_scope.

      Para obter informações sobre como as propriedades móveis são afetadas pelo escopo da aplicação, consulte Propriedades móveis.

      Descrição Descrição da propriedade móvel. Insira uma descrição da propriedade. Por exemplo, Ativa ou desativa a atualização automática de dados da instância para aplicativos para celular.
      Tipo Tipo de dados do registro de propriedade móvel. Você deve selecionar JSON para a propriedade móvel clientRefresh.
      Valor O código JSON que configura este recurso.
      • Para desabilitar o recurso, insira o seguinte:
        {"isEnabled":false,"refreshScope":"all_tabs"}
      • Para habilitar o recurso, insira o seguinte:
        {"isEnabled":true,"refreshScope":"all_tabs"}
      • Para aumentar o escopo dos dados atualizados, insira o seguinte:
        {"isEnabled":true,"refreshScope":"all_tabs"}

        O uso de "all_tabs" atualiza todas as telas em todas as guias da barra de navegação depois que uma ação é executada no aplicativo para celular que muda os dados em um registro.

      • Para limitar o escopo dos dados atualizados, insira o seguinte:
        {"isEnabled":true,"refreshScope":"current_tab"}

        O uso de "current_tab" atualiza apenas a guia da barra de navegação atual depois que uma ação é executada no aplicativo para celular.

      Nota:
      Use um formatador/validador JSON para garantir que não haja problemas de sintaxe.
      Ativo Opção para ativar a propriedade móvel. Se a caixa de seleção estiver desmarcada, a propriedade móvel não estará ativada para uso.
      Configuração do aplicativo para celular Configuração do aplicativo para celular para a qual você deseja usar a propriedade móvel. Esta configuração limita o comportamento da propriedade móvel aos usuários que têm acesso a esta configuração do aplicativo para celular. Outros usuários não têm acesso a esta propriedade móvel e, em vez disso, experimentam o comportamento padrão.

      Para inserir um valor, comece a digitar o nome da configuração ou selecione o ícone de pesquisa. A caixa de diálogo de pesquisa lista as configurações que você pode escolher. Selecione uma configuração na caixa de diálogo Configurações do aplicativo para celular.

      Aplicativo para celular Aplicativo para celular para o qual você deseja enviar a propriedade móvel. Esta configuração limita o comportamento da propriedade móvel aos usuários que têm acesso a este aplicativo para celular. Outros usuários não têm acesso a esta propriedade móvel e, em vez disso, experimentam o comportamento padrão.

      Para inserir um valor, comece a digitar o nome da aplicação ou selecione o ícone de pesquisa. A caixa de diálogo de pesquisa lista as aplicações que você pode escolher. Selecione uma aplicação na caixa de diálogo Aplicações para celular.

    4. Selecione Enviar.

    O que Fazer Depois

    Depois de atualizar esta propriedade, o usuário final deve extrair para atualizar e obter as configurações de recurso mais recentes.