Arquitetura do NowSDK

  • Versão de lançamento: Yokohama
  • Atualizado 30 de jan. de 2025
  • 4 min. de leitura

    • O NowSDK é a entidade de nível superior da estrutura de classe Mobile SDK.

    Ele contém várias classes, interfaces e funções que permitem aproveitar os recursos significativos fornecidos pela instância Mobile SDK e sua instância ServiceNow. Este documento se concentra na descrição dos principais serviços de recursos expostos no Mobile SDK que permitem que você interaja com sua instância ServiceNow.

    Para usar qualquer um dos serviços de recursos fornecidos pelo Mobile SDK, você precisa integrar a biblioteca do NowSDK ao seu código. Você deve chamar a biblioteca principal para configurar e inicializar o SDK antes de usar qualquer funcionalidade do SDK.

    O NowSDK fornece os seguintes recursos:

    • Inicialização do SDK e recuperação e configuração de configurações.
    • Manipulação contínua de autorização e sessão de usuário.
    • Interface de registro em log. O NowSDK fornece serviços de registro em log para todos os serviços do recurso. Por padrão, as mensagens de log são gravadas nos logs do sistema usando a funcionalidade específica da plataforma. Você pode controlar o limite de registro em log por meio de um parâmetro que faz parte da chamada para configurar o SDK. Há também uma opção para suprimir todas as mensagens de log geradas pelo SDK e seus serviços de recursos (nível de log = nenhum). Se você já tiver sua própria solução de registro em log, o Mobile SDK permitirá que você a use.
    • Criar e liberar a infraestrutura.
    O NowSDK fornece os seguintes serviços de recursos e APIs associadas:
    • NowDataSDK

      Permite que aplicações de terceiros acessem as REST APIs públicas expostas por sua instância ServiceNow. O desenvolvimento é simplificado porque o NowDataSDK utiliza os recursos de autenticação e manipulação de sessão fornecidos pelo NowSDK.

      • APIs primárias:
        • NowAPIService: esta API fornece uma funcionalidade que permite que você interaja com o REST APIs exposto publicamente em sua instância ServiceNow.
        • NowAttachmentService: esta API fornece funcionalidade para carregar e consultar anexos de arquivo em sua instância ServiceNow na aplicação Android.
        • NowGraphQLService: esta API fornece a funcionalidade que permite que você use consultas GraphQL para obter dados de tabelas em sua instância ServiceNow usando a ServiceNow REST GraphQL API.
        • NowTableService: esta API fornece a funcionalidade que permite executar operações de criação, leitura, atualização e exclusão (CRUD) em tabelas existentes em sua instância ServiceNow que são atendidas por meio da ServiceNow REST Table API.
    • Now Analytics

      Permite que você reúna e rastreie análises de uso em seus aplicativos para celular.

      • APIs primárias:
        • NowAnalytics: esta API fornece funcionalidade para coletar dados de análise do usuário e armazená-los na plataforma ServiceNow para análise e acompanhamento posteriores.
    • NowChat

      Permite que você incorpore uma janela de bate-papo nativa Virtual Agent em suas aplicações. Este serviço inclui recursos de IU/UX.

      • APIs primárias:
        • NowChatService: esta API fornece Virtual Agent e Atendente capacidades de bate-papo para suas aplicações Android. Aproveite os recursos de bate-papo de serviço completo fornecidos pela plataforma ServiceNow simplesmente implementando NowChatService em seu aplicativo.
    • NowPush

      Permite que você envie mensagens não solicitadas para suas aplicações que aproveitam a funcionalidade NowChat/Virtual Agent.

      • APIs primárias:
        • NowPushSDK: esta API fornece a função necessária para criar um NowPushService que permite o envio de notificações não solicitadas (push) para dispositivos Android.
        • NowPushService: esta API fornece funções que permitem a interação com o serviço de push.
    • NowWeb

      Permite que você carregue páginas da Web hospedadas em sua instância ServiceNow em uma exibição da Web nativa ou Cabrillo. Ela lida automaticamente com a autenticação de usuário e o gerenciamento de sessões em vez de forçar os usuários a fazer login na instância por meio de uma página da Web de login.

      Quando o webview é solicitado a carregar uma página da Web hospedada em uma instância ServiceNow, ele cria uma solicitação HTTP com o cabeçalho do portador apropriado que contém o token de acesso OAuth fornecido pelo NowSDK. Quando a instância recebe essa solicitação, ela inicia uma nova sessão de usuário e retorna cookies relacionados a essa sessão. Conforme o usuário interage com as páginas da Web no webview, a instância usa os cookies para validar que a sessão ainda é válida. Neste ponto, o cabeçalho do portador não é mais relevante, somente os cookies são usados para validação de sessão. A sessão da Web expira se o usuário parar de interagir com o site por mais tempo do que o período de tempo limite. Depois que a sessão expirar, se o usuário tentar interagir com a página da Web, ele será redirecionado automaticamente para a página de login. O NowWebViewController detecta o redirecionamento e tenta iniciar uma nova sessão da Web solicitando um token de acesso atualizado do NowSDK e usando o token para criar uma solicitação HTTP (com cabeçalho do portador) para a última página carregada conhecida.

      • APIs primárias:

        NowWebSDK: esta API fornece funcionalidade para criar um objeto de serviço NowWeb que permite que páginas da Web da sua instância ServiceNow sejam exibidas na aplicação Android.