The Tealeaf Segment Builder service can be used to create session segments based on externally specified queries of Tealeaf session data. For example, a third-party application can specify a set of queries in a file, which are then run to generate a new session segment.
Uploading segment queries
This service polls a preconfigured directory within the Tealeaf install directory for query files, runs the queries, and assembles the returned session data into a session segment. The segment is then available through the Portal.
The preferred method is to upload the file to the directory by using the Portal.
Prepared segment queries are retrieved from the following directory:
<install_directory>\Integration\Segments
Operations
When the Segment Builder polls the Segments
directory, it attempts to turn the .txt
, .csv
, or .zip
files in the directory into sets of queries of the Tealeaf session dataset.
If the process is successful, the segment becomes available through the Managing Session Segments page. The source file is moved to the following directory:
<install_directory>\Integration\Completed
If there is a failure, the file is moved to the completed directory and the error is logged in the log file. In this case, no session segment is created.
Monitoring segment builder service
You can monitor the progress of the Segment Builder service through the Managing Session Segments page in the Portal.
The service detects any new files in the segment directory and processes them immediately. When the queries are finished, the assembled session segment is available through the Managing Session Segments page.