接続の確立

Monday への接続を追加

Monday への接続を追加するには：

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

必須プロパティについては、設定タブを参照してください。

通常必須ではない接続プロパティについては、高度な設定タブを参照してください。

Monday への接続

Monday AuditLog API

Monday AuditLog API は、API トークンによる認証のみをサポートしています。

監査ログAPI トークンを生成するには：

Monday アカウントにログインします。
Admin セクションにアクセスします。
Security に移動します。
Audit タブをクリックします。
Monitor by API をクリックします。Monday がAPI トークンを表示します。

API トークンを取得した後、以下の接続プロパティを設定します。

Schema=AuditLog
AuthScheme=Token
APIToken=取得した監査ログAPI トークン
Domain=https://yourdomain.monday.com

これで、Monday AuditLog API に接続する準備が整いました。

Monday GraphQL API

Monday GraphQL API は、API トークンまたはOAuth 標準による認証をサポートしています。

API トークン

API トークンでSync App に接続するには、AuthScheme をToken に設定し、次の手順でAPIToken を取得します。

Monday アカウントにログインします。
左ペインのManage Applications に移動します。Monday は管理するアプリケーションのリストを表示します。
トークンを作成するアプリケーションを選択します。最初にアプリケーションを作成する必要がある場合があります。
APIToken を生成するには、Create token をクリックします。

OAuth

Monday はOAuth 認証のみサポートします。この認証を有効にするには、すべてのOAuth フローでAuthScheme をOAuth に設定し、カスタムOAuth アプリケーションを作成する必要があります。

以下のサブセクションでは、3つの標準的な認証フローでのMonday への認証について詳しく説明します。

デスクトップ：ユーザーのローカルマシン上でのサーバーへの接続で、テストやプロトタイピングによく使用されます。
Web：共有ウェブサイト経由でデータにアクセスします。
ヘッドレスサーバー：他のコンピュータやそのユーザーにサービスを提供する専用コンピュータで、モニタやキーボードなしで動作するように構成されています。

カスタムOAuth アプリケーションの作成については、カスタムOAuth アプリケーションの作成を参照してください。

Monday で利用可能な接続文字列プロパティの全リストは、Connection を参照してください。

アクセストークンの期限が切れたときは、Sync App は自動でアクセストークンをリフレッシュします。

OAuth アクセストークンの自動リフレッシュ：

Sync App がOAuth アクセストークンを自動的にリフレッシュするようにするには、次のように設定します。

はじめてデータに接続する際、次の接続プロパティを設定します。
- InitiateOAuth = REFRESH。
- OAuthClientId = アプリケーション設定のクライアントId。
- OAuthClientSecret = アプリケーション設定のクライアントシークレット。
- OAuthAccessToken = によって返されたアクセストークン。
- OAuthSettingsLocation = Sync App がOAuth 値を保存する場所のパス。これは接続間で維持されます。
その後のデータ接続では、以下を設定します。
- InitiateOAuth
- OAuthSettingsLocation

高度な機能

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

ユーザー定義ビュー

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

SSL の設定

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

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

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

クエリ処理

Sync App は、Monday にできるだけ多くの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 に設定します。

データモデル

CData Sync App は、Monday API のエンティティをビューおよびストアドプロシージャにモデル化します。これらは、簡単なテキストベースのコンフィギュレーションファイルであるスキーマファイルにて定義されます。

Information の使用

Information スキーマで利用可能なエンティティについては、Information データモデルを参照してください。

AuditLog の使用

AuditLog スキーマで利用可能なエンティティについては、AuditLog データモデルを参照してください。

Workspace の使用

Workspace タイプのスキーマで利用可能なエンティティについては、Workspace データモデルを参照してください。

Information データモデル

Overview

This section shows the available API objects and provides more information on executing SQL to Monday APIs.

Key Features

The Sync App models Monday entities as relational views and tables, allowing you to write SQL to query and modify Monday data.
Stored procedures allow you to execute operations to Monday
Live connectivity to these objects means any changes to your account are reflected when using the Sync App.

Tables

テーブル are tables that can be modified.

Views

ビュー are tables that cannot be modified. Typically, model data that is read-only and cannot be updated are shown as views.

Stored Procedures

ストアドプロシージャ are function-like interfaces to the data source.

テーブル

Sync App はMonday のデータを、標準のSQL ステートメントを使用してクエリできるリレーショナルデータベースのテーブルのリストとしてモデル化します。

Monday Connector for CData Sync テーブル


Name	Description
Boards	Get a collection of boards.
BoardTeams	Get a board's team subscribers.
BoardUsers	Get a board's subscribers.
DocBlocks	Get a document's content blocks.
Docs	Get a collection of docs.
Folders	Get a collection of folders. Note that this won't return folders from closed workspaces to which you are not subscribed.
Groups	Get a board's visible groups.
Tags	Get a collection of tags.
TeamUsers	Get a team's users.
Updates	Get a collection of updates.
Webhooks	Get a collection of webhooks.
Workspaces	Get a collection of workspaces.
WorkspaceTeams	Get the teams subscribed to the workspace.
WorkspaceUsers	Get the users subscribed to the workspace.

Boards

Get a collection of boards.

View-Specific Information

SELECT

The Sync App uses the Monday API to process some of the filters. The Sync App processes other filters client-side within the Sync App. You can turn off the client-side execution of the query by setting SupportEnhancedSQL to false in which case any search criteria that refers to other columns will cause inconsistent data.

Id supports the '=','IN' comparison operators.
BoardKind supports the '=' comparison operator.
State supports the '=' comparison operator.
WorkspaceId supports the '=','IN' comparison operators.

For example, the following queries are processed server side:

SELECT * FROM Boards WHERE Id = '2182296646'
SELECT * FROM Boards WHERE Id IN ('2307103055', '2182296646', '2181960030')
SELECT * FROM Boards WHERE Id IN ('2307103055', '2182296646', '2181960030') AND BoardKind = 'public'
SELECT * FROM Boards WHERE BoardKind = 'public'

INSERT

INSERT statements are mapped to the 'create_board' GraphQL mutation.

The following inputs can be used in INSERT statements:

Name, Description, BoardKind, BoardFolderId, WorkspaceId, TemplateId, BoardOwnerIds, BoardOwnerTeamIds, BoardSubscriberIds, BoardSubscriberTeamIds, Empty

INSERT INTO Boards (WorkspaceId,BoardKind,Name,Description,BoardFolderId,BoardOwnerIds,BoardSubscriberTeamIds,Empty) VALUES ('3820334','public','NewBoard','A newly created board.','12689416','51688059,51085546','960990',true)

UPDATE

UPDATE statements are mapped to the 'update_board' and 'archive_board' GraphQL mutations.

