Utilizzo del servizio Invoke nell’Editor di regole visive per i moduli basati su componenti core

L'editor di regole visive in un modulo adattivo supporta la funzionalità Richiama servizio, che consente di selezionare un servizio dall'elenco di modelli di dati modulo (FDM) configurati per l'istanza. Puoi mappare i campi modulo direttamente sui parametri di input del servizio. Per mappare i campi modulo ai parametri di output, utilizza l’opzione payload dell’evento per il servizio del modello dati modulo specificato. Inoltre, l'editor di regole visive consente di creare regole per i gestori di operazioni riuscite e non riuscite per le operazioni Richiama servizio in base alle relative risposte di output. I gestori di errori gestiscono l'esecuzione corretta dell'operazione Richiama servizio, mentre i gestori di errori risolvono gli errori che si verificano.

Vantaggi dell’utilizzo del servizio Invoke nell’editor di regole del modulo

Di seguito sono riportati alcuni vantaggi dell’utilizzo dell’operazione Invoke Service nell’editor di regole di un modulo Adobe:

Richiama i gestori del servizio per le risposte di esito positivo e negativo

L'editor di regole visive consente di creare regole per i gestori di operazioni riuscite e non riuscite per le operazioni Richiama servizio in base alle relative risposte di output. L'immagine seguente mostra il servizio Invoke nell'editor di regole visive per un modulo adattivo:

Per aggiungere un gestore operazioni riuscite o non riuscite, fare clic rispettivamente su Aggiungi gestore operazioni riuscite o Aggiungi gestore operazioni non riuscite.

Quando si fa clic su Aggiungi gestore operazioni riuscite, viene visualizzato l'editor di regole Richiama gestore operazioni riuscite del servizio, che consente di specificare regole o logica per gestire la risposta di output Richiama servizio quando l'operazione ha esito positivo. È possibile specificare regole anche senza definire condizioni; tuttavia, è possibile aggiungere condizioni per il gestore di operazione riuscita facendo clic sull'opzione Aggiungi condizione.

È possibile aggiungere più regole per gestire le risposte corrette per l'operazione Richiama servizio:

{width="50%,"}

Analogamente, è possibile aggiungere regole per gestire la risposta di output Invoke Service quando l'operazione non riesce. Nell'immagine seguente viene visualizzato l'editor di regole Richiama gestore errori servizio:

È inoltre possibile aggiungere più regole per gestire le risposte non riuscite dall'operazione Richiama servizio.

La funzionalità Abilita convalida errori sul server consente l'aggiunta di convalide da parte dell'autore durante la progettazione di un modulo adattivo da eseguire anche sul server.

Prerequisiti per l’utilizzo del servizio Invoke nell’editor di regole

Di seguito sono riportati i prerequisiti che è necessario soddisfare prima di utilizzare Invoke Service nell'editor di regole:

Esplorazione del servizio Invoke attraverso diversi casi d’uso

Il servizio Invoke dell'editor di regole visive ti consente di eseguire diverse operazioni utili. Puoi utilizzarlo per popolare le opzioni a discesa, impostare pannelli ripetibili o semplici e convalidare i campi del modulo, il tutto in base alla risposta di output del servizio Invoke. In questo modo, è possibile migliorare la flessibilità e l'interattività dei moduli.

La tabella seguente descrive alcuni scenari in cui è possibile utilizzare il servizio Invoke:

Creare un modulo Get Information che recuperi i valori in base all'input immesso nella casella di testo Pet ID. La schermata seguente mostra il modulo utilizzato in questi casi d’uso:

Campi modulo

Aggiungi i campi seguenti al modulo:

NOTE

Nel campo Associa riferimento della finestra di dialogo Proprietà dei campi modulo, seleziona e passa alla proprietà binaria aggiunta nel modello dati modulo.

Configurazione dei pannelli

Impostate i pannelli come ripetitivi con i seguenti vincoli:

È possibile regolare i valori dei pannelli ripetitivi in base alle proprie esigenze.

Origine dati

