Arquitetura do NowSDK

  • Versão de lançamento: Washingtondc
  • Atualizado 1 de fev. de 2024
  • 3 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 ServiceNow. Este documento se concentra em descrever os serviços de recurso primário expostos no Mobile SDK que permitem que você interaja com sua instância ServiceNow.

    Para usar qualquer um dos serviços de recurso 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.
    • Autorização contínua e manipulação de 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 em 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. Também há uma opção para suprimir todas as mensagens de log geradas pelo SDK e seus serviços de recurso (nível de log = nenhum). Se você já tem sua própria solução de registro em log, o Mobile SDK permite usá-la.
    • Crie e libere 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 pela sua instância ServiceNow. O desenvolvimento é simplificado porque o NowDataSDK utiliza os recursos de autenticação e manipulação de sessões fornecidos pelo NowSDK.

      • APIs primárias:
        • NowAPIService: esta API fornece funcionalidade que permite interagir com o exposto publicamente REST APIs em sua instância ServiceNow.
        • NowAttachmentService: esta API fornece funcionalidade para carregar e consultar anexos de arquivo na sua instância ServiceNowAndroid na aplicação [].
        • NowGraphQLService: esta API fornece funcionalidade que permite usar consultas GraphQL para obter dados de tabelas em sua instância ServiceNow usando a ServiceNow REST GraphQL API.
        • NowTableService: esta API fornece 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.
    • NowAnalytics

      Permite coletar e rastrear 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ê integre uma janela de bate-papo Virtual Agent nativa em suas aplicações. Este serviço inclui recursos de IU/UX.

      • APIs primárias:
        • NowChatService: esta API fornece recursos de bate-papo Virtual Agent e Atendente para suas aplicações Android. Aproveite as capacidades de bate-papo de serviço completo fornecidas pela plataforma ServiceNow simplesmente implementando o 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 (por push) para Android dispositivos.
        • NowPushService: esta API fornece funções que permitem a interação com o serviço de envio por push.
    • NowWeb

      Permite que você carregue páginas da Web hospedadas em sua instância ServiceNow em uma exibição nativa da Web ou no Cabrillo. Ele 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 os 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 da 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 em seu aplicativo Android.