Validar endereços

Neste guia de início rápido, mostramos como criar um programa que valida endereços comerciais armazenados no banco de dados SAP usando a API Address Validation, por meio da edição SAP BTP do SDK ABAP para o Google. Cloud.

Antes de começar

Antes de executar este guia de início rápido, verifique se você ou seus administradores concluíram os seguintes pré-requisitos:

Você tem uma conta e um projeto do Google Cloud.
O faturamento está ativado para o projeto. Veja como confirmar se o faturamento está ativado para o projeto.
A edição SAP BTP do ABAP SDK for Google Cloud está instalada e configurada. Confira como instalar e configurar a edição SAP BTP do ABAP SDK for Google Cloud.
A autenticação para acessar as APIs do Google Cloud está configurada. Saiba como configurar a autenticação.
Você tem acesso ao ambiente SAP BTP e ABAP.
Você fez o download e instalou a versão mais recente do ABAP Development Tools (ADT) na plataforma mais recente do Eclipse.
Você criou um projeto do Cloud ABAP.

Verifique se a API Address Validation está ativada no seu projeto do Google Cloud.

Acessar a biblioteca de APIs

Criar uma classe ABAP para validar endereços

Criar um pacote:

Observação: se você já tem um pacote, pode usar o atual. Ignorar etapa 1.
1. No ADT, acesse o Project Explorer.
2. Clique com o botão direito do mouse no pacote ZLOCAL e selecione New > ABAP Package.
3. Insira os seguintes detalhes do pacote:
  - Nome: insira ZABAPSDK_TEST.
  - Descrição: insira ABAP SDK Test Package.
4. Clique em Próxima.
5. Na caixa de diálogo Selecione uma solicitação de transporte, marque a caixa de seleção Criar uma nova solicitação.
6. Insira uma descrição para a solicitação de transporte.
7. Clique em Finish.
Crie uma classe ABAP para chamar a API Address Validation:
1. Clique com o botão direito do mouse no pacote ABAP e selecione Nova > Classe ABAP.
2. Digite os seguintes detalhes da sua classe ABAP:
  - Nome: insira ZGOOG_CL_QS_ADDRESS_VALIDATION.
  - Descrição: insira Quick start for Address Validation API.
3. Clique em Próxima.
4. Selecione uma solicitação de transporte e clique em Concluir.

No editor de código, substitua o código padrão pelo seguinte snippet de código:

 CLASS zcl_qs_validate_address DEFINITION
 PUBLIC FINAL
 CREATE PUBLIC.

 PUBLIC SECTION.
   INTERFACES if_oo_adt_classrun.
 ENDCLASS.

 CLASS zcl_qs_validate_address IMPLEMENTATION.
  METHOD if_oo_adt_classrun~main.

   DATA ls_input             TYPE /goog/cl_addrvaldn_v1=>ty_012.
   DATA lo_address_validator TYPE REF TO /goog/cl_addrvaldn_v1.

   TRY.
       " Open HTTP connection
       lo_address_validator = NEW #( iv_key_name = 'DEMO_ADDR_VAL' ).

       " Pass the address to be validated
       ls_input-address-region_code = 'US'.
       ls_input-address-locality    = 'Mountain View'.
       APPEND '1600, Amphitheatre, Parkway' TO ls_input-address-address_lines.

       " Call the API Method to validate address
       lo_address_validator->validate_address( EXPORTING is_input    = ls_input
                                               IMPORTING es_output   = DATA(ls_output)
                                                         ev_ret_code = DATA(lv_ret_code)
                                                         ev_err_text = DATA(lv_err_text)
                                                         es_err_resp = DATA(ls_err_resp) ).

       IF     lo_address_validator->is_success( lv_ret_code ) = abap_true
          AND ls_output-result-verdict-address_complete       = abap_true.
         out->write( 'Address is complete' ).
       ENDIF.

     CATCH /goog/cx_sdk INTO DATA(lo_exception).
       " Handle exception here
   ENDTRY.
  ENDMETHOD.
 ENDCLASS.

Substitua DEMO_ADDR_VAL pelo nome da chave do cliente.

Salve e ative as alterações.
Execute o aplicativo:
1. Selecione a classe ABAP ZGOOG_CL_QS_ADDRESS_VALIDATION.
2. Clique em Run > Run As > ABAP Application (Console). Ou pressione F9. Depois de finalizado, a saída a seguir será exibida:
```
'Address is complete'
```

A seguir

Leia o guia Desenvolvimento de aplicativos com a edição SAP BTP do ABAP SDK for Google Cloud.
Faça suas perguntas e discuta o ABAP SDK for Google Cloud com a comunidade nos Fóruns do Cloud.