Extração de dados OCR
Extrair dados automaticamente de uma grande variedade de documentos emitidos pelo governo para preencher seus formulários adaptáveis.
Há várias organizações que fornecem esse serviço e, desde que tenham APIs REST bem documentadas, é possível integrar facilmente ao AEM Forms usando o recurso de integração de dados. Para fins deste tutorial, usei o ID Analyzer para demonstrar a extração de dados de OCR dos documentos carregados.
As etapas a seguir foram seguidas para implementar a extração de dados de OCR com o AEM Forms usando o serviço do Analisador de ID.
Criar conta de desenvolvedor
Crie uma conta de desenvolvedor com o Analisador de ID. Anote a chave de API. Essa chave é necessária para chamar as APIs REST do serviço do Analisador de ID.
Criar arquivo Swagger/OpenAPI
A Especificação de OpenAPI (antiga Especificação do Swagger) é um formato de descrição de API para APIs REST. Um arquivo OpenAPI permite descrever toda a API, incluindo:
- Pontos de extremidade disponíveis (https://experienceleague.adobe.com/users?lang=pt-BR) e operações em cada ponto de extremidade (GET /users, POST /users)
- Parâmetros de operação Entrada e saída para cada operação
Métodos de autenticação - Informações de contato, licença, termos de uso e outras informações.
- As especificações da API podem ser escritas em YAML ou JSON. O formato é fácil de aprender e legível tanto para seres humanos quanto para máquinas.
Para criar seu primeiro arquivo swagger/OpenAPI, siga a documentação sobre OpenAPI
Use o editor do swagger para criar seu arquivo do swagger e descrever as operações que enviam e verificam o código OTP enviado por SMS. O arquivo swagger pode ser criado no formato JSON ou YAML. O arquivo Swagger completo pode ser baixado de aqui
Considerações ao definir o arquivo swagger
- As definições são obrigatórias
- $ref precisa ser usado para definições de método
- Preferir ter consume produz seções definidas
- Não defina parâmetros de corpo de solicitação em linha ou parâmetros de resposta. Tente modular o máximo possível. Por exemplo, a definição a seguir não é suportada
"name": "body",
"in": "body",
"required": false,
"schema": {
"type": "object",
"properties": {
"Rollnum": {
"type": "string",
"description": "Rollnum"
}
}
}
O seguinte é suportado com uma referência à definição requestBody
"name": "requestBody",
"in": "body",
"required": false,
"schema": {
"$ref": "#/definitions/requestBody"
}
Criar Source de dados
Para integrar o AEM/AEM Forms com aplicativos de terceiros, precisamos criar a fonte de dados na configuração dos serviços em nuvem. Use o arquivo swagger para criar sua fonte de dados.
Criar modelo de dados do formulário
A integração de dados do AEM Forms fornece uma interface de usuário intuitiva para criar e trabalhar com modelos de dados de formulário. Baseie o modelo de dados do formulário na fonte de dados criada na etapa anterior.
Criar biblioteca do cliente
Precisaríamos obter a string codificada em base64 do documento carregado. Essa string codificada em base64 é passada como um dos parâmetros de nossa invocação REST.
A biblioteca do cliente pode ser baixada daqui.
Criar formulário adaptável
Integre as invocações POST do Modelo de dados de formulário ao seu formulário adaptável para extrair dados do documento carregado pelo usuário no formulário. Você pode criar seu próprio formulário adaptável e usar a invocação POST do modelo de dados de formulário para enviar a cadeia de caracteres codificada base64 do documento carregado.
Implantar no servidor
Se quiser usar os ativos de amostra com sua chave de API, siga as seguintes etapas:
- Baixe a fonte de dados e importe para a AEM usando o gerenciador de pacotes
- Baixe o modelo de dados de formulário e importe para o AEM usando o gerenciador de pacotes
- Baixar a biblioteca do cliente
- Baixe o formulário adaptável de exemplo pode ser baixado daqui. Este formulário de amostra usa as invocações de serviço do modelo de dados de formulário fornecido como parte deste artigo.
- Importar o formulário para o AEM da Forms e da Interface do Usuário do Documento
- Abrir o formulário no modo de edição nto.
- Especifique sua Chave de API como o valor padrão no campo apikey e salve as alterações
- Abra o editor de regras para o campo String Base 64. Observe a invocação do serviço quando o valor desse campo for alterado.
- Salve o formulário
- Visualize o formulário, carregue a imagem frontal da sua licença de motorista