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
Feature | Support | Notes |
---|---|---|
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 Selection | N/A | This is dependant on the form(s) selected. | Form Information |
Subform Selection | N/A | This is dependant on the form(s) selected. | SubForm Information |
Subform's Subform Selection | N/A | This is dependant on the form(s) selected. | SubForm's subform Information |
Form Selection (Incremental) | _KLEENE_LOADED_DATE | This is dependant on the form(s) selected. | Form Information |
Subform Selection (Incremental) | _KLEENE_LOADED_DATE | This is dependant on the form(s) selected. | SubForm Information |
Subform's Subform Selection (Incremental) | _KLEENE_LOADED_DATE | This 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 Fieldlive
:
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.
Updated 5 days ago