Clarion ProPath Help

The Developer Mode Tab

The Developer Mode Tab

Previous topic Next topic  

The Developer Mode Tab

Previous topic Next topic  

The Developer Mode tab of the global support extension template is where you enable and configure the Developer Mode of ProPath.  This makes it easy to test your application and troubleshoot client data.

 

clip0109

 

Enabling Developer Mode

 

To enable the ProPath Developer Mode, check this box:

 

clip0200

 

 

Displaying a warning message when Developer Mode is active

 

To enable the warning, check this box:

 

clip0201

 

If you check this box, then whenever your application starts and ProPath determines that the Developer Mode is active, a warning message will be displayed.

 

 

clip0202

 

 

Setting the Development Mode Controller

 

The ProPath Development Controller can either be an External Control File in the application folder, or you can use Fixed paths that are compiled into the application.

 

clip0203

 

 

Using an External Control File

 

If you use an External Control File, you reap two immediate benefits:

 

1.You can ship the application with Developer Mode enabled.  As long as you do NOT ship the External Control File (or details about its usage and location), the end users will never know it is enabled.        
2.You can use the compiled application to troubleshoot multiple sets of user data.

 

Note: the External Control File must be in the same folder where the application is started from.  This is by design and it is one of the things that make the Developer Mode work.

 

 

Configuring the External Control File

 

clip0204

 

There are three elements that must be exact if the External Control File is to activate the Developer Mode.

 

The first is the name of the file.  The name of the physical file must be an exact match for what is entered here.

 

The second is the format of the INI file.

 

First is the SECTION.  It must be as follows:

 

[Developer Mode]

 

 

The second is the ENTRY.  It must be one (or both) of these words:

 

MAIN

SYSTEM

 

You will use one or both of these depending on how many data folders you have ProPath configured to use.

 

 

The third item is the VALUE.  This is the actual path to the folder where you want ProPath to set the data location

 

A complete External Control File might look like this:

 

[Developer Mode]

MAIN=C:\Temp\MAINData

SYSTEM=C:\Temp\SYSTEMData

 

Note: the target folders specified must exist.  ProPath will NOT create them in Developer Mode.  This is by design.

 

 

 

Using Fixed Paths

 

If you don't want to use the External Control File as the Developer Mode Controller, you can use the Fixed Path option.

 

clip0205

 

In Fixed Controller Mode, you will have a field to enter a fixed path for the MAIN data path.

 

If the ProPath configuration includes a SYSTEM folder, you will also have a field to enter the fixed path for that location.

 

Note: the target folders specified must exist.  ProPath will NOT create them in Developer Mode.  This is by design.

 

 

Developer Mode Guidelines

 

For your convenience a copy of the Developer Mode Guidelines is displayed in the template.

 

clip0206

 

 

Developer Mode vs First Run Technology

 

When Developer Mode is active, it bypasses the First Run technology.  This is by design and by necessity since the normal triggers would not work as expected.

 

If you are using both Developer Mode and First Run technology at the same time, you can test your First Run actions with the built-in SETCOMMAND option.