Show Menu
ARGOMENTI×

Esercitazione: Verifica del modulo adattivo

Questa esercitazione è un passaggio della serie Crea il primo modulo adattivo. Si consiglia di seguire le serie in sequenza cronologica per comprendere, eseguire e dimostrare l'uso completo dell'esercitazione.
Una volta che il modulo adattivo è pronto, è importante verificare l'adattivo prima di distribuirlo agli utenti finali. È possibile testare manualmente (test funzionale) ogni campo o automatizzare il test del modulo adattivo. In presenza di più moduli adattivi, il test manuale di tutti i campi di tutti i moduli adattivi diventa un'attività scoraggiante.
AEM Forms offre un framework di verifica, Calvin, per automatizzare il test dei moduli adattivi. Utilizzando il framework, potete scrivere ed eseguire test di interfaccia direttamente in un browser Web. Il framework fornisce API JavaScript per la creazione di test. Il test automatizzato consente di verificare l'esperienza di precompilazione di un modulo adattivo, inviare esperienze relative a un modulo adattivo, regole di espressione, da convalide, caricamento lento e interazioni dell'interfaccia utente. Questa esercitazione illustra i passaggi necessari per creare ed eseguire test automatici su un modulo adattivo. Al termine di questa esercitazione, potrete:

Passaggio 1: Creare una suite di test

Le suite di test dispongono di una raccolta di casi di test. Potete avere più suite di test. È consigliabile disporre di una suite di test distinta per ciascun modulo. Per creare una suite di test:
  1. Accedi all’istanza di creazione di AEM Forms come amministratore. Aprite CRXDE Lite. Toccate AEM Logo > Strumenti > Generale > CRXDE Lite oppure aprite l’URL https://localhost:4502/crx/de/index.jsp in un browser per aprire CRXDE Lite.
  2. Andate a /etc/clientlibs in CRXDE Lite. Fare clic con il pulsante destro del mouse sulla sottocartella /etc/clientlibs e scegliere Crea > Crea nodo. Nel campo Nome digitare WeRetailFormTestCase . Selezionare il tipo come cq:ClientLibraryFolder e fare clic su OK . Crea un nodo. È possibile utilizzare qualsiasi nome al posto di WeRetailFormTestCase.
  3. Aggiungete le seguenti proprietà al nodo WeRetailFormTestCase e toccate Salva TUTTO .
Proprietà Tipo Più Valore
categorie Stringa Abilitato
  • granite.testing.hobbes.tests
  • granite.testing.calvin.tests
dipendenze Stringa Abilitato
  • granite.testing.hobbes.testrunner
  • granite.testing.calvin
  • apps.testframework.all
Accertatevi che ciascuna proprietà sia aggiunta a una casella separata come illustrato di seguito:
  1. Fare clic con il pulsante destro del mouse sul nodo WeRetailFormTestCase , fare clic su Crea > Crea file . Nel campo Nome, digitare js.txt e fare clic su OK .
  2. Aprite il file js.txt per la modifica, aggiungete il codice seguente e salvate il file:
    #base=.
     init.js
    
    
  3. Create un file, init.js, nel WeRetailFormTestCases nodo. Aggiungi il codice seguente al file e tocca Salva tutto .
    (function(window, hobs) {
        'use strict';
        window.testsuites = window.testsuites || {};
      // Registering the test form suite to the sytem
      // If there are other forms, all registration should be done here
        window.testsuites.testForm3 = new hobs.TestSuite("We retail - Tests", {
            path: '/etc/clientlibs/WeRetailFormTestCases/init.js',
            register: true
        });
     // window.testsuites.testForm2 = new hobs.TestSuite("testForm2");
    }(window, window.hobs));
    
    
    Il codice riportato sopra crea una suite di test denominata We retail - Test .
  4. Aprite l'interfaccia utente di AEM Testing (AEM > Strumenti > Operazioni > Test). La suite di test - We retail - Test - è elencata nell'interfaccia utente.

Passaggio 2: Creare un test case per precompilare i valori in un modulo adattivo

