Loading the Integration Theme Client SDK
The Integration Theme provides a fully-fledged JavaScript SDK, to assist with using the API.
Whilst not a requirement to use the API, this vastly simplifies common commands in environments that support JavaScript.
It is advised that you load the JavaScript Client served automatically by your DriveWorks Live server, not a copy hosted locally by the site utilizing it. This ensures the use of the latest version of the script, matching the currently installed version of DriveWorks.
To load the JavaScript SDK, include the following script tag on each page:
<script src="https://[your-live-server.com]/DriveWorksLiveIntegrationClient.min.js"></script>
This script should be placed before the closing </body> tag, and before any scripts using SDK functionality.
Default Configuration
The Integration Theme is pre-configured to use a single Group, known as the Default Group.
The Default Group is denoted by a hyphen ( - ) when required to provide a Group Alias.
- When using DriveWorks Live & Personal Web Edition, the Default Group matches the Group this is being used within the desktop application.
- When using Internet Information Services (IIS), use advanced configuration to specify the Default Group (see below).
Advanced Configuration Optional
To specify a Default Group, or access multiple DriveWorks Groups using the Integration Theme, you must register a Group Alias for each Group in a configuration file.
Group Aliases are defined by DriveWorksConfigUser.xml on the host machine:
C:\ProgramData\DriveWorks\[Version]\Live\Themes\Integration\DriveWorksConfigUser.xml
More information about advanced configuration settings in this file can be found in the online help file.
Accessing Examples
We have created a range of examples that showcase how the Integration Theme Client SDK can be used.
These interact with the API to create custom web content - all powered by DriveWorks.
These collections are a great way to get started or provide inspiration.
They are completely customizable and ready to use with your existing DriveWorks Projects and Specifications.
Client SDK Documentation
The Client SDK Documentation displays all of the functions and properties that are available when utilizing the SDK to communicate with the Server API.
Here you will find:
- A list of the available classes, functions and properties.
- A list of the supporting data types, which show the format of data returned from the Server API when it reaches the client.
- Information on each entity detailing functionality, required data, data types, and return values.
Server API Documentation
The Server API Documentation displays all of the endpoints that can be interacted with using the Integration Theme.
Here you will find:
- A description of the functionality of each endpoint.
- The required format for sending a request to the endpoint.
- Information on the required data, the format of that data and its purpose.
- The responses that the endpoint can produce.
- The ability to try out each endpoint directly on the help page.
DriveWorks Help
For further help using DriveWorks in general, please visit the main Online Help File.
Here you will find a wide range of help, information and tips to assist you.
View DriveWorks Help