Tutorial: applicare regole ai campi del modulo adattivo tutorial-apply-rules-to-adaptive-form-fields

06-apply-rules-to-adaptive-form_main

Questo tutorial è un passaggio del Creare il primo modulo adattivo serie. L’Adobe consiglia di seguire la serie in sequenza cronologica per comprendere, eseguire e dimostrare il caso di utilizzo completo dell’esercitazione.

Informazioni sull’esercitazione about-the-tutorial

È possibile utilizzare le regole per aggiungere interattività, logica di business e convalide intelligenti a un modulo adattivo. I moduli adattivi hanno un editor di regole integrato. L’editor di regole fornisce una funzionalità di trascinamento della selezione, simile alle visite guidate. Il metodo di trascinamento della selezione è il metodo più rapido e semplice per creare regole. L’editor di regole fornisce anche una finestra di codice per gli utenti interessati a testare le loro abilità di codifica o a portare le regole a un livello successivo.

Per ulteriori informazioni sull’editor delle regole, consulta Editor regole di Forms adattivo.

Entro la fine dell’esercitazione imparerai a creare regole per:

  • Richiama un servizio Modello dati modulo per recuperare i dati dal database
  • Richiama un servizio Modello dati modulo per aggiungere dati al database
  • Eseguire un controllo delle convalide e visualizzare i messaggi di errore

Le immagini GIF interattive alla fine di ogni sezione dell'esercitazione consentono di apprendere e convalidare al volo la funzionalità del modulo che si sta creando.

Passaggio 1: recuperare un record cliente dal database retrieve-customer-record

È stato creato un modello dati modulo seguendo la crea modello dati modulo articolo. Ora è possibile utilizzare l'editor di regole per richiamare i servizi Forms Data Model per recuperare e aggiungere informazioni al database.

A ogni cliente viene assegnato un numero ID cliente univoco, che consente di identificare i dati rilevanti del cliente in un database. La procedura seguente utilizza l’ID cliente per recuperare informazioni dal database:

  1. Apri il modulo adattivo per la modifica.

    http://localhost:4502/editor.html/content/forms/af/change-billing-shipping-address.html

  2. Seleziona la ID cliente e selezionare il Modifica regole icona. Viene visualizzata la finestra Editor regole.

  3. Seleziona la + Crea per aggiungere una regola. Viene aperto l'Editor visivo.

    Nell'editor visivo, il QUANDO è selezionata per impostazione predefinita. Inoltre, l'oggetto modulo (in questo caso, ID cliente) da dove hai avviato l'editor di regole è specificato in QUANDO dichiarazione.

  4. Seleziona la Seleziona stato a discesa e selezionare è stato modificato.

    quando customeridischanged

  5. In THEN istruzione, seleziona Richiama servizio dal Seleziona azione a discesa.

  6. Seleziona la Recupera indirizzo di spedizione servizio da Seleziona a discesa.

  7. Trascina la selezione ID cliente dalla scheda Oggetti modulo al campo Rilascia l'oggetto o seleziona qui campo in INPUT casella.

    dropobjectstoinputfield-recuperedata

  8. Trascina la selezione ID cliente, nome, indirizzo di spedizione, stato e CAP dalla scheda Oggetti modulo al campo Rilascia l'oggetto o seleziona qui campo in OUTPUT casella.

    dropobjectstooutputfield-recuperedata

    Seleziona Fine per salvare la regola. Nella finestra dell’editor delle regole, seleziona Chiudi.

  9. Visualizza l’anteprima del modulo adattivo. Immetti un ID in ID cliente campo. Il modulo ora può recuperare i dettagli del cliente dal database.

    retrieve-information

Passaggio 2: aggiungere l'indirizzo del cliente aggiornato al database updated-customer-address

