Richiama le funzioni Cloud Run

Questa guida rapida mostra come chiamare una funzione che pubblica un messaggio costruito dagli argomenti ricevuti dalla funzione, utilizzando l'API Funzioni Cloud Run.

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 Cloud Functions sia abilitata nel tuo progetto Google Cloud.

    Vai alla libreria API

  • A seconda dell'ambiente in cui è ospitato il sistema SAP, configura l'autenticazione per richiamare le funzioni Cloud Run. Per istruzioni, consulta Autenticazione per richiamare le funzioni Cloud Run. Configura le chiavi client come segue:

    • Per accedere all'endpoint della funzione Cloud Run, crea una chiave client denominata DEMO-CF.
    • Per richiamare la funzione Cloud Run, crea una chiave client denominata DEMO-CF-INVOKER.

  • Nella console Google Cloud, scrivi una funzione HTTP di 2ª generazione, cf-gen2-hello-with-args, che pubblica un messaggio utilizzando gli argomenti forniti:

        exports.helloWorld = (req, res) => {
    let name = req.body.name || req.query.name;
    let full_name = `${req.body.firstname} ${req.body.lastname}`;
    res.status(200).send(`Hello ${name}! Full Name: ${full_name}`);
  };

    Per informazioni su come scrivere funzioni HTTP, consulta Scrivere funzioni Cloud Run.

Creare un programma per richiamare le funzioni Cloud Run

  1. Nel sistema SAP, crea un programma eseguibile nel tuo spazio dei nomi personalizzato (ad es. Z o Y) utilizzando la transazione SE38.

    1. In SAP GUI, inserisci il codice transazione SE38.

    2. Nel campo Programma, inserisci un nome per il programma. Ad esempio, ZDEMO_CLOUDFUNC_INVOKER.

    3. Fai clic su Crea.

    4. Specifica gli attributi del programma:

      1. Nel campo Title (Titolo), inserisci il titolo del programma, ad esempio Invoke Cloud Function using Cloud Function Invoker.

      2. Nel campo Tipo, scegli Executable Program.

      3. Fai clic su Salva.

    5. Salva il programma come Oggetto locale.

    6. Nell'editor ABAP, aggiungi il seguente 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.                                *
**********************************************************************
REPORT zr_qs_cfinvoker.

DATA(lv_cf_name)  = CONV string( 'cf-gen2-hello-with-args' ).
DATA(lv_msg)      = CONV string( '{"firstname": "John", "lastname" : "Doe"}' ).


TRY.
    " Create a Client API stub for Cloud Functions
    DATA(lo_cloudfunc_client) = NEW /goog/cl_cloudfunc_v2( iv_key_name   = 'DEMO_CF' ).
    " Create a Client API stub for Cloud Function Invoker.
    " Internally this uses the Cloud Function instance to fetch the cloud function HTTP endpoint
    DATA(lo_cfinvoker_client) = NEW /goog/cl_cloudfunc_invoker( iv_key_name   = 'DEMO_CF_INVOKER' ).

    " Send additional query parameters as inputs to the cloud function.
    lo_cfinvoker_client->add_common_qparam( iv_name  = 'name'
                                            iv_value = 'Johnny' ).

    lo_cfinvoker_client->invoke(
      EXPORTING
        iv_cf_name      = lv_cf_name            "Cloud Function Name
        iv_cf_location  = 'us-central1'         "Location where the Cloud Function is hosted
        io_cf_instance  = lo_cloudfunc_client   "Instance of cloud Function Client API Stub
        iv_body         = lv_msg                "Input payload to the Cloud Function
        iv_content_type = 'application/json'
        iv_method       = 'POST'
      IMPORTING
        es_output       = DATA(lv_output)
        ev_ret_code     = DATA(lv_ret_code)
        ev_err_text     = DATA(lv_err_text)
        es_err_resp     = DATA(ls_err_resp)
    ).

    IF lo_cfinvoker_client->is_success( iv_code = lv_ret_code ).
      WRITE: / 'HTTP Return Code:', lv_ret_code.
      WRITE: / 'Response:', lv_output. "Output of cloud function
    ELSE.
      WRITE: / 'HTTP Return Code:', lv_ret_code.
      WRITE: / 'Error:', lv_err_text.
    ENDIF.

  CATCH /goog/cx_sdk INTO DATA(lo_exp).
    WRITE: / lo_exp->get_text( ).
ENDTRY.

    Sostituisci quanto segue:

    • DEMO_CF: il nome della chiave client utilizzata per accedere all'endpoint della funzione Cloud Run.
    • DEMO_CF_INVOKER: il nome della chiave client utilizzata per richiamare la funzione Cloud Run.

  2. Esegui l'applicazione in SE38. Se l'operazione ha esito positivo, viene visualizzato il seguente output:

     HTTP Return Code:        200
 Response: Hello Johnny! Full Name: John Doe

Passaggi successivi