In questo esempio viene utilizzata l'API Swagger Petstore per configurare un'origine dati. Il Modello dati modulo è configurato per il servizio getPetById, che recupera i dettagli dell'animale domestico in base all'ID immesso.

Pubblichiamo il seguente JSON utilizzando il servizio addPet nell'API Swagger Petstore:

{
        "id": 101,
        "category": {
            "id": 1,
            "name": "Labrador"
        },
        "name": "Lisa",
        "photoUrls": [
            "https://example.com/photos/lisa1.jpg",
            "https://example.com/photos/lisa2.jpg"
        ],
        "tags": [
            {
                "id": 1,
                "name": "vaccinated"
            },
            {
                "id": 2,
                "name": "friendly"
            },
            {
                "id": 3,
                "name": "house-trained"
            }
        ],
        "status": "available"
    }

Le regole e la logica vengono implementate utilizzando l'azione Richiama servizio nell'editor delle regole nella casella di testo Pet ID per dimostrare i casi d'uso menzionati.

Esaminiamo ora in dettaglio l’implementazione di ogni caso d’uso.

Caso d’uso 1: popolare i valori a discesa utilizzando l’output del servizio di richiamo

Questo caso d'uso illustra come popolare dinamicamente le opzioni a discesa in base all'output di un Invoke Service.

Implementazione

Per ottenere questo risultato, creare una regola nella casella di testo Pet ID per richiamare il servizio getPetById. Nella regola, impostare la proprietà enum del menu a discesa photo-url su photoUrls in Aggiungi gestore di successo.

Output

Immettere 101 nella casella di testo Pet ID per popolare dinamicamente le opzioni del menu a discesa in base al valore immesso.

Caso d’uso 2: impostare un pannello ripetibile utilizzando l’output del servizio di richiamo

Questo caso d'uso illustra come popolare i pannelli ripetibili in modo dinamico in base all'output di un servizio Invoke.

Considerazioni

Implementazione

Creare una regola nella casella di testo Pet ID per richiamare il servizio getPetById. In Aggiungi gestore operazioni riuscite, aggiungi un'altra risposta del gestore operazioni riuscite. Impostare il valore del pannello tags su tags nella regola.

Output

Immettere 101 nella casella di testo Pet ID per popolare il pannello ripetibile in modo dinamico in base al valore di input.

Caso d’uso 3: impostare il pannello utilizzando l’output del servizio di richiamo

In questo caso d'uso viene illustrato come impostare in modo dinamico il valore di un pannello in base all'output di un servizio Invoke.

Considerazioni

Implementazione

Creare una regola nella casella di testo Pet ID per richiamare il servizio getPetById. In Aggiungi gestore operazioni riuscite, aggiungi un'altra risposta del gestore operazioni riuscite. Impostare il valore della casella di testo categoryname su category.name nella regola.

Output

Immettere 101 nella casella di testo Pet ID per popolare il pannello in modo dinamico in base al valore di input.

Caso d’uso 4: utilizzo del parametro di output del servizio Invoke per convalidare altri campi

Questo caso d'uso illustra come utilizzare l'output di un richiama servizio per convalidare dinamicamente altri campi modulo.

Implementazione

Creare una regola nella casella di testo Pet ID per richiamare il servizio getPetById. In Aggiungi gestore errori, aggiungere una risposta del gestore errori. Nascondi il pulsante Invia se viene immesso un Pet ID non corretto.

Output

Immettere 102 nella casella di testo Pet ID e il pulsante Invia è nascosto.

Domande frequenti

D: cosa succede se ho creato una regola utilizzando il servizio Invoke e quindi eseguo l'aggiornamento alla versione più recente dei componenti core?

A: Quando si esegue l'aggiornamento alla versione più recente dei componenti core, la regola Richiama servizio viene aggiornata automaticamente all'interfaccia utente più recente, in quanto è compatibile con le versioni precedenti.

Q: è possibile aggiungere più regole per gestire le risposte di esito positivo o negativo per l'operazione di richiamo del servizio?

A: Sì, è possibile aggiungere più regole per gestire le risposte di esito positivo o negativo per l'operazione Richiama servizio.

Articoli correlati

Risorse aggiuntive