Estensione di Google Cloud Functions

Richiama funzione Node.js

L'esempio seguente mostra un criterio ExtensionCallout che chiama un'estensione Google Cloud Functions. L'estensione chiama il nome predefinito "Hello World" inclusa quando abiliti l'API Cloud Functions.

Il seguente codice JavaScript Node.js è implementato in Cloud Functions per un account Google Cloud. Se la richiesta include una proprietà del messaggio, il codice lo restituisce. In caso contrario, restituisce "Hello World!". come risposta.

/**
 * Responds to any HTTP request.
 *
 * @param {!express:Request} req HTTP request context.
 * @param {!express:Response} res HTTP response context.
 */
exports.helloWorld = (req, res) => {
  let message = req.query.message || req.body.message || 'Hello World!';
  res.status(200).send(message);
};

Questo esempio include un'estensione di Google Cloud Functions configurata con le credenziali necessarie per l'autenticazione e l'autorizzazione a richiamare il codice su Cloud Functions.

Il codice della funzione precedente viene salvato in Cloud Functions semplicemente come helloWorld. Il seguente codice di configurazione del criterio ExtensionCallout utilizza questo nome, insieme ai valori dell'ID progetto e della regione corrispondenti ai dettagli dell'ambiente Cloud Functions in cui è stato eseguito il deployment della funzione.

<Action>invoke</Action>
<Input><![CDATA[
  {
    "region" : "us-central1",
    "projectId" : "my-project",
    "functionName" : "hello-world",
    "method" : "POST",
    "payload" : { "message" : "Hello yourself!" }
  }
]]></Input>
<Output parsed="false">function.response</Output>

Il seguente criterioAssignMessage acquisisce il valore della risposta a scopo di debug.

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<AssignMessage async="false" continueOnError="false" enabled="true" name="Get-Function-Response">
    <DisplayName>Get Function Response</DisplayName>
    <AssignTo type="response" createNew="false"/>
    <Set>
        <Payload contentType="application/json">{function.response}</Payload>
    </Set>
</AssignMessage>

La risposta alla richiesta precedente sarebbe la seguente:

Hello yourself!

Il valore predefinito di parsed è true. In questo esempio viene impostato parsed="false" nel tag <Output> del criterio, che impedisce al criterio di analizzare la risposta JSON. Nella maggior parte dei casi, quando utilizzi l'estensione Cloud Functions, devi impostare parsed="false". Vedi <Output> per ulteriori informazioni.

Se la funzione Cloud Functions restituisce una risposta JSON e imposti parsed="true", la risposta dell'estensione è un riferimento a un oggetto. Per estrarre la risposta dal riferimento, utilizza la seguente sintassi: {objectName}.{jsonKey}. Ad esempio:

function.response.message

Sintassi

<Action>invoke</Action>
<Input><![CDATA[
  {
    "region" : "deployment-region",
    "projectId" : "project-id",
    "functionName" : "function-name",
    "method" : "http-method",
    "payload" : { json-payload }
  }
]]></Input>
<Output>function.response</Output>

Esempio

<Action>invoke</Action>
<Input><![CDATA[
  {
    "region" : "us-central1",
    "projectId" : "my-project",
    "functionName" : "hello-world",
    "method" : "POST",
    "payload" : { "message" : "Hello yourself!" }
  }
]]></Input>
<Output>function.response</Output>