Show Menu
TEMAS×

Tutorial: Prueba del formulario adaptable

Este tutorial es un paso de la serie Crear su primer formulario adaptable. Se recomienda seguir la serie en secuencia cronológica para comprender, realizar y demostrar el caso de uso completo del tutorial.
Una vez que el formulario adaptable esté listo, es importante probar el adaptador antes de extenderlo a los usuarios finales. Puede probar manualmente (pruebas funcionales) cada campo o automatizar la prueba del formulario adaptable. Cuando tiene varios formularios adaptables, la prueba manual de cada campo de todos los formularios adaptables se convierte en una tarea de enormes proporciones.
AEM Forms proporcionar un marco de pruebas, Calvin, para automatizar las pruebas de los formularios adaptables. Con el marco, las pruebas de interfaz de usuario se escriben y ejecutan directamente en un navegador web. El marco proporciona API de JavaScript para crear pruebas. La prueba automatizada le permite probar la experiencia de cumplimentación previa de un formulario adaptable, enviar la experiencia de un formulario adaptable, reglas de expresión, validaciones, carga diferida e interacciones con la interfaz de usuario. Este tutorial le guía por los pasos para crear y ejecutar pruebas automatizadas en un formulario adaptable. Al final de este tutorial, podrá:

Paso 1: Crear un grupo de pruebas

Los grupos de pruebas tienen una colección de casos de prueba. Puede tener varios grupos de pruebas. Se recomienda disponer de un grupo de pruebas independiente para cada formulario. Para crear un grupo de pruebas:
  1. Inicie sesión como administrador en AEM Forms instancia de autor. Abra CRXDE Lite. Puede tocar AEM logotipo > Herramientas > General > CRXDE Lite o abrir la https://localhost:4502/crx/de/index.jsp URL en un navegador para abrir CRXDE Lite.
  2. Vaya a /etc/clientlibs en el CRXDE Lite. Haga clic con el botón derecho en la subcarpeta /etc/clientlibs y haga clic en Crear > Crear nodo . En el campo Nombre , escriba WeRetailFormTestCases . Seleccione el tipo como cq:ClientLibraryFolder y haga clic en Aceptar . Crea un nodo. Puede utilizar cualquier nombre en lugar de WeRetailFormTestCases .
  3. Añada las siguientes propiedades en el WeRetailFormTestCases nodo y toque Guardar todo .
    Propiedad Tipo Multi Value
    categorías Cadena Activado
    • granite.testing.hobbes.tests
    • granite.testing.calvin.tests
    dependencias Cadena Activado
    • granite.testing.hobbes.testrunner
    • granite.testing.calvin
    • apps.testframework.all
    Asegúrese de que cada propiedad se agrega a un cuadro independiente como se muestra a continuación:
  4. Haga clic con el botón derecho en el nodo WeRetailFormTestCases y haga clic en Crear > Crear archivo . En el campo Nombre , escriba js.txt y haga clic en Aceptar .
  5. Abra el archivo js.txt para editarlo, añada el siguiente código y guarde el archivo:
    #base=.
     init.js
    
    
  6. Cree un archivo, init.js, en el WeRetailFormTestCases nodo. Añada el código siguiente en el archivo y toque Guardar todo .
    (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));
    
    
    El código anterior crea un grupo de pruebas llamado We Retail - Tests .
  7. Abra AEM interfaz de usuario de prueba (AEM > Herramientas > Operaciones > Pruebas ). El grupo de pruebas - We Retail - Tests - aparece en la interfaz de usuario.

Paso 2: Crear un caso de prueba para rellenar previamente los valores en un formulario adaptable

Un caso de prueba es un conjunto de acciones para probar una funcionalidad específica. Por ejemplo, anteponiendo todos los campos de un formulario y validando algunos campos para asegurarse de que se introducen los valores correctos.
Una acción es una actividad específica de un formulario adaptable, como hacer clic en un botón. Para crear un caso de prueba y acciones para validar los datos introducidos por el usuario para cada campo de formulario adaptable:
  1. En la lista CRXDE, vaya a la /content/forms/af/create-first-adaptive-form carpeta. Haga clic con el botón derecho en el nodo de la carpeta create-first-adaptive-form y haga clic en Crear > Crear archivo . En el campo Nombre , escriba prefill.xml y haga clic en Aceptar . Añada el siguiente código al archivo:
    <?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. Ir a /etc/clientlibs . Haga clic con el botón secundario en la /etc/clientlibs subcarpeta y haga clic en Crear > Crear nodo .
    En el campo Nombre , escriba WeRetailFormTests . Seleccione el tipo como cq:ClientLibraryFolder y haga clic en Aceptar .
  3. Añada las siguientes propiedades al nodo WeRetailFormTests .
    Propiedad Tipo Multi Value
    categorías Cadena Activado
    • granite.testing.hobbes.tests
    • granite.testing.hobbes.tests.testForm
    dependencias Cadena Activado
    • granite.testing.calvin.tests
  4. Cree un archivo, js.txt, en el nodo WeRetailFormTests . Añada lo siguiente en el archivo:
    #base=.
    prefillTest.js
    
    
    Haga clic en Guardar todo .
  5. Cree un archivo prefillTest.js en el nodo WeRetailFormTests . Añada el código siguiente en el archivo. El código crea un caso de prueba. El caso de prueba antepone todos los campos de un formulario y valida algunos campos para asegurarse de que se introducen los valores correctos.
    (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));
    
    
    El caso de prueba se crea y está listo para ejecutarse. Puede crear casos de prueba para validar varios aspectos de un formulario adaptable, como comprobar la ejecución de la secuencia de comandos de cálculo, validar patrones y validar la experiencia de envío de un formulario adaptable. Para obtener información sobre varios aspectos de la prueba de formularios adaptables, consulte Automatización de la prueba de formularios adaptables.

Paso 3: Ejecutar todas las pruebas en un grupo o en casos de pruebas individuales

Un grupo de pruebas puede tener varios casos de prueba. Puede ejecutar todos los casos de prueba en un grupo de pruebas a la vez o individualmente. Al ejecutar una prueba, los iconos indican los resultados:
  • Un icono de marca de verificación indica una prueba pasada:
  • El icono "X" indica que la prueba ha fallado:
  1. Vaya a AEM icono > Herramientas > Operaciones > Pruebas
  2. Para ejecutar todas las pruebas de Test Suite:
    1. En el panel Pruebas , toque We Retail - Tests (1) . Se expande el conjunto para mostrar la lista de la prueba.
    2. Puntee en el botón Ejecutar pruebas . El área en blanco a la derecha de la pantalla se sustituye por un formulario adaptable a medida que se ejecuta la prueba.
  3. Para ejecutar una sola prueba desde Test Suite:
    1. En el panel Pruebas, toque We Retail - Tests (1) . Se expande el conjunto para mostrar la lista de la prueba.
    2. Toque la Prueba de relleno previo y toque el botón Ejecutar pruebas . El área en blanco a la derecha de la pantalla se sustituye por un formulario adaptable a medida que se ejecuta la prueba.
  4. Toque el nombre de la prueba, Prueba de relleno previo, para revisar los resultados del caso de prueba. Abre el panel Resultado . Toque el nombre del caso de prueba en el panel Resultado para vista de todos los detalles de la prueba.
Ahora el formulario adaptable está listo para su publicación.