Installing the Erewhon ATCG Variant

Before you install the generic version of ATCG, install the Erewhon variant so that you can refer to the provided examples.

To install the Erewhon variant

1. From the JADE-Erewhon link at https://github.com/jadesoftwarenz, load the Erewhon example schemas into Jade and familiarize yourself with the applications.

2. Enable method tracking, by updating your Jade initialization file so that the value of the MethodTrackingEnabled parameter in the [JadeSecurity] section is set to true.

3. Load the AtcgGeneratorSchema (that is, the AtcgGeneratorSchema.scm and AtcgGeneratorSchema.ddx files) as a subschema of ErewhonViewSchema, as follows.

   1. Load the schema and forms definition files in the usual way, by specifying the schema and forms file names on the File Selection sheet of the Load Options dialog, and then clicking the Advanced button.

   2. On the Advanced Load Options dialog:

      1. Change the Subschema of value from RootSchema to ErewhonViewSchema.

      2. In the text box portion of the Target Schema combo box, specify AtcgGeneratorSchema. (This schema is not displayed in the drop‑down list of the combo box.)

      3. Click the OK button.

4. Load the AtcgTestCodeSchema (that is, the AtcgTestCodeSchema.scm and AtcgTestCodeSchema.ddx files), by performing the actions specified in the previous step of this instruction, but specifying AtcgGeneratorSchema in step b.i and AtcgTestCodeSchema in step b.ii.

The Erewhon ATCG variant schemas are then displayed under the ErewhonViewSchema, as shown in the following image.

In the AtcgTestCodeSchema, check the:

• AtcgProfile class contains the TestProfile class. The TestProfile class will be the superclass for all of your profile test classes.

• AtcgTestCodeSchemaApp class atcgGetControlOptions method to make sure that the ErewhonViewSchema is tracked; for example:

  .... 
  // list of schemas to be tracked during recording 
  targetSchemas.add("AtcgTestCodeSchema");
  targetSchemas.add("ErewhonViewSchema");
  ....

In the ErewhonViewSchema, global ErewhonViewSchemaGlobal class, check the:

• getAndValidateUser method to make sure that all of the ATCG applications can run; for example:

  if app.name <> AdminApp and
          app.name <> "AtcgControlApp" and
          app.name <> "AtcgReplayApp" and
          app.name <> "AtcgRecordApp" and
          ....
      return false;
  endif;
  ....
  if app.isWebShopApp or
      app.name = "AtcgControlApp" or
      app.name = "AtcgReplayApp" or
      app.name = "AtcgRecordApp" or
      ....
  then
      return true;
  endif;

• isUserValid method to make sure that all of the ATCG applications can run; for example:

  if app.isWebShopApp or
      app.name = "AtcgControlApp" or
      app.name = "AtcgReplayApp" or
      app.name = "AtcgRecordApp" or
      ....
  then
      isValid := true;
  endif;

Check that the AtcgControlApp application in AtcgTestCodeSchema runs; that is, the dialog like the example in the following image is displayed.

When you start the AtcgRecordApp, the startup method in the TestProfile class (a subclass of AtcgProfile in AtcgTestCodeSchema) creates the main form and log-on screen for the ErewhonShop application.

To finish checking the installed schemas

1. Start the AtcgRecordApp application manually and then:

   1. Check that the ErewhonShop application in the ErewhonViewSchema starts automatically.

   2. Close the application.

   AtcgRecordApp can be run as a standard (fat) client or presentation (thin) client. For details about running ATCG in thin client mode, see "Thin Client Method Broadcasting", later in this chapter.

2. Load the provided BasicDemo.cls example profile class into AtcgTestCodeSchema.

3. Start the AtcgControlApp application.

   1. Double‑click on Basic Demo.

   2. Click the Replay List button, which should replay a basic sequence of events in the ErewhonShop application.

   If the setup is correct and the data matches the recorded profile, this recorded sequence should replay correctly.

4. Click the Start Recording button, to start the AtcgRecordApp application automatically. When the Please Wait form closes:

   1. Perform a couple of actions within the application.

   2. When completed, click the Generate and Load button to terminate the AtcgRecordApp application and generate and load a new profile class.

   3. Click the Replay Last button. The main form of your ErewhonShop application should be displayed and the actions that you performed then replayed.

Basic installation is now complete.