Automatizar la prueba de formularios adaptables

Información general

Los formularios adaptables son esenciales para las interacciones con los clientes. Es importante probar los formularios adaptables con todos los cambios que realice en ellos, como cuando se despliega un nuevo paquete de correcciones o se cambia una regla del formulario. Sin embargo, la prueba funcional de los formularios adaptables y de todos los campos de los mismos puede resultar tediosa.

Calvin le permite automatizar la prueba de sus formularios adaptables en el navegador web. Calvin utiliza la interfaz de usuario de Hobbes para ejecutar las pruebas y proporciona las siguientes herramientas:

• Una API de JavaScript para crear pruebas.
• Una interfaz de usuario para ejecutar pruebas.

Con Calvin, puede crear casos de prueba en CRXDE y ejecutar pruebas de interfaz de usuario directamente en el navegador web para probar a fondo los siguientes aspectos de los formularios adaptables:

Requisitos previos

Antes de utilizar este artículo para crear los casos de prueba, debe saber lo siguiente:

• Creación de grupos de pruebas y ejecución de casos de prueba mediante Hobbes
• Hobbes JavaScript API
• API de JavaScript de Calvin

Ejemplo: Crear un grupo de pruebas para un formulario adaptable usando Hobbes como marco de pruebas

El siguiente ejemplo lo acompaña durante la creación de un grupo de pruebas para probar varios formularios adaptables. Debe crear un caso de prueba independiente para cada formulario que necesite probar. Si sigue pasos similares a los siguientes y modifica el código JavaScript en el paso 11, puede crear su propio grupo de pruebas para probar los formularios adaptables.

1. Vaya a CRXDE Lite en el navegador web: https://[server]:[port]/crx/de.

2. Haga clic con el botón derecho en la subcarpeta /etc/clientlibs y haga clic en Crear > Crear nodo. Escriba un nombre (aquí afTestRegistration), especifique el tipo de nodo como cq:ClientLibraryFolder y haga clic en Aceptar.

   La carpeta clientlibs contiene el aspecto de registro de la aplicación (JS e Init). Se recomienda registrar todos los objetos de los grupos de pruebas Hobbes específicos de un formulario en la carpeta clientlibs.

3. Especifique los siguientes valores de propiedad en el nodo recién creado (aquí afTestRegistration) y haga clic en Guardar todo. Estas propiedades ayudan a Hobbes a reconocer la carpeta como una prueba. Para reutilizar esta biblioteca de cliente como una dependencia en otras bibliotecas de cliente, asígnele el nombre granite.testing.calvin.testing.

1. Haga clic con el botón secundario en el nodo de prueba (aquí afTestRegistration) y, a continuación, haga clic en Crear > Crear archivo. Asigne un nombre al archivo js.txt y haga clic en Aceptar.

2. En el archivo js.txt, agregue el siguiente texto:

   #base=.
   js.txt
   

3. Haga clic en Guardar todo y cierre el archivo js.txt.

4. Haga clic con el botón derecho en el nodo de prueba (aquí afTestRegistration) y haga clic en Crear > Crear archivo. Asigne un nombre al archivo init.js y haga clic en Aceptar.

5. Copie el siguiente código en el archivo init.js y haga clic en 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.testForm = new hobs.TestSuite("Adaptive Form - Demo Test", {
           path: '/etc/clientlibs/afTestRegistration/init.js',
           register: true
       });
    // window.testsuites.testForm1 = new hobs.TestSuite("testForm1");
   }(window, window.hobs));
   

   El código anterior crea un grupo de pruebas denominado Formulario adaptable - Prueba de demostración. Para crear un grupo de pruebas con un nombre diferente, cambie el nombre según corresponda.

6. Haga clic en Crear > Crear nodo para crear un nodo en la carpeta clientlib para cada formulario que desee probar. En este ejemplo se utiliza un nodo denominado testForm para probar un formulario adaptable denominado testForm .Especifique las siguientes propiedades y haga clic en Aceptar:

   • Nombre: testForm (su nombre de formulario)
   • Tipo: cq:ClientLibraryFolder

7. Añada las siguientes propiedades en el nodo recién creado (aquí testForm) para probar un formulario adaptable:

   Propiedad	Tipo	Value
   categorías	Cadena[]	granite.testing.hobbes.testing, granite.testing.hobbes.testing.testForm
   dependencias	Cadena[]	granite.testing.calvin.tests

   NOTA

   En este ejemplo se utiliza una dependencia de la biblioteca de cliente granite.testing.calvin.testing para una mejor administración. En este ejemplo también se agrega una categoría de biblioteca de cliente, "granite.testing.hobbes.testing.testForm", para reutilizar esta biblioteca de cliente, si es necesario.

   