Dopo aver recuperato i dettagli del cliente dal database, puoi aggiornare l’indirizzo di spedizione, lo stato e il codice postale. La procedura seguente richiama un servizio del modello dati modulo per aggiornare le informazioni sul cliente nel database:

  1. Seleziona la Invia e selezionare il Modifica regole icona. Viene visualizzata la finestra Editor regole.

  2. Seleziona la Submit - Click e seleziona la Modifica icona. Vengono visualizzate le opzioni per modificare la regola di invio.

    submit-rule

    Nell’opzione WHEN, il comando Invia e ha fatto clic su opzioni già selezionate.

    invio su cui si fa clic

  3. In THEN , seleziona l'opzione + Aggiungi istruzione opzione. Seleziona Richiama servizio dal Seleziona azione a discesa.

  4. Seleziona la Aggiorna indirizzo di spedizione servizio da Seleziona a discesa.

    update-shipping-address

    dropobjectstoinputfield-updatedata

  5. Trascina la selezione Indirizzo di spedizione, stato e CAP campo da Oggetti modulo al corrispondente nome di tabella .property (ad esempio, customerdetails .shippingAddress) del Rilascia l'oggetto o seleziona qui campo in INPUT casella. Tutti i campi con prefisso tablename (ad esempio, customerdetails in this use case) fungono da dati di input per il servizio di aggiornamento. Tutto il contenuto fornito in questi campi viene aggiornato nell’origine dati.

    note note
    NOTE
    Non trascinare Nome e ID cliente campi corrispondenti a tablename.property (ad esempio, customerdetails.name). Consente di evitare di aggiornare il nome e l’ID del cliente per errore.
  6. Trascina la selezione ID cliente campo da Oggetti modulo scheda al campo id nella sezione INPUT casella. I campi senza un nome di tabella preceduto (ad esempio, customerdetails in questo caso d’uso) fungono da parametro di ricerca per il servizio di aggiornamento. Il id in questo caso d’uso identifica in modo univoco un record nel customerdetails tabella.

  7. Seleziona Fine per salvare la regola. Nella finestra dell’editor delle regole, seleziona Chiudi.

  8. Visualizza l’anteprima del modulo adattivo. Recupera i dettagli di un cliente, aggiorna l’indirizzo di spedizione e invia il modulo. Quando recuperi nuovamente i dettagli dello stesso cliente, viene visualizzato l’indirizzo di spedizione aggiornato.

Passaggio 3: (sezione Bonus) Utilizza l’editor di codice per eseguire convalide e visualizzare messaggi di errore step-bonus-section-use-the-code-editor-to-run-validations-and-display-error-messages

Eseguire la convalida del modulo per verificare che i dati immessi nel modulo siano corretti e che venga visualizzato un messaggio di errore in caso di dati errati. Ad esempio, se nel modulo viene inserito un ID cliente non esistente, deve essere visualizzato un messaggio di errore.

I moduli adattivi forniscono diversi componenti con convalide incorporate, ad esempio e-mail e campi numerici che puoi utilizzare per casi d’uso comuni. Utilizza l’editor di regole per i casi d’uso avanzati, ad esempio, per visualizzare un messaggio di errore quando il database restituisce record zero (0) (nessun record).

Nella procedura seguente viene illustrato come creare una regola per visualizzare un messaggio di errore se l'ID cliente immesso nel modulo non esiste nel database. La regola porta anche lo stato attivo su e ripristina il ID cliente campo. La regola utilizza API dataIntegrationUtils del servizio modello dati modulo per verificare se l’ID cliente esiste nel database.

  1. Seleziona la ID cliente e selezionare il Edit Rules icona. Il Editor regole viene visualizzata la finestra.

  2. Seleziona la + Crea per aggiungere una regola. Viene aperto l'Editor visivo.

    Nell'editor visivo, il QUANDO è selezionata per impostazione predefinita. Inoltre, l'oggetto modulo (in questo caso, ID cliente) da dove hai avviato l'editor di regole è specificato in QUANDO dichiarazione.

  3. Seleziona la Seleziona stato a discesa e selezionare è stato modificato.

    quando customeridischanged

    In THEN istruzione, seleziona Richiama servizio dal Seleziona azione a discesa.

  4. Passa da Editor visivo a Editor di codice. Il comando dell'interruttore si trova sul lato destro della finestra. Viene visualizzato l'Editor di codice, con un codice simile al seguente:

    editor di codice

  5. Sostituisci la sezione della variabile di input con il seguente codice:

    code language-javascript
    var inputs = {
        "id" : this
    };
    
  6. Sostituisci il guidelib.dataIntegrationUtils.executeOperation (operationInfo, inputs, outputs) sezione con il seguente codice:

    code language-javascript
    guidelib.dataIntegrationUtils.executeOperation(operationInfo, inputs, outputs, function (result) {
      if (result) {
          result = JSON.parse(result);
        customer_Name.value = result.name;
        customer_Shipping_Address = result.shippingAddress;
      } else {
        if(window.confirm("Invalid Customer ID. Provide a valid customer ID")) {
              customer_Name.value = " ";
             guideBridge.setFocus(customer_ID);
        }
      }
    });
    
  7. Visualizza l’anteprima del modulo adattivo. Immetti un ID cliente errato. Viene visualizzato un messaggio di errore.

    display-validation-error

recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2