接続の確立

Sync App アプリケーションの接続ページに移動し、接続の追加 パネルで対応するアイコンを選択して、Trello への接続を作成します。Trello アイコンが利用できない場合は、Add More アイコンをクリックしてCData サイトからTrello コネクタをダウンロードおよびインストールします。

必須プロパティは［設定］タブにリストされています。［Advanced］タブには、通常は必要ない接続プロパティが表示されます。

Trello は、トークンベース認証を使用して、サードパーティアプリケーションにAPI へのアクセスを許可します。ユーザーがアプリケーションにデータへのアクセスを許可すると、アプリケーションにはTrello のAPI へのリクエストに使用できるトークンが付与されます。 Trello のAPI には2通りの方法でアクセスできます。1つ目はTrello 独自の認可ルートで、2つ目はOAuth1.0 を使用する方法です。

Trello 認可ルート

登録の時点で、Trello はAPI キーとトークンをアカウントに割り当てます。

Note: Set AuthScheme to Token to activate this authentication method.

登録の時点で、Trello はAPI キーとトークンをアカウントに割り当てます。Trello にログインしてhttps://trello.com/app-key にアクセスすると、このAPI キーを取得できます。 API キーを取得したら、それを使用してhttps://trello.com/1/authorize?expiration=never&name=MyPersonalToken&scope=read,write,account&response_type=token&key={Key} にアクセスし、{key} を取得したAPI キーで置き換えるとToken を取得できます。ページにアクセスした後、［許可］ボタンをクリックして、アプリケーションがアカウントを使用することを許可できます。トークンを使用してページにリダイレクトされます。 Trello のAPI にリクエストするには、API キーとトークンの両方が必要になります。

Note: You can change the expiration time of the token by changing expiration= with one of the following values (1hour, 1day, 30days, never).

以下を設定します。

APIKey：https://trello.com/app-key にあるキー
Token：取得したトークン

OAuth

Note: Set AuthScheme to OAuth to activate this authentication method.

認可の使用と同様に、OAuth は、アカウントの作成時にApplication Id とSecret を作成します。接続方法については、OAuth 認証の使用を参照してください。

データアクセスのファインチューニング

カスタム接続プロパティ

OrganizationId

Trello のOrganizationId は、接続文字列で指定することで特定のTrello 組織を参照します。指定すると、いくつかのクエリの対象範囲がその組織に関連付けられます。例：

SELECT * FROM Lists

は、その組織のボードのリストをすべて返します。

SELECT * FROM Memberships

は、その組織のメンバーをすべて返します。

SELECT * FROM Actions

は、その組織のアクションをすべて返します。

BoardId

Trello のBoardId は、接続文字列で指定することで、特定のTrello ボードを参照します。指定すると、いくつかのクエリの対象範囲がそのボードに関連付けられます。例：

SELECT * FROM Lists

は、そのボードのリストをすべて返します。

SELECT * FROM Memberships

は、そのボードのメンバーをすべて返します。

SELECT * FROM Actions

は、そのボードのすべてのアクションを返します。ボードは多数のアクションを持つ可能性があるため、クエリの実行に時間がかかる場合があります。

MemberId

Trello のMemberId は、接続文字列で指定することで、特定のTrello メンバーを参照します。指定すると、いくつかのクエリの対象範囲がそのメンバーに関連付けられます。例：

SELECT * FROM Actions

は、そのメンバーのアクションをすべて返します。

SELECT * FROM Boards

は、ログインしているユーザー、および指定されたメンバーの両方が共通して持つボードをすべて返します。

IncludeCustomFields

カスタムフィールドはTrello で最も人気のあるPower-Up です。カスタムフィールドを使い始めるには、Trello ボードでPower-Up を有効にして、カードにカスタムフィールドを作成、または追加します。 IncludeCustomFields はすでにデフォルトでtrue に設定されているので、接続文字列にBoardId を指定するだけでカスタムフィールドが表示されるようになります。この接続プロパティは、Trello カードに作成されたカスタムフィールドを取得するために使用します。

SELECT * FROM Cards

このクエリを実行すると、作成されたカスタムフィールドがすべて、テーブルのカラムとしてリスト化されます。カラム名はカスタムフィールド名となり、行の値はカスタムフィールドの値となります。ドロップダウンリストタイプのカスタムフィールドの場合は、選択されたオプション名が表示されます。

高度な機能

このセクションでは、Trello Sync App の高度な機能を厳選して説明します。

ユーザー定義ビュー

Sync App を使用すると、事前設定されたクエリによって内容が決定されるユーザー定義ビューと呼ばれる仮想テーブルを定義できます。このビューは、ドライバーに発行されるクエリを直接制御できない場合に有効です。カスタムビューの作成と設定の概要については、ユーザー定義ビューを参照してください。

SSL の設定

SSL の設定を使用して、Sync App が証明書のネゴシエーションをどのように扱うかを調整します。さまざまな証明書形式を選択できます。詳しくは、接続文字列オプションにあるSSLServerCert プロパティを参照してください。

ファイアウォールとプロキシ

Windows プロキシとHTTP プロキシを含むファイアウォールとプロキシに合致するようSync App を設定します。トンネル接続を設定することもできます。

クエリ処理

Sync App は、Trello にできるだけ多くのSELECT ステートメント処理をオフロードし、残りのクエリをクライアント側のインメモリで処理します。

詳しくはクエリ処理を参照してください。

ログ

CData ログを調整するために使用可能な設定の概要については、ログを参照してください。基本的なロギングでは、次の2つの接続プロパティを設定するだけです。LogModules 接続プロパティを使用してログに記録する情報のサブセットを選択できる、より洗練されたロギングをサポートする多数の機能があります。

SSL の設定

SSL 設定のカスタマイズ

デフォルトでは、Sync App はサーバーの証明書をシステムの信頼できる証明書ストアと照合してSSL / TLS のネゴシエーションを試みます。

別の証明書を指定するには、利用可能なフォーマットについてSSLServerCert プロパティを参照してください。

ファイアウォールとプロキシ

Firewall またはProxy 経由の接続

HTTP プロキシ

Windows のシステムプロキシ経由の接続では、接続プロパティを追加で設定する必要はありません。他のプロキシに接続するには、ProxyAutoDetect をfalse に設定します。

さらにHTTP プロキシへの認証には、ProxyServer とProxyPort に加えてProxyAuthScheme、ProxyUser、およびProxyPassword を設定します。

その他のプロキシ

次のプロパティを設定します。

プロキシベースのファイヤーウォールを使用するには、FirewallType、FirewallServer、およびFirewallPort を設定します。
接続をトンネルするには、FirewallType をTUNNEL に設定します。
認証するには、FirewallUser とFirewallPassword を設定します。
SOCKS プロキシへの認証には、さらにFirewallType をSOCKS5 に設定します。

データモデル

The CData Sync App models Trello objects as relational views. A Trello object has relationships to other objects; in the views, these relationships are expressed through foreign keys. The following sections show the available API objects and provide more information on executing SQL to Trello APIs.

Key Features

The Sync App models Trello Boards, Lists, Labels, and more as relational views, allowing you to write SQL to query Trello data.
Stored procedures allow you to execute operations to Trello, including downloading and uploading objects.
Live connectivity to these objects means any changes to your Trello account are immediately reflected when using the Sync App.

テーブル

Sync App はTrello のデータを、標準のSQL ステートメントを使用してクエリできるテーブルのリストにモデル化します。

一般的には、Trello テーブルのクエリは、リレーショナルデータベースのテーブルのクエリと同じです。時には特別なケースもあります。例えば、テーブルの特定のカラムデータを取得するために特定のカラムをWHERE 句に含める必要がある場合などです。これは通常、特定のカラムを取得するために行ごとに個別のリクエストを行う必要がある場合に必要です。これらの特別な状況は、以下にリンクされているテーブルページの上部に明確に文書化されています。

Trello Connector for CData Sync テーブル


Name	Description
Cards	Lists all the cards from every board
Comments	Lists comments on cards.

Cards

Lists all the cards from every board

Table Specific Information

Select

