Valida direcciones

En esta guía de inicio rápido, se muestra cómo crear un programa que valida las direcciones empresariales almacenadas en la base de datos de SAP mediante la API de Address Validation a través de la edición SAP BTP del SDK de ABAP para Google Cloud.

Antes de comenzar

Antes de ejecutar esta guía de inicio rápido, asegúrate de que tú o tus administradores hayan completado los siguientes requisitos previos:

Crea una clase ABAP para validar direcciones

  1. Crea un paquete:

    1. En ADT, ve al Explorador de proyectos.
    2. Haz clic con el botón derecho en el paquete ZLOCAL y selecciona Nuevo > Paquete de ABAP.

    3. Ingresa los siguientes detalles para tu paquete:

      • Nombre: Ingresa ZABAPSDK_TEST.
      • Descripción: ingresa ABAP SDK Test Package.

    4. Haz clic en Siguiente.

    5. En el cuadro de diálogo Seleccionar una solicitud de transporte, selecciona la casilla de verificación Crear una solicitud nueva.

    6. Ingresa una descripción para la solicitud de transporte.

    7. Haz clic en Finish (Finalizar).

  2. Crea una clase ABAP para llamar a la API de Address Validation:

    1. Haz clic con el botón derecho en tu paquete ABAP y selecciona Nueva > Clase ABAP.

    2. Ingresa los siguientes detalles para tu clase ABAP:

      • Nombre: Ingresa ZGOOG_CL_QS_ADDRESS_VALIDATION.
      • Descripción: ingresa Quick start for Address Validation API.

    3. Haz clic en Siguiente.

    4. Selecciona una solicitud de transporte y haz clic en Finalizar.

  3. En el editor de código, reemplace el código predeterminado por el siguiente fragmento 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.

    Reemplaza DEMO_ADDR_VAL por el nombre de la clave de cliente.

  4. Guarda y activa los cambios.

  5. Ejecuta tu aplicación:

    1. Selecciona la clase de ABAP ZGOOG_CL_QS_ADDRESS_VALIDATION.
    2. Haz clic en Run > Run As > ABAP Application (Console). También puedes presionar F9. Si se ejecuta de forma correcta, se mostrará el siguiente resultado: 
      'Address is complete'

¿Qué sigue?