/
How to Customize Deeplinks for ISV Integration

How to Customize Deeplinks for ISV Integration

The purpose of deep links is to enable dynamic link usage through the Groovy API and simplify adjustments to link structures. In other words, this allows links to be easily added, or edited in PlatformManager and then used within the Pricefx application via Groovy API.

This feature allows you to add and edit the URLs of links to Enable, which are then sent to the partition’s Advanced Configuration Options and stored in the isvConnection_pages file in JSON format.

Example of the isvConnection_pages file:

{ "enable": { "baseUrl": { "tradingPrograms": "https://uk-dev.trading-programs.enable.com", "collaborator": "https://collaborator-dev.enable.com" }, "channelId": "pfx-int-dev-2", "pages": { "isvEnableProgramLinesPage": "{{baseUrl.tradingPrograms}}/Client/{{channelId}}/Deals/Schemes/Deals/{{id}}", "isvEnableSettingsPage": "{{baseUrl.tradingPrograms}}/Client/{{channelId}}/Deals/Schemes/Edit/{{id}}", "isvEnableTermsPage": "{{baseUrl.tradingPrograms}}/Client/{{channelId}}/Deals/Schemes/Terms/{{id}}", "isvEnableApprovalsPage": "{{baseUrl.tradingPrograms}}/Client/{{channelId}}/Deals/Schemes/Approval/{{id}}", "isvEnableAnalysisPage": "{{baseUrl.tradingPrograms}}/Client/{{channelId}}/Deals/Schemes/Analysis/{{id}}", "isvEnableProgramLinePage": "{{baseUrl.tradingPrograms}}/Client/{{channelId}}/Deals/Deals/Edit/{{id}}", "isvEnableForecastingPage": "{{baseUrl.tradingPrograms}}/Client/{{channelId}}/Deals/Modules/Forecasting/{{id}}", "isvEnableEarningsPage": "{{baseUrl.tradingPrograms}}/Client/{{channelId}}/Deals/Deals/DealEarnings/{{id}}", "isvEnableCustomersPage": "{{baseUrl.tradingPrograms}}/Client/{{channelId}}/Deals/TradingPartners", "isvEnableProgressTracker": "{{baseUrl.collaborator}}/en-GB/uk/{{channelId}}/progress-tracker?indirectTransactions=false" } } }

The JSON configuration is sent from PlatformManager to the Pricefx partition either when a new ISV connection is created or when the Resend to Partition (Account > ISV Connection > Vendor tab) or Send to Partitions (Administration > Constants > Enable Deeplinks) button is clicked.

How to Edit Enable Deeplinks

  1. Navigate to Administration > Constants > Enable Deeplinks to display the table of parameter names and their corresponding URL structures.

  2. Update a desired link. Use placeholders like {{baseUrl}} and {{channelId}} to maintain dynamic references.

  3. If needed, add a new link:

    1. Click the + Add a new link button at the bottom of the table.

    2. Enter the following details:

      1. Parameter Name: Provide a unique name for the new parameter.

      2. URL Structure: Define the URL using placeholders as required.

  4. Save changes to partition’s Advanced Configuration Options by clicking the Send to Partitions button at the top-right corner of the screen.

Links are now ready to use. For more details about using links in Groovy, refer to the How to Use Links to Enable in Groovy article.

ISV Enable: Important Notes

  • If Enable changes its URL structure, the generated links will no longer function, and the logic will need to be adjusted accordingly.

  • If the baseUrl or channelId is changed, previously generated links will retain their original form and will no longer work. The logic must be recalculated to ensure the links function correctly.

  • If Enable modifies its link-generating logic structure, the current logic for generating links will cease to work and will require updates.

Related content

How to Configure Rebates by Enable Integration
How to Configure Rebates by Enable Integration
More like this
How to Configure ISV Data Mapping
How to Configure ISV Data Mapping
Read with this
How to Use Links to Enable in Groovy
How to Use Links to Enable in Groovy
More like this
How to Create ISV Connection
How to Create ISV Connection
Read with this
routePage Values to Use in targetPage
routePage Values to Use in targetPage
More like this
Rebates by ENABLE in Caribou Lou
Rebates by ENABLE in Caribou Lou
Read with this

PlatformManager version 1.80.0