Versions Compared

Version Old Version 42 New Version 43
Changes made by

Carrie Warner (Unlicensed)

Carrie Warner (Unlicensed)

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

 

Section

Image Added

Run Twitter Reader for the First Time

The first time you run the Twitter Reader, you are prompted to create a new server connection instance. Enter an Instance Name and click OK.

Image Added

Setup Tab - Connect to a Database

The Twitter Reader agent must be configured to connect to a database. Connection and user authentication values would have been correctly configured by your system administrator initially during installation; however, you can modify the values at any time using the Setup tab. Modify configuration and click Test Connection. Your configuration is automatically saved.

Column
width70%

Twitter Reader is an agent that runs in the background on the data server, such as TweetOut or Super Ticker. The Twitter Reader agent connects directly to the TweetOut or Super Ticker database. This agent It reaches out to Twitter and returns valid content based on your enabled topic searches created in Flow.

Expand
titleClick here to see an example of the screen.

Image AddedImage Added


Note

Important: This The Twitter Reader agent must be running in order to receive new content. If you are troubleshooting a lack of new content, ensure that the Twitter Reader agent is running and functional using the Agent Status.

Running a

Cloud Instance or Local Instance?

 

Customers using a cloud instance of TweetOut or Super Ticker do not need to manage the Twitter Reader themselves; Bannister Lake manages it for you. For assistance with your instance of Twitter Reader, contact Bannister Lake Support. 

Running a Local Instance?

Customers using a local instance of TweetOut or Super Ticker can access and manage their own instance of Twitter Reader.

  • In a standard installation, Twitter Reader is available on the server, also known as the Flow Server or database server.
  • In a custom installation, Twitter Reader may be located elsewhere. See your local system administrator for details.

Access Twitter Reader

To access the Twitter Reader agent, run the agent from its desktop icon on the server.

Image Removed

Image Removed

Configure Twitter Reader

When the agent opens, you can configure the following options.

OptionDescription
Expand
titleClick here to see an example of the screen.
Note

Use caution when modifying these values. 

Image Added

Setup Tab - Feed Settings

Using the Setup tab, you can also configure the following feed settings:

OptionDescription
Remove Links From Tweets

By default, the Twitter Reader removes hypertext links from Tweets. You can re-enable links by enabling this option.

Filter on Black List words

By default, the Twitter Reader automatically removes Tweets that contain words found in the Black List. You can turn off Black List content validation by disabling this option, though it is not recommended.

For more information on Black List filtering:

Store ImagesYou can choose to store images attached to Tweets in the database to use in a broadcast by enabling this option. By default, images are not stored in the database.
Read Tweets Every X Seconds

You can configure how often Tweets are read using this option. This value must be a minimum of 60 seconds (1 minute).

Run Tab

The Run tab displays the following details:

OptionDescription
Countdown

By default, the Twitter Reader attempts to retrieve data every two (2) minutes. You can adjust this frequency on the Setup tab; however, the minimum frequency must be one (1) minute or more.

Click Read Now to manually retrieve data on demand and bypass the countdown clock.

Rate Limit

Twitter only allows data clients like Twitter Reader to make a limited number of calls for new data in a given hour to

protect against querying for Tweets too frequently and to

control abuse. If the rate limit reaches zero (0) no new tweets will be retrieved.


 


To avoid exceeding Twitter’s limits,

remove

disable any unnecessary TweetOut topics in Flow.

TopicsYou can review all of the Twitter topics configured via Flow, and review whether or not they are currently enabled.
New Tweets
Review the
The number of new Tweets added
on
during the last data retrieval.
Countdown For Next Read

By default, Twitter Reader attempts to retrieve data every two (2) minutes. The countdown frequency can be adjusted via File > Preferences; however, the minimum value must be one (1) minute or more.

Read NowTrigger an immediate data retrieval by clicking Read Now to bypass the countdown clock.File > Preferences 

The Twitter Reader agent must be configured to connect to your database. Connection and user authentication values would have been correctly configured by your system administrator initially during installation. Use caution when modifying these values.   

Image Removed

From this dialog you also:

  • Test your connection to your database by clicking Test Connection. This can be a handy troubleshooting step.
  • Control whether Tweets returned include hypertext links or not using the Remove Links From Tweets option. 
  • Configure the reader for a single user or a pool of users that all TweetOut Readers share between them using the User Pool option. When configuring the user pool option you need to restart the Twitter Reader for your changes to take effect.
  • Enable or disable the automatic black list content validation using the Filter on Black List words option.
  • Configure how often Tweets are read using the Read Tweets Every value. You will not be able to set this value lower than 60 seconds.
Help > Open Today’s LogTwitter Reader generates a log file of its activities while it’s running.
You can review this log file. Using the date and time, you can confirm that Twitter Reader is connecting and returning Tweets successfully
Status, Database Connection, & Enabled
  • Data retrieval status and time stamp
  • Database connection status
  • Agent status

Topics Tab

The Topics tab shows you all of the Twitter topics configured and enabled in Flow.

Check for Updates

On launch, Twitter Reader automatically checks for updates and prompts you if a newer reader version becomes available.

Image Added

You can manually check for updates by selecting Help > Check for Updates.

Multiple Server Instance Support

You can create and manage multiple server instances for the Twitter Reader.

  1. To create another instance, select File > New Instance.
  2. Assign the instance a name and configure that instance for a specific database.
Column
width30%
Panel
borderColor#0070b1
bgColor#FFFFFF
borderWidth1

In this section:

Table of Contents
indent15px

Include Page
DAS:Promos Top
DAS:Promos Top

...