Priority Software

Version 0.0.2

📘

Please read the Priority Software API documentation for more information

Set up


Accessing the Priority Software API

You will need a valid Username, Password and Company Base Url before you can use the API. You will need to retrieve this through the instructions in the Basic Authentication API Documentation.

Features


FeatureSupportNotes
Backfill🟡Backfill is supported on Forms with Business Process Management (BPM) applied via Form Selection (Incremental), Subform Selection (Incremental) and Subform's Subform Selection (Incremental) reports.
Incremental🟡Incremental is supported on Forms with Business Process Management (BPM) applied via Form Selection (Incremental), Subform Selection (Incremental) and Subform's Subform Selection (Incremental) reports.
API reliability🟡You may occasionally encounter 524 or 503 server errors due to API rate limits and timeouts. To avoid this, do not run more than two extracts simultaneously.

Reports detail


⬇️ Report🔑 Primary key📄 Link to API endpoint
Form SelectionN/AThis is dependant on the form(s) selected.Form Information
Subform SelectionN/AThis is dependant on the form(s) selected.SubForm Information
Subform's Subform SelectionN/AThis is dependant on the form(s) selected.SubForm's subform Information
Form Selection (Incremental)_KLEENE_LOADED_DATEThis is dependant on the form(s) selected.Form Information
Subform Selection (Incremental)_KLEENE_LOADED_DATEThis is dependant on the form(s) selected.SubForm Information
Subform's Subform Selection (Incremental)_KLEENE_LOADED_DATEThis is dependant on the form(s) selected.SubForm's subform Information

📘

Source Field: Company Base URL

To run the connector, input your company base URL into the 'Source' field.

For example, if the company is "Company", the base URL would most likely be erp.company.com. Still make sure to check your Priority Software account to verify that this is accurate.

📘

Extract Field: Forms can be entered into the 'Input Form(s)' field in the connector.

Within the 'Extract' configuration, forms can be added to specify those wanted in the extract, there is an example picture in the section below.

For best results, we recommend entering only one form at a time, as each form has unique columns that do not usually overlap with others. Including multiple forms in a single extract may result in a table with many columns, which will have empty cells due to non-overlapping data between form columns.

If there is a need for multiple forms in an extract, this can be done by entering them as a comma-separated list without spaces. For example, for forms "AAA", "BBB" and "CCC", these would be entered into the 'Input Form(s)' field as AAA,BBB,CCC.

📘

Extract Field: Internal/Variable Company

Within the 'Extract' configuration, you can also specify the internal or variable company name. Users can input the company variable (e.g., live, base) to dynamically connect to different Priority environments.

This field is located directly below the 'Input Form(s)' field, and these fields differ in that 'Company Field' only allows one input value at a time. Below is an example of an Input Form USERS and a Company Field live:

📘

SubForm Naming.

For Subform Selection and Subform's Subform Selection reports.

The name of a Subform or a Subform with another Subform must be appended with the suffix _SUBFORM. For example, if the Subform is called CONTACTS, its equivalent name for retrieval via the API would be CONTACTS_SUBFORM.

🚧

Note: The Forms available depend on the credentials access

For all forms to be retrieved correctly from the report, ensure that the credentials used have access to the report.

🚧

Note: Subform's Subform Data Format

Data returned within the Subform's Subform extract is in a compressed form and requires flattening through transforms.

🚧

Note: Incremental Versions of the Forms, Subforms and Subform's Subform Selection.

These reports are only available for forms with Business Process Management (BPM) applied. You can find helpful knowledge articles on setting this up here and webinar here.