The Sync App will use the Trello API to process WHERE clause conditions built with the following columns and operators. The rest of the filter is executed client-side within the driver. For example, the following query is processed server-side: Closed column determines if the Card has been archived or not.

SELECT * FROM Cards

The query above will return all cards found regardless of whether they are archived or not.

SELECT * FROM Cards WHERE Closed='false'

The query above will return all the cards that are not archived.

SELECT * FROM Cards WHERE ListID='4e99eb7aa9797361bc22e6d5'

SELECT * FROM Cards WHERE BoardID='4e99eb7aa9797361bc22e6ct'

SELECT * FROM Cards WHERE Closed='true'

You can turn off client-side execution by setting SupportEnhancedSQL to false in which case any search criteria that refers to other columns will cause an error.

Insert

To insert a new Card in table Cards you have to specify a Name and a ListId in the insert statement. Columns Name, Description, ListID, MemberIds, LabelIds and Due can be used for insert where ListId is. Columns MemberIds and LabelIds are comma separated list of member/label ids. Example of inserting a new Card:

INSERT INTO Cards(Name, Description, ListID, MemberIds, LabelIds, Due) VALUES('new Card', 'new card description', 'list_id', 'member_id_1, member_id_2', 'label_id_1,label_id_2', '2019-09-18')

Update

To execute an update to table Cards you have to specify the CardId you are trying to update. Columns Name, Description, ListID, MemberIds, LabelIds, Due and closed can be updated. Columns MemberIds and LabelIds are comma separated list of member/label ids. Example of updating all the fields:

UPDATE Cards SET Name='new name', Description='new description', ListID='listId', MemberIds='member_id_1,member_id_2', LabelIds='label_id_1,label_id_2', Due='2019-09-18' WHERE CardID='card_id'

To archive a card you can update its closed property to true for ex:

UPDATE Cards SET Closed='true' WHERE CardID='card_id'

Delete

To delete a card you must specify a CardID for ex:

DELETE FROM Cards WHERE CardID='card_id'

Columns


Name	Type	ReadOnly	Description
CardID [KEY]	String	True	The Id of the card
Name	String	False	The name of the card
BoardID	String	True	The Id of the board which the card references
ListID	String	False	The Id of the list which the card references
MemberIds	String	False	The Ids of the members assigned to card
CheckListId	String	True	The Id of the checklist which the card references
LabelIds	String	False	The Ids of the labels assigned to card
CoverAttachmentId	String	True	The Id of the attachment on the cover of the card
Description	String	False	Description of the card
Closed	Boolean	False	Determines if the card is closed or not
Due	Datetime	False	This field returns the due time if it has been assigned to card
LastActivityDate	Datetime	True
AttachmentCount	Int	True	Number of total attachments in the card
StartDate	Datetime	True	The start date of a card!

Comments

Lists comments on cards.

Columns


