Graft uses a number of field types to help configure data sources, entities and enrichments, the following details how to use them and any limitations
A text field allows you to enter any text and usually appears as a blank box in the UI with the name of the field
Depending on the data source and its access method additional syntax to look for specific terms such as "hello world" rather than any of "hello" or "world" may be used Twitter search Documentation
A list field is a variation of the Text field with options to manually enter a list using the separator defined in the tool tip for the field or using a pre-loaded datasource. A list field is identified by the "Data Icon"
This icon will appear Black when one or more data sources are available or "greyed out" if none are available.
Using a data source as a list
When using another data source as a list you will specify which field is the one to be pulled in and used as the list.
For this example we will create a twitter data source and pull in a list of authors from another uploaded source file (climate experts).
- Click on the data source icon (in the Author field)
- Check Pull Values From Data Source
- Select the pre-loaded datasource file from the drop down list
- Select the field to be used for your list (author in our example)
- Set the max number of results to be pulled into the datasource
- Click the "X" in the top right hand corner of the window to return to the Data source configuration screen
The field is now populated with the list from the second data source Click NEXT once the rest of the screen has been completed
Details of how to set up a CSV or S3 file can be found in the Connecting to your data section of the help center
HOW LISTS AND QUERY LIMITS WORK
In order to not have a single Author bias the retrieved tweets, Graft will round robin each Author on the list retrieving a tweet per Author (if it exists) and then moving on to the next, Graft will continue to iterate through the list until the Limit is reached. It is best practice to ensure that the limit matches or is greater than the number of entries in the list field.
PROCESSING COST IMPACTS OF USING A LIST
Please note that depending on the data source using a list may have an impact on the processing and storage costs. In this example Graft would query twitter for each Author listed as a tweet can only have a single Author and not combinations
A number only field will allow integers to be entered, once clicked upon the up and down arrows will appear allowing the user the option to click through to select the correct number
The password field is easily identifiable with the ‘eye’ icon at the end of the field box.
Toggling on this icon will display or hide your password