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.
Criar uma classe ABAP para validar endereços
Criar um pacote:
- No ADT, acesse o Project Explorer.
- Clique com o botão direito do mouse no pacote
ZLOCAL
e selecione New > ABAP Package. Insira os seguintes detalhes do pacote:
- Nome: insira
ZABAPSDK_TEST
. - Descrição: insira
ABAP SDK Test Package
.
- Nome: insira
Clique em Próxima.
Na caixa de diálogo Selecione uma solicitação de transporte, marque a caixa de seleção Criar uma nova solicitação.
Insira uma descrição para a solicitação de transporte.
Clique em Finish.
Crie uma classe ABAP para chamar a API Address Validation:
- Clique com o botão direito do mouse no pacote ABAP e selecione Nova > Classe ABAP.
Digite os seguintes detalhes da sua classe ABAP:
- Nome: insira
ZGOOG_CL_QS_ADDRESS_VALIDATION
. - Descrição: insira
Quick start for Address Validation API
.
- Nome: insira
Clique em Próxima.
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:
- Selecione a classe ABAP
ZGOOG_CL_QS_ADDRESS_VALIDATION
. - Clique em Run > Run As > ABAP Application (Console).
Ou pressione
F9
. Depois de finalizado, a saída a seguir será exibida:'Address is complete'
- Selecione a classe ABAP
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.