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 :

    " --------------------------------------------------------------------
"  Copyright 2024 Google LLC                                         -
"                                                                    -
"  Licensed under the Apache License, Version 2.0 (the "License");   -
"  you may not use this file except in compliance with the License.  -
"  You may obtain a copy of the License at                           -
"      https://www.apache.org/licenses/LICENSE-2.0                   -
"  Unless required by applicable law or agreed to in writing,        -
"  software distributed under the License is distributed on an       -
"  "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND,      -
"  either express or implied.                                        -
"  See the License for the specific language governing permissions   -
"  and limitations under the License.                                -
" --------------------------------------------------------------------
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). " TODO: variable is assigned but never used (ABAP cleaner)
        " 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