Instalar e configurar a aplicação com escopo Mobile SDK

Antes de gravar qualquer aplicação que aproveite o Mobile SDK, você deve instalar e configurar a aplicação com escopo Mobile SDK.

Antes de Iniciar

Função necessária: administrador

Procedimento

1. Navegue até a página [ Mobile SDK no site ServiceNow Store.
   Para obter detalhes, consulte Install a ServiceNow Store application.
2. Selecione Solicitar instalação para baixar a aplicação com escopo Mobile SDK em sua instância ServiceNow.
3. Verifique se a aplicação com escopo Mobile SDK foi instalada corretamente na sua instância ServiceNow.
   1. Abra o formulário do plug-in: Definição do sistema > Plug- ins.
   2. No campo de pesquisa, insira mobile_sdk.
      Uma tela semelhante à seguinte deve aparecer:

      
      
      
   3. Verifique se o ID do plug-in é sn_mobile_sdk e se a versão é a mais recente.
4. Abra a tabela Mobile SDK Configurações [sn_mobile_sdk] e crie um novo registro de aplicação para a aplicação que aproveitará o Mobile SDK.
   
   
   
   1. No campo Nome, insira o nome da sua aplicação que aproveitará o Mobile SDK.
   2. Nos campos ID do aplicativo Android e ID do pacote da Apple, insira o ID do seu aplicativo para celular.
      Por exemplo, se o Mobile SDK foi adicionado aos seus aplicativos para celular, esses IDs serão os IDs dos aplicativos para celular.
   3. No campo Configurações do SDK, insira as propriedades de configuração JSON para todos os serviços do recurso que sua aplicação aproveitará, definidas como verdadeiro.
      Por exemplo:

      {
          "graphql": {
              "enabled" : true,
                      "allowGuestAccess" : true
          },
          "table": {
              "enabled" : true,
                      "allowGuestAccess" : true
          },
          "api": {
              "enabled" : true,
                      "allowGuestAccess" : true
          },
          "attachment": {
              "enabled" : true,
                      "allowGuestAccess" : true
          },
          "chat": {
              "enabled" : true,
                      "allowGuestAccess" : true
          },
          "web": {
              "enabled" : true,
                      "allowGuestAccess" : true
          },
          "push": {
              "enabled" : true
          }
      }

      Certifique-se de que a caixa de seleção Avançado esteja desmarcada. Isso permite que você insira JSON no campo Configurações do SDK.

      
      
      

      Qualquer configuração aplicável adicionada nas Configurações do SDK é usada em conjunto com a configuração da instância ServiceNow.

      Por exemplo, se bate-papo: habilitado = verdadeiro, sua instância ServiceNow deve ter o plug-in Virtual Agent instalado para aproveitar a funcionalidade de bate-papo. Se o plug-in Virtual Agent estiver instalado, mas as configurações do SDK contiverem bate-papo: habilitado = falso, sua aplicação não poderá aproveitar a interface de bate-papo.

   4. Selecione Enviar para salvar as configurações da aplicação.
5. Opcional. Se você quiser que sua aplicação aproveite a Análise de experiência do usuário, registre sua aplicação com a aplicação Análise de experiência do usuário.
   1. Reabra o registro de Configurações Mobile SDK da sua aplicação.
   2. Na parte inferior esquerda da tela, selecione Registrar para análise.
      Uma tela semelhante à seguinte é exibida:

      
      
      
   3. Selecione Atualizar para salvar o registro.
6. Verifique as configurações do SDK.
   1. Navegue até o Explorador de REST API.
   2. Insira o seguinte nos campos especificados:
      • Namespace: sn_mobile_sdk
      • Nome da API: Mobile SDK
      • Versão da API: mais recente
   3. Selecione Obter configurações para o aplicativo Android (GET).
   4. No campo applicationID, insira o Android ID da aplicação que você inseriu no registro de configurações Mobile SDK associado e selecione Enviar.
      A resposta deve ser semelhante à seguinte:

      
      
      

      O corpo da resposta JSON deve ser semelhante ao seguinte:

      { 
        "platformVersion": "utah", 
        "enabled": true, 
        "analytics": { 
          "AnalyticsEnabled": true, 
          "AnalyticsEnabledForUnauthenticatedUser": false, 
          "EndpointUrl": "https://my-instance.servicenow.com.com", 
          "InstanceId": "db63a848db9f6091fd3467c8f4879524", 
          "ApiKey": "de742fc9db9f6090e03ad7c8f4961923:af0f36b91bc074109a9054a26032a6bf", 
          "ApiAuth": "11ab4240a6d5459c96d2bfb8e1aa3ddd", 
          "ConsentSettings": null, 
          "AppName": "TestNow App", 
          "AppType": "MobileSDK", 
          "ChannelType": "sdk", 
          "Configuration": {} 
        }, 
        "sdk": { 
          "graphql": { 
            "enabled": true 
          }, 
          "table": { 
            "enabled": true 
          }, 
          "api": { 
            "enabled": true 
          }, 
          "attachment": { 
            "enabled": true 
          }, 
          "chat": { 
            "enabled": true 
          }, 
          "web": { 
            "enabled": true 
          },
          "push": { 
            "enabled": true 
        } 
      }