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

Antes de escrever 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 em 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 a 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 Apple, insira o ID do seu aplicativo para celular.
      Por exemplo, se o Mobile SDK foi adicionado aos seus aplicativos para celular, esses IDs seriam 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 de recursos que sua aplicação aproveitará, defina 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 o 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 da experiência do usuário, registre-a na aplicação Análise da 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 do aplicativo para Android (GET).
   4. No campo applicationID, insira a Android ID da aplicação que você inseriu no registro associado de Mobile SDK Configurações e selecione Enviar.
      A resposta deve ser semelhante a esta:

      
      
      

      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 
        } 
      }