8. Haga clic con el botón derecho en la carpeta que ha creado para el formulario de prueba (aquí testForm) y seleccione Crear > Crear archivo. Asigne un nombre al archivo scriptingTest.js y agregue el siguiente código al archivo y haga clic en Guardar todo.

   Para utilizar el siguiente código para probar otro formulario adaptable, cambie la ruta y el nombre del formulario en navigateTo (líneas 11, 36 y 62) y los respectivos casos de prueba. Para obtener más información sobre las API para probar diferentes aspectos de formularios y objetos de formulario, consulte API de Calvin.

   (function(window, hobs) {
       'use strict';
   
    var ts = new hobs.TestSuite("Script Test", {
           path: '/etc/clientlibs/testForm/scriptingTest.js',
     register: false
    }) 
   
       .addTestCase(new hobs.TestCase("Checking execution of calculate script")
           // navigate to the testForm which is to be tested
           .navigateTo("/content/forms/af/testForm.html?wcmmode=disabled")
           // check if adaptive form is loaded
           .asserts.isTrue(function () {
               return calvin.isFormLoaded()
           })
           .execSyncFct(function () {
               // create a spy before checking for the expression
               calvin.spyOnExpression("panel1.textbox1");
               // setValue would trigger enter, set the value and exit from the field
               calvin.setValueInDOM("panel1.textbox", "5");
           })
           // if the calculate expression was setting "textbox1" value to "5", let's also check that
           .asserts.isTrue(function () {
               return calvin.isExpressionExecuted("panel1.textbox1", "Calculate");
           })
           .execSyncFct(function () {
               calvin.destroySpyOnExpression("panel1.textbox1");
           })
           .asserts.isTrue(function () {
               return calvin.model("panel1.textbox1").value == "5"
           })
       )
   
       .addTestCase(new hobs.TestCase("Calculate script Test")
           // navigate to the testForm which is to be tested
           .navigateTo("/content/forms/af/cal/demoform.html?wcmmode=disabled&dataRef=crx:///content/forms/af/cal/prefill.xml")
           // check if adaptive form is loaded
           .asserts.isTrue(function () {
               return calvin.isFormLoaded()
           })
   
           .execSyncFct(function () {
               // create a spy before checking for the expression
               calvin.spyOnExpression("panel2.panel1488218690733.downPayment");
               // setValue would trigger enter, set the value and exit from the field
               calvin.setValueInDOM("panel2.panel1488218690733.priceProperty", "1000000");
           })
           .asserts.isTrue(function () {
               return calvin.isExpressionExecuted("panel2.panel1488218690733.downPayment", "Calculate");
           })
           .execSyncFct(function () {
               calvin.destroySpyOnExpression("panel2.panel1488218690733.downPayment");
           })
           .asserts.isTrue(function () {
               // if the calculate expression was setting "downPayment" value to "10000", let's also check that
      return calvin.model("panel2.panel1488218690733.downPayment").value == 10000
           })
       )
   
       .addTestCase(new hobs.TestCase("Checking execution of Value commit script")
           // navigate to the testForm which is to be tested
           .navigateTo("/content/forms/af/cal/demoform.html?wcmmode=disabled&dataRef=crx:///content/forms/af/cal/prefill.xml")
           // check if adaptive form is loaded
           .asserts.isTrue(function () {
               return calvin.isFormLoaded()
           })
   
           .execSyncFct(function () {
               // create a spy before checking for the expression
               calvin.spyOnExpression("panel2.panel1488218690733.priceProperty");
               // setValue would trigger enter, set the value and exit from the field
               calvin.setValueInDOM("panel2.panel1488218690733.priceProperty", "100");
           })
           .asserts.isTrue(function () {
               return calvin.isExpressionExecuted("panel2.panel1488218690733.priceProperty", "Value Commit");
           })
           .execSyncFct(function () {
               calvin.destroySpyOnExpression("panel2.panel1488218690733.priceProperty");
           })
           .asserts.isTrue(function () {
            // if the value commit expression was setting "textbox1488215618594" value to "0", let's also check that
               return calvin.model("panel2.panel1488218690733.textbox1488215618594").value == 0
           })
       );
   
    // register the test suite with testForm
     window.testsuites.testForm.add(ts);
   
    }(window, window.hobs));
   

   Se crea el caso de prueba. Proceda a ejecutar el caso de prueba para probar los formularios adaptables a través de Hobbes. Para ver los pasos para ejecutar los casos de prueba, consulte Ejecución de pruebas en la prueba de la interfaz de usuario mediante pruebas automatizadas.

También puede instalar el paquete en el archivo adjunto SampleTestPackage.zip para obtener los mismos resultados que con los pasos explicados en Ejemplo: Cree un grupo de pruebas para un formulario adaptable utilizando Hobbes como marco de prueba.

Obtener archivo

Prueba de la interfaz de usuario mediante pruebas automatizadas

Ejecución de un único grupo de pruebas

Los grupos de pruebas se pueden ejecutar de forma individual. Al ejecutar un grupo de pruebas, la página cambia a medida que se ejecutan los casos de prueba y sus acciones y los resultados aparecen una vez finalizada la 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:

Para ejecutar un grupo de pruebas:

1. En el panel Pruebas, toque o haga clic en el nombre del caso de prueba que desee ejecutar para expandir los detalles de las acciones.

   

2. Toque o haga clic en el botón Ejecutar pruebas.

   

3. El marcador de posición se reemplaza por el contenido de la página a medida que se ejecuta la prueba.

   

4. Revise los resultados del caso de prueba tocando o haciendo clic en la descripción para abrir el panel Resultado. Al tocar o hacer clic en el nombre del caso de prueba en el panel Resultado se muestran todos los detalles.

   

Los pasos para probar los formularios adaptables AEM son similares a los pasos para probar la IU AEM. Para obtener más información sobre la prueba de los formularios adaptables, consulte los siguientes temas en Prueba de la interfaz de usuario:

• Visualización de grupos de pruebas
• Ejecución de varias pruebas

Glosario