Valider des adresses

Ce guide de démarrage rapide explique comment créer un programme qui valide les adresses professionnelles stockées dans la base de données SAP à l'aide de l'API Adress Validation, via l'édition SAP BTP du SDK ABAP pour Google Cloud.

Avant de commencer

Avant d'exécuter ce guide de démarrage rapide, assurez-vous que vous ou vos administrateurs avez rempli les conditions préalables suivantes :

Créer une classe ABAP pour valider les adresses

  1. Créer un package :

    1. Dans ADT, accédez à l'explorateur de projets.
    2. Effectuez un clic droit sur le package ZLOCAL, puis sélectionnez Nouveau > Package ABAP.

    3. Saisissez les informations suivantes pour votre package :

      • Nom : saisissez ZABAPSDK_TEST.
      • Description : saisissez ABAP SDK Test Package.

    4. Cliquez sur Suivant.

    5. Dans la boîte de dialogue Sélectionner une requête de transport, cochez la case Créer une requête.

    6. Saisissez une description pour la requête de transport.

    7. Cliquez sur Terminer.

  2. Créez une classe ABAP pour appeler l'API Address Validation :

    1. Effectuez un clic droit sur votre package ABAP, puis sélectionnez Nouveau > Classe ABAP.

    2. Saisissez les informations suivantes pour votre classe ABAP :

      • Nom : saisissez ZGOOG_CL_QS_ADDRESS_VALIDATION.
      • Description : saisissez Quick start for Address Validation API.

    3. Cliquez sur Suivant.

    4. Sélectionnez une demande de transport, puis cliquez sur Terminer.

  3. Dans l'éditeur de code, remplacez le code par défaut par l'extrait de code suivant :

     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.

    Remplacez DEMO_ADDR_VAL par le nom de la clé client.

  4. Enregistrez et activez les modifications.

  5. Exécuter votre application :

    1. Sélectionnez la classe ABAP ZGOOG_CL_QS_ADDRESS_VALIDATION.
    2. Cliquez sur Exécuter > Exécuter en tant que > Application ABAP (console). Vous pouvez également appuyer sur F9. Si l'opération réussit, le résultat suivant s'affiche : 
      'Address is complete'

Étapes suivantes