Convalida gli indirizzi

Questa guida rapida mostra come creare un programma che convalidi gli indirizzi aziendali archiviati nel database SAP utilizzando l'API Address Validation tramite l'edizione SAP BTP dell'SDK ABAP per Google Cloud.

Prima di iniziare

Prima di eseguire questa guida rapida, assicurati che tu o i tuoi amministratori abbiate completato i seguenti prerequisiti:

  • Assicurati che l'API Address Validation sia abilitata nel tuo progetto Google Cloud.

    Vai alla libreria API

Crea una classe ABAP per convalidare gli indirizzi

  1. Crea un pacchetto:

    1. In ADT, vai a Project Explorer.
    2. Fai clic con il pulsante destro del mouse sul pacchetto ZLOCAL e seleziona Nuovo > Pacchetto ABAP.

    3. Inserisci i seguenti dettagli per il pacco:

      • Nome: inserisci ZABAPSDK_TEST.
      • Descrizione: inserisci ABAP SDK Test Package.

    4. Tocca Avanti.

    5. Nella finestra di dialogo Seleziona una richiesta di trasporto, seleziona la casella di controllo Crea una nuova richiesta.

    6. Inserisci una descrizione per la richiesta di trasporto.

    7. Fai clic su Fine.

  2. Crea una classe ABAP per chiamare l'API Address Validation:

    1. Fai clic con il pulsante destro del mouse sul pacchetto ABAP e seleziona Nuovo > Classe ABAP.

    2. Inserisci i seguenti dettagli per il tuo corso ABAP:

      • Nome: inserisci ZGOOG_CL_QS_ADDRESS_VALIDATION.
      • Descrizione: inserisci Quick start for Address Validation API.

    3. Tocca Avanti.

    4. Seleziona una richiesta di trasporto e fai clic su Fine.

  3. Nell'editor di codice, sostituisci il codice predefinito con il seguente snippet di codice:

    " --------------------------------------------------------------------
"  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.

    Sostituisci DEMO_ADDR_VAL con il nome della chiave client.

  4. Salva e attiva le modifiche.

  5. Esegui l'applicazione:

    1. Seleziona la classe ABAP ZGOOG_CL_QS_ADDRESS_VALIDATION.
    2. Fai clic su Esegui > Esegui come > Applicazione ABAP (console). In alternativa, premi F9. In caso di esito positivo, viene visualizzato il seguente output: 
      'Address is complete'

Passaggi successivi