The Socrata Open Data Listener allows to query Socrata Open Data services with the custom SoQL queries.
This Listener has 4 tabs: Basic, Advanced, Transaction Logging and SoQL Query.
1. Basic: Here you will specify the following:
Polling interval: how often the Input File query is executed
Service URL: URL of the Socrata Open Data service. Sandbox service by default
Email: username used for authentication
Password: password used for authentication
Application Token: application (API) token of the user
Resource ID: ID of the resource to query
Return Data Type: what type of data will be returned.
2. Advanced: In the Advanced tab, you can specify:
Initialize on trigger only: If enabled, the Listener doesn’t start up until a trigger initializes it.
Allow command-line invocation: If enabled, the Listener can be invoked using the CLI client application.
Restart on listening error: If enabled, the Listener will be restarted after an error occurs.
FIFO Queue Name: The FIFO stuff enables a “First In, First Out” queuing mechanism between Listeners and Transports. If a “FIFO Queue Name” is provided, that name will be used as a key for a queue Transactions & will be pushed into before reaching a transport. They’ll be ordered in this queue according to when the Listener created them.
FIFO Queue Delay: It is the interval between updates/checks against that queue. Providing a queue name guarantees that a given Transport sends transactions in the same order the Listener created them in.
3. Transaction Logging – This tab allows us to enable transaction events logging. That data can be logged by a TransactionEventListener.
Transaction Logging Enable checkbox allows transaction events originating from this listener to be logged by a TransactionEventListener.
Log Transaction Attribute – if enabled, logs transaction attributes.
Log Transaction Data – if enabled, logs transaction data body.
Log Transaction Data Base64 – if enabled, logs transaction data body as Base64.
4. SoQL Query: In the SoQL Query tab, you can specify:
Select All: if selected, all the data will be selected from the data set.
SoQl Query: Socrata Query Language expression.