Getting Templates List
Using folioTemplates as a server you can see all of the id’s of the templates that your application can see, you can then use the id when creating a Folio to specify the template you are wanting to use.
| Request | Response |
|
|
To find the id of a specific template (To find the fields on it for example) you can use the exactNames on the query to refine the search, see below for an example
| Request | Response |
|
|
Getting Folio Field ID’s.
When creating or updating Folios you will need to pass the values you want in each field. You do that by using the fieldId which you get from using the folioFields query - which provides you with all of the fields on the template, their type, their name and its id that you then use when creating or updating Folios.
| Request | Response |
|
|
|
Note - The above example is for a public link application. Below is an example for a server application where you need to specify which template you want the fields for
| Request | Response |
|
|
|
Getting Entity Fields
When creating or updating Entities you will need to pass the values you want in each field. You use the entityFields query to get the unique id for each field, an truncated example of the query is shown below.
| Request | Response |
|
|
Getting Contact Fields
When creating or updating Contacts you will need to pass the values you want in each field. You use the contactFields query to get the unique id for each field - an truncated example of the query is shown below.
| Request | Response |
|
|
Breakdown of the Response
Folio Templates fields, Entity fields and Contact fields are made up of an graphql term called Edges.
Each edge contains a node which is either a field, section or table. So the node is what we care about as it contains the information.
A breakdown of what each of the items of a node is:
-
builtInFieldName
- Used to identify the BuiltInFieldName of the field so you know if it's one of Folio’s built in fields (will be null for all custom fields) - The built in fields do not have field types but are explained here
-
fieldType
-
The field will have one of the following types of fields:
- short_text
- long_text
- single_select
- multi_select
- numeric
- date
- time
- url
- attachments
- address
- scale
- instructions
-
The field will have one of the following types of fields:
-
Id
- The unique id of the field, and is what you use when sending a form back to Folio to identify the field.
-
libraryFieldId
- ID Used for the field when you are getting values from Folio
-
lookupType
-
The lookup type will have one of the following types:
- Location
- Contact
- Entity
- User
- BusinessUnit
- Program
- Folio
-
The lookup type will have one of the following types:
-
Name
- The name of the field in Folio
-
nodeType
- The type of node - is either a field, section or table.
Getting answers to single & multi select fields
To get the answers for a single or multi select field you will use the fieldAnswers query which provides all of the answers for the field. You use the id to specify the answer you want when creating or updating a Folio.
| Request | Response |
|
|