ProTOML - Template Usage

To use ProTOML, add the global extension template to your Clarion application and enter the license supplied with your order.

Add the template

Open your EXE application in the Clarion IDE.
Go to Global Extensions and click Insert.
Type ProTOML in the search box.
Select the ProTOML global extension entry and click Select.
Enter the required template settings. Use the developer license value supplied with your purchase, or leave the default PTM-DEMO value for demo mode.
Write the ProTOML calls your application needs.
Compile and run the application.

The global template supplies the ready-to-use Toml object, includes the high-level wrapper, links the ProTOML import library, and generates the startup license initialization.

Write the application code

After adding the template, call the high-level methods wherever your application needs them:

Toml.StartDocument()
Toml.SetString('application.name',AppName)
Toml.WriteGroup('settings',AppSettings)
Toml.WriteQueue('contacts',ContactQueue)

You do not need to declare the Toml object or call the low-level API functions.

Clarion multi-DLL applications

In a Clarion multi-DLL application, add the ProTOML global template to the EXE app.

The supporting DLL apps do not need their own ProTOML global extension. The EXE startup code initializes ProTOML for the running process.

Hand-coded applications

Developers who intentionally do not use the template can follow Hand-Coded Integration Without the Template. That page shows the class include, object declaration, import-library requirement, and manual license initialization.

Deployment reminder

Include ProTOML.dll with your application at runtime. The .lib file is used only at compile time.