Skip to main content

Tacton CPQ

The Tacton CPQ plugin brings helper functions and code completion for your Tacton product model to the DynaMaker editor. In order to explain how the plugin work, we will go through:

1. Prepare Tacton model​

Create one or more groups in your Tacton model containing the values that you want the DynaMaker app to be able to access. The group name must include the string dynamaker (not case sensitive) to be available in autocomplete in the DynaMaker editor.

2. DynaMaker Plugin​

To set it up, you can either:

  • A. manually upload the model (.tcx file) to the DynaMaker dashboard,
  • B. or set up an automatic server synchronization via an API user.

A. Manual upload​

As an alternative to the automatic server synchronzation, you can do a manual upload of the model. If you don't already have the product model (.tcx file), you can download it from the Tacton CPQ admin interface. For that:

  • Open the ticket that you want to target.
  • Go to Master Data > Products > YOUR_PRODUCT.
  • In Attribute Values to the right, under Model click on Download.

Now that you have the file, you can upload it to the application dashboard in DynaMaker.

  • Go to Plugins in your app dashboardlook for Tacton plugin.
  • Choose File Upload, add your .tcx file & click on Save.

B. Automatic server synchronization​

As an alternative to the manual upload, you can do a automatic server synchronization. For that you need to:

1. Create Tacton CPQ API User:​

Create an API user for the DynaMaker integration in the ticket that you want to synchronize with. In the Tacton ticket administration, go to Sales Process > Structure > Objects and Attributes > Users > Instances > Create User. Make sure to set the API User field to Yes in the Attribute Values section.

2. Allow Tacton model download​

In the Tacton ticket administration, go to Sales Process > Structure > Master Data Objects > Standard Objects > Product > Attributes > model and set Prevent Download to No.

3. Fill in the fields in DynaMaker​

  • Go to Plugins in your app dashboardlook for Tacton plugin.
  • Choose Server Sync.
  • In Fill in URL, Ticket ID, Username and Password of your API user.
  • Click on Save.
  • Refresh the Product list and select the model that you want to sync with.
  • Click on Synchronize.

C. Use Plugin​

Once you have set up the plugin, you can now use it in the DynaMaker editors (i.e. UI and components mainly). After importing the PLUGINS module in the DynaMaker editor, you can access the helper functions and code completion by writing PLUGINS.TACTON.[ctrl+space].

You can set up a listener for configuration updates from Tacton CPQ by using the setupPostMessageListener function of the plugin. This is commonly used to update the 3D geometry in DynaMaker whenever the end-user changes the configuration.

export function onInit() {
  PLUGINS.TACTON.onConfigurationUpdate((parsedData, rawData) => {
    if (tactonData !== undefined) {
      const parsedData = PLUGINS.TACTON.parseTactonData(rawData)
      Studio.requestGeometryUpdate()
    }
  })
}