The automatic read/writ tool lets you carry out reading and writing on a FormWork instance in match mode. The tool is distributed inside the installation package and is in tools.


Command line


You can launch the tool from the command line, the first parameter the basic url of the FormWork Instance to be tested (in the "http://my.instance:8088/" form), followed, if necessary, by a second parameter "w" if the tool requires write access. 

If the second parameter is omitted, the tool will run ready only.

 

Configuration

 

In order to configure the tool and to indicate which tables to read and write, you have put a file with .profile extension into the same folder as the executable. These files describe a test scenario run with a user and referring to a series of forms. The content of these files is as follows (with the exception of the values of the fields in red):


<?xml version="1.0" encoding="utf-8" ?>

<TestScenario>

  <Username>admin</Username>

  <Password>my_password_here</Password>

 

  <Forms>

 <Form>

 <!-- Form ID; getting using the query:

     

        SELECT A.[ModuleId], F.FLU_ID, T.TabPath + '//' + F.FLU_NOM AS FULL_NAME

        FROM [dnn_Iconsulting_ExcelAddin_FlowsAssociation] A

        INNER JOIN dbo.dnn_Iconsulting_TiCarICO_FLUSSO F

              ON A.FlowId = F.FLU_ID

        INNER JOIN dnn_vw_Modules V

              ON V.[ModuleId] = A.[ModuleId]

        INNER JOIN dbo.dnn_Tabs T

              ON V.TABID = T.TABID

      -->

      <ModuleId>901</ModuleId>

      <!-- read / write field name (case insensitive) field must be writable and the form must have at least read+edit grant -->

      <FieldName>SOC</FieldName>

      <!-- text to add (and subsequently remove) to the field on the first record -->

      <ValueToAdd>.</ValueToAdd>

      <!-- Waiting maximum timeout (not mandatory) -->

      <MaxTimeout>30000</MaxTimeout>

    </Form>

 

    <Form>

      <ModuleId>796</ModuleId>

      <FieldName>EnglishProductSubcategoryName</FieldName>

      <ValueToAdd>.</ValueToAdd>

      <MaxTimeout>30000</MaxTimeout>

    </Form>

  </Forms>

</TestScenario>


After the read/write the tool gives the number of errors as exit code.