CData Sync App は、Trello データをデータベース、データレイク、またはデータウェアハウスに継続的にパイプライン化する簡単な方法を提供し、分析、レポート、AI、および機械学習で簡単に利用できるようにします。
Trello コネクタはCData Sync アプリケーションから使用可能で、Trello からデータを取得して、サポートされている任意の同期先に移動できます。
Sync App はTrello API を利用して、Trello への接続を実現します。
必須プロパティについては、設定タブを参照してください。
通常必須ではない接続プロパティについては、高度な設定タブを参照してください。
Trello API は、Trello 自身の認可ルート、またはOAuth 経由でアクセスできます。
登録の時点で、Trello はAPI キーとトークンをアカウントに割り当てます。
認可ルート経由のアクセスを有効にするには:
API キーとトークンの両方が取得できたら、Trello APIへのリクエストの準備は完了です。
以下のサブセクションでは、3つの一般的な認証フローでのTrello への認証について詳しく説明します。
カスタムOAuth アプリケーションの作成については、カスタムOAuth アプリケーションの作成 を参照してください。
Trello で利用可能な接続文字列プロパティの全リストは、Connection を参照してください。
OAuth アクセストークンの自動リフレッシュ:
Sync App がOAuth アクセストークンを自動的にリフレッシュするようにするには、次のように設定します。
Trello のOrganizationId は、接続文字列で指定することで特定のTrello 組織を参照します。指定すると、いくつかのクエリの対象範囲がその組織に関連付けられます。例:
SELECT * FROM Listsは、その組織のボードのリストをすべて返します。
SELECT * FROM Membershipsは、その組織のメンバーをすべて返します。
SELECT * FROM Actionsは、その組織のアクションをすべて返します。
Trello のBoardId は、接続文字列で指定することで、特定のTrello ボードを参照します。指定すると、いくつかのクエリの対象範囲がそのボードに関連付けられます。例:
SELECT * FROM Listsは、そのボードのリストをすべて返します。
SELECT * FROM Membershipsは、そのボードのメンバーをすべて返します。
SELECT * FROM Actionsは、そのボードのすべてのアクションを返します。ボードは多数のアクションを持つ可能性があるため、クエリの実行に時間がかかる場合があります。
Trello のMemberId は、接続文字列で指定することで、特定のTrello メンバーを参照します。指定すると、いくつかのクエリの対象範囲がそのメンバーに関連付けられます。例:
SELECT * FROM Actionsは、そのメンバーのアクションをすべて返します。
SELECT * FROM Boardsは、ログインしているユーザー、および指定されたメンバーの両方が共通して持つボードをすべて返します。
カスタムフィールドはTrello で最も人気のあるPower-Up です。カスタムフィールドを使い始めるには、Trello ボードでPower-Up を有効にして、カードにカスタムフィールドを作成、または追加します。
IncludeCustomFields はすでにデフォルトでtrue に設定されているので、接続文字列にBoardId を指定するだけでカスタムフィールドが表示されるようになります。この接続プロパティは、Trello カードに作成されたカスタムフィールドを取得するために使用します。
SELECT * FROM Cardsこのクエリを実行すると、作成されたカスタムフィールドがすべて、テーブルのカラムとしてリスト化されます。カラム名はカスタムフィールド名となり、行の値はカスタムフィールドの値となります。 ドロップダウンリストタイプのカスタムフィールドの場合は、選択されたオプション名が表示されます。
このセクションでは、Trello Sync App の高度な機能を厳選して説明します。
Sync App はユーザー定義ビューの使用をサポートします。これは事前設定されたユーザー定義クエリによって内容が決定される仮想テーブルです。 このビューは、ドライバーに発行されるクエリを直接制御できない場合に有効です。 カスタムビューの作成と設定の概要については、ユーザー定義ビュー を参照してください。
SSL の設定 を使用して、Sync App が証明書のネゴシエーションをどのように扱うかを調整します。さまざまな証明書形式を選択できます。詳しくは、「接続文字列オプション」にあるSSLServerCert プロパティを参照してください。
Windows プロキシとHTTP プロキシを含むファイアウォールとプロキシ に合致するようSync App を設定します。トンネル接続を設定することもできます。
詳しくは、クエリ処理 を参照してください。
デフォルトでは、Sync App はサーバーとのTLS のネゴシエーションを試みます。サーバー証明書は、デフォルトのシステム信頼済み証明書ストアで検証されます。SSLServerCert 接続プロパティを使用して、証明書の検証方法をオーバーライドできます。
別の証明書を指定するには、SSLServerCert 接続プロパティを参照してください。
HTTP プロキシへの認証には、以下のように設定します。
次のプロパティを設定します。
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.
Sync App はTrello のデータを、標準のSQL ステートメントを使用してクエリできるリレーショナルデータベースのテーブルのリストとしてモデル化します。
| Name | Description |
| Boards | Lists all boards that are available to the user. |
| CardAttachments | Lists all the attachments of each card. |
| CardChecklists | Lists all checklists that have been created. |
| Cards | Lists all the cards from every board |
| Comments | Lists comments on cards. |
| Lists | Lists all the lists that have been created on boards. |
| Memberships | Lists all members associated with the boards. |
Lists all boards that are available to the user.
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 WHERE OrganizationId = '583558863c5859587053200c' SELECT * FROM Boards WHERE BoardId = '583558863c5859587053200c' SELECT * FROM Boards WHERE MemberId = '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'
| Name | Type | ReadOnly | Description |
| BoardID [KEY] | String | True |
The Id of the Board |
| Name | String | True |
The name of the Board. |
| Description | String | True |
The description of the board. |
| Pinned | Boolean | True |
Determines if Board is pinned or not. |
| Starred | Boolean | True |
Determines if Board is starred or not. |
| Closed | Boolean | True |
Determines if Board is archived or not. |
| Url | String | True |
Board Url. |
| Subscribed | Boolean | True |
Indicates if the user is subscribed to the board. |
| DateLastActivity | Datetime | True |
Timestamp of the most recent activity on the board. |
| DateLastView | Datetime | True |
Time when it board was last viewed. |
| CreationMethod | String | True |
Indicates how the board was created. |
| MemberID | String | True |
References the member of the board. |
| OrganizationID | String | True |
References the organization of which the board is part of. |
| EnterpriseOwned | Boolean | True |
Determines if the board is enterprise owned. |
| PermissionLevel | String | True |
Permission level of the board (private, organization, public). |
| HideVotes | Boolean | True |
Determines if votes can be shown or not. |
| Voting | String | True |
Determines if voting is allowed. |
| Comments | String | True |
Determines the user level which can comment. |
| Invitations | String | True |
Determines the user level which can invite. |
| SelfJoin | Boolean | True |
Determines if self join is enabled. |
| IsTemplate | Boolean | True |
Determines if the board is a template. |
| CardCovers | Boolean | True |
Determines if cards should have covers or not. |
| CardAging | String | True |
Determines what style the cards will get if they stay for too long in a list. |
| CalendarFeedEnabled | Boolean | True |
Determines if the calendar feed is enabled. |
| Background | String | True |
Background color. |
| BackgroundImage | String | True |
Background image. |
| BackgroundImageScaled | String | True |
Background image. |
| BackgroundTile | String | True |
Background tile. |
| BackgroundBrightness | String | True |
Background brightness. |
| BackgroundColor | String | True |
Background color. |
| BackgroundBottomColor | String | True |
Bottom background color. |
| BackgroundTopColor | String | True |
Top background color. |
| CanBePublic | Boolean | True |
Determines if the board can be public. |
| CanBeEnterprise | Boolean | True |
Determines if the board can be enterprise. |
| CanBeOrg | Boolean | True |
Determines if the board can be an organization. |
| CanBePrivate | Boolean | True |
Determines if the board can be private. |
| CanInvite | Boolean | True |
Determines if invitations are enabled. |
| MyCustomFieldName | String | True |
A JSON aggregates value containing the custom fields of the board. To retrieve these, IncludeCustomFields property must be enabled and a BoardId must be specified. |
Lists all the attachments of each card.
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 WHERE BoardId = '5835594ee003411c6abdbfbd'
| Name | Type | ReadOnly | Description |
| CardID [KEY] | String | True |
The Id of the Card. |
| AttachmentId [KEY] | String | True |
The Id of the Attachment. |
| Name | String | True |
Filename of the Attachment. |
| BoardID | String | True |
The Id of the Board referencing the card with attachment. |
Lists all checklists that have been created.
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 WHERE BoardId = '4e99eb7aa9897361bc22e6ce' SELECT * FROM CardCheckLists WHERE CardId = '5cd4655f9c12a516f688b296'
| Name | Type | ReadOnly | Description |
| CheckListId [KEY] | String | True |
The Id of the checklist. |
| Name | String | False |
The name of the checklist. |
| Position | Double | False |
The position of the checklist. |
| CardID | String | False |
The Id of the card with the checklist. |
| BoardID | String | True |
The Id of the board referencing the card with the checklist. |
Lists all the cards from every board
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.
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'
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')
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'
To delete a card you must specify a CardID for ex:
DELETE FROM Cards WHERE CardID = 'card_id'
| 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. |
| CreatedDate | Datetime | False |
The time when the card was created. |
| Location | Boolean | False |
Shows if Location is set in the UI. |
| StartDate | Datetime | False |
The start date of a card. |
| URL | String | False |
URL of the card. |
| ShortURL | String | False |
Short Url of the card. |
Lists comments on cards.
| Name | Type | ReadOnly | Description |
| CommentId [KEY] | String | True |
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 |
The Id of the organization which the comment references. |
| Comment | String | False |
The comment body if the action is of type commentCard. |
| CreatedDate | Datetime | True |
The time the action was created. |
Lists all the lists that have been created on boards.
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. Closed column determines if the List has been archived or not. For example, the following query is processed server-side:
SELECT * FROM Lists WHERE BoardId = '4e99eb7aa9797361bc22e6ct' SELECT * FROM Lists WHERE ListId = '4e99eb7aa9797361bc22e6ct'
If BoardId is specified in connection properties,
SELECT * FROM Listswill return all lists of the board.
If OrganizationId is specified in connection properties
SELECT * FROM Listswill return all lists of the boards on that organization.
If BoardId and OrganizationId are not specified in connection properties
SELECT * FROM Listswill return all lists of the boards that the logged user is part of.
| Name | Type | ReadOnly | Description |
| ListId [KEY] | String | True |
The Id of the list. |
| Name | String | False |
The name of the list. |
| Position | Double | False |
The position of the list. |
| Closed | Boolean | False |
Determines if the list is closed {archived}. |
| Subscribed | Boolean | False |
Whether the active member is subscribed to this list. |
| BoardID | String | False |
The id of the board where the list is created. |
Lists all members associated with the boards.
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 WHERE BoardId = '4e99eb7aa9797361bc22e6ct'
If BoardId is not present in the connection properties or in query, for example:
SELECT * FROM Membershipsall members from all boards will be returned,
otherwise if BoardId is specified:
SELECT * FROM Membershipswill return all members of the board.
| Name | Type | ReadOnly | Description |
| MemberId [KEY] | String | True |
The Id of the member. |
| FullName | String | True |
The full name of the member. |
| UserName | String | True |
The username of the member. |
| OrganizationID | String | True |
The Id of the organization where the member is part of. |
| BoardID [KEY] | String | True |
The Id of the board that the member is part of. |
ビューは、データを示すという点でテーブルに似ていますが、ビューは読み取り専用です。
クエリは、ビューに対して通常のテーブルと同様に実行することができます。
| 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. |
| BoardStars | Lists all the Boards that the user has starred. |
| 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 | Deprecated. 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. |
| Notifications | Lists all notifications of the user logged. |
| OrganizationMembers | List the members in a Organization. |
| 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. |
Lists different actions made on Organization/Board/Card determined by type.
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 Actionswill 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 Actionswill return all actions actions on the organization.
If both properties are present
SELECT * FROM Actionswill return all Actions of the board.
| 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 | The Id of the organization which the action references. |
| Comment | String | The comment body if the action is of type commentCard. |
| CreatedDate | Datetime | The time the action was created. |
Lists all plugins enabled for each board.
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 WHERE BoardId = '5835594ee003411c6abdbfbd'
| Name | Type | Description |
| ID | String | Record Id. |
| PluginId [KEY] | String | The Id of the Plugin. |
| BoardId | String | The Id of the Board. |
Lists preferences of the boards.
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 WHERE BoardId = '5835594ee004411c6abdbfbc'
| 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. |
Lists all the Boards that the user has starred.
The Sync App will use the Trello API to retrieve data for starred boards.
| Name | Type | Description |
| ID [KEY] | String | The Id of the Board. |
| Name | String | The name of the Board. |
| Pinned | Boolean | Determines if Board is pinned or not. |
| IsClosed | Boolean | Is the board closed. |
Lists all labels assigned to each card.
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 WHERE CardId = '5cd4655f9c12a516f688b296'
| 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. |
Lists all members assigned to each card.
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 WHERE CardId = '5cd4655f9c12a516f688b296'
| 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. |
Lists all stickers for each card.
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 WHERE Name = 'thumbsdown' SELECT * FROM CardStickers WHERE BoardID = '4e99eb7aa9797361bc22e6ct'
| 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. |
Lists all items found on checklists.
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 WHERE CheckListId = '58e2018031e2b8e881b89b4g' SELECT * FROM CheckListItems WHERE CardId = '58e34da8446e578ac1bbb03b'
| 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. |
| DueDate | Datetime | The due date of the item. |
| MemberId | String | The due date 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. |
Deprecated. Lists all checklists found on boards.
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 WHERE CardId = '58e34da8446e578ac1bbb03b' SELECT * FROM CheckLists WHERE BoardID = '58e2018031e2b8e881b89b4g' SELECT * FROM CheckLists WHERE ChecklistId = '58e2018031e2b8e881b89b4g'
| 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. |
Gets information about an enterprise.
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'
| 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. |
Lists all exports of the organizations.
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'
| 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. |
Lists all labels of the boards.
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 WHERE BoardId = '4e99eb7aa9797361bc22e6ct' SELECT * FROM Labels WHERE LabelId = '4e99eb7aa9797361bc22e6ct'
| 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 all notifications of the user logged.
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 Text FROM Notifications WHERE Type = 'commentCard'
| 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. |
List the members in a Organization.
| Name | Type | Description |
| Id [KEY] | String | Id of the member. |
| Username | String | The username of this account. |
| FullName | String | The full name related to the account, if it is public. |
| AaEmail | String | AaEmail field of this member. |
| AaEnrolledDate | String | AaEnrolledDate field of this member. |
| AaId | String | AaId field of this member. |
| ActivityBlocked | Boolean | ActivityBlocked field of this member. |
| AvatarHash | String | AvatarHash field of this member. |
| AvatarSource | String | AvatarSource field of this member. |
| AvatarUrl | String | The url of this member's avatar. |
| Bio | String | Bio of the member. |
| BioData | String | Bio Data of the member. |
| Confirmed | Boolean | Whether the user has confirmed their email address for their account. |
| String | Email of the member. | |
| GravatarHash | String | The Gravatar Hash. |
| IdBoards | String | List of boards this member belongs to. |
| IdBoardsPinned | String | Id boards pinned of the member. |
| IdEnterprise | String | Id enterprise of the member. |
| IdEnterprisesAdmin | String | Id enterprises admin of the member. |
| IdEnterprisesDeactivated | String | Id enterprises deactivated of the member. |
| IdMemberReferrer | String | Id member referrer. |
| IdOrganizations | String | List of workspaces this member belongs to. |
| IdPremOrgsAdmin | String | IdPremOrgsAdmin field of this member. |
| Initials | String | The initials related to the account, if it is public. |
| IsAaMastered | Boolean | IsAaMastered field of this member. |
| IxUpdate | Integer | IxUpdate field of this member. |
| LimitsDisableAt | Integer | Limits disable at. |
| LimitsStatus | String | Limits status. |
| LimitsWarnAt | Integer | Limits warn at. |
| LoginTypes | String | Login types of the member. |
| MarketingDate | Datetime | Marketing opt-in date. |
| MarketingOptedIn | Boolean | Marketing opt-inOptedIn of the member. |
| MemberType | String | Type of the member. |
| MessagesDismissedId | String | Messages dismissed id of the member. |
| MessagesDismissedCount | String | Messages dismissed count of the member. |
| MessagesDismissedLastDismissed | Datetime | Messages dismissed last dismissed of the member. |
| MessagesDismissedName | String | Messages dismissed name of the member. |
| NonPublicAvailable | Boolean | Non public Available field of this member. |
| NonPublicAvatarHash | String | Non public AvatarHash field of this member. |
| NonPublicAvatarUrl | String | Non public AvatarUrl field of this member. |
| NonPublicFullName | String | Non public FullName field of this member. |
| NonPublicInitials | String | Non public Initials field of this member. |
| OneTimeMessagesDismissed | String | One time messages dismissed field of this member. |
| PrefsColorBlind | Boolean | Preferred ColorBlind field of this member. |
| PrefsLocale | String | Preferred Locale field of this member. |
| PrefsMinutesBeforeDeadlineToNotify | Integer | Preferred MinutesBeforeDeadlineToNotify field of this member. |
| PrefsMinutesBetweenSummaries | Integer | Preferred MinutesBetweenSummaries field of this member. |
| PrefsPrivacyAvatar | String | Preferred PrivacyAvatar field of this member. |
| PrefsPrivacyFullName | String | Preferred PrivacyFullName field of this member. |
| PrefsSendSummaries | Boolean | Preferred SendSummaries field of this member. |
| PrefsTimezone | String | The preferred timezone of this member. |
| PrefsTimezoneInfoDateNext | Datetime | Preferred TimezoneInfoDateNext field of this member. |
| PrefsTimezoneInfoOffsetCurrent | Integer | Preferred TimezoneInfoOffsetCurrent field of this member. |
| PrefsTimezoneInfoOffsetNext | Integer | Preferred TimezoneInfoOffsetNext. |
| PrefsTimezoneInfoTimezoneCurrent | String | Preferred TimezoneInfoTimezoneCurrent field of this member. |
| PrefsTimezoneInfoTimezoneNext | String | Preferred TimezoneInfoTimezoneNext field of this member. |
| PrefsTwoFactorEnabled | Boolean | Preferred TwoFactorEnabled field of this member. |
| PrefsTwoFactorNeedsNewBackups | Boolean | Preferred TwoFactorNeedsNewBackups field of this member. |
| PremiumFeatures | String | Premium features of the member. |
| Products | Integer | Products of the member. |
| Status | String | Status of the member. |
| Trophies | String | Trophies of the member. |
| UploadedAvatarHash | String | Uploaded avatar hash. |
| UploadedAvatarUrl | String | Uploaded avatar url. |
| Url | String | Url field of this member. |
| OrganizationId [KEY] | String | The Id of the organization where the member is part of. |
Lists preferences of the boards.
| 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. |
Lists all organizations where the user is associated.
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
| Name | Type | Description |
| OrganizationID [KEY] | String | The Id of the organization. |
| Name | String | The name of the organization. |
Get data from plugins that have been enabled on board.
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'
| 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. |
Lists all Reactions made on the logged users Actions.
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'
| 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 | The Id of the member who made the reaction. |
| 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 | The native of the emoji. |
| EmojiSkinVariation | String | The color of the emoji. |
| EmojiShortName | String | The short name of the emoji. |
Gets information about read and write permissions.
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 WHERE ModelId = '5ccad9ab1747f81fb1493569'
| 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. |
| プロパティ | 説明 |
| AuthScheme | The scheme used for authentication. Accepted entries are Token and OAuth. |
| APIKey | The Trello API key. |
| Token | The Trello Token. |
| プロパティ | 説明 |
| OrganizationId | The Trello OrganizationId. |
| BoardId | The Trello BoardId. |
| MemberId | The Trello MemberId. |
| プロパティ | 説明 |
| OAuthClientId | カスタムOAuth アプリケーションの作成時に割り当てられたクライアントId を指定します。(コンシューマーキーとも呼ばれます。)このID は、カスタムアプリケーションをOAuth 認可サーバーに登録します。 |
| OAuthClientSecret | カスタムOAuth アプリケーションの作成時に割り当てられたクライアントシークレットを指定します。( コンシューマーシークレット とも呼ばれます。)このシークレットは、カスタムアプリケーションをOAuth 認可サーバーに登録します。 |
| AuthToken | OAuth アクセストークンをリクエストおよび取得するために使用される認証トークン。 |
| AuthKey | OAuth アクセストークンをリクエストおよび取得するために使用される認証シークレット。 |
| プロパティ | 説明 |
| SSLServerCert | TLS/SSL を使用して接続する際に、サーバーが受け入れ可能な証明書を指定します。 |
| プロパティ | 説明 |
| FirewallType | provider がプロキシベースのファイアウォールを介してトラフィックをトンネリングするために使用するプロトコルを指定します。 |
| FirewallServer | ファイアウォールを通過し、ユーザーのクエリをネットワークリソースに中継するために使用されるプロキシのIP アドレス、DNS 名、またはホスト名を識別します。 |
| FirewallPort | プロキシベースのファイアウォールで使用するTCP ポートを指定します。 |
| FirewallUser | プロキシベースのファイアウォールに認証するアカウントのユーザーID を識別します。 |
| FirewallPassword | プロキシベースのファイアウォールで認証するユーザーアカウントのパスワードを指定します。 |
| プロパティ | 説明 |
| ProxyAutoDetect | provider が、手動で指定されたプロキシサーバーを使用するのではなく、既存のプロキシサーバー構成についてシステムプロキシ設定をチェックするかどうかを指定します。 |
| ProxyServer | HTTP トラフィックをルートするプロキシサーバーのホストネームもしくはIP アドレス。 |
| ProxyPort | クライアントとの間でHTTP トラフィックをルーティングするために予約された、指定されたプロキシサーバー(ProxyServer 接続プロパティで設定)のTCP ポート。 |
| ProxyAuthScheme | ProxyServer 接続プロパティで指定されたプロキシサーバーに対して認証する際にprovider が使用する認証方法を指定します。 |
| ProxyUser | ProxyServer 接続プロパティで指定されたプロキシサーバーに登録されているユーザーアカウントのユーザー名。 |
| ProxyPassword | ProxyUser 接続プロパティで指定されたユーザーに紐付けられたパスワード。 |
| ProxySSLType | ProxyServer 接続プロパティで指定されたプロキシサーバーに接続する際に使用するSSL タイプ。 |
| ProxyExceptions | ProxyServer 接続プロパティで設定されたプロキシサーバー経由での接続が免除される宛先ホスト名またはIP のセミコロン区切りのリスト。 |
| プロパティ | 説明 |
| LogModules | ログファイルに含めるコアモジュールを指定します。セミコロンで区切られたモジュール名のリストを使用します。デフォルトでは、すべてのモジュールがログに記録されます。 |
| プロパティ | 説明 |
| Location | テーブル、ビュー、およびストアドプロシージャを定義するスキーマファイルを格納するディレクトリの場所を指定します。サービスの要件に応じて、これは絶対パスまたは相対パスのいずれかで表されます。 |
| BrowsableSchemas | レポートされるスキーマを利用可能なすべてのスキーマのサブセットに制限するオプション設定。例えば、 BrowsableSchemas=SchemaA,SchemaB,SchemaC です。 |
| Tables | レポートされるテーブルを利用可能なすべてのテーブルのサブセットに制限するオプション設定。例えば、 Tables=TableA,TableB,TableC です。 |
| Views | レポートされたビューを使用可能なテーブルのサブセットに制限するオプション設定。例えば、 Views=ViewA,ViewB,ViewC です。 |
| プロパティ | 説明 |
| 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 | 集計やGROUP BY を使用しないクエリで返される最大行数を指定します。 |
| Other | 特定のユースケースに対して追加の隠しプロパティを指定します。これらは通常のprovider の機能では必要ありません。複数のプロパティを定義するには、セミコロンで区切られたリストを使用します。 |
| PseudoColumns | テーブルカラムとして公開する擬似カラムを指定します。'TableName=ColumnName;TableName=ColumnName' という形式を使用します。デフォルトは空の文字列で、このプロパティを無効にします。 |
| Timeout | provider がタイムアウトエラーを返すまでにサーバーからの応答を待機する最大時間を秒単位で指定します。デフォルトは60秒です。タイムアウトを無効にするには0を設定します。 |
| UserDefinedViews | カスタムビューを定義するJSON 構成ファイルへのファイルパスを指定します。provider は、このファイルで指定されたビューを自動的に検出して使用します。 |
このセクションでは、本プロバイダーの接続文字列で設定可能なAuthentication プロパティの全リストを提供します。
| プロパティ | 説明 |
| AuthScheme | The scheme used for authentication. Accepted entries are Token and OAuth. |
| APIKey | The Trello API key. |
| Token | The Trello Token. |
The scheme used for authentication. Accepted entries are Token and OAuth.
This field is used to authenticate to Trello. OAuth is the default option.
The Trello API key.
The Trello API key is used alongside Token to authenticate using Trello's own authorization route.
The Trello Token.
The Trello Token key is used alongside APIKey to authenticate using Trello's own authorization route.
このセクションでは、本プロバイダーの接続文字列で設定可能なConnection プロパティの全リストを提供します。
| プロパティ | 説明 |
| OrganizationId | The Trello OrganizationId. |
| BoardId | The Trello BoardId. |
| MemberId | The Trello MemberId. |
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 Listswill return all lists of the boards on that organization.
SELECT * FROM Membershipswill return all members of the organization.
SELECT * FROM Actionswill return all actions on the organization.
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 Listswill return all lists of the board.
SELECT * FROM Membershipswill return all members of the board.
SELECT * FROM Actionswill return all Actions of the board. Given that a board can have many actions, the query may take a while to execute.
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 Actionswill return all actions of that member.
SELECT * FROM Boardswill return all boards that both the logged user and member specified have in common.
このセクションでは、本プロバイダーの接続文字列で設定可能なOAuth プロパティの全リストを提供します。
| プロパティ | 説明 |
| OAuthClientId | カスタムOAuth アプリケーションの作成時に割り当てられたクライアントId を指定します。(コンシューマーキーとも呼ばれます。)このID は、カスタムアプリケーションをOAuth 認可サーバーに登録します。 |
| OAuthClientSecret | カスタムOAuth アプリケーションの作成時に割り当てられたクライアントシークレットを指定します。( コンシューマーシークレット とも呼ばれます。)このシークレットは、カスタムアプリケーションをOAuth 認可サーバーに登録します。 |
| AuthToken | OAuth アクセストークンをリクエストおよび取得するために使用される認証トークン。 |
| AuthKey | OAuth アクセストークンをリクエストおよび取得するために使用される認証シークレット。 |
カスタムOAuth アプリケーションの作成時に割り当てられたクライアントId を指定します。(コンシューマーキーとも呼ばれます。)このID は、カスタムアプリケーションをOAuth 認可サーバーに登録します。
OAuthClientId は、ユーザーがOAuth 経由で認証を行う前に設定する必要があるいくつかの接続パラメータの1つです。詳細は接続の確立を参照してください。
カスタムOAuth アプリケーションの作成時に割り当てられたクライアントシークレットを指定します。( コンシューマーシークレット とも呼ばれます。)このシークレットは、カスタムアプリケーションをOAuth 認可サーバーに登録します。
OAuthClientSecret は、ユーザーがOAuth 経由で認証を行う前に設定する必要があるいくつかの接続パラメータの1つです。詳細は接続の確立を参照してください。
OAuth アクセストークンをリクエストおよび取得するために使用される認証トークン。
このプロパティは、OAuth 1.0でヘッドレス認証を実行する場合にのみ必要です。これは、GetOAuthAuthorizationUrl ストアドプロシージャから取得できます。
GetOAuthAccessToken ストアドプロシージャでAuthKey とともに指定して、OAuthAccessToken を取得できます。
OAuth アクセストークンをリクエストおよび取得するために使用される認証シークレット。
このプロパティは、OAuth 1.0でヘッドレス認証を実行する場合にのみ必要です。これは、GetOAuthAuthorizationUrl ストアドプロシージャから取得できます。
GetOAuthAccessToken ストアドプロシージャでAuthToken とともに指定して、OAuthAccessToken を取得できます。
このセクションでは、本プロバイダーの接続文字列で設定可能なSSL プロパティの全リストを提供します。
| プロパティ | 説明 |
| SSLServerCert | TLS/SSL を使用して接続する際に、サーバーが受け入れ可能な証明書を指定します。 |
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 プロパティの全リストを提供します。
| プロパティ | 説明 |
| FirewallType | provider がプロキシベースのファイアウォールを介してトラフィックをトンネリングするために使用するプロトコルを指定します。 |
| FirewallServer | ファイアウォールを通過し、ユーザーのクエリをネットワークリソースに中継するために使用されるプロキシのIP アドレス、DNS 名、またはホスト名を識別します。 |
| FirewallPort | プロキシベースのファイアウォールで使用するTCP ポートを指定します。 |
| FirewallUser | プロキシベースのファイアウォールに認証するアカウントのユーザーID を識別します。 |
| FirewallPassword | プロキシベースのファイアウォールで認証するユーザーアカウントのパスワードを指定します。 |
provider がプロキシベースのファイアウォールを介してトラフィックをトンネリングするために使用するプロトコルを指定します。
プロキシベースのファイアウォール(またはプロキシファイアウォール)は、ユーザーのリクエストとそれがアクセスするリソースの間に介在するネットワークセキュリティデバイスです。 プロキシは認証済みのユーザーのリクエストを受け取り、ファイアウォールを通過して適切なサーバーにリクエストを送信します。
プロキシは、リクエストを送信したユーザーに代わってデータバケットを評価し転送するため、ユーザーはサーバーに直接接続することなく、プロキシのみに接続します。
Note:デフォルトでは、Sync App はシステムプロキシに接続します。この動作を無効化し、次のプロキシタイプのいずれかに接続するには、ProxyAutoDetect をfalse に設定します。
次の表は、サポートされている各プロトコルのポート番号情報です。
| プロトコル | デフォルトポート | 説明 |
| TUNNEL | 80 | Sync App がTrello への接続を開くポート。トラフィックはこの場所のプロキシを経由して行き来します。 |
| SOCKS4 | 1080 | Sync App がTrello への接続を開くポート。SOCKS 4 は次にFirewallUser 値をプロキシに渡し、接続リクエストが許容されるかどうかを決定します。 |
| SOCKS5 | 1080 | Sync App がTrello にデータを送信するポート。SOCKS 5 プロキシに認証が必要な場合には、FirewallUser およびFirewallPassword をプロキシが認識する認証情報に設定します。 |
HTTP プロキシへの接続には、ProxyServer およびProxyPort ポートを使ってください。HTTP プロキシへの認証には、ProxyAuthScheme、ProxyUser、およびProxyPassword を使ってください。
ファイアウォールを通過し、ユーザーのクエリをネットワークリソースに中継するために使用されるプロキシのIP アドレス、DNS 名、またはホスト名を識別します。
プロキシベースのファイアウォール(またはプロキシファイアウォール)は、ユーザーのリクエストとそれがアクセスするリソースの間に介在するネットワークセキュリティデバイスです。 プロキシは認証済みのユーザーのリクエストを受け取り、ファイアウォールを通過して適切なサーバーにリクエストを送信します。
プロキシは、リクエストを送信したユーザーに代わってデータバケットを評価し転送するため、ユーザーはサーバーに直接接続することなく、プロキシのみに接続します。
プロキシベースのファイアウォールで使用するTCP ポートを指定します。
プロキシベースのファイアウォール(またはプロキシファイアウォール)は、ユーザーのリクエストとそれがアクセスするリソースの間に介在するネットワークセキュリティデバイスです。 プロキシは認証済みのユーザーのリクエストを受け取り、ファイアウォールを通過して適切なサーバーにリクエストを送信します。
プロキシは、リクエストを送信したユーザーに代わってデータバケットを評価し転送するため、ユーザーはサーバーに直接接続することなく、プロキシのみに接続します。
プロキシベースのファイアウォールに認証するアカウントのユーザーID を識別します。
プロキシベースのファイアウォール(またはプロキシファイアウォール)は、ユーザーのリクエストとそれがアクセスするリソースの間に介在するネットワークセキュリティデバイスです。 プロキシは認証済みのユーザーのリクエストを受け取り、ファイアウォールを通過して適切なサーバーにリクエストを送信します。
プロキシは、リクエストを送信したユーザーに代わってデータバケットを評価し転送するため、ユーザーはサーバーに直接接続することなく、プロキシのみに接続します。
プロキシベースのファイアウォールで認証するユーザーアカウントのパスワードを指定します。
プロキシベースのファイアウォール(またはプロキシファイアウォール)は、ユーザーのリクエストとそれがアクセスするリソースの間に介在するネットワークセキュリティデバイスです。 プロキシは認証済みのユーザーのリクエストを受け取り、ファイアウォールを通過して適切なサーバーにリクエストを送信します。
プロキシは、リクエストを送信したユーザーに代わってデータバケットを評価し転送するため、ユーザーはサーバーに直接接続することなく、プロキシのみに接続します。
このセクションでは、本プロバイダーの接続文字列で設定可能なProxy プロパティの全リストを提供します。
| プロパティ | 説明 |
| ProxyAutoDetect | provider が、手動で指定されたプロキシサーバーを使用するのではなく、既存のプロキシサーバー構成についてシステムプロキシ設定をチェックするかどうかを指定します。 |
| ProxyServer | HTTP トラフィックをルートするプロキシサーバーのホストネームもしくはIP アドレス。 |
| ProxyPort | クライアントとの間でHTTP トラフィックをルーティングするために予約された、指定されたプロキシサーバー(ProxyServer 接続プロパティで設定)のTCP ポート。 |
| ProxyAuthScheme | ProxyServer 接続プロパティで指定されたプロキシサーバーに対して認証する際にprovider が使用する認証方法を指定します。 |
| ProxyUser | ProxyServer 接続プロパティで指定されたプロキシサーバーに登録されているユーザーアカウントのユーザー名。 |
| ProxyPassword | ProxyUser 接続プロパティで指定されたユーザーに紐付けられたパスワード。 |
| ProxySSLType | ProxyServer 接続プロパティで指定されたプロキシサーバーに接続する際に使用するSSL タイプ。 |
| ProxyExceptions | ProxyServer 接続プロパティで設定されたプロキシサーバー経由での接続が免除される宛先ホスト名またはIP のセミコロン区切りのリスト。 |
provider が、手動で指定されたプロキシサーバーを使用するのではなく、既存のプロキシサーバー構成についてシステムプロキシ設定をチェックするかどうかを指定します。
この接続プロパティをTrue に設定すると、Sync App は既存のプロキシサーバー構成についてシステムプロキシ設定をチェックします(プロキシサーバーの詳細を手動で入力する必要はありません)。
この接続プロパティは他のプロキシ設定より優先されます。特定のプロキシサーバーに接続するためにSync App を手動で構成する場合は、False に設定します。
HTTP プロキシへの接続には、ProxyServer を参照してください。SOCKS やトンネリングなどの他のプロキシには、FirewallType を参照してください。
HTTP トラフィックをルートするプロキシサーバーのホストネームもしくはIP アドレス。
ProxyAutoDetect がFalse に設定されている場合、Sync App はこの接続プロパティで指定されたプロキシサーバーを通じてのみHTTP トラフィックをルーティングします。ProxyAutoDetect がTrue に設定されている場合(デフォルト)、Sync App は代わりにシステムプロキシ設定で指定されたプロキシサーバーを介してHTTP トラフィックをルーティングします。
クライアントとの間でHTTP トラフィックをルーティングするために予約された、指定されたプロキシサーバー(ProxyServer 接続プロパティで設定)のTCP ポート。
ProxyAutoDetect がFalse に設定されている場合、Sync App はこの接続プロパティで指定されたプロキシサーバーポートを通じてのみHTTP トラフィックをルーティングします。ProxyAutoDetect がTrue に設定されている場合(デフォルト)、Sync App は代わりにシステムプロキシ設定で指定されたプロキシサーバーポートを介してHTTP トラフィックをルーティングします。
その他のプロキシタイプについては、FirewallType を参照してください。
ProxyServer 接続プロパティで指定されたプロキシサーバーに対して認証する際にprovider が使用する認証方法を指定します。
認証タイプは次のいずれかです。
"NONE" 以外のすべての値については、ProxyUser およびProxyPassword 接続プロパティも設定する必要があります。
SOCKS 5 認証のような他の認証タイプを使用するには、FirewallType を参照してください。
ProxyServer 接続プロパティで指定されたプロキシサーバーに登録されているユーザーアカウントのユーザー名。
ProxyUser および ProxyPassword 接続プロパティは、ProxyServer で指定されたHTTP プロキシに対して接続よび認証するために使用されます。
ProxyAuthScheme で利用可能な認証タイプを1つ選択した後、このプロパティを以下のように設定します。
| ProxyAuthScheme の値 | ProxyUser に設定する値 |
| BASIC | プロキシサーバーに登録されているユーザーのユーザー名。 |
| DIGEST | プロキシサーバーに登録されているユーザーのユーザー名。 |
| NEGOTIATE | プロキシサーバーが属するドメインまたは信頼されたドメイン内の有効なユーザーであるWindows ユーザーのユーザー名。user@domain またはdomain\user の形式で指定。 |
| NTLM | プロキシサーバーが属するドメインまたは信頼されたドメイン内の有効なユーザーであるWindows ユーザーのユーザー名。user@domain またはdomain\user の形式で指定。 |
| NONE | ProxyPassword 接続プロパティは設定しないでください。 |
Sync App は、ProxyAutoDetect がFalse に設定されている場合にのみ、このユーザー名を使用します。ProxyAutoDetect がTrue に設定されている場合(デフォルト)、Sync App は代わりにシステムのプロキシ設定で指定されているユーザー名を使用します。
ProxyUser 接続プロパティで指定されたユーザーに紐付けられたパスワード。
ProxyUser および ProxyPassword 接続プロパティは、ProxyServer で指定されたHTTP プロキシに対して接続よび認証するために使用されます。
ProxyAuthScheme で利用可能な認証タイプを1つ選択した後、このプロパティを以下のように設定します。
| ProxyAuthScheme の値 | ProxyPassword に設定する値 |
| BASIC | ProxyUser で指定したプロキシサーバーユーザーに紐付けられたパスワード。 |
| DIGEST | ProxyUser で指定したプロキシサーバーユーザーに紐付けられたパスワード。 |
| NEGOTIATE | ProxyUser で指定したWindows ユーザーアカウントに紐付けられたパスワード。 |
| NTLM | ProxyUser で指定したWindows ユーザーアカウントに紐付けられたパスワード。 |
| NONE | ProxyPassword 接続プロパティは設定しないでください。 |
SOCKS 5 認証もしくは、トンネリングは、FirewallType を参照してください。
Sync App は、ProxyAutoDetect がFalse に設定されている場合にのみ、このパスワードを使用します。ProxyAutoDetect がTrue に設定されている場合(デフォルト)、Sync App は代わりにシステムのプロキシ設定で指定されているパスワードを使用します。
ProxyServer 接続プロパティで指定されたプロキシサーバーに接続する際に使用するSSL タイプ。
このプロパティは、ProxyServer で指定されたHTTP プロキシへの接続にSSL を使用するかどうかを決定します。この接続プロパティには、以下の値を設定できます。
| AUTO | デフォルト設定。ProxyServer がHTTPS URL に設定されている場合、Sync App は、TUNNEL オプションを使用します。ProxyServer がHTTP URL に設定されている場合、コンポーネントはNEVER オプションを使用します。 |
| ALWAYS | 接続は、常にSSL 有効となります。 |
| NEVER | 接続は、SSL 有効になりません。 |
| TUNNEL | 接続はトンネリングプロキシ経由で行われます。プロキシサーバーがリモートホストへの接続を開き、プロキシを経由して通信が行われます。 |
ProxyServer 接続プロパティで設定されたプロキシサーバー経由での接続が免除される宛先ホスト名またはIP のセミコロン区切りのリスト。
ProxyServer は、このプロパティで定義されたアドレスを除くすべてのアドレスに使用されます。セミコロンを使用してエントリを区切ります。
Sync App はデフォルトでシステムプロキシ設定を使用するため、それ以上の設定は必要ありません。この接続にプロキシ例外を明示的に設定する場合は、ProxyAutoDetect をFalse に設定します。
このセクションでは、本プロバイダーの接続文字列で設定可能なLogging プロパティの全リストを提供します。
| プロパティ | 説明 |
| LogModules | ログファイルに含めるコアモジュールを指定します。セミコロンで区切られたモジュール名のリストを使用します。デフォルトでは、すべてのモジュールがログに記録されます。 |
ログファイルに含めるコアモジュールを指定します。セミコロンで区切られたモジュール名のリストを使用します。デフォルトでは、すべてのモジュールがログに記録されます。
このプロパティは、含めるログモジュールを指定することでログファイルの内容をカスタマイズすることができます。 ログモジュールは、クエリ実行、メタデータ、SSL 通信などの異なる領域にログ情報を分類します。 各モジュールは4文字のコードで表され、文字の名前の場合は末尾にスペースが必要なものもあります。
例えば、EXEC はクエリ実行をログに記録し、INFO は一般的なプロバイダーメッセージをログに記録します。 複数のモジュールを含めるには、次のように名前をセミコロンで区切ります:INFO;EXEC;SSL。
Verbosity 接続プロパティは、このプロパティで指定されたモジュールベースのフィルタリングよりも優先されます。 Verbosity レベルを満たし、指定されたモジュールに属するログエントリのみが記録されます。 利用可能なすべてのモジュールをログファイルに含めるには、このプロパティを空白のままにします。
利用可能なモジュールの完全なリストとログの設定に関する詳細な手引きについては、ログ の「高度なログの記録」セクションを参照してください。
このセクションでは、本プロバイダーの接続文字列で設定可能なSchema プロパティの全リストを提供します。
| プロパティ | 説明 |
| Location | テーブル、ビュー、およびストアドプロシージャを定義するスキーマファイルを格納するディレクトリの場所を指定します。サービスの要件に応じて、これは絶対パスまたは相対パスのいずれかで表されます。 |
| BrowsableSchemas | レポートされるスキーマを利用可能なすべてのスキーマのサブセットに制限するオプション設定。例えば、 BrowsableSchemas=SchemaA,SchemaB,SchemaC です。 |
| Tables | レポートされるテーブルを利用可能なすべてのテーブルのサブセットに制限するオプション設定。例えば、 Tables=TableA,TableB,TableC です。 |
| Views | レポートされたビューを使用可能なテーブルのサブセットに制限するオプション設定。例えば、 Views=ViewA,ViewB,ViewC です。 |
テーブル、ビュー、およびストアドプロシージャを定義するスキーマファイルを格納するディレクトリの場所を指定します。サービスの要件に応じて、これは絶対パスまたは相対パスのいずれかで表されます。
Location プロパティは、定義をカスタマイズしたり(例えば、カラム名を変更する、カラムを無視するなど)、新しいテーブル、ビュー、またはストアドプロシージャでデータモデルを拡張する場合にのみ必要です。
指定しない場合、デフォルトの場所は%APPDATA%\\CData\\Trello Data Provider\\Schema となり、%APPDATA%はユーザーのコンフィギュレーションディレクトリに設定されます:
| プラットフォーム | %APPDATA% |
| Windows | APPDATA 環境変数の値 |
| Linux | ~/.config |
レポートされるスキーマを利用可能なすべてのスキーマのサブセットに制限するオプション設定。例えば、 BrowsableSchemas=SchemaA,SchemaB,SchemaC です。
利用可能なデータベーススキーマをすべてリストすると余分な時間がかかり、パフォーマンスが低下します。 接続文字列にスキーマのリストを指定することで、時間を節約しパフォーマンスを向上させることができます。
レポートされるテーブルを利用可能なすべてのテーブルのサブセットに制限するオプション設定。例えば、 Tables=TableA,TableB,TableC です。
データベースによっては、利用可能なすべてのテーブルをリストするのに時間がかかり、パフォーマンスが低下する場合があります。 接続文字列にテーブルのリストを指定することで、時間を節約しパフォーマンスを向上させることができます。
利用可能なテーブルがたくさんあり、すでに作業したいテーブルが決まっている場合、このプロパティを使用して対象のテーブルのみに表示を制限することができます。これを行うには、カンマ区切りのリストで使用したいテーブルを指定します。各テーブルは、角かっこ、二重引用符、またはバッククオートを使用してエスケープされた特殊文字列を含む有効なSQL 識別子である必要があります。 例えば、Tables=TableA,[TableB/WithSlash],WithCatalog.WithSchema.`TableC With Space` です。
Note:複数のスキーマまたはカタログを持つデータソースに接続する場合は、表示する各テーブルを完全修飾名で指定する必要があります。これにより、複数のカタログやスキーマに存在するテーブルが混同されることを防ぎます。
レポートされたビューを使用可能なテーブルのサブセットに制限するオプション設定。例えば、 Views=ViewA,ViewB,ViewC です。
データベースによっては、利用可能なすべてのビューをリストするのに時間がかかり、パフォーマンスが低下する場合があります。 接続文字列にビューのリストを指定することで、時間を節約しパフォーマンスを向上させることができます。
利用可能なビューがたくさんあり、すでに作業したいビューが決まっている場合、このプロパティを使用して対象のビューのみに表示を制限することができます。これを行うには、カンマ区切りのリストで使用したいビューを指定します。各ビューは、角かっこ、二重引用符、またはバッククオートを使用してエスケープされた特殊文字列を含む有効なSQL 識別子である必要があります。 例えば、Views=ViewA,[ViewB/WithSlash],WithCatalog.WithSchema.`ViewC With Space` です。
Note:複数のスキーマまたはカタログを持つデータソースに接続する場合は、確認する各ビューを完全修飾名で指定する必要があります。これにより、複数のカタログやスキーマに存在するビューが混同されることを防ぎます。
このセクションでは、本プロバイダーの接続文字列で設定可能な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 | 集計やGROUP BY を使用しないクエリで返される最大行数を指定します。 |
| Other | 特定のユースケースに対して追加の隠しプロパティを指定します。これらは通常のprovider の機能では必要ありません。複数のプロパティを定義するには、セミコロンで区切られたリストを使用します。 |
| PseudoColumns | テーブルカラムとして公開する擬似カラムを指定します。'TableName=ColumnName;TableName=ColumnName' という形式を使用します。デフォルトは空の文字列で、このプロパティを無効にします。 |
| Timeout | provider がタイムアウトエラーを返すまでにサーバーからの応答を待機する最大時間を秒単位で指定します。デフォルトは60秒です。タイムアウトを無効にするには0を設定します。 |
| UserDefinedViews | カスタムビューを定義するJSON 構成ファイルへのファイルパスを指定します。provider は、このファイルで指定されたビューを自動的に検出して使用します。 |
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 CardsRunning the query above will list all the custom fields created as table columns.
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.
集計やGROUP BY を使用しないクエリで返される最大行数を指定します。
このプロパティは、集計やGROUP BY 句を含まないクエリに対してSync App が返す行数の上限を設定します。 この制限により、クエリがデフォルトで過度に大きな結果セットを返さないようにします。
クエリにLIMIT 句が含まれている場合、クエリで指定された値がMaxRows 設定よりも優先されます。 MaxRows が"-1" に設定されている場合、LIMIT 句が明示的にクエリに含まれていない限り、行の制限は行われません。
このプロパティは、非常に大きなデータセットを返す可能性のあるクエリを実行する際に、パフォーマンスを最適化し過剰なリソース消費を防ぐのに役立ちます。
特定のユースケースに対して追加の隠しプロパティを指定します。これらは通常のprovider の機能では必要ありません。複数のプロパティを定義するには、セミコロンで区切られたリストを使用します。
このプロパティは、シニアユーザーが特定のシナリオに対して隠しプロパティを設定できるようにします。 これらの設定は通常のユースケースには必要ありませんが、特定の要件に対応したり、追加の機能を提供したりすることができます。 複数のプロパティをセミコロン区切りのリストで定義できます。
Note: 特定のシナリオや問題に対処するためにサポートチームから助言があった場合にのみ、これらのプロパティを設定することを強く推奨します。
複数のプロパティをセミコロン区切りリストで指定します。
| DefaultColumnSize | データソースがメタデータにカラムの長さを提供しない場合に、文字列フィールドのデフォルトの長さを設定します。デフォルト値は2000です。 |
| ConvertDateTimeToGMT | 日時の値を、マシンのローカルタイムではなくGMT グリニッジ標準時に変換するかどうかを決定します。 |
| RecordToFile=filename | 基底のソケットデータ転送を指定のファイルに記録します。 |
テーブルカラムとして公開する擬似カラムを指定します。'TableName=ColumnName;TableName=ColumnName' という形式を使用します。デフォルトは空の文字列で、このプロパティを無効にします。
このプロパティを使用すると、Sync App がテーブルカラムとして公開する擬似カラムを定義できます。
個々の擬似カラムを指定するには、以下の形式を使用します。"Table1=Column1;Table1=Column2;Table2=Column3"
すべてのテーブルのすべての擬似カラムを含めるには、次のようにします:"*=*"
provider がタイムアウトエラーを返すまでにサーバーからの応答を待機する最大時間を秒単位で指定します。デフォルトは60秒です。タイムアウトを無効にするには0を設定します。
このプロパティは、Sync App が操作をキャンセルする前に操作の完了を待機する最大時間を秒単位で制御します。 操作の完了前にタイムアウト時間が経過すると、Sync App は操作をキャンセルして例外をスローします。
タイムアウトは、クエリや操作全体ではなくサーバーとの個々の通信に適用されます。 例えば、各ページング呼び出しがタイムアウト制限内に完了する場合、クエリは60秒を超えて実行を続けることができます。
このプロパティを0に設定するとタイムアウトが無効になり、操作が成功するか、サーバー側のタイムアウト、ネットワークの中断、またはサーバーのリソース制限などの他の条件で失敗するまで無期限に実行されます。 このプロパティは慎重に使用してください。長時間実行される操作がパフォーマンスを低下させたり、応答しなくなる可能性があるためです。
カスタムビューを定義するJSON 構成ファイルへのファイルパスを指定します。provider は、このファイルで指定されたビューを自動的に検出して使用します。
このプロパティを使用すると、UserDefinedViews.json というJSON 形式の構成ファイルを通じてカスタムビューを定義および管理できます。 これらのビューはSync App によって自動的に認識され、標準のデータベースビューのようにカスタムSQL クエリを実行できるようになります。 JSON ファイルは、各ビューをルート要素として定義し、その子要素として"query" を持ちます。この"query" にはビューのSQL クエリが含まれています。次に例を示します。
{
"MyView": {
"query": "SELECT * FROM Cards WHERE MyColumn = 'value'"
},
"MyView2": {
"query": "SELECT * FROM MyTable WHERE Id IN (1,2,3)"
}
}
このプロパティを使用して、1つのファイルに複数のビューを定義し、ファイルパスを指定できます。 例:UserDefinedViews=C:\Path\To\UserDefinedViews.json。 このプロパティを使用すると、指定されたビューのみがSync App によって検知されます。
詳しくは、ユーザー定義ビュー を参照してください。