The following inputs can be used in UPDATE statements (note that due to API limitations only one column's value can be updated per statement):

Id, Name, Description, Communication, State, BoardAttributes

UPDATE Boards SET Name='AnotherName' WHERE Id='5549166043'
UPDATE Boards SET State='archived' WHERE Id='5549166043'

DELETE

DELETE statements are mapped to the 'delete_board' GraphQL mutation.

You can delete entries by specifying the Id.

DELETE FROM Boards WHERE Id='5549166043'

Columns


Name	Type	ReadOnly	References	Description
Id [KEY]	String	False		The unique identifier of the board.
CreatorId	String	False	Users.Id	The user's unique identifier.
Name	String	False		The board's name.
ItemTerminology	String	False		The Board's item nickname, one of a predefined set of values, or a custom user value.
ItemsCount	Int	False		The number of items on the board.
TopGroupId	String	False	Groups.Id	The group's unique identifier.
Description	String	False		The board's description.
UpdatedAt	Datetime	False		The last time the board was updated at.
Type	String	False		The board object type.
BoardKind	String	False		The board's kind (public / private / share).
BoardFolderId	String	False	Folders.Id	The board's folder unique identifier.
Communication	String	False		Get the board communication value - typically meeting ID.
Permissions	String	False		The board's permissions.
TagsIds	String	False	Tags.Id	A comma separated list of the tags' unique identifiers.
State	String	False		The board's state (all / active / archived / deleted).
WorkspaceId	String	False	Workspaces.Id	The board's workspace unique identifier (null for main workspace).

Pseudo-Columns

SELECT ステートメントのWHERE 句では、疑似カラムフィールドを使用して、データソースから返されるタプルを詳細に制御することができます。


Name	Type	Description
TemplateId	String	Optional board template id.
BoardOwnerIds	String	Optional, comma-seperated list of board owner user ids.
BoardOwnerTeamIds	String	Optional, comma-seperated list of board owner team ids.
BoardSubscriberIds	String	Optional, comma-seperated list of board subscriber ids.
BoardSubscriberTeamIds	String	Optional, comma-seperated list of subscriber team ids.
Empty	Bool	Optional flag to create an empty board (without any default items).

BoardTeams

Get a board's team subscribers.

View-Specific Information

SELECT

The Sync App uses the Monday API to process some of the filters. The Sync App processes other filters client-side within the Sync App. You can turn off the client-side execution of the query by setting SupportEnhancedSQL to false in which case any search criteria that refers to other columns will cause inconsistent data.

BoardId supports the '=' comparison operator.

For example, the following queries are processed server side:

SELECT * FROM BoardTeams WHERE BoardId='5557271485'

INSERT

INSERT statements are mapped to the 'add_teams_to_board' GraphQL mutation.

The following inputs can be used in INSERT statements:

Id, BoardId, Kind

INSERT INTO BoardTeams (Id,BoardId,Kind) VALUES ('51688059','5546871560','subscriber')

DELETE

DELETE statements are mapped to the 'delete_teams_from_board' GraphQL mutation.

You can delete entries by specifying the Id and BoardId.

DELETE FROM BoardTeams WHERE Id='51688059' AND BoardId='5546871560'

Columns


Name	Type	ReadOnly	References	Description
Id [KEY]	String	False	Teams.Id	The board team's unique identifier.
BoardId [KEY]	String	False	Boards.Id	The unique identifier of the board.
Kind	String	False		The team's role: subscriber or owner. All owners are by default also subscribers. This column can be used to filter non-owners.

BoardUsers

Get a board's subscribers.

View-Specific Information

SELECT

The Sync App uses the Monday API to process some of the filters. The Sync App processes other filters client-side within the Sync App. You can turn off the client-side execution of the query by setting SupportEnhancedSQL to false in which case any search criteria that refers to other columns will cause inconsistent data.

BoardId supports the '=','IN' comparison operators.
Kind supports the '=' comparison operator.

For example, the following queries are processed server side:

SELECT * FROM BoardUsers WHERE BoardId='5525287714'
SELECT * FROM BoardUsers WHERE Kind='owner'

INSERT

INSERT statements are mapped to the 'add_users_to_board' GraphQL mutation.

The following inputs can be used in INSERT statements:

Id, BoardId, Kind

INSERT INTO BoardUsers (Id,BoardId,Kind) VALUES ('51688059','5546871560','subscriber')

DELETE

DELETE statements are mapped to the 'delete_subscribers_from_board' GraphQL mutation.

You can delete entries by specifying the Id and BoardId.

DELETE FROM BoardUsers WHERE Id='51688059' AND BoardId='5546871560'

Columns


Name	Type	ReadOnly	References	Description
Id [KEY]	String	False	Users.Id	The board owner's unique identifier.
BoardId [KEY]	String	False	Boards.Id	The unique identifier of the board.
Kind	String	False		The user's role: subscriber or owner. All owners are by default also subscribers. This column can be used to filter non-owners.

DocBlocks

Get a document's content blocks.

View-Specific Information

SELECT

The Sync App uses the Monday API to process some of the filters. The Sync App processes other filters client-side within the Sync App. You can turn off the client-side execution of the query by setting SupportEnhancedSQL to false in which case any search criteria that refers to other columns will cause inconsistent data.

DocId supports the '=','IN' comparison operators.

For example, the following queries are processed server side:

SELECT * FROM DocBlocks WHERE DocId = '9014425'
SELECT * FROM DocBlocks WHERE DocId IN ('9014425','9014490')

INSERT

INSERT statements are mapped to the 'create_doc_block' GraphQL mutation.

The following inputs can be used in INSERT statements:

ParentBlockId, DocId, Content, Type, AfterBlockId

INSERT INTO DocBlocks (DocId,Type,Content,AfterBlockId) VALUES ('9180448','code','{"alignment":"left","direction":"ltr","deltaFormat":[{"insert":"Test"}]}','53ab947f-226f-49f5-8d43-1021f9f36431')

UPDATE

UPDATE statements are mapped to the 'update_doc_block' GraphQL mutation.

The following inputs can be used in UPDATE statements:

Id, Content

UPDATE DocBlocks SET Content='{"alignment":"left","direction":"ltr","deltaFormat":[{"insert":"NewValue"}]}' WHERE Id = '9b24043b-6ea9-46b0-9f0a-1ec226f12d21'

DELETE

DELETE statements are mapped to the 'delete_doc_block' GraphQL mutation.

You can delete entries by specifying the Id.

DELETE FROM DocBlocks WHERE Id = '9b24043b-6ea9-46b0-9f0a-1ec226f12d21'

Columns


Name	Type	ReadOnly	References	Description
Id [KEY]	String	False		The block's unique identifier.
ParentBlockId	String	False		The block's parent block unique identifier.
DocId	String	False	Docs.Id	The block's document unique identifier.
CreatedById	String	False	Users.Id	The user's unique identifier.
Position	Double	False		The block's position on the document.
Content	String	False		The block's content.
Type	String	False		The block content type.
CreatedAt	Date	False		The block's creation date.
UpdatedAt	Date	False		The block's last updated date.

Pseudo-Columns

SELECT ステートメントのWHERE 句では、疑似カラムフィールドを使用して、データソースから返されるタプルを詳細に制御することができます。


Name	Type	Description
AfterBlockId	String	After which block to insert this one. If not provided, will be inserted first in the document.

Docs

Get a collection of docs.

View-Specific Information

SELECT

The Sync App uses the Monday API to process some of the filters. The Sync App processes other filters client-side within the Sync App. You can turn off the client-side execution of the query by setting SupportEnhancedSQL to false in which case any search criteria that refers to other columns will cause inconsistent data.

Id supports the '=','IN' comparison operators.
ObjectId supports the '=','IN' comparison operators.
WorkspaceId supports the '=','IN' comparison operators.

For example, the following queries are processed server side:

SELECT * FROM Docs WHERE Id = '9014425'
SELECT * FROM Docs WHERE Id IN ('9014425','9014490')
SELECT * FROM Docs WHERE ObjectId = '5499548740'
SELECT * FROM Docs WHERE ObjectId IN ('5499548740','5499563743')
SELECT * FROM Docs WHERE WorkspaceId = '3578971'

INSERT

INSERT statements are mapped to the 'create_doc' GraphQL mutation.

The following inputs can be used in INSERT statements:

WorkspaceId, DocKind, Name

INSERT INTO Docs (WorkspaceId,DocKind,Name) VALUES ('3820334','public','CreatedDoc')

Columns


Name	Type	ReadOnly	References	Description
Id [KEY]	String	False		The document's unique identifier.
DocFolderId	String	False	Folders.Id	The document's folder unique identifier (null for first level).
ObjectId	String	False		The associated board or object's unique identifier.
WorkspaceId	String	False	Workspaces.Id	The document's workspace unique identifier (null for main workspace).
CreatedById	String	False	Users.Id	The user's unique identifier.
DocKind	String	False		The document's kind (public / private / share).
Name	String	False		The document's name.
RelativeUrl	String	False		The document's relative url.
Settings	String	False		The document's settings.
Url	String	False		The document's direct url.
CreatedAt	Date	False		The document's creation date.

Folders

Get a collection of folders. Note that this won't return folders from closed workspaces to which you are not subscribed.

View-Specific Information

SELECT

The Sync App uses the Monday API to process some of the filters. The Sync App processes other filters client-side within the Sync App. You can turn off the client-side execution of the query by setting SupportEnhancedSQL to false in which case any search criteria that refers to other columns will cause inconsistent data.

Id supports the '=','IN' comparison operators.
WorkspaceId supports the '=','IN' comparison operators.

For example, the following queries are processed server side:

SELECT * FROM Folders WHERE Id = '12622355'
SELECT * FROM Folders WHERE WorkspaceId = '3578971'

INSERT

INSERT statements are mapped to the 'create_folder' GraphQL mutation.

The following inputs can be used in INSERT statements:

ParentId, WorkspaceId, Color, Name

INSERT INTO Folders (WorkspaceId,Name,Color) VALUES ('3578971','TestFolder','BRIGHT_BLUE')

UPDATE

UPDATE statements are mapped to the 'update_folder' GraphQL mutation.

The following inputs can be used in UPDATE statements:

Id, ParentId, Color, Name

UPDATE Folders SET Color='SUNSET',Name='UpdatedName' WHERE Id='12678064'

DELETE

DELETE statements are mapped to the 'delete_folder' GraphQL mutation.

You can delete entries by specifying the Id.

DELETE FROM Folders WHERE Id='12678064'

Columns


Name	Type	ReadOnly	References	Description
Id [KEY]	String	False		The folder's unique identifier.
OwnerId	String	False	Users.Id	The folder's user owner unique identifier.
ParentId	String	False		The unique identifiers of the folder's parent folder.
SubFolderIds	String	False		The unique identifiers of the sub-folders inside the folder.
WorkspaceId	String	False	Workspaces.Id	The workspace's unique identifier.
Color	String	False		The folder's color.
Name	String	False		The folder's name.
CreatedAt	Datetime	False		The folder's creation date.

Groups

Get a board's visible groups.

View-Specific Information

SELECT

The Sync App uses the Monday API to process some of the filters. The Sync App processes other filters client-side within the Sync App. You can turn off the client-side execution of the query by setting SupportEnhancedSQL to false in which case any search criteria that refers to other columns will cause inconsistent data.

Id supports the '=','IN' comparison operators.
BoardId supports the '=','IN' comparison operators.

For example, the following queries are processed server side:

SELECT * FROM Groups WHERE Id = 'topics'
SELECT * FROM Groups WHERE Id IN ('topics', 'group_title')
SELECT * FROM Groups WHERE BoardId IN ('2182296646', '21822966')
SELECT * FROM Groups WHERE BoardId = '2182296646' AND Id = 'topics'

INSERT

INSERT statements are mapped to the 'create_group' GraphQL mutation.

The following inputs can be used in INSERT statements:

BoardId, Title, RelativeTo, PositionRelativeMethod

INSERT INTO Groups (BoardId,Title,RelativeTo,PositionRelativeMethod) VALUES ('5525287714','NewGroup','testgroup','after_at')

UPDATE

UPDATE statements are mapped to the 'update_group' and 'archive_group' GraphQL mutations.

The following inputs can be used in UPDATE statements (note that due to API limitations only one column's value can be updated per statement):

Id, BoardId, Archived, Color, Title, RelativePositionAfter, RelativePositionBefore

UPDATE Groups SET Color='lime-green' WHERE BoardId='5525287714' AND Id='newgroup'
UPDATE Groups SET Archived='true' WHERE BoardId='5525287714' AND Id='newgroup'

DELETE

DELETE statements are mapped to the 'delete_group' GraphQL mutation.

You can delete entries by specifying the Id and BoardId.

DELETE FROM Groups WHERE BoardId='5525287714' AND Id='testgroup'

Columns


Name	Type	ReadOnly	References	Description
Id [KEY]	String	False		The group's unique identifier.
BoardId [KEY]	String	False	Boards.Id	The unique identifier of the board.
Archived	Bool	False		Whether or not the group is archived.
Color	String	False		The group's color.
Deleted	Bool	False		Whether or not the group is deleted.
Position	String	False		The group's position in the board.
Title	String	False		The group's title.

Pseudo-Columns

SELECT ステートメントのWHERE 句では、疑似カラムフィールドを使用して、データソースから返されるタプルを詳細に制御することができます。


Name	Type	Description
RelativeTo	String	The group to set the position next to.
PositionRelativeMethod	String	The position relative method to another group (before_at / after_at).
RelativePositionAfter	String	The group's relative position after another group in the board.
RelativePositionBefore	String	The group's relative position before another group in the board.

TeamUsers

Get a team's users.

Columns


Name	Type	ReadOnly	References	Description
Id [KEY]	String	False	Users.Id	The user's unique identifier.
TeamId [KEY]	String	False	Teams.Id	The unique identifier of the team.

Updates

Get a collection of updates.

View-Specific Information

SELECT

The Sync App uses the Monday API to process some of the filters. The Sync App processes other filters client-side within the Sync App. You can turn off the client-side execution of the query by setting SupportEnhancedSQL to false in which case any search criteria that refers to other columns will cause inconsistent data.

Id supports the '=','IN' comparison operators.
BoardId supports the '=' comparison operator.
ItemId supports the '=' comparison operator.

For example, the following queries are processed server side:

SELECT * FROM Updates WHERE Id = '173981152'
SELECT * FROM Updates WHERE ItemId = '1388002886'
SELECT * FROM Updates WHERE BoardId = '1388002765'

INSERT

INSERT statements are mapped to the 'create_update' GraphQL mutation.

The following inputs can be used in INSERT statements:

Body, ItemId, ParentId

INSERT INTO Updates (ItemId,Body,ParentId) VALUES ('5525287847','This is a new reply.','2553498004')

DELETE

DELETE statements are mapped to the 'delete_update' GraphQL mutation.

You can delete entries by specifying the Id.

DELETE FROM Updates WHERE Id='2553512994'

Columns


Name	Type	ReadOnly	References	Description
Id [KEY]	String	False		The update's unique identifier.
Body	String	False		The update's html formatted body.
CreatedAt	Datetime	False		The update's creation date.
CreatorId	String	False	Users.Id	The unique identifier of the update creator.
ItemId	String	False		The update's item ID.
TextBody	String	False		The update's text body.
UpdatedAt	Datetime	False		The update's last edit date.
AssetsIds	String	False	Assets.Id	A comma separated list of the update's assets/files unique identifiers.
Replies	String	False		The update's replies.

Pseudo-Columns

SELECT ステートメントのWHERE 句では、疑似カラムフィールドを使用して、データソースから返されるタプルを詳細に制御することができます。


Name	Type	Description
ParentId	String	The parent update's unique identifier. This can be used to create a reply to an update.

Webhooks

Get a collection of webhooks.

View-Specific Information

Select

The Sync App uses the Monday API to process WHERE clause conditions built with the following column and operator. The Sync App processes other filters client-side within the Sync App.

BoardId supports the '=' comparison operator.

For example, the following query isare processed server side:

SELECT * FROM Webhooks WHERE BoardId='5574930939'

INSERT

INSERT statements are mapped to the 'create_webhook' GraphQL mutation.

The following inputs can be used in INSERT statements:

BoardId, Config, Event, Url

INSERT INTO Webhooks (BoardId,Config,Event,Url) VALUES ('5574930939','{\"columnId\":\"status\", \"columnValue\":{\"$any$\":true}}','change_status_column_value','https://test.com/')

DELETE

DELETE statements are mapped to the 'delete_webhook' GraphQL mutation.

You can delete entries by specifying the Id.

DELETE FROM Webhooks WHERE Id='242031214'

Columns


Name	Type	ReadOnly	References	Description
Id [KEY]	String	False		The webhooks's unique identifier.
BoardId	String	False		Board unique identifier.
Config	String	False		The webhooks's config.
Event	String	False		The event webhook will listen to.
AppWebhooksOnly	Bool	False		Filters webhooks that were created by the app initiating the request.

Pseudo-Columns

SELECT ステートメントのWHERE 句では、疑似カラムフィールドを使用して、データソースから返されるタプルを詳細に制御することができます。


Name	Type	Description
Url	String	The webhook URL.

Workspaces

Get a collection of workspaces.

View-Specific Information

SELECT

The Sync App uses the Monday API to process some of the filters. The Sync App processes other filters client-side within the Sync App. You can turn off the client-side execution of the query by setting SupportEnhancedSQL to false in which case any search criteria that refers to other columns will cause inconsistent data.

Id supports the '=','IN' comparison operators.
Kind supports the '=' comparison operator.
State supports the '=' comparison operator.

For example, the following queries are processed server side:

SELECT * FROM Workspaces WHERE Id='3578971'
SELECT * FROM Workspaces WHERE Kind='open'
SELECT * FROM Workspaces WHERE State='active'

INSERT

INSERT statements are mapped to the 'create_workspace' GraphQL mutation.

The following inputs can be used in INSERT statements:

Description, Kind, Name

INSERT INTO Workspaces (Name,Kind,Description) VALUES ('New Workspace','open','This is my new workspace.')

UPDATE

UPDATE statements are mapped to the 'update_workspace' GraphQL mutation.

The following inputs can be used in INSERT statements:

Id, Description, Name, Kind

UPDATE Workspaces Set Description='testDescription', Name='testName', Kind='open' WHERE Id='3819431'

DELETE

DELETE statements are mapped to the 'delete_workspace' GraphQL mutation.

You can delete entries by specifying the Id.

DELETE FROM Workspaces WHERE Id='3819431'

Columns


Name	Type	ReadOnly	References	Description
Id [KEY]	String	False		The workspace's unique identifier.
Description	String	False		The workspace's description.
Kind	String	False		The workspace's kind (open / closed).
Name	String	False		The workspace's name.
State	String	False		The workspace's state (all / active / archived / deleted).
CreatedAt	Datetime	False		The workspace's creation date.
AccountProductId	String	False		The account product id.
AccountProductKind	String	False		The account product kind (core / marketing / crm / software / projectManagement / project_management / forms / whiteboard).
SettingsIconColor	String	False		The icon color in hex value. Used as a background for the image.
SettingsIconImage	String	False		The public image URL, which is temporary in the case of a file that was uploaded by the user, so you'll need to pull a new version at least once an hour. In case it is null, you can use the first letter of the workspace name.

WorkspaceTeams

Get the teams subscribed to the workspace.

View-Specific Information

SELECT

The Sync App uses the Monday API to process some of the filters. The Sync App processes other filters client-side within the Sync App. You can turn off the client-side execution of the query by setting SupportEnhancedSQL to false in which case any search criteria that refers to other columns will cause inconsistent data.

WorkspaceId supports the '=' comparison operator.
Kind supports the '=' comparison operator.

For example, the following queries are processed server side:

SELECT * FROM WorkspaceTeams WHERE Kind='owner'
SELECT * FROM WorkspaceTeams WorkspaceId='3820334'

INSERT

INSERT statements are mapped to the 'add_teams_to_workspace' GraphQL mutation.

The following inputs can be used in INSERT statements:

Id, WorkspaceId, Kind

INSERT INTO WorkspaceTeams (Id,WorkspaceId,Kind) VALUES ('961021','3820334','subscriber')
INSERT INTO WorkspaceTeams (Id,WorkspaceId,Kind) VALUES ('961021','3820334','owner')

DELETE

DELETE statements are mapped to the 'delete_teams_from_workspace' GraphQL mutation.

You can delete entries by specifying the Id and WorkspaceId.

DELETE FROM WorkspaceTeams WHERE Id='961021' AND WorkspaceId='3820334'

Columns


Name	Type	ReadOnly	References	Description
Id [KEY]	String	False		The team's unique identifier.
WorkspaceId [KEY]	String	False		The workspace's unique identifier.
Kind	String	False		The team's role: subscriber or owner. All owners are by default also subscribers. This column can be used to filter non-owners.

WorkspaceUsers

Get the users subscribed to the workspace.

View-Specific Information

SELECT

The Sync App uses the Monday API to process some of the filters. The Sync App processes other filters client-side within the Sync App. You can turn off the client-side execution of the query by setting SupportEnhancedSQL to false in which case any search criteria that refers to other columns will cause inconsistent data.

WorkspaceId supports the '=' comparison operator.
Kind supports the '=' comparison operator.

For example, the following queries are processed server side:

SELECT * FROM WorkspaceUsers WHERE WorkspaceId='3578971'
SELECT * FROM WorkspaceUsers WHERE Kind='owner'

INSERT

INSERT statements are mapped to the 'add_users_to_workspace' GraphQL mutation.

The following inputs can be used in INSERT statements:

Id, WorkspaceId, Kind

INSERT INTO WorkspaceUsers (Id,WorkspaceId,Kind) VALUES ('51688059','3820334','subscriber')

DELETE

DELETE statements are mapped to the 'delete_users_from_workspace' GraphQL mutation.

You can delete entries by specifying the Id and WorkspaceId.

DELETE FROM WorkspaceUsers WHERE Id='51688059' AND WorkspaceId='3820334'

Columns


Name	Type	ReadOnly	References	Description
Id [KEY]	String	False		The user's unique identifier.
WorkspaceId [KEY]	String	False		The workspace's unique identifier.
Kind	String	False		The user's role: subscriber or owner. All owners are by default also subscribers. This column can be used to filter non-owners.

ビュー

ビューは、データを示すという点でテーブルに似ていますが、ビューは読み取り専用です。

クエリは、ビューに対して通常のテーブルと同様に実行することができます。

Monday Connector for CData Sync ビュー


Name	Description
ActivityLogs	Get a board's log events.
Assets	Get a collection of assets by ids.
BoardViews	Get a board's views.
Teams	Get a collection of teams.
Users	Get a collection of users.

ActivityLogs

Get a board's log events.

View-Specific Information

SELECT

The Sync App uses the Monday API to process some of the filters. The Sync App processes other filters client-side within the Sync App. You can turn off the client-side execution of the query by setting SupportEnhancedSQL to false in which case any search criteria that refers to other columns will cause inconsistent data.

BoardId supports the '=','IN' comparison operators.
UserId supports the '=','IN' comparison operators.
CreatedAt supports the '>','>=;to' comparison operators.
ColumnId supports the '=','IN' comparison operators.
GroupId supports the '=','IN' comparison operators.
ItemId supports the '=','IN' comparison operators.

For example, the following queries are processed server side:

SELECT * FROM ActivityLogs WHERE BoardId IN ('2307103055', '2182296646')
SELECT * FROM ActivityLogs WHERE UserId IN ('27278379', '28087608')
SELECT * FROM ActivityLogs WHERE ColumnId IN ('27278379', '28087608')
SELECT * FROM ActivityLogs WHERE GroupId IN ('27278379', '28087608')
SELECT * FROM ActivityLogs WHERE ItemId IN ('27278379', '28087608')
SELECT * FROM ActivityLogs WHERE CreatedAt > '2022-02-17 05:12:04.419' AND CreatedAt < '2022-02-17 05:12:04.861'
SELECT * FROM ActivityLogs WHERE CreatedAt >= '2022-02-17 05:12:04.419' AND CreatedAt <= '2022-02-17 05:12:04.861'

Columns


Name	Type	References	Description
Id [KEY]	String		The ID of the activity log event.
BoardId	String	Boards.id	The unique identifier of the board.
AccountId	String		The account ID that initiated the event.
UserId	String	Users.Id	The user ID of the user who initiated the event.
CreatedAt	Datetime		The time of the event.
Data	String		The item's column values in string form.
Entity	String		The entity of the event that was changed (pulse / board).
Event	String		The action that took place.
ColumnId	String		Column id to filter.
GroupId	String	Groups.Id	Group id to filter.
ItemId	String		Item id to filter.

Assets

Get a collection of assets by ids.

View-Specific Information

SELECT

Note: The Id filter is required to retrieve data from this table.

The Sync App uses the Monday API to process some of the filters. The Sync App processes other filters client-side within the Sync App. You can turn off the client-side execution of the query by setting SupportEnhancedSQL to false in which case any search criteria that refers to other columns will cause inconsistent data.

Id supports the '=','IN' comparison operators.

For example, the following queries are processed server side:

SELECT * FROM Assets WHERE Id = '397532775'
SELECT * FROM Assets WHERE Id IN ('397532775', '397532776')

Columns


Name	Type	References	Description
Id [KEY]	String		The file's unique identifier.
Name	String		The file's name.
CreatedAt	Datetime		The file's creation date.
FileExtension	String		The file's extension.
FileSize	Int		The file's size in bytes.
OriginalGeometry	String		The original geometry of the asset.
PublicUrl	String		The public url to the asset, valid for 1 hour.
UploadedById	String	Users.Id	The user's unique identifier.
Url	String		The url to view the asset.
UrlThumbnail	String		The url to view the asset in thumbnail mode. Only available for images.

BoardViews

Get a board's views.

View-Specific Information

SELECT

The Sync App uses the Monday API to process some of the filters. The Sync App processes other filters client-side within the Sync App. You can turn off the client-side execution of the query by setting SupportEnhancedSQL to false in which case any search criteria that refers to other columns will cause inconsistent data.

Id supports the '=','IN' comparison operators.
BoardId supports the '=','IN' comparison operators.
Type supports the '=' comparison operator.

For example, the following queries are processed server side:

SELECT * FROM BoardViews WHERE BoardId = '2182296646'
SELECT * FROM BoardViews WHERE Type = 'Chart'
SELECT * FROM BoardViews WHERE BoardId IN ('2182296646', '2181960030')

Columns


Name	Type	References	Description
Id [KEY]	String		The view's unique identifier.
BoardId	String	Boards.Id	The unique identifier of the board.
Name	String		The view's name.
Settings	String		The view's settings in a string form.
Type	String		The view's type.
ViewSpecificData	String		Specific board view data (supported only for forms).
SourceViewId	String		The view's template id if it was duplicated from another view.

Teams

Get a collection of teams.

View-Specific Information

SELECT

The Sync App uses the Monday API to process some of the filters. The Sync App processes other filters client-side within the Sync App. You can turn off the client-side execution of the query by setting SupportEnhancedSQL to false in which case any search criteria that refers to other columns will cause inconsistent data.

Id supports the '=','IN' comparison operators.

For example, the following queries are processed server side:

SELECT * FROM Teams WHERE Id = '565332'
SELECT * FROM Teams WHERE Id IN ('565332, 565333')

Columns


Name	Type	References	Description
Id [KEY]	String		The team's unique identifier.
Name	String		The team's name.
PictureUrl	String		The team's picture url.

Users

Get a collection of users.

View-Specific Information

SELECT

The Sync App uses the Monday API to process some of the filters. The Sync App processes other filters client-side within the Sync App. You can turn off the client-side execution of the query by setting SupportEnhancedSQL to false in which case any search criteria that refers to other columns will cause inconsistent data.

Id supports the '=','IN' comparison operators.
TeamsIds supports the '=','IN' comparison operators.
Email supports the '=','IN' comparison operators.
IsGuest supports the '=' comparison operator.
IsPending supports the '=' comparison operator.
NonActive supports the '=' comparison operator.

For example, the following queries are processed server side:

SELECT * FROM Users ORDER BY CreatedAt DESC
SELECT * FROM Users WHERE IsPending = true
SELECT * FROM Users WHERE IsGuest = true
SELECT * FROM Users WHERE ID = '27278379'
SELECT * FROM Users WHERE ID IN ('27278379', '27278377')
SELECT * FROM Users WHERE Email = '[email protected]'
SELECT * FROM Users WHERE Email IN ('[email protected]', '[email protected]')

Columns


Name	Type	References	Description
Id [KEY]	String		The user's unique identifier.
TeamsIds	String	Teams.Id	A list of teams unique identifiers to which the user belongs.
Name	String		The user's name.
Phone	String		The user's phone number.
Birthday	Date		The user's birthday.
CurrentLanguage	String		The current user's language.
CountryCode	String		The user's country code.
CreatedAt	Datetime		The user's creation date.
LastActivity	Datetime		Last date and time when user was active.
Email	String		The user's email.
Enabled	Bool		Whether or not the user is enabled.
IsAdmin	Bool		Whether or not the user is an account admin.
IsGuest	Bool		Whether or not the user is a guest.
IsPending	Bool		Whether or not the user is a pending user
IsVerified	Bool		Whether or not the user verified their email.
IsViewOnly	Bool		Whether or not the user is a view only user.
JoinDate	Date		The date the user joined the account.
Location	String		The user's location.
MobilePhone	String		The user's mobile phone number.
PhotoOriginal	String		The user's photo in the original size.
PhotoSmall	String		The user's photo in small size (150x150).
PhotoThumb	String		The user's photo in thumbnail size (100x100).
PhotoThumbSmall	String		The user's photo in small thumbnail size (50x50).
PhotoTiny	String		The user's photo in tiny size (30x30).
TimeZoneIdentifier	String		The user's timezone identifier.
Title	String		The user's title.
Url	String		The user's profile url.
UtcHoursDiff	Int		The user's utc hours difference.
SignUpProductKind	String		The product to which the user signed up to first.
AccountFirstDayOfTheWeek	String		The first day of the week for the account (sunday / monday)
AccountId	String		The account's unique identifier.
AccountLogo	String		The account's logo.
AccountName	String		The account's name.
AccountPlanMaxUsers	Int		The maximum users allowed in the plan.
AccountPlanPeriod	String		The plan's time period.
AccountPlanTier	String		The plan's tier.
AccountPlanVersion	Int		The plan's version.
AccountShowTimelineWeekends	Bool		Whether or not to show weekends in the timeline.
AccountSlug	String		The account's slug.
AccountTier	String		The account's tier.
AccountCountryCode	String		The account's country two-letter code in ISO3166 format.
AccountSignUpProductKind	String		The product the account signed up to first.
AccountProducts	String		The account's active products.
OutOfOfficeActive	Bool		Is the status active?
OutOfOfficeDisableNotifications	Bool		Are notification disabled?
OutOfOfficeStartDate	Date		The status start date.
OutOfOfficeEndDate	Date		The status end date.
OutOfOfficeType	String		Out of office type.
NonActive	Bool		Return non active users in the account.

AuditLog データモデル

Overview

This section shows the available API objects and provides more information on executing SQL to Monday APIs.

Key Features

The Sync App models Monday entities as relational views, allowing you to write SQL to query Monday data.
Stored procedures allow you to execute operations to Monday
Live connectivity to these objects means any changes to your account are reflected when using the Sync App.

Views

ビュー are tables that cannot be modified. Typically, model data that is read-only and cannot be updated are shown as views.

ビュー

ビューは、データを示すという点でテーブルに似ていますが、ビューは読み取り専用です。

クエリは、ビューに対して通常のテーブルと同様に実行することができます。

Monday Connector for CData Sync ビュー


Name	Description
AuditLogs	Get a board's audit log events.

AuditLogs

Get a board's audit log events.

Table Specific Information

SELECT

The Sync App uses the Monday API to process some of the filters. The Sync App processes other filters client-side within the Sync App. You can turn off the client-side execution of the query by setting SupportEnhancedSQL to false in which case any search criteria that refers to other columns will cause inconsistent data. For example, the following queries are processed server side.

Timestamp supports the '=, >, >=, <, <=' operators.
UserId supports the '=' operator.
IpAddress supports the '=' operator.
Event supports the '=, IN' operators.

All available values

export-board-activity-log:
export-account-data:
download-attachment:
export-board:
export-dashboard:
export-content-directory:
login:
forgot-password:
logout:
failed-login:
user-reactivated:
user-deactivated:
user-details-deleted:
user-invite:
cancel-user-invite:
user-role-change:
delete-board:
delete-workspace:
create-team:
delete-team:
security-settings-change:
board-broadcast-enabled:
add-user-to-team:
remove-user-from-team:
add-user-to-product:
remove-user-from-product:
add-team-to-product:
remove-team-from-product:
api-complexity-br for the event filter are listed and explained below: Logs board Activity Log export by users Logs account data export by admins Logs file downloads by users Logs board exports by users Logs dashboard exports by users Logs content directory exports by admins Logs users' logins to the system Logs users' "Forgot password?" clicks from the login page Logs users' logouts from the system Logs users' failed login attemts Logs users' reactivation by admins Logs users' deactivation by admins Logs users' deletion by admins Logs users' invite from within the system Logs cancelled users' invite from within the system Logs users' type change by admins Logs board deletion by users Logs workspace deletion by users Logs team creation by users Logs team deletion by users Logs security settings changes by admins Logs board broadcast enablement by users Logs users' addition to teams by users Logs users' removal from teams by users Logs users' addition to Work OS Products Logs users' removal from Work OS Products Logs teams' addition to Work OS Products Logs teams' removal from Work OS Products each-over-time: Logs api calls reaching the account limit

The following queries are executed server-side:

SELECT * FROM AuditLogs WHERE Timestamp >= '2022-01-01T07:30:00Z' AND Timestamp <= '2022-01-02T07:30:00Z'
SELECT * FROM AuditLogs WHERE Event IN ('export-board-activity-log', 'delete-board')
SELECT * FROM AuditLogs WHERE Timestamp >= '2022-01-01T07:30:00Z' AND Timestamp <= '2022-01-02T07:30:00Z' AND Event = 'delete-board' AND UserId = 27 AND IpAddress = '123.123'

Columns


Name	Type	References	Description
Timestamp	Datetime		The timestamp of the event
AccountId	String		The account ID that initiated the event.
UserId	Integer		The user ID of the user who initiated the event.
Event	String		The action that took place. 使用できる値は次のとおりです。export-board-activity-log, export-account-data, download-attachment, export-board, export-dashboard, export-content-directory, login, forgot-password, logout, failed-login, user-reactivated, user-deactivated, user-details-deleted, user-invite, cancel-user-invite, user-role-change, delete-board, delete-workspace, create-team, delete-team, security-settings-change, board-broadcast-enabled, add-user-to-team, remove-user-from-team, add-user-to-product, remove-user-from-product, add-team-to-product, remove-team-from-product, api-complexity-breach-over-time
Slug	String		The slug of the event that took place.
IpAddress	String		The IP Address recorded for this event.
UserAgent	String		The User Agent of the event.
ClientName	String		Name of the software client.
ClientVersion	String		Version of the software client.
OsName	String		Name of the operating system.
OsVersion	String		Version of the operating system.
DeviceName	String		The name of the device.
DeviceType	String		The type of the device.
ActivityMetadata	String		Additional activity metadata for the event

Workspace データモデル

Overview

This section shows the available API objects and provides more information on executing SQL to Monday APIs.

Key Features

The Sync App models Monday entities as tables, allowing you to write SQL to query and modify Monday data.
Stored procedures allow you to execute operations to Monday
Live connectivity to these objects means any changes to your account are reflected when using the Sync App.

Tables

テーブル are tables that can be modified.

Stored Procedures

ストアドプロシージャ are function-like interfaces to the data source.

テーブル

Sync App はMonday のデータを、標準のSQL ステートメントを使用してクエリできるリレーショナルデータベースのテーブルのリストとしてモデル化します。

Monday Connector for CData Sync テーブル


Name	Description
Board	An example board.
BoardSubitems	An example subitems board.

Board

An example board.

Table Specific Information

Note: This is an example board. Column names are retrieved dynamically from the API, and might be different from the examples provided.

SELECT

The Sync App uses the Monday API to process some of the filters. The Sync App processes other filters client-side within the Sync App. You can turn off the client-side execution of the query by setting SupportEnhancedSQL to false in which case any search criteria that refers to other columns will cause inconsistent data.

Note that multiple filters are supported server-side provided they are all connected with either only AND or only OR logical operators.

ItemId supports the '=', 'IN', operators.
Item supports the '=', 'IN', '!=', 'NOT IN', 'CONTAINS' operators.
Text supports the '=', 'IN', '!=', 'NOT IN', 'CONTAINS' operators.
Check supports the '=', '!=', 'IS TRUE', 'IS FALSE', 'IS NOT TRUE', 'IS NOT FALSE' operators.
BoardRelationDisplayValue supports the '=', '!=' operators when comparing with an empty string.
BoardRelationLinkedItemIds supports the '=', '!=' operators when comparing with an empty string.
TagsText supports the '=', '!=' operators when comparing with an empty string.
TagsIds supports the '=', '!=' operators when comparing with an empty string.
CountryCode supports the '=', 'IN', '!=', 'NOT IN', 'IS NULL', 'IS NOT NULL' operators.
CountryName supports the '=', 'CONTAINS', 'IS NULL', 'IS NOT NULL' operators.
DependentOnDisplayValue supports the '=', '!=' operators when comparing with a string containing only one pair of square brackets '[]'.
DependentOnLinkedItemsIds supports the '=', '!=' operators when comparing with an empty string.
EmailLabel supports the '=', 'IN', '!=', 'NOT IN', 'CONTAINS', 'IS NULL', 'IS NOT NULL' operators.
Hour supports the '=', 'IN', '!=', 'NOT IN' operators for time values between 04:00 inclusive and 23:59 inclusive, and the 'IS NULL', 'IS NOT NULL' operators.
DateValue supports the 'IS NULL', 'IS NOT NULL' operators.
TimelineFrom supports the 'IS NULL', 'IS NOT NULL' operators.
TimelineTo supports the 'IS NULL', 'IS NOT NULL' operators.
WeekStartDate supports the 'IS NULL', 'IS NOT NULL' operators.
WeekEndDate supports the 'IS NULL', 'IS NOT NULL' operators.
LinkUrlText supports the '=', 'IN', '!=', 'NOT IN', 'CONTAINS', 'IS NULL', 'IS NOT NULL' operators.
Numbers supports the '=', '!=', 'IN', 'NOT IN', '>', '>=', '<', '<=', 'IS NULL', 'IS NOT NULL' operators.
PeopleText supports the '=', '!=' operators when comparing with an empty string.
PeopleValue supports the 'IS NULL', 'IS NOT NULL' operators.
DropdownText supports the '=', '!=' operators when comparing with an empty string.
DropdownValue supports the 'IS NULL', 'IS NOT NULL' operators.
PhoneCountryShortName supports the '=', 'IN', '!=', 'NOT IN', 'IS NULL', 'IS NOT NULL' operators.
Phone supports the '=', 'CONTAINS', 'IS NULL', 'IS NOT NULL' operators.
Rating supports the '=', 'IN', '!=', 'NOT IN', 'IS NULL', 'IS NOT NULL' operators.
StatusIndex supports the '=', 'IN', '!=', 'NOT IN', 'IS NULL', 'IS NOT NULL' operators.
StatusLabel supports the '=', 'IN', '!=', 'NOT IN', 'IS NULL', 'IS NOT NULL' operators.
LastUpdated supports the '=', 'IN', '!=', 'NOT IN' operators.
TimeTrackingRunning supports the '=', '!=', 'IS TRUE', 'IS FALSE', 'IS NOT TRUE', 'IS NOT FALSE' operators.
VoteVoterIds supports the '=', '!=' operators when comparing with an empty string.

The following columns are sorted server-side when including an ORDER BY clause:

CreatedAt supports 'ASC NULLS FIRST', 'DESC NULLS LAST'.
UpdatedAt supports 'ASC NULLS FIRST', 'DESC NULLS LAST'.
Item supports 'ASC NULLS FIRST', 'DESC NULLS LAST'.
BoardRelationDisplayValue supports 'ASC NULLS FIRST', 'DESC NULLS LAST'.
Check supports 'ASC NULLS FIRST', 'DESC NULLS LAST'.
ColorPickerColor supports 'ASC NULLS FIRST', 'DESC NULLS LAST'.
CountryName supports 'ASC NULLS FIRST', 'DESC NULLS LAST'.
DependentOnDisplayValue supports 'ASC NULLS FIRST', 'DESC NULLS LAST'.
EmailLabel supports 'ASC NULLS FIRST', 'DESC NULLS LAST'.
Numbers supports 'ASC NULLS LAST', 'DESC NULLS FIRST'.
LinkUrlText supports 'ASC NULLS FIRST', 'DESC NULLS LAST'.
Phone supports 'ASC NULLS FIRST', 'DESC NULLS LAST'.
Rating supports 'ASC NULLS FIRST', 'DESC NULLS LAST'.
TimeTrackingDuration supports 'ASC NULLS FIRST', 'DESC NULLS LAST'.

The following queries are processed server side:

SELECT * FROM Board
SELECT * FROM Board WHERE ItemId = '5465844671'
SELECT * FROM Board WHERE ItemId IN ('5465844671','5465844679')
SELECT * FROM Board WHERE Item = 'Item 2'
SELECT * FROM Board WHERE Item != 'Item 2'
SELECT * FROM Board WHERE Item NOT IN ('Item 1','Item 2')
SELECT * FROM Board WHERE Item Contains 'Item'
SELECT * FROM Board WHERE CONTAINS(Item,'Item')
SELECT * FROM Board WHERE NOT CONTAINS(Item,'Item')
SELECT * FROM Board WHERE Check = True
SELECT * FROM Board WHERE Check != True
SELECT * FROM Board WHERE Check IS TRUE
SELECT * FROM Board WHERE Check IS NOT TRUE
SELECT * FROM Board WHERE Check = False
SELECT * FROM Board WHERE Check != False
SELECT * FROM Board WHERE Check IS FALSE
SELECT * FROM Board WHERE Check IS NOT FALSE
SELECT * FROM Board WHERE BoardRelationLinkedItemIds = ''
SELECT * FROM Board WHERE BoardRelationLinkedItemIds != ''
SELECT * FROM Board WHERE BoardRelationDisplayValue = ''
SELECT * FROM Board WHERE BoardRelationDisplayValue != ''
SELECT * FROM Board WHERE CountryCode = 'US'
SELECT * FROM Board WHERE CountryCode != 'US'
SELECT * FROM Board WHERE CountryCode IN ('US','UK')
SELECT * FROM Board WHERE CountryCode NOT IN ('US','UK')
SELECT * FROM Board WHERE CountryCode IS NULL
SELECT * FROM Board WHERE CountryCode IS NOT NULL
SELECT * FROM Board WHERE DependentOnDisplayValue = '[]'
SELECT * FROM Board WHERE DependentOnDisplayValue != '[]'
SELECT * FROM Board WHERE Hour='07:32:00'
SELECT * FROM Board WHERE Numbers IN (12, 55)
SELECT * FROM Board WHERE Numbers = 10
SELECT * FROM Board WHERE Numbers != 10
SELECT * FROM Board WHERE Numbers > 10
SELECT * FROM Board WHERE Numbers >= 10
SELECT * FROM Board WHERE Numbers < 10
SELECT * FROM Board WHERE Numbers <= 10
SELECT * FROM Board WHERE Text='test' AND Numbers=10
SELECT * FROM Board WHERE Text='test' OR Numbers=10
SELECT * FROM Board ORDER BY Item
SELECT * FROM Board ORDER BY CreatedAt
SELECT * FROM Board ORDER BY UpdatedAt
SELECT * FROM Board ORDER BY Numbers ASC NULLS LAST

INSERT

INSERT statements are mapped to the 'create_item' GraphQL mutation.

The following inputs can be used in INSERT statements:

GroupId, ItemName, CreateLabelsIfMissing, BoardId, BoardRelationLinkedItemIds, Checkbox, CountryCode, CountryName, DateDate, DateDatetime, DependencyLinkedItemsIds, DropdownText, DropdownValue, Email, EmailLabel, Hour, LinkUrl, LinkUrlText, LocationLat, LocationLng, LocationAddress, LongText, Numbers, PeopleValue, PhoneCountryShortName, Phone, Rating, StatusIndex, StatusLabel, TagsIds, Text, TimelineFrom, TimelineTo, WeekStartDate, WeekEndDate, WorldClock

INSERT INTO Board (Item,GroupId,Check) VALUES ('Test','topics',true)
INSERT INTO Board (Item,GroupId,CountryCode,CountryName) VALUES ('Test','topics','US','United States')
INSERT INTO Board (Item,GroupId,Date) VALUES ('Test','topics','2023-11-16')
INSERT INTO Board (Item,GroupId,Datetime) VALUES ('Test','topics','2023-11-16 09:00:00.0-05:00')
INSERT INTO Board (Item,GroupId,DependentLinkedItemsIds) VALUES ('Test','topics','[5561036960, 5561037791]')
INSERT INTO Board (Item,GroupId,DropdownText) VALUES ('Test','topics','label1,label2')
INSERT INTO Board (Item,GroupId,DropdownText,CreateLabelsIfMissing) VALUES ('Test','topics','label3,label4','true')
INSERT INTO Board (Item,GroupId,DropdownValue) VALUES ('Test','topics','{"ids":[1,2]}')
INSERT INTO Board (Item,GroupId,Email,EmailLabel) VALUES ('Test','topics','[email protected]','Mail')
INSERT INTO Board (Item,GroupId,Hour) VALUES ('Test','topics','09:00:00')
INSERT INTO Board (Item,GroupId,LinkUrl,LinkUrlText) VALUES ('Test','topics','https://www.test.com/', 'TestLink')
INSERT INTO Board (Item,GroupId,LocationLat,LocationLng,LocationAddress) VALUES ('Test','topics',29.9772962,31.1324955,'Giza Pyramid Complex')
INSERT INTO Board (Item,GroupId,LongText) VALUES ('Test','topics','TestText')
INSERT INTO Board (Item,GroupId,Numbers) VALUES ('Test','topics','-10')
INSERT INTO Board (Item,GroupId,PeopleValue) VALUES ('Test','topics','{"personsAndTeams":[{"id":51688059,"kind":"person"},{"id":51085546,"kind":"person"}]}')
INSERT INTO Board (Item,GroupId,PhoneCountryShortName,Phone) VALUES ('Test','topics','US','12345678900')
INSERT INTO Board (Item,GroupId,Rating) VALUES ('Test','topics','5')
INSERT INTO Board (Item,GroupId,StatusIndex) VALUES ('Test','topics','2')
INSERT INTO Board (Item,GroupId,StatusIndex,StatusLabel,CreateLabelsIfMissing) VALUES ('Test','topics','15','NewLabel','true')
INSERT INTO Board (Item,GroupId,StatusLabel) VALUES ('Test','topics','Working on it')
INSERT INTO Board (Item,GroupId,TagsIds) VALUES ('Test','topics','[20826704,20826705]')
INSERT INTO Board (Item,GroupId,BoardLinkedItemIds) VALUES ('Test','topics','[5561037791,5561036960]')
INSERT INTO Board (Item,GroupId,Text) VALUES ('Test','topics','TestText')
INSERT INTO Board (Item,GroupId,TimelineFrom,TimelineTo) VALUES ('Test','topics','2023-11-01','2023-12-04')
INSERT INTO Board (Item,GroupId,WeekStartDate,WeekEndDate) VALUES ('Test','topics','2023-11-05','2023-11-11')
INSERT INTO Board (Item,GroupId,World_Clock) VALUES ('Test','topics','Africa/Algiers')

UPDATE

UPDATE statements are mapped to the 'change_multiple_column_values','move_item_to_group', and 'archive_item' GraphQL mutations.

The following inputs can be used in UPDATE statements:

ItemId, CreateLabelsIfMissing, BoardId, BoardRelationLinkedItemIds, Checkbox, CountryCode, CountryName, DateDate, DateDatetime, DependencyLinkedItemsIds, DropdownText, DropdownValue, Email, EmailLabel, Hour, LinkUrl, LinkUrlText, LocationLat, LocationLng, LocationAddress, LongText, Numbers, PeopleValue, PhoneCountryShortName, Phone, Rating, StatusIndex, StatusLabel, TagsIds, Text, TimelineFrom, TimelineTo, WeekStartDate, WeekEndDate, WorldClock, GroupId, State

Note that GroupId, State and column values cannot be updated in the same statement.

Also note that certain types require specifying all related columns to update the object's value (this includes Email, Link, Location, Phone, Timeline, Week).

UPDATE Board SET GroupId='new_group' WHERE ItemId='5562458608'
UPDATE Board SET State='archived' WHERE ItemId='5562458608'
UPDATE Board SET Check = false WHERE ItemId='5561890829'
UPDATE Board SET CountryCode='US',CountryName='United States' WHERE ItemId='5561890829'
UPDATE Board SET CountryCode=NULL,CountryName=NULL WHERE ItemId='5561890829'
UPDATE Board SET Date='2023-11-25' WHERE ItemId='5561890829'
UPDATE Board SET Date=NULL WHERE ItemId='5561890829'
UPDATE Board SET Datetime='2023-11-23 04:00:00.0' WHERE ItemId='5561890829'
UPDATE Board SET DependentLinkedItemsIds='[5562459384, 5562458774]' WHERE ItemId='5561890829'
UPDATE Board SET DependentLinkedItemsIds=NULL WHERE ItemId='5561890829'
UPDATE Board SET DropdownText='Label1,Label2' WHERE ItemId='5561890829'
UPDATE Board SET DropdownText='Label6,Label7',CreateLabelsIfMissing='true' WHERE ItemId='5561890829'
UPDATE Board SET DropdownValue='{"ids":[2,3]}' WHERE ItemId='5561890829'
UPDATE Board SET DropdownValue=NULL WHERE ItemId='5561890829'
UPDATE Board SET Email='[email protected]',EmailLabel='NewMail' WHERE ItemId='5561890829'
UPDATE Board SET Email=NULL,EmailLabel=NULL WHERE ItemId='5561890829'
UPDATE Board SET Hour='21:00:00' WHERE ItemId='5561890829'
UPDATE Board SET Hour=NULL WHERE ItemId='5561890829'
UPDATE Board SET LinkUrl='https://www.test.com',LinkUrlText='TestText' WHERE ItemId='5561890829'
UPDATE Board SET LinkUrl=NULL,LinkUrlText=NULL WHERE ItemId='5561890829'
UPDATE Board SET LocationAddress=NULL,LocationLat=NULL,LocationLng=NULL WHERE ItemId='5561890829'
UPDATE Board SET LocationLat='82',LocationLng='135',LocationAddress='TestLocation' WHERE ItemId='5561890829'
UPDATE Board SET LongText='changed text' WHERE ItemId='5561890829'
UPDATE Board SET LongText=NULL WHERE ItemId='5561890829'
UPDATE Board SET Numbers=10 WHERE ItemId='5561890829'
UPDATE Board SET Numbers=NULL WHERE ItemId='5561890829'
UPDATE Board SET PeopleValue='{"personsAndTeams":[{"id":51085546,"kind":"person"},{"id":961021,"kind":"team"}]}' WHERE ItemId='5561890829'
UPDATE Board SET PeopleValue=NULL WHERE ItemId='5561890829'
UPDATE Board SET Phone=NULL,PhoneCountryShortName=NULL WHERE ItemId='5561890829'
UPDATE Board SET PhoneCountryShortName='US',Phone='16102347959' WHERE ItemId='5561890829'
UPDATE Board SET Rating='1' WHERE ItemId='5561890829'
UPDATE Board SET Rating=NULL WHERE ItemId='5561890829'
UPDATE Board SET StatusIndex='2' WHERE ItemId='5561890829'
UPDATE Board SET StatusIndex=NULL WHERE ItemId='5561890829'
UPDATE Board SET StatusLabel='NewLabel',StatusIndex='159',CreateLabelsIfMissing='true' WHERE ItemId='5561890829'
UPDATE Board SET StatusLabel='Working on it' WHERE ItemId='5561890829'
UPDATE Board SET TagsIds='[20826705,20833783]' WHERE ItemId='5561890829'
UPDATE Board SET TagsIds=NULL WHERE ItemId='5561890829'
UPDATE Board SET BoardLinkedItemIds = NULL WHERE ItemId='5561890829'
UPDATE Board SET BoardLinkedItemIds='[5562459384, 5561890829, 5562458774]' WHERE ItemId='5561890829'
UPDATE Board SET Text='changedText' WHERE ItemId='5561890829'
UPDATE Board SET Text=NULL WHERE ItemId='5561890829'
UPDATE Board SET TimelineFrom='2023-01-01', TimelineTo='2023-10-10' WHERE ItemId='5561890829'
UPDATE Board SET TimelineFrom=NULL, TimelineTo=NULL WHERE ItemId='5561890829'
UPDATE Board SET WeekStartDate='2023-11-13', WeekEndDate='2023-11-19' WHERE ItemId='5561890829'
UPDATE Board SET WeekStartDate=NULL, WeekEndDate=NULL WHERE ItemId='5561890829'
UPDATE Board SET WorldClock='America/New York' WHERE ItemId='5561890829'
UPDATE Board SET WorldClock=NULL WHERE ItemId='5561890829'

DELETE

DELETE statements are mapped to the 'delete_item' GraphQL mutation.

You can delete items by specifying the ItemId.

DELETE FROM Board WHERE ItemId='5561890829'

Columns


Name	Type	ReadOnly	References	Description
ItemId [KEY]	String	False		The item's unique identifier.
CreatorId	String	False		The item's creator unique identifier.
CreatedAt	Datetime	False		The item's create date.
UpdatedAt	Datetime	False		The item's last updated date.
State	String	False		The item's state (all, active, archived, deleted).
RelativeLink	String	False		The item's relative path.
ItemEmail	String	False		The item's email.
AssetsIds	String	False		A comma separated list of the items' assets/files unique identifiers.
GroupId	String	False		The title of the group that contains this item.
GroupTitle	String	False		The title of the group that contains this item.
Item	String	False		The item's name.
BoardRelationDisplayValue	String	False		A string representing all the names of the linked items, separated by commas.
BoardRelationLinkedItemIds	String	False		The linked item IDs.
ButtonLabel	String	False		The button's label.
ButtonColor	String	False		The button's color in hex value.
ButtonValue	String	False		The column's value in json format.
Check	Bool	False		The column's boolean value.
ColorPickerColor	String	False		The color in hex value.
ColorPickerValue	String	False		The column's value in json format.
CountryCode	String	False		The country's two-letter code.
CountryName	String	False		The country's name.
DateIcon	String	False		The string representation of selected icon.
Date	Date	False		The column's date value.
Datetime	Datetime	False		The column's datetime value.
DependencyDisplayValue	String	False		Choose the item your task will be dependent on. If the “dependent on” item’s date is changing, the other dates will adjust automatically A string representing all the names of the linked items, separated by commas.
DependencyLinkedItemsIds	String	False		Choose the item your task will be dependent on. If the “dependent on” item’s date is changing, the other dates will adjust automatically The linked items ids.
DocFileId	String	False		The file's unique identifier.
DocFileCreatorId	String	False		The ID of user who created the file.
DocFileObjectId	String	False		The associated board or object's unique identifier.
DocFileUrl	String	False		The file's url.
DropdownText	String	False		The column's textual value in string form.
DropdownValue	String	False		The column's value in json format.
Email	String	False		The column's email value.
EmailLabel	String	False		The column's text value. It can be the same as email when user didn't enter any text.
FileText	String	False		The column's textual value in string form.
FileValue	String	False		The column's value in json format.
Hour	Time	False		The column's time value.
IntegrationIssueId	String	False		ID of the issue.
IntegrationEntityId	String	False		ID of the entity.
IntegrationIssueApiUrl	String	False		URL of the issue.
IntegrationValue	String	False		The column's value in json format.
LastUpdated	String	False		ID of the user who updated the item.
LinkUrl	String	False		Url.
LinkUrlText	String	False		Url text.
LocationLat	Double	False		Latitude.
LocationLng	Double	False		Longitude.
LocationPlaceId	String	False		Place ID of the location.
LocationAddress	String	False		Address.
LocationCity	String	False		City.
LocationCityShort	String	False		City.
LocationCountry	String	False		Country.
LocationCountryShort	String	False		Country short name (e.g. PE for Peru).
LocationStreet	String	False		Street.
LocationStreetNumber	String	False		Number of building in the street.
LocationStreetNumberShort	String	False		Short number of building in the street.
LocationStreetShort	String	False		Street.
LongText	String	False		Long text.
MirrorDisplayValue	String	False		The display value of the mirrored items' column.
MirroredItems	String	False		The mirrored items.
Numbers	Double	False		Number.
PeopleText	String	False		The column's textual value in string form.
PeopleValue	String	False		The column's value in json format.
PhoneCountryShortName	String	False		ISO-2 country code.
Phone	String	False		Phone number.
Rating	Int	False		Rating value.
StatusIndex	Int	False		The index of the status in the board.
StatusIsDone	Bool	False		Whether the status is done.
StatusLabel	String	False		The label of the status.
StatusUpdateId	String	False		The ID of an update attached to the status.
StatusLabelStyleColor	String	False		The style of the status label. The label's color in hex format.
StatusLabelStyleBorder	String	False		The style of the status label. The label's border color in hex format.
TagsText	String	False		The column's textual value in string form.
TagsIds	String	False		Tag IDs.
Text	String	False		The column's textual value in string form.
TimeTrackingRunning	Bool	False		Whether the time tracker is running.
TimeTrackingStartedAt	Datetime	False		The date when the time tracker was started.
TimeTrackingDuration	Int	False		Total duration of the time tracker in seconds.
TimelineFrom	Date	False		The start date of the timeline.
TimelineTo	Date	False		The end date of the timeline.
TimelineVisualizationType	String	False		The visualization type for the timeline.
VoteCount	Int	False		The total number of votes.
VoterIds	String	False		A list of IDs of users who voted.
WeekStartDate	Date	False		The start date of the week.
WeekEndDate	Date	False		The end date of the week.
WorldClock	String	False		Timezone.

Pseudo-Columns

SELECT ステートメントのWHERE 句では、疑似カラムフィールドを使用して、データソースから返されるタプルを詳細に制御することができます。


Name	Type	Description
CreateLabelsIfMissing	Bool	Create Status/Dropdown labels if they're missing. Requires permission to change board structure.

BoardSubitems

An example subitems board.

Table Specific Information

The Sync App uses the Monday API to process some of the filters. The Sync App processes other filters client-side within the Sync App. You can turn off the client-side execution of the query by setting SupportEnhancedSQL to false in which case any search criteria that refers to other columns will cause inconsistent data.

SELECT

Note: 'Subitems'-type tables support the same server-side filters and CUD operations as the main board.

SELECT C.ItemId AS ChildId, C.Subitem AS ChildName, P.ItemId AS ParentId, P.Item AS ParentName FROM BoardSubitems C INNER JOIN Board P ON C.ParentItemId=P.ItemId

INSERT

INSERT statements are mapped to the 'create_subitem' GraphQL mutation.

The following inputs can be used in INSERT statements:

ParentItemId, GroupId, ItemName, CreateLabelsIfMissing, BoardId, BoardRelationLinkedItemIds, Checkbox, CountryCode, CountryName, DateDate, DateDatetime, DependencyLinkedItemsIds, DropdownText, DropdownValue, Email, EmailLabel, Hour, LinkUrl, LinkUrlText, LocationLat, LocationLng, LocationAddress, LongText, Numbers, PeopleValue, PhoneCountryShortName, Phone, Rating, StatusIndex, StatusLabel, TagsIds, Text, TimelineFrom, TimelineTo, WeekStartDate, WeekEndDate, WorldClock

INSERT INTO BoardSubitems (ParentItemId, Subitem) VALUES ('5562458608','NewSubItem')

UPDATE

UPDATE statements are mapped to the 'change_multiple_column_values' GraphQL mutation.

The following inputs can be used in UPDATE statements:

ItemId, CreateLabelsIfMissing, BoardId, BoardRelationLinkedItemIds, Checkbox, CountryCode, CountryName, DateDate, DateDatetime, DependencyLinkedItemsIds, DropdownText, DropdownValue, Email, EmailLabel, Hour, LinkUrl, LinkUrlText, LocationLat, LocationLng, LocationAddress, LongText, Numbers, PeopleValue, PhoneCountryShortName, Phone, Rating, StatusIndex, StatusLabel, TagsIds, Text, TimelineFrom, TimelineTo, WeekStartDate, WeekEndDate, WorldClock

UPDATE BoardSubitems SET WorldClock='Europe/Amsterdam' WHERE ItemId='5573109452'

DELETE

DELETE statements are mapped to the 'delete_item' GraphQL mutation.

You can delete entries by specifying the ItemId.

Columns


Name	Type	ReadOnly	References	Description
ItemId [KEY]	String	False		The item's unique identifier.
ParentItemId	String	False		The item's parent unique identifier.
CreatorId	String	False		The item's creator unique identifier.
CreatedAt	Datetime	False		The item's create date.
UpdatedAt	Datetime	False		The item's last updated date.
State	String	False		The item's state (all, active, archived, deleted).
RelativeLink	String	False		The item's relative path.
ItemEmail	String	False		The item's email.
AssetsIds	String	False		A comma separated list of the items' assets/files unique identifiers.
GroupId	String	False		The title of the group that contains this item.
GroupTitle	String	False		The title of the group that contains this item.
Subitem	String	False		The item's name.
OwnerText	String	False		The column's textual value in string form.
OwnerValue	String	False		The column's value in json format.
StatusIndex	Int	False		The index of the status in the board.
StatusIsDone	Bool	False		Whether the status is done.
StatusLabel	String	False		The label of the status.
StatusUpdateId	String	False		The ID of an update attached to the status.
StatusLabelStyleColor	String	False		The style of the status label. The label's color in hex format.
StatusLabelStyleBorder	String	False		The style of the status label. The label's border color in hex format.
DateIcon	String	False		The string representation of selected icon.
Date	Date	False		The column's date value.
Datetime	Datetime	False		The column's datetime value.

Pseudo-Columns

SELECT ステートメントのWHERE 句では、疑似カラムフィールドを使用して、データソースから返されるタプルを詳細に制御することができます。


Name	Type	Description
CreateLabelsIfMissing	Bool	Create Status/Dropdown labels if they're missing. Requires permission to change board structure.

接続文字列オプション

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

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

Authentication

プロパティ	説明
Schema	Specifies which Monday schema to use.
AuthScheme	The type of authentication to use when connecting to Monday.
APIToken	The API token obtained from your Monday account.
Domain	Specify the domain of your Monday account. Necessary only for the AuditLog API tables. Example: https://yourdomain.monday.com

OAuth

プロパティ	説明
OAuthClientId	OAuth 認証サーバーを使用してアプリケーションを登録する場合に割り当てられたクライアントId。
OAuthClientSecret	OAuth 認証サーバーにアプリケーションを登録する場合に割り当てられたクライアントシークレット。

SSL

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

Firewall

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

Proxy

プロパティ	説明
ProxyAutoDetect	これは、システムプロキシ設定を使用するかどうかを示します。
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

プロパティ	説明
MaxPointsPerCall	Specifies how many points a call will cost.
MaxRows	クエリで集計またはGROUP BY を使用しない場合に返される行数を制限します。これはLIMIT 句よりも優先されます。
Other	これらの隠しプロパティは特定のユースケースでのみ使用されます。
PseudoColumns	このプロパティは、テーブルのカラムとして疑似カラムが含まれているかどうかを示します。
Timeout	タイムアウトエラーがスローされ、処理をキャンセルするまでの秒数。
UserDefinedViews	カスタムビューを含むJSON コンフィギュレーションファイルを指すファイルパス。

Authentication

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

プロパティ	説明
Schema	Specifies which Monday schema to use.
AuthScheme	The type of authentication to use when connecting to Monday.
APIToken	The API token obtained from your Monday account.
Domain	Specify the domain of your Monday account. Necessary only for the AuditLog API tables. Example: https://yourdomain.monday.com

Schema

Specifies which Monday schema to use.

解説

Possible values include 'Information' for general views with information on your account, 'AuditLog' for the Audit Log API, and values corresponding to dynamically generated schemas based on the workspaces in your account.

AuthScheme

The type of authentication to use when connecting to Monday.

解説

Token: Set this to perform Monday token authentication when connecting to the Monday GraphQL API with a personal access token or the AuditLog API with an audit log API token.
OAuth: Set this to perform Monday OAuth authentication when connecting to the Monday GraphQL API.

APIToken

The API token obtained from your Monday account.

解説

Admin Tab

If you are an admin user on your monday.com account, you are able to access your API tokens from the "Admin" tab with the following steps:

Log into your monday.com account.
Click on your avatar (picture icon) in the bottom left corner of your screen.
Select Admin from the resulting menu (this requires you to have admin permissions).
Go to the API section.
Generate a "API v2 Token"
Copy your token.

Developer Tab

If you are a member user on your monday.com account, you are able to access your API tokens from the Developer tab with the following steps:

Log into your monday.com account.
Click on your avatar (picture icon) in the bottom left corner of your screen.
Select Developer from the resulting menu.
In the top menu, click on the "Developer" dropdown menu.
Select the first option on the dropdown menu titled "My Access Tokens."
Click on the blue "Show" button to expose your API token and copy it.

Domain

Specify the domain of your Monday account. Necessary only for the AuditLog API tables. Example: https://yourdomain.monday.com

解説

Specify the domain of your Monday account. Necessary only for the AuditLog API tables. Example: https://yourdomain.monday.com

OAuth

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

プロパティ	説明
OAuthClientId	OAuth 認証サーバーを使用してアプリケーションを登録する場合に割り当てられたクライアントId。
OAuthClientSecret	OAuth 認証サーバーにアプリケーションを登録する場合に割り当てられたクライアントシークレット。

OAuthClientId

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

解説

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

OAuthClientSecret

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

解説

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

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 はMonday への接続を開き、プロキシを経由して通信が行われます。
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	これは、システムプロキシ設定を使用するかどうかを示します。
ProxyServer	HTTP トラフィックをルートするためのプロキシのホストネームもしくはIP アドレス。
ProxyPort	ProxyServer プロキシが起動しているTCP ポート。
ProxyAuthScheme	ProxyServer プロキシへの認証で使われる認証タイプ。
ProxyUser	ProxyServer プロキシへの認証に使われるユーザー名。
ProxyPassword	ProxyServer プロキシへの認証に使われるパスワード。
ProxySSLType	ProxyServer プロキシへの接続時に使用するSSL タイプ。
ProxyExceptions	ProxyServer 経由での接続が免除される宛先ホスト名またはIP のセミコロン区切りのリスト。

ProxyAutoDetect

これは、システムプロキシ設定を使用するかどうかを示します。

解説

これは他のプロキシ設定よりも優先されるため、カスタムプロキシ設定を使用するには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 もしくはKerberos トークンを取得します。
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\\Monday Data Provider\\Schema" となり、%APPDATA% はユーザーのコンフィギュレーションディレクトリに設定されます：


Platform	%APPDATA%
Windows	APPDATA 環境変数の値
Linux	~/.config

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 プロパティの全リストを提供します。

プロパティ	説明
MaxPointsPerCall	Specifies how many points a call will cost.
MaxRows	クエリで集計またはGROUP BY を使用しない場合に返される行数を制限します。これはLIMIT 句よりも優先されます。
Other	これらの隠しプロパティは特定のユースケースでのみ使用されます。
PseudoColumns	このプロパティは、テーブルのカラムとして疑似カラムが含まれているかどうかを示します。
Timeout	タイムアウトエラーがスローされ、処理をキャンセルするまでの秒数。
UserDefinedViews	カスタムビューを含むJSON コンフィギュレーションファイルを指すファイルパス。

MaxPointsPerCall

Specifies how many points a call will cost.

解説

The total cost of a single query cannot exceed 5,000,000 points at any given time. Trial and free accounts using personal API tokens cannot exceed 1,000,000 points per minute.

MaxRows

クエリで集計またはGROUP BY を使用しない場合に返される行数を制限します。これはLIMIT 句よりも優先されます。

解説

クエリで集計またはGROUP BY を使用しない場合に返される行数を制限します。これはLIMIT 句よりも優先されます。

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 Invoices WHERE MyColumn = 'value'"
	},
	"MyView2": {
		"query": "SELECT * FROM MyTable WHERE Id IN (1,2,3)"
	}
}

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

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