Name	Type	ReadOnly	Description
CommentId [KEY]	String	False	The Id of the action
Type	String	True	The action type (possible values https://developers.trello.com/reference#action-types)
Date	Datetime	True	Date created
BoardID	String	True	The Id of the board which the action references.
ListName	String	True	The name of the list which the action references.
ListID	String	True	The Id of the list which the action references.
CardID [KEY]	String	False	The Id of the card which the action references.
CardName	String	True	The name of the card which the action references.
CardShortLink	String	True	The link of the card which the action references.
MemberId	String	True	The Id of the member associated with the action.
MemberName	String	True	The name of the member associated with the action.
OldPosition	String	True	The old position of the card when you move it up or down inside a list.
ListAfterId	String	True	The old position of the card when you move it up or down inside a list.
ListBeforeId	String	True	The old position of the card when you move it up or down inside a list.
OrganizationID	String	True
Comment	String	False	The comment body if the action is of type commentCard
CreatedDate	Datetime	True	The time the action was created

ビュー

ビューは、カラムと疑似カラムで構成されます。ビューは、データを示すという点でテーブルに似ていますが、ビューでは更新はサポートされません。通常、ビューとして表されるエンティティは、読み取り専用のエンティティです。多くの場合、これらのデータはストアドプロシージャを使用することで更新できます（その機能がデータソースに適用できる場合）。

ビューに対しては、通常のテーブルと同じようにクエリを実行でき、このときに返されるデータも同様です。

ビューとして公開されるクエリなどの動的ビューや、project_team ワークアイテムの特定の組み合わせを検索するためのビューがサポートされています。

Trello Connector for CData Sync ビュー


Name	Description
Actions	Lists different actions made on Organization/Board/Card determined by type.
BoardPlugins	Lists all plugins enabled for each board.
BoardPreferences	Lists preferences of the boards.
Boards	Lists all boards that are available to the user.
BoardStars	Lists all the Boards that the user has starred.
CardAttachments	Lists all the attachments of each card.
CardChecklists	Lists all checklists that have been created.
CardLabels	Lists all labels assigned to each card.
CardMembers	Lists all members assigned to each card.
CardStickers	Lists all stickers for each card.
CheckListItems	Lists all items found on checklists.
Checklists	Lists all checklists found on boards.
Enterprises	Gets information about an enterprise.
Exports	Lists all exports of the organizations.
Labels	Lists all labels of the boards.
Lists	Lists all the lists that have been created on boards.
Memberships	Lists all members associated with the boards.
Notifications	Lists all notifications of the user logged.
OrganizationPreferences	Lists preferences of the boards.
Organizations	Lists all organizations where the user is associated.
PluginData	Get data from plugins that have been enabled on board.
Reactions	Lists all Reactions made on the logged users Actions.
TokenPermissions	Gets information about read and write permissions.

Actions

Lists different actions made on Organization/Board/Card determined by type.

Table Specific Information

Select

The Sync App will use the Trello API to process WHERE clause conditions built with the following columns and operators. The rest of the filter is executed client-side within the driver. For example, the following queries are processed server-side: Actions differ from each other from their type.

SELECT * FROM Actions WHERE Type='commentCard' AND CardId='56eae4d5eb3eb531f1ab43af'

We are retrieving all comment actions made on Card with CardId='56eae4d5eb3eb531f1ab43af'.

SELECT * FROM Actions WHERE Type='addMemberToBoard' AND BoardId='5835595ee004411c6abdbfbd'

We are retrieving all add member actions made on Board with BoardId='56eae4d5eb3eb531f1ab43af'.

For a full list of actions types, visit: https://developers.trello.com/reference#action-types

If BoardId and OrganizationId are not present in the connection properties or in query ( in the case of

SELECT * FROM Actions

, for example) all logged actions of the user will be returned,

otherwise if BoardId is specified,

SELECT * FROM Actions

will return all Actions of the board. Because a board can have many actions, the query may take a while to execute.

If OrganizationId is specified

SELECT * FROM Actions

will return all actions actions on the organization.

If both properties are present

SELECT * FROM Actions

will return all Actions of the board.

You can turn off client-side execution by setting SupportEnhancedSQL to false in which case any search criteria that refers to other columns will cause an error.

Columns


Name	Type	Description
ActionId [KEY]	String	The Id of the action
Type	String	The action type (possible values https://developers.trello.com/reference#action-types)
Date	Datetime	Date created
BoardID	String	The Id of the board which the action references.
ListName	String	The name of the list which the action references.
ListID	String	The Id of the list which the action references.
CardID	String	The Id of the card which the action references.
CardName	String	The name of the card which the action references.
CardShortLink	String	The link of the card which the action references.
MemberId	String	The Id of the member associated with the action.
MemberName	String	The name of the member associated with the action.
OldPosition	String	The old position of the card when you move it up or down inside a list.
ListAfterId	String	The old position of the card when you move it up or down inside a list.
ListBeforeId	String	The old position of the card when you move it up or down inside a list.
OrganizationID	String

BoardPlugins

Lists all plugins enabled for each board.

Table Specific Information

Select

The Sync App will use the Trello API to process the criteria columns. Get all the plugins that are enabled in Boards.

SELECT * FROM BoardPlugins

SELECT * FROM BoardPlugins WHERE BoardId='5835594ee003411c6abdbfbd'

You can turn off client-side execution by setting SupportEnhancedSQL to false in which case any search criteria that refers to other columns will cause an error.

Columns


Name	Type	Description
ID	String	Record Id.
PluginId [KEY]	String	The Id of the Plugin.
BoardId	String	The Id of the Board.

BoardPreferences

Lists preferences of the boards.

Table Specific Information

Select

The Sync App will use the Trello API to process WHERE clause conditions built with the following columns and operators. The rest of the filter is executed client-side within the driver. For example, the following query is processed server-side:

SELECT * FROM BoardPreferences

SELECT * FROM BoardPreferences WHERE BoardId='5835594ee004411c6abdbfbc'

You can turn off client-side execution by setting SupportEnhancedSQL to false in which case any search criteria that refers to other columns will cause an error.

Columns


Name	Type	Description
BoardId [KEY]	String	The Id of the Board.
BoardName	String	The Name of the Board.
PermissionLevel	String	Permission level of the board (private, organization, public).
HideVotes	Boolean	Determines if votes can be shown or not.
Voting	String	Determines if voting is allowed.
Comments	String	Determines the user level which can comment.
Invitations	String	Determines the user level which can invite.
SelfJoin	Boolean	Determines if self join is enabled.
IsTemplate	Boolean	Determines if the board is a template.
CardCovers	Boolean	Determines if cards should have covers or not.
CardAging	String	Determines what style the cards will get if they stay for too long in a list.
CalendarFeedEnabled	Boolean	Determines if the calendar feed is enabled.
Background	String	Background color.
BackgroundImage	String	Background image.
BackgroundImageScaled	String	Background image.
BackgroundTile	String	Background tile.
BackgroundBrightness	String	Background brightness.
BackgroundColor	String	Background color.
BackgroundBottomColor	String	Bottom background color.
BackgroundTopColor	String	Top background color.
CanBePublic	Boolean	Determines if the board can be public.
CanBeEnterprise	Boolean	Determines if the board can be enterprise.
CanBeOrg	Boolean	Determines if the board can be an organization.
CanBePrivate	Boolean	Determines if the board can be private.
CanInvite	Boolean	Determines if invitations are enabled.

Boards

Lists all boards that are available to the user.

Table Specific Information

Select

The Sync App will use the Trello API to process WHERE clause conditions built with the following columns and operators. The rest of the filter is executed client-side within the driver. For example, the following query is processed server-side:

SELECT * FROM Boards

SELECT * FROM Boards WHERE Starred='true'

SELECT * FROM Boards WHERE OrganizationId='583558863c5859587053200c'

We can retrieve public Trello Boards by providing their Id directly to the query. You can try the query below, which tries to retrieve data from the following board https://trello.com/board/trello-development/4d5ea62fd76aa1136000000c

To get the Id of a public board, append ".json" to the board URL ( https://trello.com/b/rq2mYJNn/public-trello-boards.json for example ) and you will see something like "{"id":"4e99eb7aa9797361bc22e6ce", ...". Take that id and use it in a query.

SELECT * FROM Boards WHERE BoardId='4d5ea62fd76aa1136000000c'

You can turn off client-side execution by setting SupportEnhancedSQL to false in which case any search criteria that refers to other columns will cause an error.

Columns


Name	Type	Description
BoardID [KEY]	String	The Id of the Board
Name	String	The name of the Board
Pinned	Boolean	Determines if Board is pinned or not
Starred	Boolean	Determines if Board is starred or not
Closed	Boolean	Determines if Board is archived or not
Url	String	Board Url
DateLastView	Datetime	Time when it board was last viewed
MemberID	String	References the member of the board
OrganizationID	String	References the organization of which the board is part of
MyCustomFieldName	String	My custom field.

BoardStars

Lists all the Boards that the user has starred.

Table Specific Information

Select

The Sync App will use the Trello API to process WHERE clause conditions built with the following columns and operators. The rest of the filter is executed client-side within the driver. For example, the following query is processed server-side:

SELECT * FROM BoardStars

SELECT * FROM BoardStars WHERE BoardId='4e99eb7aa9897361bc22e6ce'

You can turn off client-side execution by setting SupportEnhancedSQL to false in which case any search criteria that refers to other columns will cause an error.

Columns


Name	Type	Description
ID [KEY]	String	Record Id.
BoardId	String	The Id of the Board.
Position	Int	Position.

CardAttachments

Lists all the attachments of each card.

Table Specific Information

Select

The Sync App will use the Trello API to process WHERE clause conditions built with the following columns and operators. The rest of the filter is executed client-side within the driver. For example, the following query is processed server-side:

SELECT * FROM CardAttachments

SELECT * FROM CardAttachments WHERE CardId='56eae4d5eb3eb531f1ab43af'

SELECT * FROM CardAttachments WHERE BoardId='5835594ee003411c6abdbfbd'

You can turn off client-side execution by setting SupportEnhancedSQL to false in which case any search criteria that refers to other columns will cause an error.

Columns


Name	Type	Description
CardID [KEY]	String	The Id of the Card.
AttachmentId [KEY]	String	The Id of the Attachment.
Name	String	Filename of the Attachment.
BoardID	String	The Id of the Board referencing the card with attachment.

CardChecklists

Lists all checklists that have been created.

Table Specific Information

Select

The Sync App will use the Trello API to process WHERE clause conditions built with the following columns and operators. The rest of the filter is executed client-side within the driver. For example, the following query is processed server-side:

SELECT * FROM CardCheckLists

SELECT * FROM CardCheckLists WHERE BoardId='4e99eb7aa9897361bc22e6ce'

SELECT * FROM CardCheckLists WHERE CardId='5cd4655f9c12a516f688b296'

You can turn off client-side execution by setting SupportEnhancedSQL to false in which case any search criteria that refers to other columns will cause an error.

Columns


Name	Type	Description
CardID [KEY]	String	The Id of the card where the checklist was created.
CheckListId [KEY]	String	The Id of the Checklist.
BoardID	String	Id of the board referencing the card with the checklist.

CardLabels

Lists all labels assigned to each card.

Table Specific Information

Select

The Sync App will use the Trello API to process WHERE clause conditions built with the following columns and operators. The rest of the filter is executed client-side within the driver. For example, the following query is processed server-side:

SELECT * FROM CardLabels

SELECT * FROM CardLabels WHERE CardId='5cd4655f9c12a516f688b296'

You can turn off client-side execution by setting SupportEnhancedSQL to false in which case any search criteria that refers to other columns will cause an error.

Columns


Name	Type	Description
CardID [KEY]	String	Id of the card holding the label.
LabelId [KEY]	String	Id of the label.
BoardID	String	Id of the board holding the card with assigned label.

CardMembers

Lists all members assigned to each card.

Table Specific Information

Select

The Sync App will use the Trello API to process WHERE clause conditions built with the following columns and operators. The rest of the filter is executed client-side within the driver. For example, the following query is processed server-side:

SELECT * FROM CardMembers

SELECT * FROM CardMembers WHERE CardId='5cd4655f9c12a516f688b296'

You can turn off client-side execution by setting SupportEnhancedSQL to false in which case any search criteria that refers to other columns will cause an error.

Columns


Name	Type	Description
CardID [KEY]	String	The Id of the card
MemberId [KEY]	String	The Ids of the members assigned to card
BoardID	String	The Id of the Board holding the card
OrganizationID	String	The Id of the Organization

CardStickers

Lists all stickers for each card.

Table Specific Information

Select

The Sync App will use the Trello API to process WHERE clause conditions built with the following columns and operators. The rest of the filter is executed client-side within the driver. For example, the following query is processed server-side:

SELECT * FROM CardStickers

SELECT * FROM CardStickers WHERE Name='thumbsdown'

SELECT * FROM CardStickers WHERE BoardID='4e99eb7aa9797361bc22e6ct'

You can turn off client-side execution by setting SupportEnhancedSQL to false in which case any search criteria that refers to other columns will cause an error.

Columns


Name	Type	Description
CardID [KEY]	String	The Id of the card.
StickerId [KEY]	String	The Id of the sticker.
Name	String	Name of the sticker.
BoardID	String	The Id of the board referencing the card with the sticker.

CheckListItems

Lists all items found on checklists.

Table Specific Information

Select

The Sync App will use the Trello API to process WHERE clause conditions built with the following columns and operators. The rest of the filter is executed client-side within the driver. For example, the following query is processed server-side:

SELECT * FROM CheckListItems

SELECT * FROM CheckListItems WHERE CheckListId='58e2018031e2b8e881b89b4g'

SELECT * FROM CheckListItems WHERE CardId='58e34da8446e578ac1bbb03b'

You can turn off client-side execution by setting SupportEnhancedSQL to false in which case any search criteria that refers to other columns will cause an error.

Columns


Name	Type	Description
CheckListItemId [KEY]	String	The Id of the item.
CheckListId	String	The Id of the checklist.
Name	String	The name of the item.
State	String	The state of the item.
CardID	String	The Id of the card referencing the checklist.
BoardID	String	The Id of the Board referencing the card with the checklist.

Checklists

Lists all checklists found on boards.

Table Specific Information

Select

The Sync App will use the Trello API to process WHERE clause conditions built with the following columns and operators. The rest of the filter is executed client-side within the driver. For example, the following query is processed server-side:

SELECT * FROM CheckLists

SELECT * FROM CheckLists WHERE CardId='58e34da8446e578ac1bbb03b'

SELECT * FROM CheckLists WHERE BoardID='58e2018031e2b8e881b89b4g'

You can turn off client-side execution by setting SupportEnhancedSQL to false in which case any search criteria that refers to other columns will cause an error.

Columns


Name	Type	Description
ChecklistId [KEY]	String	The Id of the checklist.
Name	String	The name of the checklist.
CardID	String	The Id of the card with the checklist.
BoardID	String	The Id of the board referencing the card with the checklist

Enterprises

Gets information about an enterprise.

Table Specific Information

Select

The Sync App will use the Trello API to process WHERE clause conditions built with the following columns and operators. The rest of the filter is executed client-side within the driver. For example, the following query is processed server-side:
EnterpriseID needs to be specified in the query.

SELECT * FROM Enterprises WHERE EnterpriseID='123'

You can turn off client-side execution by setting SupportEnhancedSQL to false in which case any search criteria that refers to other columns will cause an error.

Columns


Name	Type	Description
EnterpriseId [KEY]	String	The Id of the enterprise.
Name	String	The Name of the enterprise.
DisplayName	String	The display name of the enterprise.
AdminIds	String	The Ids of the admins which are part of the enterprise.
MemberIds	String	The Ids of the members which are part of the enterprise.
OrganizationIds	String	The Ids of the organizations which are part of the enterprise.
Products	String	The products which are part of the enterprise.

Exports

Lists all exports of the organizations.

Table Specific Information

Select

The Sync App will use the Trello API to process WHERE clause conditions built with the following columns and operators. The rest of the filter is executed client-side within the driver. For example, the following query is processed server-side:
In case an OrganizationID has not been specified as a connection property, it needs to be specified in the query.

SELECT * FROM Exports WHERE OrganizationID='123'

SELECT * FROM Exports WHERE OrganizationID='123' AND Finished='true'

SELECT * FROM Exports WHERE OrganizationID='123' AND Stage='Export_completed'

You can turn off client-side execution by setting SupportEnhancedSQL to false in which case any search criteria that refers to other columns will cause an error.

Columns


Name	Type	Description
ExportID [KEY]	String	The Id of the export.
OrganizationID	String	The Id of the organization.
Attempts	Int	The number of attempts.
Finished	Boolean	Determines whether or not the export is finished.
Stage	String	The stage of which the export is.
Progress	Int	Determines the progress of the export.
StartedAt	Datetime	The date and time when the export started.
Size	String	The size of the export.
ExportUrl	String	The url where you can find the export.

Labels

Lists all labels of the boards.

Table Specific Information

Select

The Sync App will use the Trello API to process WHERE clause conditions built with the following columns and operators. The rest of the filter is executed client-side within the driver. For example, the following query is processed server-side:

SELECT * FROM Labels

SELECT * FROM Labels WHERE BoardId='4e99eb7aa9797361bc22e6ct'

You can turn off client-side execution by setting SupportEnhancedSQL to false in which case any search criteria that refers to other columns will cause an error.

Columns


Name	Type	Description
LabelID [KEY]	String	The Id of the label.
BoardID	String	The id of the board.
Name	String	The name of the label.
Color	String	The color of the label.

Lists

Lists all the lists that have been created on boards.

Table Specific Information

Select

The Sync App will use the Trello API to process WHERE clause conditions built with the following columns and operators. The rest of the filter is executed client-side within the driver. For example, the following query is processed server-side: Closed column determines if the List has been archived or not.

SELECT * FROM Lists

SELECT * FROM Lists WHERE Closed='false'

SELECT * FROM Lists WHERE BoardId='4e99eb7aa9797361bc22e6ct'

If BoardId is specified in connection properties,

SELECT * FROM Lists

will return all lists of the board.

If OrganizationId is specified in connection properties

SELECT * FROM Lists

will return all lists of the boards on that organization.

If BoardId and OrganizationId are not specified in connection properties

SELECT * FROM Lists

will return all lists of the boards that the logged user is part of.

You can turn off client-side execution by setting SupportEnhancedSQL to false in which case any search criteria that refers to other columns will cause an error.

Columns


Name	Type	Description
ListId [KEY]	String	The Id of the list.
Name	String	The name of the list.
Position	Double	The position of the list.
BoardID	String	The id of the board where the list is created.
Closed	Boolean	Determines if the list is closed {archived}.

Memberships

Lists all members associated with the boards.

Table Specific Information

Select

The Sync App will use the Trello API to process WHERE clause conditions built with the following columns and operators. The rest of the filter is executed client-side within the driver. For example, the following query is processed server-side:

SELECT * FROM Memberships

SELECT * FROM Memberships WHERE BoardId='4e99eb7aa9797361bc22e6ct'

If BoardId and OrganizationId are not present in the connection properties or in query ( for example,

SELECT * FROM Memberships

) all members from all boards will be returned,

otherwise if BoardId is specified,

SELECT * FROM Memberships

will return all members of the board.

If OrganizationId is specified,

SELECT * FROM Memberships

will return all members of the organization.

If both properties are present,

SELECT * FROM Memberships

will return all members of the organization.

You can turn off client-side execution by setting SupportEnhancedSQL to false in which case any search criteria that refers to other columns will cause an error.

Columns


Name	Type	Description
MemberId [KEY]	String	The Id of the member.
FullName	String	The full name of the member.
UserName	String	The username of the member.
OrganizationID [KEY]	String	The Id of the organization where the member is part of.
BoardID [KEY]	String	The Id of the board that the member is part of.

Notifications

Lists all notifications of the user logged.

Table Specific Information

Select

The Sync App will use the Trello API to process WHERE clause conditions built with the following columns and operators. The rest of the filter is executed client-side within the driver. For example, the following query is processed server-side: Notifications differ from each other from Type. A notification could be of type: addedToBoard, commentCard etc.

SELECT * FROM Notifications

SELECT Text FROM Notifications WHERE Type='commentCard'

You can turn off client-side execution by setting SupportEnhancedSQL to false in which case any search criteria that refers to other columns will cause an error.

Columns


Name	Type	Description
NotificationId [KEY]	String	The Id of the notification
Type	String	The type of the notification
Text	String	The text value returned if the notification is of type commentCard
Date	Datetime	The date when the notification has been sent
DateRead	Datetime	The date when the notification has been read
Unread	Boolean	Determines if the notification has not been read
MemberID	String	The Id of the member who received the notification

OrganizationPreferences

Lists preferences of the boards.

Columns


Name	Type	Description
OrganizationId [KEY]	String	The Id of the Organization.
OrganizationName	String	The Name of the Board.
PermissionLevel	String	Permission level of the board (private, organization, public).
ExternalMembersDisabled	Boolean	Whether non-team members can be added to boards inside the team
AssociatedDomain	String	The domain associated with the organization.
GoogleAppsVersion	Int	Google application version.
BoardVisibilityRestrictPrivate	String	Who can make private boards. One of: admin, none, org
BoardVisibilityRestrictOrg	String	Who on the team can make team visible boards. One of admin, none, org
BoardVisibilityRestrictPublic	String	Who on the team can make public boards. One of: admin, none, org

Organizations

Lists all organizations where the user is associated.

Table Specific Information

Select

The Sync App will use the Trello API to process WHERE clause conditions built with the following columns and operators. The rest of the filter is executed client-side within the driver. For example, the following query is processed server-side:

SELECT * FROM Organizations

You can turn off client-side execution by setting SupportEnhancedSQL to false in which case any search criteria that refers to other columns will cause an error.

Columns


Name	Type	Description
OrganizationID [KEY]	String	The Id of the organization.
Name	String	The name of the organization.

PluginData

Get data from plugins that have been enabled on board.

Table Specific Information

Select

The Sync App will use the Trello API to process WHERE clause conditions built with the following columns and operators. The rest of the filter is executed client-side within the driver. For example, the following query is processed server-side:
CardID needs to be specified in the query for ex.

SELECT * FROM PluginData WHERE CardID='58355989b87aab776a356f76'

You can turn off client-side execution by setting SupportEnhancedSQL to false in which case any search criteria that refers to other columns will cause an error.

Columns


Name	Type	Description
ID [KEY]	String	The record Id.
PluginId	String	The id of the plugin.
CardID [KEY]	String	The id of the card.
Value	String	The value returned from the plugin.
Access	String	Determines if plugin data has shared or private access.
Scope	String	The scope of the plugin data.

Reactions

Lists all Reactions made on the logged users Actions.

Table Specific Information

Select

The Sync App will use the Trello API to process WHERE clause conditions built with the following columns and operators. The rest of the filter is executed client-side within the driver. For example, the following query is processed server-side:
ActionId needs to be specified in the query for ex.

SELECT * FROM Reactions WHERE ActionId='5cf527965bd25809b8c75f0b'

SELECT * FROM Reactions WHERE ActionId='5cf527965bd25809b8c75f0b' AND EmojiShortName='rage'

You can turn off client-side execution by setting SupportEnhancedSQL to false in which case any search criteria that refers to other columns will cause an error.

Columns


Name	Type	Description
ReactionId [KEY]	String	The Id of the reaction.
ActionId	String	The Id of the action where the reaction was made.
MemberId	String
MemberFullName	String	The full name of the member who made the reaction.
MemberInitials	String	The initials of the member who made the reaction.
MemberUsername	String	The username of the member who made the reaction.
EmojiUnified	String	The code of the emoji.
EmojiName	String	The name of the emoji.
EmojiNative	String
EmojiSkinVariation	String	The color of the emoji.
EmojiShortName	String	The short name of the emoji.

TokenPermissions

Gets information about read and write permissions.

Table Specific Information

Select

The Sync App will use the Trello API to process WHERE clause conditions built with the following columns and operators. The rest of the filter is executed client-side within the driver. For example, the following query is processed server-side:

SELECT * FROM TokenPermissions

SELECT * FROM TokenPermissions WHERE ModelId='5ccad9ab1747f81fb1493569'

You can turn off client-side execution by setting SupportEnhancedSQL to false in which case any search criteria that refers to other columns will cause an error.

Columns


Name	Type	Description
TokenId [KEY]	String	The Id of the Token.
ModelId [KEY]	String	The Id of the Model.
ModelType	String	The Type of the Model.
CanRead	Bool	Determines if the model has read permissions.
CanWrite	Bool	Determines if the model has write permissions.

接続文字列オプション

接続文字列プロパティは、接続を確立するために使用できるさまざまなオプションです。このセクションでは、本プロバイダーの接続文字列で設定できるオプションの一覧を示します。詳細については各リンクをクリックしてください。

接続を確立する方法について詳しくは、接続の確立を参照してください。

Authentication

プロパティ	説明
AuthScheme	The scheme used for authentication. Accepted entries are Auto,Token and OAuth.
APIKey	The Trello API key.
Token	The Trello Token.

Connection

プロパティ	説明
OrganizationId	The Trello OrganizationId.
BoardId	The Trello BoardId.
MemberId	The Trello MemberId.

OAuth

プロパティ	説明
OAuthClientId	OAuth 認証サーバーを使用してアプリケーションを登録する場合に割り当てられたクライアントId。
OAuthClientSecret	OAuth 認証サーバーにアプリケーションを登録する場合に割り当てられたクライアントシークレット。
AuthToken	OAuth アクセストークンをリクエストおよび取得するために使用される認証トークン。
AuthKey	OAuth アクセストークンをリクエストおよび取得するために使用される認証シークレット。

SSL

プロパティ	説明
SSLServerCert	TLS/SSL を使用して接続するときに、サーバーが受け入れ可能な証明書。

Firewall

プロパティ	説明
FirewallType	プロキシベースのファイアウォールで使われるプロトコル。
FirewallServer	プロキシベースのファイアウォールの名前もしくはIP アドレス。
FirewallPort	プロキシベースのファイアウォールのTCP ポート。
FirewallUser	プロキシベースのファイアウォールに認証するために使うユーザー名。
FirewallPassword	プロキシベースのファイアウォールへの認証に使われるパスワード。

Proxy

プロパティ	説明
ProxyAutoDetect	これは、システムプロキシ設定を使用するかどうかを示します。これは他のプロキシ設定よりも優先されるため、カスタムプロキシ設定を使用するにはProxyAutoDetect をFALSE に設定する必要があります。
ProxyServer	HTTP トラフィックをルートするためのプロキシのホストネームもしくはIP アドレス。
ProxyPort	ProxyServer プロキシが起動しているTCP ポート。
ProxyAuthScheme	ProxyServer プロキシへの認証で使われる認証タイプ。
ProxyUser	ProxyServer プロキシへの認証に使われるユーザー名。
ProxyPassword	ProxyServer プロキシへの認証に使われるパスワード。
ProxySSLType	ProxyServer プロキシへの接続時に使用するSSL タイプ。
ProxyExceptions	ProxyServer 経由での接続が免除される宛先ホスト名またはIP のセミコロン区切りのリスト。

Logging

プロパティ	説明
LogModules	ログファイルに含めるコアモジュール。

Schema

プロパティ	説明
Location	テーブル、ビュー、およびストアドプロシージャを定義するスキーマファイルを格納するディレクトリへのパス。
BrowsableSchemas	このプロパティは、使用可能なスキーマのサブセットにレポートされるスキーマを制限します。例えば、BrowsableSchemas=SchemaA,SchemaB,SchemaC です。
Tables	このプロパティは、使用可能なテーブルのサブセットにレポートされるテーブルを制限します。例えば、Tables=TableA,TableB,TableC です。
Views	使用可能なテーブルのサブセットにレポートされるビューを制限します。例えば、Views=ViewA,ViewB,ViewC です。

Miscellaneous

プロパティ	説明
IncludeCustomFields	Determines if the custom fields created on a card will be shown.
IncludeOrganizationBoards	IncludeOrganizationBoards determines if the logged in user has organizations or an enterprise of its own. And want to retrieve data from both organization and personal boards.
MaxRows	クエリで集計またはグループ化を使用しない場合に返される行数を制限します。これにより、設計時にパフォーマンスの問題を回避できます。
Other	これらの隠しプロパティは特定のユースケースでのみ使用されます。
PseudoColumns	このプロパティは、テーブルのカラムとして疑似カラムが含まれているかどうかを示します。
Timeout	タイムアウトエラーがスローされ、処理をキャンセルするまでの秒数。
UserDefinedViews	カスタムビューを含むJSON コンフィギュレーションファイルを指すファイルパス。

Authentication

このセクションでは、本プロバイダーの接続文字列で設定可能なAuthentication プロパティの全リストを提供します。

プロパティ	説明
AuthScheme	The scheme used for authentication. Accepted entries are Auto,Token and OAuth.
APIKey	The Trello API key.
Token	The Trello Token.

AuthScheme

The scheme used for authentication. Accepted entries are Auto,Token and OAuth.

解説

This field is used to authenticate to Trello. Auto is the default option.

Token: Set this to use Token and APIKey authentication.
OAuth: Set this to use OAuth authentication.

APIKey

The Trello API key.

解説

The Trello API key is used alongside Token to authenticate using Trello's own authorization route.

Token

The Trello Token.

解説

The Trello Token key is used alongside APIKey to authenticate using Trello's own authorization route.

Connection

このセクションでは、本プロバイダーの接続文字列で設定可能なConnection プロパティの全リストを提供します。

プロパティ	説明
OrganizationId	The Trello OrganizationId.
BoardId	The Trello BoardId.
MemberId	The Trello MemberId.

OrganizationId

The Trello OrganizationId.

解説

The Trello OrganizationId references a specific Trello organization. If specified the range of some queries will be bound to that organization. For example:

SELECT * FROM Lists

will return all lists of the boards on that organization.

SELECT * FROM Memberships

will return all members of the organization.

SELECT * FROM Actions

will return all actions on the organization.

BoardId

The Trello BoardId.

解説

The Trello BoardId references a specific Trello board. If specified the range of some queries will be bound to that board. For example:

SELECT * FROM Lists

will return all lists of the board.

SELECT * FROM Memberships

will return all members of the board.

SELECT * FROM Actions

will return all Actions of the board. Given that a board can have many actions, the query may take a while to execute.

MemberId

The Trello MemberId.

解説

The Trello MemberId references a specific Trello member. If specified, the range of some queries will be bound to that member. For example:

SELECT * FROM Actions

will return all actions of that member.

SELECT * FROM Boards

will return all boards that both the logged user and member specified have in common.

OAuth

このセクションでは、本プロバイダーの接続文字列で設定可能なOAuth プロパティの全リストを提供します。

プロパティ	説明
OAuthClientId	OAuth 認証サーバーを使用してアプリケーションを登録する場合に割り当てられたクライアントId。
OAuthClientSecret	OAuth 認証サーバーにアプリケーションを登録する場合に割り当てられたクライアントシークレット。
AuthToken	OAuth アクセストークンをリクエストおよび取得するために使用される認証トークン。
AuthKey	OAuth アクセストークンをリクエストおよび取得するために使用される認証シークレット。

OAuthClientId

OAuth 認証サーバーを使用してアプリケーションを登録する場合に割り当てられたクライアントId。

解説

OAuth アプリケーションの登録の一環として、コンシューマキーとも呼ばれるOAuthClientId 値、およびクライアントシークレットOAuthClientSecret が提供されます。

OAuthClientSecret

OAuth 認証サーバーにアプリケーションを登録する場合に割り当てられたクライアントシークレット。

解説

OAuth アプリケーションの登録の一環として、コンシューマキーとも呼ばれるOAuthClientId が提供されます。また、コンシューマーシークレットと呼ばれるクライアントシークレットも提供されます。クライアントシークレットをOAuthClientSecret プロパティに設定します。

AuthToken

OAuth アクセストークンをリクエストおよび取得するために使用される認証トークン。

解説

このプロパティは、OAuth 1.0でヘッドレス認証を実行する場合にのみ必要です。これは、GetOAuthAuthorizationUrl ストアドプロシージャから取得できます。

GetOAuthAccessToken ストアドプロシージャでAuthKey とともに指定して、OAuthAccessToken を取得できます。

AuthKey

OAuth アクセストークンをリクエストおよび取得するために使用される認証シークレット。

解説

このプロパティは、OAuth 1.0でヘッドレス認証を実行する場合にのみ必要です。これは、GetOAuthAuthorizationUrl ストアドプロシージャから取得できます。

GetOAuthAccessToken ストアドプロシージャでAuthToken とともに指定して、OAuthAccessToken を取得できます。

SSL

このセクションでは、本プロバイダーの接続文字列で設定可能なSSL プロパティの全リストを提供します。

プロパティ	説明
SSLServerCert	TLS/SSL を使用して接続するときに、サーバーが受け入れ可能な証明書。

SSLServerCert

TLS/SSL を使用して接続するときに、サーバーが受け入れ可能な証明書。

解説

TLS/SSL 接続を使用する場合は、このプロパティを使用して、サーバーが受け入れるTLS/SSL 証明書を指定できます。コンピュータによって信頼されていない他の証明書はすべて拒否されます。

このプロパティは、次のフォームを取ります：


説明	例
フルPEM 証明書（例では省略されています）	-----BEGIN CERTIFICATE----- MIIChTCCAe4CAQAwDQYJKoZIhv......Qw== -----END CERTIFICATE-----
証明書を保有するローカルファイルへのパス。	C:\cert.cer
公開鍵（例では省略されています）	-----BEGIN RSA PUBLIC KEY----- MIGfMA0GCSq......AQAB -----END RSA PUBLIC KEY-----
MD5 Thumbprint （hex 値はスペースおよびコロン区切り）	ecadbdda5a1529c58a1e9e09828d70e4
SHA1 Thumbprint （hex 値はスペースおよびコロン区切り）	34a929226ae0819f2ec14b4a3d904f801cbb150d

これを指定しない場合は、マシンが信用するすべての証明書が受け入れられます。

すべての証明書の受け入れを示すには、'*'を使用します。セキュリティ上の理由から、これはお勧めできません。

Firewall

このセクションでは、本プロバイダーの接続文字列で設定可能なFirewall プロパティの全リストを提供します。

プロパティ	説明
FirewallType	プロキシベースのファイアウォールで使われるプロトコル。
FirewallServer	プロキシベースのファイアウォールの名前もしくはIP アドレス。
FirewallPort	プロキシベースのファイアウォールのTCP ポート。
FirewallUser	プロキシベースのファイアウォールに認証するために使うユーザー名。
FirewallPassword	プロキシベースのファイアウォールへの認証に使われるパスワード。

FirewallType

プロキシベースのファイアウォールで使われるプロトコル。

解説

このプロパティは、Sync App がFirewallServer プロキシ経由でトンネルトラフィックを使うためのプロトコルを指定します。デフォルトでは、Sync App はシステムプロキシに接続します。この動作を無効化し次のプロキシタイプのどれかで接続するには、ProxyAutoDetect をfalse に設定します。


タイプ	デフォルトポート	説明
TUNNEL	80	これが設定されている場合、Sync App はTrello への接続を開き、プロキシを経由して通信が行われます。
SOCKS4	1080	これが設定されている場合、Sync App はデータをFirewallServer およびFirewallPort で指定されたSOCS 4 プロキシ経由で送信し、接続リクエストが許容されるかどうかを決定します。
SOCKS5	1080	これが設定されている場合、Sync App はデータをFirewallServer およびFirewallPort で指定されたSOCS 5 プロキシ経由で送信します。プロキシに認証が必要な場合には、FirewallUser およびFirewallPassword をプロキシが認識する認証情報に設定します。

HTTP プロキシへの接続には、ProxyServer およびProxyPort ポートを使ってください。HTTP プロキシへの認証には、ProxyAuthScheme、ProxyUser、およびProxyPassword を使ってください。

FirewallServer

プロキシベースのファイアウォールの名前もしくはIP アドレス。

解説

ファイアウォールトラバーサルを許容するために設定するIP アドレス、DNS 名、もしくはプロキシホスト名を指定するプロパティです。プロトコルはFirewallType で指定されます。このプロパティとFirewallServer を使って、SOCKS 経由での接続、もしくはトンネリングが可能です。HTTP プロキシへの接続には、ProxyServer を使用します。

Sync App はデフォルトでシステムプロキシを使うので注意してください。他のプロキシを使う場合には、ProxyAutoDetect をfalse に設定してください。

FirewallPort

プロキシベースのファイアウォールのTCP ポート。

解説

ファイアウォールトラバーサルを許容するために設定するプロキシベースのファイアウォールのTCP ポート。名前もしくはIP アドレスを指定するには、FirewallServer を使います。FirewallType でプロトコルを指定します。

FirewallUser

プロキシベースのファイアウォールに認証するために使うユーザー名。

解説

FirewallUser およびFirewallPassword プロパティは、FirewallType により指定された認証方式に則り、FirewallServer、およびFirewallPort で指定されたプロキシに対しての認証に使われます。

FirewallPassword

プロキシベースのファイアウォールへの認証に使われるパスワード。

解説

このプロパティは、FirewallType により指定された認証メソッドに則り、FirewallServer およびFirewallPort で指定されたプロキシに渡されます。

Proxy

このセクションでは、本プロバイダーの接続文字列で設定可能なProxy プロパティの全リストを提供します。

プロパティ	説明
ProxyAutoDetect	これは、システムプロキシ設定を使用するかどうかを示します。これは他のプロキシ設定よりも優先されるため、カスタムプロキシ設定を使用するにはProxyAutoDetect をFALSE に設定する必要があります。
ProxyServer	HTTP トラフィックをルートするためのプロキシのホストネームもしくはIP アドレス。
ProxyPort	ProxyServer プロキシが起動しているTCP ポート。
ProxyAuthScheme	ProxyServer プロキシへの認証で使われる認証タイプ。
ProxyUser	ProxyServer プロキシへの認証に使われるユーザー名。
ProxyPassword	ProxyServer プロキシへの認証に使われるパスワード。
ProxySSLType	ProxyServer プロキシへの接続時に使用するSSL タイプ。
ProxyExceptions	ProxyServer 経由での接続が免除される宛先ホスト名またはIP のセミコロン区切りのリスト。

ProxyAutoDetect

これは、システムプロキシ設定を使用するかどうかを示します。これは他のプロキシ設定よりも優先されるため、カスタムプロキシ設定を使用するにはProxyAutoDetect をFALSE に設定する必要があります。

解説

これは他のプロキシ設定よりも優先されるため、カスタムプロキシ設定を使用するにはProxyAutoDetect をFALSE に設定する必要があります。

HTTP プロキシへの接続には、ProxyServer を参照してください。SOCKS やトンネリングなどの他のプロキシには、FirewallType を参照してください。

ProxyServer

HTTP トラフィックをルートするためのプロキシのホストネームもしくはIP アドレス。

解説

HTTP トラフィックをルートするためのプロキシのホストネームもしくはIP アドレス。HTTP プロキシへの認証には、Sync App はHTTP、Windows(NTLM)、もしくはKerberos 認証タイプを使用することができます。

SOCKS プロキシを経由して接続する、もしくは接続をトンネルするには、FirewallType を参照してください。

デフォルトで、Sync App はsystem プロキシを使います。他のプロキシを使う場合には、ProxyAutoDetect をfalse に設定します。

ProxyPort

ProxyServer プロキシが起動しているTCP ポート。

解説

HTTP トラフィックをリダイレクトするHTTP プロキシが実行されているポート。ProxyServer でHTTP プロキシを指定します。その他のプロキシタイプについては、FirewallType を参照してください。

ProxyAuthScheme

ProxyServer プロキシへの認証で使われる認証タイプ。

解説

この値は、ProxyServer およびProxyPort で指定されるHTTP プロキシに認証するために使われる認証タイプを指定します。

Sync App は、デフォルトでsystem proxy settings を使い、追加での設定が不要です。他のプロキシへの接続をする場合には、ProxyServer およびProxyPort に加え、ProxyAutoDetect をfalse に設定します。認証するには、ProxyAuthScheme を設定し、必要な場合にはProxyUser およびProxyPassword を設定します。

認証タイプは、次のどれかになります。

BASIC： Sync App はHTTP BASIC 認証を行います。
DIGEST： Sync App はHTTP DIGEST 認証を行います。
NEGOTIATE： Sync App は認証において有効なプロトコルに応じて、NTLM もしくはKereros トークンを取得します。
PROPRIETARY： Sync App はNTLM もしくはKerberos トークンを発行しません。このトークンを、HTTP リクエストのAuthorization ヘッダーに含める必要があります。

SOCKS 5 認証のような他の認証タイプを使用するには、FirewallType を参照してください。

ProxyUser

ProxyServer プロキシへの認証に使われるユーザー名。

解説

ProxyUser および ProxyPassword オプションは、ProxyServer で指定されたHTTP プロキシに対して接続および認証するために使用されます。

ProxyAuthScheme で使用可能な認証タイプを選択することができます。HTTP 認証を使う場合、これをHTTP プロキシで識別可能なユーザーのユーザー名に設定します。Windows もしくはKerberos 認証を使用する場合、このプロパティを次の形式のどれかでユーザー名に設定します。

user@domain
domain\user

ProxyPassword

ProxyServer プロキシへの認証に使われるパスワード。

解説

このプロパティは、NTLM(Windows)、Kerberos、もしくはHTTP 認証をサポートするHTTP プロキシサーバーに認証するために使われます。HTTP プロキシを指定するためには、ProxyServer およびProxyPort を設定します。認証タイプを指定するためにはProxyAuthScheme を設定します。

HTTP 認証を使う場合、さらにHTTP プロキシにProxyUser およびProxyPassword を設定します。

NTLM 認証を使う場合、Windows パスワードにProxyUser およびProxyPassword を設定します。Kerberos 認証には、これらを入力する必要があります。

SOCKS 5 認証もしくは、トンネリングは、FirewallType を参照してください。

デフォルトで、Sync App はsystem プロキシを使います。他のプロキシに接続する場合には、これをfalse に設定します。

ProxySSLType

ProxyServer プロキシへの接続時に使用するSSL タイプ。

解説

このプロパティは、ProxyServer で指定されたHTTP プロキシへの接続にSSL を使用するかどうかを決定します。この値は、AUTO、ALWAYS、NEVER、TUNNEL のいずれかです。有効な値は次のとおりです。


AUTO	デフォルト設定。URL がHTTPS URL の場合、Sync App は、TUNNEL オプションを使います。URL がHTTP URL の場合、コンポーネントはNEVER オプションを使います。
ALWAYS	接続は、常にSSL 有効となります。
NEVER	接続は、SSL 有効になりません。
TUNNEL	接続は、トンネリングプロキシを経由します。プロキシサーバーがリモートホストへの接続を開き、プロキシを経由して通信が行われます。

ProxyExceptions

ProxyServer 経由での接続が免除される宛先ホスト名またはIP のセミコロン区切りのリスト。

解説

ProxyServer は、このプロパティで定義されたアドレスを除くすべてのアドレスに使用されます。セミコロンを使用してエントリを区切ります。

Sync App は、追加設定なしにデフォルトでシステムのプロキシ設定を使います。この接続のプロキシ例外を明示的に構成するには、ProxyAutoDetect をfalse に設定して、ProxyServer およびProxyPort を設定する必要があります。認証するには、ProxyAuthScheme を設定し、必要な場合にはProxyUser およびProxyPassword を設定します。

Logging

このセクションでは、本プロバイダーの接続文字列で設定可能なLogging プロパティの全リストを提供します。

プロパティ	説明
LogModules	ログファイルに含めるコアモジュール。

LogModules

ログファイルに含めるコアモジュール。

解説

指定された（';' で区切られた）モジュールのみがログファイルに含まれます。デフォルトではすべてのモジュールが含まれます。

概要はログページを参照してください。

Schema

このセクションでは、本プロバイダーの接続文字列で設定可能なSchema プロパティの全リストを提供します。

プロパティ	説明
Location	テーブル、ビュー、およびストアドプロシージャを定義するスキーマファイルを格納するディレクトリへのパス。
BrowsableSchemas	このプロパティは、使用可能なスキーマのサブセットにレポートされるスキーマを制限します。例えば、BrowsableSchemas=SchemaA,SchemaB,SchemaC です。
Tables	このプロパティは、使用可能なテーブルのサブセットにレポートされるテーブルを制限します。例えば、Tables=TableA,TableB,TableC です。
Views	使用可能なテーブルのサブセットにレポートされるビューを制限します。例えば、Views=ViewA,ViewB,ViewC です。

Location

テーブル、ビュー、およびストアドプロシージャを定義するスキーマファイルを格納するディレクトリへのパス。

解説

Sync App のスキーマファイル（テーブルとビューの場合は.rsd ファイル、ストアドプロシージャの場合は.rsb ファイル）を含むディレクトリへのパス。このフォルダの場所は、実行ファイルの場所からの相対パスにすることができます。Location プロパティは、定義をカスタマイズしたり（例えば、カラム名を変更する、カラムを無視するなど）、新しいテーブル、ビュー、またはストアドプロシージャでデータモデルを拡張する場合にのみ必要です。

指定しない場合、デフォルトの場所は"%APPDATA%\\CData\\Trello Data Provider\\Schema" となり、%APPDATA% はユーザーのコンフィギュレーションディレクトリに設定されます：

BrowsableSchemas

このプロパティは、使用可能なスキーマのサブセットにレポートされるスキーマを制限します。例えば、BrowsableSchemas=SchemaA,SchemaB,SchemaC です。

解説

スキーマをデータベースからリストすると、負荷がかかる可能性があります。接続文字列でスキーマのリストを提供すると、パフォーマンスが向上します。

Tables

このプロパティは、使用可能なテーブルのサブセットにレポートされるテーブルを制限します。例えば、Tables=TableA,TableB,TableC です。

解説

テーブルを複数のデータベースからリストすると、負荷がかかる可能性があります。接続文字列でテーブルのリストを提供すると、Sync App のパフォーマンスが向上します。

このプロパティは、作業したいビューがすでにわかっていて、ビューが多すぎる場合に、ビューを自動的にリストする代わりに使用することもできます。

カンマ区切りのリストで使用したいテーブルを指定します。各テーブルは、角かっこ、二重引用符、またはバッククオートを使用してエスケープされた特殊文字列を含む有効なSQL 識別子である必要があります。例えば、Tables=TableA,[TableB/WithSlash],WithCatalog.WithSchema.`TableC With Space` です。

複数のスキーマまたはカタログを持つデータソースに接続する場合は、複数のカタログやスキーマに存在するテーブル間の曖昧さを避けるため、最後の例のように、このプロパティにテーブルの完全修飾名を指定する必要があることに注意してください。

Views

使用可能なテーブルのサブセットにレポートされるビューを制限します。例えば、Views=ViewA,ViewB,ViewC です。

解説

ビューを複数のデータベースからリストすると、負荷がかかる可能性があります。接続文字列でビューのリストを提供すると、Sync App のパフォーマンスが向上します。

このプロパティは、作業したいビューがすでにわかっていて、ビューが多すぎる場合に、ビューを自動的にリストする代わりに使用することもできます。

カンマ区切りのリストで使用したいビューを指定します。各ビューは、角かっこ、二重引用符、またはバッククオートを使用してエスケープされた特殊文字列を含む有効なSQL 識別子である必要があります。例えば、Views=ViewA,[ViewB/WithSlash],WithCatalog.WithSchema.`ViewC With Space` です。

複数のスキーマまたはカタログを持つデータソースに接続する場合は、複数のカタログやスキーマに存在するテーブル間の曖昧さを避けるため、最後の例のように、このプロパティにテーブルの完全修飾名を指定する必要があることに注意してください。

Miscellaneous

このセクションでは、本プロバイダーの接続文字列で設定可能なMiscellaneous プロパティの全リストを提供します。

プロパティ	説明
IncludeCustomFields	Determines if the custom fields created on a card will be shown.
IncludeOrganizationBoards	IncludeOrganizationBoards determines if the logged in user has organizations or an enterprise of its own. And want to retrieve data from both organization and personal boards.
MaxRows	クエリで集計またはグループ化を使用しない場合に返される行数を制限します。これにより、設計時にパフォーマンスの問題を回避できます。
Other	これらの隠しプロパティは特定のユースケースでのみ使用されます。
PseudoColumns	このプロパティは、テーブルのカラムとして疑似カラムが含まれているかどうかを示します。
Timeout	タイムアウトエラーがスローされ、処理をキャンセルするまでの秒数。
UserDefinedViews	カスタムビューを含むJSON コンフィギュレーションファイルを指すファイルパス。

IncludeCustomFields

Determines if the custom fields created on a card will be shown.

解説

Custom Fields is one of the most popular power ups found on Trello. To begin using Custom fields, first activate the power up in your Trello board and create/add custom fields to your cards. After you are done setting up the power up and adding custom fields, they will appear as columns in the Cards table. Set this property to false if you do not want custom fields to show up. Please note that you must also specify the BoardId in the connection string. This connection property is used for retrieving custom fields that have been created on Trello's cards.

SELECT * FROM Cards

Running the query above will list all the custom fields created as table columns.

IncludeOrganizationBoards

IncludeOrganizationBoards determines if the logged in user has organizations or an enterprise of its own. And want to retrieve data from both organization and personal boards.

解説

If IncludeOrganizationBoards is set to true the provider will retrieve all data from all the boards that the logged user has access to. In contrary it will retrieve data only from the boards where the logged in user is a member of.

MaxRows

クエリで集計またはグループ化を使用しない場合に返される行数を制限します。これにより、設計時にパフォーマンスの問題を回避できます。

解説

クエリで集計またはグループ化を使用しない場合に返される行数を制限します。これにより、設計時にパフォーマンスの問題を回避できます。

Other

これらの隠しプロパティは特定のユースケースでのみ使用されます。

解説

以下にリストされているプロパティは、特定のユースケースで使用可能です。通常のドライバーのユースケースおよび機能では、これらのプロパティは必要ありません。

複数のプロパティをセミコロン区切りリストで指定します。

統合およびフォーマット


DefaultColumnSize	データソースがメタデータにカラムの長さを提供しない場合に、文字列フィールドのデフォルトの長さを設定します。デフォルト値は2000です。
ConvertDateTimeToGMT	日時の値を、マシンのローカルタイムではなくGMT グリニッジ標準時に変換するかどうかを決定します。
RecordToFile=filename	基底のソケットデータ転送を指定のファイルに記録します。

PseudoColumns

このプロパティは、テーブルのカラムとして疑似カラムが含まれているかどうかを示します。

解説

Entity Framework ではテーブルカラムでない疑似カラムに値を設定できないため、この設定はEntity Framework で特に便利です。この接続設定の値は、"Table1=Column1, Table1=Column2, Table2=Column3" の形式です。"*=*" のように"*" 文字を使用して、すべてのテーブルとすべてのカラムを含めることができます。

Timeout

タイムアウトエラーがスローされ、処理をキャンセルするまでの秒数。

解説

Timeout が0に設定されている場合は、操作がタイムアウトしません。処理が正常に完了するか、エラー状態になるまで実行されます。

Timeout の有効期限が切れても処理が完了していない場合は、Sync App は例外をスローします。

UserDefinedViews

カスタムビューを含むJSON コンフィギュレーションファイルを指すファイルパス。

解説

ユーザー定義ビューは、UserDefinedViews.json というJSON 形式のコンフィギュレーションファイルで定義されています。Sync App は、このファイルで指定されたビューを自動的に検出します。

また、複数のビュー定義を持ち、UserDefinedViews 接続プロパティを使用して制御することも可能です。このプロパティを使用すると、指定されたビューのみがSync App によって検知されます。

このユーザー定義ビューのコンフィギュレーションファイルは、次のようにフォーマットされています。

各ルートエレメントはビューの名前を定義します。
各ルートエレメントには、query と呼ばれる子エレメントが含まれており、この子エレメントにはビューのカスタムSQL クエリが含まれています。

次に例を示します。

{
	"MyView": {
		"query": "SELECT * FROM Cards WHERE MyColumn = 'value'"
	},
	"MyView2": {
		"query": "SELECT * FROM MyTable WHERE Id IN (1,2,3)"
	}
}

UserDefinedViews 接続プロパティを使用して、JSON コンフィギュレーションファイルの場所を指定します。次に例を示します。

"UserDefinedViews", "C:\\Users\\yourusername\\Desktop\\tmp\\UserDefinedViews.json"