Conexão com a plataforma

Introdução

O envio de eventos para a plataforma é realizado com o Tracking Component.

Este é responsável por realizar o rastreamento e o monitoramento das informações obtidas durante a execução das operações. Será possível acompanhar esses dados em tempo real na Plataforma, enquanto o processo está sendo executado no dispositivo do cliente.

Ao contrário do que acontece com o restante, este componente não funciona individualmente, ele atua de forma transversal aos demais componentes instalados na SDKMobile.

Na seção de Lançamento simplificado são detalhados os passos necessários para a integração básica do SDK. Nesta seção é adicionada a informação para o lançamento deste componente.

---

Dependência

A dependência específica do componente é:

implementation "com.facephi.androidsdk:tracking_component:$version"

---

Controladores disponíveis

Controlador	Descrição
TrackingController	Controlador principal de rastreamento
TrackingErrorController	Controlador para gerenciar os possíveis erros que ocorram
ExtraDataController	Controlador para obter o ExtraData que permite a comunicação do cliente com o servidor com SelphIDSdk instalado.

---

Lançamento simplificado

Deve-se incluir o controlador durante a inicialização do SDK.

SDKController.initSdk(
    ...
    trackingController = TrackingController(),
)

Controle de erros

Será possível configurar o callback para controlar os erros de tracking:

SDKController.launch(
     TrackingErrorController {
        Napier.d("Tracking Error: ${it.name} - ${it.error} - ${it.stepType}")
     }
)

Informações avançadas

Controladores adicionais

ExtraDataController

Este controlador (ExtraDataController) permite obter um identificador da operação atual. Esse dado será enviado ao backend onde serão realizadas as verificações pertinentes.

A chamada para obter o ExtraData, precisa das informações da operação em curso, o que obriga a que tenha sido realizado anteriormente um newOperation.

val result = SDKController.launch(
    ExtraDataController()
)
when (result) {
    is SdkResult.Success -> logs.add("ExtraData: OK")
    is SdkResult.Error -> logs.add(
        "ExtraData: KO - ${result.error.name}"
    )
}

Recepção de erros

Na parte do erro, teremos a classe TrackingError. A classe retornará 3 campos:

• name: String com o nome do erro

• error: Informação adicional no caso de ser necessária

• stepType: Componente do SDK no qual o envio do evento falhou

Lista de erros:

• APPLICATION_CONTEXT_ERROR: Erro na inicialização do contexto

• ASSET_LINK: Erro ao enviar o link do recurso

• ASSET_UPLOAD: Erro durante o carregamento do recurso

• COMPONENT_LICENSE_ERROR: Licença do componente ausente ou inválida

• CUSTOMER_ID: Erro ao obter ou validar o ID do cliente

• DEVICE_EVENT_ERROR: Falha durante um evento relacionado ao dispositivo

• EMPTY_LICENSE: Dados de licença vazios ou inexistentes

• FLOW: Erro durante o fluxo de execução

• INITIALIZATION_ERROR: Falha geral na inicialização

• INIT_IDS_ERROR: Erro ao gerar ou atribuir IDs durante a inicialização

• INIT_OPERATION: Operação falhou na fase de inicialização

• LICENSE_ERROR: Licença inválida ou corrompida

• MANAGER_NOT_INITIALIZED: Tentou-se usar o gerenciador sem inicializá-lo

• NETWORK_CONNECTION: Problema com a conexão de rede

• NETWORK_ERROR: Falha genérica de rede

• NO_OPERATION_CREATED_ERROR: Nenhuma operação foi criada quando se esperava

• OCR_DATA: Erro ao processar os dados de OCR

• OPERATION_NOT_CREATED: A operação esperada não foi gerada

• OPERATION_ID: ID da operação inválido ou ausente

• SESSION_ID: Erro na identificação da sessão

• SIGNATURE_RESULT: Falha no processo ou no resultado de assinatura

• STEP_CHANGE: Transição de etapa inesperada ou inválida

• STEP_RESULT_CANCELLED: A etapa foi cancelada de forma inesperada

• STEP_RESULT_ERROR: A etapa terminou com um erro

• STEP_RESULT_EXPIRED: O resultado da etapa expirou antes de ser concluído

• STEP_RESULT_SUCCEEDED: A etapa foi bem-sucedida, mas gerou um problema inesperado

• TOKEN_ERROR: Token ausente, expirado ou inválido

• ADVANCED_TRACKING_UPLOAD: Falha ao enviar os dados de rastreamento avançado

• TENANT_ID_EMPTY_ERROR: O ID do tenant estava vazio ou ausente

• ADVANCED_TRACKING_SERIALIZATION_ERROR: Erro ao serializar os dados de rastreamento avançado

• ADVANCED_TRACKING_VALIDATION_ERROR: Falha na validação dos dados de rastreamento

• TOKENIZER_ERROR: Erro durante o processo de tokenização