指定されたパスは引用符で囲まれていないことに注意してください。

Monday Connector for CData Sync

Monday Connector for CData Sync

概要

Monday バージョンサポート

接続の確立

Monday への接続を追加

Monday への接続

Monday AuditLog API

Monday GraphQL API

API トークン

OAuth

高度な機能

ユーザー定義ビュー

SSL の設定

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

クエリ処理

ログ

SSL の設定

SSL 設定のカスタマイズ

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

Firewall またはProxy 経由の接続

HTTP プロキシ

その他のプロキシ

データモデル

Information の使用

AuditLog の使用

Workspace の使用

Information データモデル

Overview

Key Features

Tables

Views

Stored Procedures

テーブル

Monday Connector for CData Sync テーブル

Boards

View-Specific Information

SELECT

INSERT

UPDATE

DELETE

Columns

Pseudo-Columns

BoardTeams

View-Specific Information

SELECT

INSERT

DELETE

Columns

BoardUsers

View-Specific Information

SELECT

INSERT

DELETE

Columns

DocBlocks

View-Specific Information

SELECT

INSERT

UPDATE

DELETE

Columns

Pseudo-Columns

Docs

View-Specific Information

SELECT

INSERT

Columns

Folders

View-Specific Information

SELECT

INSERT

UPDATE

DELETE

Columns

Groups

View-Specific Information

SELECT

INSERT

UPDATE