Un test case è un insieme di azioni per testare una funzionalità specifica. Ad esempio, la precompilazione di tutti i campi di un modulo e la convalida di alcuni campi per garantire l'immissione dei valori corretti.
Un'azione è un'attività specifica in un modulo adattivo, ad esempio fare clic su un pulsante. Per creare un caso di test e azioni per convalidare l’input dell’utente per ciascun campo modulo adattivo:
  1. In CRXDE Lite, individuate la /content/forms/af/create-first-adaptive-form cartella. Fare clic con il pulsante destro del mouse sul nodo della cartella create-first-adaptive-form e scegliere Crea > Crea file . Nel campo Nome, digitare prefill.xml e fare clic su OK . Aggiungi al file il codice seguente:
    <?xml version="1.0" encoding="UTF-8"?><afData>
      <afUnboundData>
        <data>
          <customer_ID>371767</customer_ID>
          <customer_Name>John Jacobs</customer_Name>
          <customer_Shipping_Address>1657 1657 Riverside Drive Redding</customer_Shipping_Address>
          <customer_State>California</customer_State>
          <customer_ZIPCode>096001</customer_ZIPCode>
         </data>
      </afUnboundData>
      <afBoundData>
        <data xmlns:xfa="https://www.xfa.org/schema/xfa-data/1.0/"/>
      </afBoundData>
    </afData>
    
    
  2. Accedi a /etc/clientlibs . Fare clic con il pulsante destro del mouse sulla /etc/clientlibs sottocartella e scegliere Crea > Crea nodo .
    Nel campo Nome digitare WeRetailFormTests . Selezionate il tipo come cq:ClientLibraryFolder e fate clic su OK .
  3. Aggiungete le seguenti proprietà al nodo WeRetailFormTest .
Proprietà Tipo Più Valore
categorie Stringa Abilitato
  • granite.testing.hobbes.tests
  • granite.testing.hobbes.tests.testForm
dipendenze Stringa Abilitato
  • granite.testing.calvin.tests
  1. Create un file, js.txt, nel nodo WeRetailFormTest . Aggiungete quanto segue al file:
    #base=.
    prefillTest.js
    
    
    Fate clic su Salva tutto .
  2. Create un file, prefillTest.js , nel nodo WeRetailFormTest . Aggiungi il codice seguente al file. Il codice crea un test case. Il test case precompila tutti i campi di un modulo e convalida alcuni campi per garantire che vengano immessi valori corretti.
    (function (window, hobs) {
        'use strict';
    
        var ts = new hobs.TestSuite("Prefill Test", {
            path: '/etc/clientlibs/WeRetailFormTests/prefillTest.js',
            register: false
        })
    
        .addTestCase(new hobs.TestCase("Prefill Test")
            // navigate to the testForm which is to be test
            .navigateTo("/content/forms/af/create-first-adaptive-form/shipping-address-add-update-form.html?wcmmode=disabled&dataRef=crx:///content/forms/af/create-first-adaptive-form/prefill.xml")
            // check if adaptive form is loaded
            .asserts.isTrue(function () {
                return calvin.isFormLoaded()
            })
            .asserts.isTrue(function () {
                return calvin.model("customer_ID").value == 371767;
            })
            .asserts.isTrue(function () {
                return calvin.model("customer_ZIPCode").value == 96001;
            })
        );
    
        // register the test suite with testForm
        window.testsuites.testForm3.add(ts);
    
    }(window, window.hobs));
    
    
    Il test case viene creato e pronto per essere eseguito. È possibile creare test case per convalidare vari aspetti di un modulo adattivo, ad esempio per controllare l'esecuzione dello script calculate, convalidare i pattern e convalidare l'esperienza di invio di un modulo adattivo. Per informazioni su vari aspetti del test dei moduli adattivi, vedere verifica automatica dei moduli adattivi.

Passaggio 3: Eseguire tutti i test in una suite o singoli casi di test

Una suite di test può contenere più casi di test. Potete eseguire tutti i casi di test in una suite di test contemporaneamente o singolarmente. Quando eseguite un test, le icone indicano i risultati:
  • Un'icona a forma di segno di spunta indica un test superato:
  • Un'icona "X" indica un test non riuscito:
  1. Passa all’icona AEM > Strumenti > Operazioni > Test
  2. Per eseguire tutti i test della suite di test:
    1. Nel pannello Test, toccate We retail - Test (1) . La suite si espande per visualizzare l'elenco dei test.
    2. Toccate il pulsante Esegui test . L'area vuota sul lato destro dello schermo viene sostituita con un modulo adattivo durante l'esecuzione del test.
  3. Per eseguire un singolo test dalla suite di test:
    1. Nel pannello Test, toccate We retail - Test (1) . La suite si espande per visualizzare l'elenco dei test.
    2. Toccate il test di precompilazione e toccate il pulsante Esegui test . L'area vuota sul lato destro dello schermo viene sostituita con un modulo adattivo durante l'esecuzione del test.
  4. Toccate il nome del test, Test di precompilazione, per esaminare i risultati del test case. Viene aperto il pannello Risultato. Toccate il nome del caso di test nel pannello Risultati per visualizzare tutti i dettagli del test.
Ora il modulo adattivo è pronto per la pubblicazione.