Trello Reader

Note

This adapter is in preview and is available on Striim Developer only. See Striim Developer for more information.

Trello is a visual project management application that facilitates peer collaboration. Trello provides your team with the ability to manage any kind of project, workflow, or task tracking by organizing your processes into boards. Striim's Trello Reader models these entities as relational objects, allowing data to be seamlessly migrated from the Trello application to any relational database or data warehouse.

Feature summary

Feature		Supported?	Notes
Objects	Standard objects	✓
Objects	Custom objects	✓
Authentication	Basic authentication		Username and password
	OAuth authentication	✓	Manual configuration based
	Custom authentication methods		Not all methods may be supported
Operations	Automated mode	✓
	Initial load	✓
	Pull-based incremental load	✓
	Push-based incremental load
	Automated pipeline
Governance	Connection profile
	Sherlock AI
	Sentinel AI
Schema handling	Initial schema creation	✓	Works with supported targets
Schema handling	Schema evolution
Setup	Wizard template
	Flow Designer	✓
	Striim TQL	✓
Runtime	Resilience/recovery	✓
	Parallel execution
	Metrics	✓	Standard metrics

Supported authentication method

The Trello Reader supports OAuth authentication using a combination of API key and OAuth token. The API key is tied to your Trello account and is used to identify your application when making requests. In addition to the API key, you'll also need an OAuth token. Creating a connection requires retrieving your API key from Trello, generating an OAuth token after initiating an OAuth authorization, and setting connection properties in Striim.

To create a connection using OAuth authentication:

Go to the Trello Developer API Key page.
Log in if necessary, and you can see or generate your API Key. Copy this key for use in API requests.
Create a URL to request the user's permission and generate an OAuth token. The URL to initiate OAuth authorization has the following format:
```
https://trello.com/1/authorize?response_type=token&key=your_api_key&scope=read&name=YourApp&expiration=never
```
- response_type=token: Indicates you are requesting an OAuth token.
- scope=read: The permissions your app is requesting.
- name=YourApp: The name of your application.
- key=your_api_key: Replace this with the API key you obtained in step 2.
Authorize the application when prompted. Once authorized, Trello will redirect to a URL containing the Auth token:
```
https://your_redirect_url#access_token=your_oauth_token&token_type=bearer
```
After the user authorizes the app, extract the OAuth token from the URL fragment access_token=YOUR_OAUTH_TOKEN.

Supported objects

The following are the supported objects for reading from Trello:

Actions
BoardPlugins
BoardPreferences
BoardStars
Boards
CardAttachments
CardChecklists
CardLabels
CardMembers
CardStickers
Cards
CheckListItems
Checklists
Comments
Enterprises
Exports
Labels
Lists
Memberships
Notifications
OrganizationMembers
OrganizationPreferences
Organizations
PluginData
Reactions
TokenPermissions

Trello Reader properties

Property	Type	Default value	Notes
API key	Password		The Trello API key used with a token to authenticate using Trello's own authorization route.
Token	Password		The Trello token used with the API key to authenticate using Trello's own authorization route.
Connection pool size	Integer	20	Specifies the maximum number of active connections.
Exclude tables	String		A list of tables excluded from read operations. Typically used to create a list of exceptions when the Tables property includes wildcards. Misconfiguration of the Tables and Exclude Tables properties can cause "Invalid table names" errors.
Incremental load marker	String		The incremental load marker is a unique incremental column in each object used for incremental load. When no marker is specified, tables are resynced at each polling interval. Specify the name of the column that contains the start position value. This column must meet the following criteria: It should have an integer or timestamp data type (for example, a creation timestamp or an employee ID). The values must be unique and continuously increasing to ensure proper incremental reading.
Migrate schema	Boolean	False	Only available in Initial Load or Automated mode. Set to `True` to enable initial schema migration, which propagates the object schema from the source to the target.
Mode	Select list: Automated mode Initial load Incremental load	Automated	Automated mode applies incremental updates to objects that support incremental load and performs full resyncs for objects that do not support incremental load.
Polling interval	Integer	5m	Specifies an interval as an integer followed by a unit. Supported units are days (`d`), hours (`h`), minutes (`m`), or seconds (`s`). The reader polls the source at the specified interval.
Start Position	String	%=-1	Value of the incremental load marker that defines the initial reading position.
Tables	String		A semicolon-delimited (;) list of objects to read from the source. Supports the `%` wildcard. Misconfiguration of the Tables and Exclude Tables properties can cause "Invalid table names" errors. Do not modify this property when recovery is enabled for the application.
Thread pool count	Integer	10	The number of parallel running threads. The default value of zero specifies single-threaded operation. When the value of the thread pool counter is higher than the connection pool size, large data ingestion operations can cause the app to halt. Since best performance is achieved when using one thread for each table being synced, increasing the size of the connection pool to match the number of threads in use is a performance best practice.