接続の確立

SurveyMonkey への接続を追加

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

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

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

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

SurveyMonkey への接続

SurveyMonkey は、アンケートデータに接続する2つの方法を提供します。

Basic 認証を使用するには、プライベートアプリケーションを登録して個人用アクセストークンを取得します。
OAuth で接続するには、SurveyMonkey に付属している埋め込みOAuth 認証情報を使用するか、カスタムOAuth アプリケーションを作成します。詳しくは、以下のOAuth 認証を参照してください。

SurveyMonkey への認証

Basic 認証

Basic 認証を使用するには、プライベートアプリケーションを登録して個人用アクセストークンを取得する必要があります。

個人用アクセストークンを取得したら、以下のプロパティを設定します。

AuthScheme = AccessToken
AccessToken = アプリケーション設定で生成されたAccessToken を入力。

OAuth 認証

SurveyMonkey は埋め込みOAuth 認証情報を提供しており、デスクトップアプリケーションからの接続を簡単にします。Web アプリケーションから接続するには、カスタムOAuth アプリケーションの作成で説明するようにカスタムOAuth アプリケーションを作成する必要があります。

すべての認証フローで、OAuth 経由で接続するにはAuthScheme をOAuth に設定する必要があります。（これは、接続に埋め込みOAuth 認証情報を使用するか、カスタムOAuth アプリケーションを作成するかに関係なく適用されます。）

以下のサブセクションでは、利用可能なOAuth フローでのSurveyMonkey への認証について詳しく説明します。カスタムOAuth アプリケーションの作成についての情報と、すでに埋め込みOAuth 認証情報を持つ認証フローでもカスタムOAuth アプリケーションを作成したほうがよい場合の説明については、カスタムOAuth アプリケーションの作成を参照してください。

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

SurveyMonkey のアンケートからの選択

The Sync App offers the possibility to select surveys as relational tables.

Creating Surveys

You can create your own Surveys by performing the following steps:

In SurveyMonkey, go to the home page and click "Create Survey" on the vertical navigation bar.
Either start a new survey from scratch or pick one of the many templates SurveyMonkey offers.
Design and create new questions for your survey.
When finished, pick one of the options to share your survey and start receiving data from it.

Selecting Responses from Your Survey

To access the responses to your surveys, append _Responses to your table name, MySurvey_Responses in the query below.

SELECT RespondentId, QuestionText, ChoiceId, ChoiceText, ChoiceWeight FROM MySurvey_Responses

Selecting Questions from Your Survey

To access your survey questions, append _Questions to your table name, MySurvey_Questions in the query below.

SELECT QuestionId, QuestionFamily, QuestionSubtype, QuestionText, AnswerText FROM MySurvey_Questions

高度な機能

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

ユーザー定義ビュー

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

SSL の設定

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

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

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

クエリ処理

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

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

ログ

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

SSL の設定

SSL 設定のカスタマイズ

デフォルトでは、Sync App はサーバーとのTLS のネゴシエーションを試みます。サーバー証明書は、デフォルトのシステム信頼済み証明書ストアで検証されます。SSLServerCert 接続プロパティを使用して、証明書の検証方法をオーバーライドできます。

別の証明書を指定するには、SSLServerCert 接続プロパティを参照してください。

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

Firewall またはProxy 経由の接続

HTTP プロキシ

HTTP プロキシへの認証には、以下のように設定します。

ProxyServer：HTTP トラフィックをルートするプロキシサーバーのホストネームもしくはIP アドレス。
ProxyPort：プロキシサーバーが起動しているTCP ポート。
ProxyAuthScheme：プロキシサーバーに対して認証する際にSync App が使用する認証方法。
ProxyUser：プロキシサーバーに登録されているユーザーアカウントのユーザー名。
ProxyPassword：ProxyUser に紐付けられたパスワード。

その他のプロキシ

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

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

データモデル

アカウント内の任意のアンケートや関連データにアクセスできます。CData Sync App は、SurveyMonkey API のエンティティをテーブル、ビュー、およびストアドプロシージャにモデル化します。

これらはスキーマファイルにて定義されます。スキーマファイルは、スキーマを簡単に拡張できるシンプルな形式のコンフィギュレーションファイルです。

クエリ処理の使用

Sync App は、SurveyMonkey API にできるだけ多くのSELECT 構文処理をオフロードし、残りのクエリをSync App 内で処理します。このセクションでは、API の制限および要件について説明します。

フィルタリングの制限

ほとんどのビューは、データを取得するために少なくとも1つのフィルタ条件を必要とします。このようなビューにクエリを実行する場合、OR 演算子は以下の条件下でのみサポートされます。 1.他のAND 演算子とは組み合わせられません。 2.OR 演算子の両側（左側と右側）は同じフィールドを使用し、比較には等号（=）を使用します。フィルタ条件を必要としないビューの場合、OR 条件はクライアント側で評価されます。

ビュー

Sync App は、アンケートおよび分析をリレーショナルビューとしてモデル化します。ビューは、一般的には読み取り専用のテーブルです。

ストアドプロシージャ

ストアドプロシージャは、データソースのファンクションライクなインターフェースです。これらを使用して、データソース内の情報を検索、更新、および変更できます。

テーブル

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

SurveyMonkey Connector for CData Sync テーブル


Name	Description
CollectorDetails	Displays detailed collector information.
CollectorMessageDetails	Displays detailed information regarding messages sent from a collector.
CollectorRecipientDetails	Displays detailed information regarding recipients of all or specific messages sent from a collector.
Collectors	Displays collector information.
SurveyDetails	Displays detailed information regarding surveys.
Surveys	Displays information regarding surveys.

CollectorDetails

Displays detailed collector information.

Columns


Name	Type	ReadOnly	Description
Id [KEY]	String	False	The Id of the collector.
SurveyId	String	False	The Id of the survey this collector belongs to.
Name	String	False	The name of the collector.
Status	String	False	The collector status. Possible values are 'open' or 'closed'.
Type	String	False	The collector type. Possible values are 'sms', 'weblink', or 'email'.
ThankYouPageIsEnabled	Boolean	False	Specifies whether to use the custom thank you message.
ThankYouPageMessage	String	False	The custom message for the thank you page, regardless of whether a custom thank you message is enabled. The default value is 'Thank you for completing our survey!'.
ThankYouMessage	String	False	The message for thank you page.
DisqualificationMessage	String	False	The message for disqualification page.
DisqualificationUrl	String	False	The redirect URL when the respondent is disqualified.
CloseDate	Datetime	False	The close date of the collector.
ClosedPageMessage	String	False	The message shown when someone visits a closed survey.
RedirectUrl	String	False	The redirect URL when a respondent completes the survey.
DisplaySurveyResults	Boolean	False	Shows respondents survey instant results when they complete the survey.
EditResponseType	String	False	When respondents can edit their response. 'until_complete', 'never', or 'always'.
AnonymousType	String	False	Turns off IP tracking. For email collectors, it also removes the respondent email address and name from the response. Possible values are 'not_anonymous', 'partially_anonymous', or 'fully_anonymous'.
AllowMultipleResponses	Boolean	False	Allows respondents to take a survey more than once from the same browser on the same computer. Only available for weblink collectors.
DateModified	Datetime	False	The date collector was last modified.
Url	String	False	If the collector is a Web Collector (type 'weblink'), the URL for the collector.
DateCreated	Datetime	False	The date the collector was created.
PasswordEnabled	Boolean	False	Indicates whether the collector is password protected. Only available for weblink collectors.
SenderEmail	String	False	The sender email for email collectors. The user's email is used if null.
RedirectType	String	False	Determines the survey end page behavior. Possible values are 'url' (redirects to the URL set in redirect_url or if none is set, shows standard SurveyMonkey thank you page), 'close' (closes the survey window or tab), or 'loop' (loops the survey back to the beginning; only available for weblink collectors with allow_multiple_responses:true).
Href	String	False	The resource API URL.
Width	Int64	False	The width of your popup.
Height	Int64	False	The height of your popup.
BorderColor	String	False	The border color surrounding the survey.
IsBrandingEnabled	Boolean	False	Indicates whether the popup has SurveyMonkey branding.
Headline	String	False	The title of the modal window surrounding the survey.
Message	String	False	The message below the headline.
SampleRate	Int64	False	The percentage of people who see your popup.
PrimaryButtonBgColor	String	False	The primary button’s background color.
PrimaryButtonTextColor	String	False	The primary button’s text color.
PrimaryButtonText	String	False	The text on the primary button.
SecondaryButtonBgColor	String	False	The secondary button’s background color.
SecondaryButtonTextColor	String	False	The secondary button’s text color.
SecondaryButtonText	String	False	The text on the secondary button.
RespondentAuthentication	Bool	False	Indicates whether Respondent Authentication is required. This is used in conjunction with SSO (single sign-on) to require respondents to sign-in. You can use Respondent Authentication to send more secure internal surveys and track the people taking your survey with SSO metadata.
Password	String	False	Sets a password to restrict access to your survey.
ResponseLimit	Int64	False	Sets the collector to close after specified number of responses are collected.
FromCollectorId	String	False	The collector Id to copy collector from.

CollectorMessageDetails

Displays detailed information regarding messages sent from a collector.

Columns


Name	Type	ReadOnly	Description
Id [KEY]	String	False	The Id of the message.
CollectorId [KEY]	String	False	The Id of the collector the message belongs to.
Status	String	False	The status of the message.
Type	String	False	The message type. Possible values are 'invite', 'reminder', or 'thank_you'.
Subject	String	False	The subject of the message.
Body	String	False	The HTML body of the message.
DateCreated	Datetime	False	The date the message was created.
ScheduleDate	Datetime	False	The date the message is scheduled to be sent. If Null, the message has not been scheduled to send.
IsBrandingEnabled	Boolean	False	Indicates whether branding is enabled for the message.
IsScheduled	Boolean	False	Indicates whether the message is scheduled.
RecipientStatus	String	False	The set of recipients to send to.

CollectorRecipientDetails

Displays detailed information regarding recipients of all or specific messages sent from a collector.

Table Specific Information

Select

You must specify SurveyId and CollectorId to query from this view. The Sync App will execute other filters client-side in memory.

Survey ID, collector ID, message ID, and ID can be processed server side. The valid combinations are:

SurveyId and CollectorId
SurveyId, CollectorId, and Id
CollectorId and MessageId

Other combinations may produce incorrect results. For example, the following queries are processed server side:

SELECT * FROM CollectorRecipientDetails WHERE SurveyId = '159264810' AND CollectorId = '218025675'

SELECT * FROM CollectorRecipientDetails WHERE SurveyId = '159264810' AND CollectorId = '218025675' AND Id = '4178228027'

SELECT * FROM CollectorRecipientDetails WHERE CollectorId = '218025675' AND MessageId = '3456'

Columns


Name	Type	ReadOnly	Description
Id [KEY]	String	False	The Id of the recipient.
SurveyId [KEY]	String	False	The Id of the survey.
CollectorId [KEY]	String	False	The Id of the collector this recipient belongs to.
MessageId	String	False	The Id of the message this recipient belongs to.
FirstName	String	False	The first name of the recipient.
LastName	String	False	The last name of the recipient.
Email	String	False	The email of the recipient.
SurveyResponseStatus	String	False	Indicates whether the recipient has completed the survey. Possible values are 'not_responded', 'partially_responded', or 'completely_responded'.
MailStatus	String	False	If an invite message to the recipient has been: 'sent', 'not_sent', or is 'processing'.
SurveyLink	String	False	The link to the survey in the invite.
RemoveLink	String	False	The unsubscribe link.
ExtraFields	String	False	Any extra fields.
CustomFields	String	False	The contact details for the recipient.
PhoneNumber	String	False	The phone number of the recipient. Required if SMS collector. Should otherwise be excluded.
Duplicates	String	False	The intended behavior while adding a duplicate recipient. Values include 'add' (default), 'add_if_not_in_message', or 'add_if_not_in_collector'.
ContactId	String	False	The Id of the contact.

Collectors

Displays collector information.

Table Specific Information

Select

You must specify the survey Id or the collector Id to query from this view. The Sync App will execute other filters client-side in memory.

The Survey ID and ID can be processed server side. At most, only one of these filters can be used at a time. Specifying both filters in the same query may result in an incorrect result set. For example, the following queries are processed server side:

SELECT * FROM Collectors WHERE SurveyId = '126748712'

SELECT * FROM Collectors WHERE Id = '175305200'

Columns


Name	Type	ReadOnly	Description
Id [KEY]	String	True	The Id of the collector.
SurveyId	String	True	The Id of the survey this collector belongs to. Only displays if filtering collectors by SurveyId.
Name	String	True	The name of the collector.
Status	String	True	The collector status. Possible values are 'open' or 'closed'. Only available if resource is being queried by Id.
Type	String	True	The collector type. Possible values are 'weblink' or 'email'. Only available if resource is being queried by Id.
ThankYouMessage	String	True	The message for the thank you page. Only available if resource is being queried by Id.
DisqualificationMessage	String	True	The message for the disqualification page. Only available if resource is being queried by Id.
ClosedPageMessage	String	True	The message shown when someone visits a closed survey. Only available if resource is being queried by Id.
DisplaySurveyResults	Boolean	True	Shows respondents survey instant results when they complete the survey. Only available if resource is being queried by Id.
EditResponseTypes	String	True	When respondents can edit their response. Possible values are 'until_complete', 'never', or 'always'. Only available if resource is being queried by Id.
AnonymousType	String	True	Turns off IP tracking. For email collectors, also removes respondent email address and name from response. Possible values are 'not_anonymous', 'partially_anonymous', or 'fully_anonymous'. Only available if resource is being queried by Id.
SenderEmail	String	True	The sender email for email collectors. The user's email is used if null. Only available if resource is being queried by Id.
Url	String	True	If the collector is a Web Collector (type 'weblink'), then the URL for the collector. Only available if resource is being queried by Id.
RedirectType	String	True	Determines survey end page behavior. Possible values are 'url' (redirects to URL set in redirect_url or if none is set, shows standard SurveyMonkey thank you page), 'close' (closes the survey window or tab), or 'loop' (loops the survey back to the beginning; only available for weblink collectors with 'allow_multiple_responses'='true'). Only available if resource is being queried by Id.
RedirectUrl	String	True	Redirects respondent to this url upon survey completion. Only available if resource is being queried by Id.
AllowMultipleResponses	Boolean	True	For weblink collectors, allows respondents to take a survey more than once from the same browser on the same computer. Only available if resource is being queried by Id.
PasswordEnabled	Boolean	True	For weblink collectors, indicates whether the collector is password protected. Only available if resource is being queried by Id.
DateModified	Datetime	True	The date the collector was last modified. Only available if resource is being queried by Id.
DateCreated	Datetime	True	The date the collector was created. Only available if resource is being queried by Id.
CloseDate	Datetime	True	The close date of the collector. Only available if resource is being queried by Id.

SurveyDetails

Displays detailed information regarding surveys.

Columns


Name	Type	ReadOnly	Description
Id [KEY]	String	False	The Id of the survey.
Title	String	False	The title of the survey.
Nickname	String	False	The nickname of the survey.
Owner	String	False	The Id of the survey owner.
Category	String	False	The category of the survey.
Language	String	False	The ISO 639-1 code for the survey language.
QuestionCount	String	False	The number of questions in the survey.
PageCount	String	False	The number of pages in the survey.
DateCreated	Datetime	False	The date that the survey was created.
DateModified	Datetime	False	The date that the survey was modified.
ButtonsTextNextButton	String	False	Button text.
ButtonsTextPrevButton	String	False	Button text.
ButtonsTextExitButton	String	False	Button text.
ButtonsTextDoneButton	String	False	Button text.
Preview	String	False	The survey preview URL.
FolderId	String	False	If applicable, the Id of the folder the survey is in.
EditUrl	String	False	The survey edit URL.
CollectUrl	String	False	The survey collect URL.
AnalyzeUrl	String	False	The survey analyze URL.
SummaryUrl	String	False	The survey summary URL.
Href	String	False	The Resource API URL.
ResponseCount	String	False	The number of responses the survey has received.
Footer	Bool	False	Indicates whether SurveyMonkey’s footer is displayed.
ThemeId	Int64	False	The Id of the theme used to create the survey, if a theme was used.
TemplateId	String	False	The Id of the template used to create the survey, if a template was used.
CustomVariables	String	False	The dictionary of survey variables.
Pages	String	False	An aggregate array containing each quiz page.
FromTeamTemplateId	String	False	The team survey template to copy from.
FromTemplateId	String	False	The survey template to copy from (required if 'from_survey_id' is not provided).
FromSurveyId	String	False	The survey Id to copy from (required if 'from_template_id' is not provided).
QuizOptions	String	False	An object describing the quiz settings, if this survey is a quiz.

Surveys

Displays information regarding surveys.

Columns


Name	Type	ReadOnly	Description
Id [KEY]	String	True	The Id of the survey.
Title	String	True	The title of the survey.
Nickname	String	True	The nickname of the survey.
Category	String	True	The category of the survey.
DateCreated	Datetime	True	The date that the survey was created.
DateModified	Datetime	True	The date that the survey was modified.
FolderId	String	True	If specified, adds the survey to the folder with that Id.
IsOwner	Boolean	True	Indicates whether the user is the owner of the survey.
Language	String	True	The language of the survey.
QuestionCount	Int	True	The number of questions in the survey.
ResponseCount	Int	True	The number of responses the survey has received.

ビュー

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

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

SurveyMonkey Connector for CData Sync ビュー


Name	Description
CollectorMessages	Displays information regarding messages sent from a collector.
CollectorRecipients	Shows information regarding recipients of all or specific messages sent from a collector.
CollectorStats	Shows statistics regarding all or specific messages sent from a collector.
ContactLists	Shows contact list information.
Contacts	Shows contact information.
Pages	Shows information regarding pages for a survey.
RollupQuestions	Shows rolled up individual stats information for a survey.
Rollups	Shows rolled up stats information for a survey.
SurveyQuestions	Shows the available columns for Survey Questions. Append _Questions to your survey name to query survey questions.
SurveyResponses	Shows the available columns for Survey Responses. Append _Responses to your survey name to query survey responses.

CollectorMessages

Displays information regarding messages sent from a collector.

Table Specific Information

Select

You must specify the collector Id to query from this view. The Sync App will execute other filters client-side in memory.

For example, the following queries are processed server side:

SELECT * FROM CollectorMessages WHERE CollectorId = '175305200'

SELECT * FROM CollectorMessages WHERE CollectorId = '175305200' AND Id = '57071816'

Columns


Name	Type	Description
Id [KEY]	String	The Id of the message.
CollectorId [KEY]	String	The Id of the collector the message belongs to.
Status	String	The status of the message.
Type	String	The message type. Values include 'invite', 'reminder', or 'thank_you'.
Subject	String	The subject of the message. Only available if resource is being queried by Id.
Body	String	The HTML body of the message. Only available if resource is being queried by Id.
DateCreated	Datetime	The date the message was created. Only available if resource is being queried by Id.
ScheduledDate	Datetime	The date the message is scheduled to be sent. If Null, the message has not been scheduled to send. Only available if the resource is being queried by Id.
EmbedFirstQuestion	Boolean	Indicates whether to embed the first question to the message. Only available if resource is being queried by Id.
EditMessageLink	String	The link to the resource to edit the message. Only available if resource is being queried by Id.
IsBrandingEnabled	Boolean	Indicates whether branding is enabled for the message. Only available if resource is being queried by Id.
IsScheduled	Boolean	Indicates whether the message is scheduled. Only available if resource is being queried by Id.
RecipientStatus	String	The recipient filter. Values include 'reminder' or 'thank_you'. Only available if resource is being queried by Id.

CollectorRecipients

Shows information regarding recipients of all or specific messages sent from a collector.

Table Specific Information

Select

You must specify the collector Id to query from this view. The Sync App will execute other filters client-side in memory.

The collector ID, message ID, and ID can be processed server side. At most, only two of these filters may be used simultaneously. Specifying all three filters in the same query may result in an incorrect result set. For example, the following queries are processed server side:

SELECT * FROM CollectorRecipients WHERE CollectorId = '175305200'

SELECT * FROM CollectorRecipients WHERE CollectorId = '175305200' AND MessageId = '57071816'

SELECT * FROM CollectorRecipients WHERE CollectorId = '175305200' AND Id = '4496877899'

Columns


Name	Type	Description
Id [KEY]	String	The Id of the recipient.
CollectorId	String	The Id of the collector this recipient belongs to.
MessageId	String	The Id of the message this recipient belongs to. Null if it doesn't belong to a specific message.
Email	String	Email of recipient added to collector.
SurveyResponseStatus	String	If the recipient has completed the survey: 'not_responded', 'partially_responded', 'completely_responded'.
MailStatus	String	If an invite message to the recipient has been: 'sent', 'not_sent', or is 'processing'.
SurveyLink	String	Link to the survey in the invite.
RemoveLink	String	Unsubscribe link.

CollectorStats

Shows statistics regarding all or specific messages sent from a collector.

Table Specific Information

Select

You must specify the collector Id to query from this view. The Sync App will execute other filters client-side in memory.

For example, the following queries are processed server side:

SELECT * FROM CollectorStats WHERE CollectorId = '175305200'

SELECT * FROM CollectorStats WHERE CollectorId = '175305200' AND MessageId = '57071816'

Columns


Name	Type	Description
CollectorId	String	The Id of the collector these statistics belongs to.
MessageId	String	The Id of the message these statistics belong to. Null if they don't belong to a specific message.
Recipients	Integer	Count of recipients included in the stats.
CompletelyResponded	Integer	Count of recipients who have completed a survey response.
NotResponded	Integer	Count of recipients who have not started the survey.
PartiallyResponded	Integer	Count of recipients who have begun the survey but not completed it.
Opened	Integer	Count of recipients that have opened the message.
OptedOut	Integer	Count of recipients that have clicked on the opt out link.
NotSent	Integer	Count of recipients that have been added but their message has not been delivered.
Sent	Integer	Count of recipients that messages have been sent to.
Bounced	Integer	Count of recipients with messages that bounced.
LinkClicked	Integer	Count of messages where the included survey link was clicked on.

ContactLists

Shows contact list information.

Select

The Sync App will execute other filters client-side in memory.

For example, the following queries are processed server side:

SELECT * FROM ContactLists WHERE Id = '123740269'

Columns


Name	Type	Description
Id [KEY]	String	The Id of the contact list.
Name	String	The name of the contact list.

Contacts

Shows contact information.

Select

The Sync App will execute other filters client-side in memory.

For example, the following queries are processed server side:

SELECT * FROM Contacts WHERE Id = '2842583326'

SELECT * FROM Contacts WHERE ContactListId = '123679423'

Columns


Name	Type	Description
Id [KEY]	String	The Id of the contact.
ContactListId	String	Use this to filter contacts only from the given ContactListId.
FirstName	String	The first name of the contact.
LastName	String	The last name of the contact.
Email	String	The email of the contact.
CustomField1	String	The value of the first custom field for this contact.
CustomField2	String	The value of the second custom field for this contact.
CustomField3	String	The value of the third custom field for this contact.
CustomField4	String	The value of the fourth custom field for this contact.
CustomField5	String	The value of the fifth custom field for this contact.
CustomField6	String	The value of the sixth custom field for this contact.

Pages

Shows information regarding pages for a survey.

Table Specific Information

Select

You must specify the survey Id for this view to see page information for the survey. The Sync App will execute other filters client-side in memory.

For example, the following query is processed server side:

SELECT * FROM Pages WHERE SurveyId = '1231231'
 
SELECT * FROM Pages WHERE SurveyId = '1231231' AND Id = '1234567'

Columns


Name	Type	Description
Id [KEY]	String	The Id of the page.
SurveyId	String	The Id of the survey.
Title	String	The title of the page.
Description	String	The description of the page.
Position	Integer	The ordinal position of the page.
QuestionCount	Integer	The number of questions in this page.

RollupQuestions

Shows rolled up individual stats information for a survey.

Select

You must specify the survey Id for this view to see roll up stats for the survey. The Sync App will execute other filters client-side in memory.

For example, the following query is processed server side:

SELECT * FROM RollupQuestions WHERE SurveyId = '1231231'

Columns


Name	Type	Description
SurveyId	String	The Id of the survey.
QuestionId	String	The Id of the question
ResponseCount	Integer	Number of people which answered by selecting this choice.
ResponseTextCount	Integer	Number of people which answered by writing in a text.
ChoiceId	String	The Id of the response.
Other	Boolean	Whether the selected choice was an other response.
Ordinal	Int	The number of the order this choice appears in the list of choices. Ordinals are used to get a meaningful representation for stats like maximum, minimum, average, median, and standard deviation.
Max	Double	The maximum value of the ordinals of the answered choices.
Min	Double	The minimum value of the ordinals of the answered choices.
Mean	Double	The average value of the ordinals of the answered choices.
Median	Double	The median value of the ordinals of the answered choices.
Std	Double	The standard deviation value of the ordinals of the answered choices.

Rollups

Shows rolled up stats information for a survey.

Table Specific Information

Select

You must specify the survey Id for this view to see roll up stats for the survey. The Sync App will execute other filters client-side in memory. For example, the following query is processed server side:

SELECT * FROM Rollups WHERE SurveyId = '1231231'

Columns


Name	Type	Description
SurveyId	String	The id of the survey.
QuestionId	String	The id of the question
Family	String	The family this question belongs to.
Subtype	String	The subtype this question belongs to.
Answered	Integer	Number of people who answered this question by picking one of the given choices.
AnsweredOther	Integer	Number of people who answered this question by picking the other option.
Skipped	Integer	Number of people who skipped this question.

SurveyQuestions

Shows the available columns for Survey Questions. Append _Questions to your survey name to query survey questions.

Select

To query the SurveyQuestions view, you must use the name of the survey and append '_Questions' to the end. For some question types when the specific id is not applicable the value will be represented as '0'

SELECT * FROM [Volunteer Feedback Template_Questions]

SELECT * FROM [Benefits Template_Questions]

Columns


Name	Type	Description
SurveyId	String	The id of the survey.
QuestionId	String	The id of the question.
QuestionPosition	Integer	The position of that query in the Survey.
QuestionText	String	The text of the question.
QuestionFamily	String	The family of the question.
QuestionSubtype	String	The subtype of the question.
ChoiceId	String	The id of the choice.
ChoiceText	String	The text of the choice.
ChoiceWeight	String	The weight of the choice. Used in questions of the subtype rating and ranking. Usually it's an ordinal number in incremenenting order.
ChoiceScore	Int	This field is dynamic and maps to the corresponding report field.
RowId	String	The id of the row.
RowText	String	The text of the row.
ColId	String	The id of the column.
ColText	String	The text of the column.
PageId	String	The id of the page.
PageTitle	String	The title of the page.

SurveyResponses

Shows the available columns for Survey Responses. Append _Responses to your survey name to query survey responses.

Select

To query the SurveyResponses view, you must use the name of the survey and append '_Responses' to the end.

The Sync App uses the SurveyMonkey APIs to filter results by the following columns and operators:

DateCreated/DateModified and TotalTime: > and <
RespondentId: =
QuestionId: = and IN
ResponseStatus, IpAddress, and TotalTimeUnit: =

The Sync App processes other filters client-side within the Sync App.

For example, the following queries are processed server side:

SELECT * FROM [Volunteer Feedback Template_Responses]

SELECT * FROM [Benefits Template_Responses]

SELECT * FROM [Benefits Template_Responses] WHERE RespondentId = '1234567890'

SELECT * FROM [Benefits Template_Responses] WHERE RespondentId IN ('1234567890', '0987654321')

SELECT * FROM [Benefits Template_Responses] WHERE DateCreated > '2018-01-01' AND DateCreated < '2018-01-30'

SELECT * FROM [Benefits Template_Responses] WHERE QuestionId = '213965574'

SELECT * FROM [Benefits Template_Responses] WHERE QuestionId IN ('213965574', '213963957')

SELECT * FROM [Benefits Template_Responses] WHERE TotalTime > 5 AND TotalTime < 10 AND TotalTimeUnit = 'minute'

SELECT * FROM [Benefits Template_Responses] WHERE IpAddress = '192.168.0.1'

SELECT * FROM [Benefits Template_Responses] WHERE ResponseStatus = 'completed'

Note: When selecting a specific respondent, the aggregate column "Metadata" will be populated with a JsonObject and its elements can be accessed using the JSON_EXTRACT function in the SQLQuery.

Columns


Name	Type	Description
RespondentId	String	The id of the respondent, the person who answered this question.
SurveyId	String	The id of the survey.
RecipientId	String	The id of the recipient.
PageId	String	The id of the page.
QuestionId	String	The id of the question.
QuestionText	String	The text of the question.
ChoiceId	String	The id of the choice.
ChoiceText	String	The text of the choice.
ChoiceWeight	String	The weight of the choice. Used in questions of the subtype rating and ranking. Usually it's an ordinal number in incremenenting order.
ChoiceScore	Int	This field is dynamic and maps to the corresponding report field.
IsCorrectChoice	Boolean	This field is dynamic and maps to the corresponding report field.
RowId	String	The id of the row.
RowText	String	The text of the row.
ColId	String	The id of the column.
ColText	String	The text of the column.
OtherId	String	The id of the other field.
OtherText	String	The text of the other field.
AnswerText	String	The text of the answer (in the case of an open-ended question).
AnswerTagHexcolors	String	This field is dynamic and maps to the corresponding report field.
AnswerTagLabels	String	This field is dynamic and maps to the corresponding report field.
AnswerTagTypes	String	This field is dynamic and maps to the corresponding report field.
CollectionMode	String	The mode of collection.
CollectorId	String	The id of the collector the response was taken for.
TotalTime	String	Total time spent on this survey.
ResponseStatus	String	The status of the response. Valid values are `completed`, `partial`, `overquota`, and `disqualified`.
DateCreated	Datetime	Date and time when survey was created.
DateModified	Datetime	Date and time when survey was last modified.
CustomValue	Integer	A custom value for this response.
EditUrl	String	Survey edit URL.
AnalyzeUrl	String	Survey analyze URL.
IpAddress	String	The IP address of the respondent.
QuizCorrectAnswers	Int	This field is dynamic and maps to the corresponding report field.
QuizIncorrectAnswers	Int	This field is dynamic and maps to the corresponding report field.
QuizPartiallyCorrectAnswers	Int	This field is dynamic and maps to the corresponding report field.
QuizTotalScore	Int	This field is dynamic and maps to the corresponding report field.
QuizTotalQuestions	Int	This field is dynamic and maps to the corresponding report field.
QuizMaxScore	Int	This field is dynamic and maps to the corresponding report field.

Pseudo-Columns

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


Name	Type	Description
TotalTimeUnit	String	The unit of time you want to filter total time values with. Valids units are `second`, `minute`, and `hour`. If not specified, it will use `second` as a default value. This only affects the filtering on SurveyMonkey's end. The values returned for TotalTime from the API will still be in seconds despite what value is being sent for TotalTimeUnit.

ストアドプロシージャ

ストアドプロシージャはファンクションライクなインターフェースで、SurveyMonkey の単純なSELECT 処理にとどまらずSync App の機能を拡張します。

ストアドプロシージャは、パラメータのリストを受け取り、目的の機能を実行し、プロシージャが成功したか失敗したかを示すとともにSurveyMonkey から関連するレスポンスデータを返します。

SurveyMonkey Connector for CData Sync ストアドプロシージャ


Name	Description
CreateSurveyQuestion	Creates a new question on a survey page.
CreateSurveyResponse	Creates a new response on a collector.
DeleteSurveyQuestion	Delete a question from a survey page.
DeleteSurveyResponse	Delete a response on a collector.
SendMessage	Sends or schedules to send an existing message to all message recipients. Targeted message must have a status of 'not_sent'.
UpdateSurveyQuestion	Updates a question on a survey page.
UpdateSurveyResponse	Update a response on a collector.

CreateSchema

Creates a schema file for the specified table or view.

CreateSchema

データモデル内の既存のテーブルまたはビューからローカルスキーマファイル（.rsd）を作成します。

スキーマファイルは、このプロシージャが実行されると、Location 接続プロパティで設定されたディレクトリに作成されます。ファイルを編集してカラムを含めたり除外したり、カラム名を変更したり、カラムのデータ型を変更したりできます。

Sync App はLocation を確認し、.rsd ファイルの名前がデータモデルのテーブルまたはビューに一致するかどうかを判断します。重複がある場合、スキーマファイルはデータモデル内のこのテーブルのデフォルトインスタンスよりも優先されます。既存のテーブルまたはビューに一致しないスキーマファイルがLocation に存在する場合、新しいテーブルまたはビューのエントリがSync App のデータモデルに追加されます。

Input


Name	Type	Required	Description
TableName	String	True	The name of the table or view.
FileName	String	False	The full file path and name of the schema to generate. If not set, the FileData output is used instead. Ex : 'C:\\Users\\User\\Desktop\\SurveyMonkey\\sheet.rsd'

Result Set Columns


Name	Type	Description
Result	String	Returns Success or Failure.
FileData	String	The generated schema encoded in Base64. Only returned if FileName and FileStream are not set.

CreateSurveyQuestion

Creates a new question on a survey page.

Input


Name	Type	Required	Description
SurveyId	String	True	The survey ID.
PageId	String	True	The page ID.
Headings	String	True	List of question headings objects.
Position	Int32	False	Position of question on page.
Family	String	True	Question family determines the type of question.
Subtype	String	True	Question family's subtype further specifies the type of question.
Sorting	String	False	Sorting details of answers.
Required	Boolean	False	Whether an answer is required for this question.
Validation	String	False	Whether the answer must pass certain validation parameters.
ForcedRanking	Boolean	False	Required if type is matrix and subtype is rating or single, whether or not to force ranking.
QuizOptions	String	False	Object containing the quiz properties of this question, if quiz-mode is enabled.
Answers	String	True	Answers object. Required for all question types except open_ended_single.
DisplayOptions	String	False	Display option object. Required for file upload, slider, image choice & emoji/star rating question types.

Result Set Columns


Name	Type	Description
QuestionId	String	The ID of the created question if the operation was executed successfully.
Success	Boolean	Whether the operation was successful or not.

CreateSurveyResponse

Creates a new response on a collector.

Input


Name	Type	Required	Description
CollectorId	String	True	The colletor ID.
CustomVariables	String	False	Values to any available custom variables in the survey.
CustomValue	String	False	A custom value to attach to the response for a weblink collector.
ResponseStatus	String	False	Status of the response: completed, partial, overquota, disqualified.
IpAddress	String	False	IP Address the response was taken from.
RecipientId	Int64	False	The recipient ID from an email collector. Required for email collectors.
Pages	String	True	Pages from the survey and their associated responses.

Result Set Columns


Name	Type	Description
ResponseId	String	The ID of the created response if the operation was executed successfully.
Success	Boolean	Whether the operation was successful or not.

DeleteSurveyQuestion

Delete a question from a survey page.

Input


Name	Type	Required	Description
SurveyId	String	True	The survey ID.
PageId	String	True	The page ID.
QuestionId	String	True	The ID of the question to delete.

Result Set Columns


Name	Type	Description
Success	Boolean	Whether the operation was successful or not.

DeleteSurveyResponse

Delete a response on a collector.

Input


Name	Type	Required	Description
CollectorId	String	True	The colletor ID.
ResponseId	String	True	The ID of the response to delete.

Result Set Columns


Name	Type	Description
Success	Boolean	Whether the operation was successful or not.

GetOAuthAccessToken

Gets an authentication token from SurveyMonkey.

Input


Name	Type	Required	Description
AuthMode	String	False	The type of authentication mode to use. Select App for getting authentication tokens via a desktop app. Select Web for getting authentication tokens via a Web app. 使用できる値は次のとおりです。APP, WEB デフォルト値はAPPです。
Scope	String	False	A comma-separated list of scopes to request from the user. Please check the SurveyMonkey API for a list of available scopes.
CallbackUrl	String	False	The URL the user will be redirected to after authorizing your application. This value must match the Redirect URL you have specified in the SurveyMonkey app settings. Only needed when the Authmode parameter is Web.
Verifier	String	False	The verifier returned from SurveyMonkey after the user has authorized your app to have access to their data. This value will be returned as a parameter to the callback URL.

Result Set Columns


Name	Type	Description
OAuthAccessToken	String	The access token used for communication with SurveyMonkey.
ExpiresIn	String	The number of seconds until the access token expires.

GetOAuthAuthorizationURL

Gets the authorization URL that must be opened separately by the user to grant access to your application. Only needed when developing Web apps. You will request the OAuthAccessToken from this URL.

Input


Name	Type	Required	Description
CallbackUrl	String	False	The URL the user will be redirected to after authorizing your application. This value must match the Redirect URL in the SurveyMonkey app settings.
Scope	String	False	A comma-separated list of scopes to request from the user. Please check the SurveyMonkey API for a list of available scopes.
State	String	False	This field indicates any state that may be useful to your application upon receipt of the response. Your application receives the same value it sent, as this parameter makes a round-trip to the SurveyMonkey authorization server and back. Uses include redirecting the user to the correct resource in your site, using nonces, and mitigating cross-site request forgery.

Result Set Columns


Name	Type	Description
URL	String	The authorization URL, entered into a Web browser to obtain the verifier token and authorize your app.

SendMessage

Sends or schedules to send an existing message to all message recipients. Targeted message must have a status of 'not_sent'.

Input


Name	Type	Required	Description
CollectorId	String	True	The Id of the collector to which the message belongs.
MessageId	String	True	The Id of the message to be sent.
ScheduledDate	Datetime	False	The date when the message should send. If not specified, message sends immediately. It is advised to include timezone.

Result Set Columns


Name	Type	Description
Success	Boolean	Outputs true if the message was sent successfully, false otherwise.

UpdateSurveyQuestion

Updates a question on a survey page.

Input


Name	Type	Required	Description
SurveyId	String	True	The survey ID.
PageId	String	True	The page ID.
QuestionId	String	True	The ID of the question to update.
Headings	String	False	List of question headings objects.
Position	Int32	False	Position of question on page.
Family	String	False	Question family determines the type of question.
Subtype	String	False	Question family's subtype further specifies the type of question.
Sorting	String	False	Sorting details of answers.
Required	Boolean	False	Whether an answer is required for this question.
Validation	String	False	Whether the answer must pass certain validation parameters.
ForcedRanking	Boolean	False	Required if type is matrix and subtype is rating or single, whether or not to force ranking.
QuizOptions	String	False	Object containing the quiz properties of this question, if quiz-mode is enabled.
Answers	String	False	Answers object. Required for all question types except open_ended_single.
DisplayOptions	String	False	Display option object. Required for file upload, slider, image choice & emoji/star rating question types.

Result Set Columns


Name	Type	Description
Success	Boolean	Whether the operation was successful or not.

UpdateSurveyResponse

Update a response on a collector.

Input


Name	Type	Required	Description
CollectorId	String	True	The colletor ID.
ResponseId	String	True	The ID of the response to update.
CustomVariables	String	False	Values to any available custom variables in the survey.
CustomValue	String	False	A custom value to attach to the response for a weblink collector.
ResponseStatus	String	False	Status of the response: completed, partial, overquota, disqualified.
IpAddress	String	False	IP Address the response was taken from.
RecipientId	Int64	False	The recipient ID from an email collector. Required for email collectors.
Pages	String	False	Pages from the survey and their associated responses.

Result Set Columns


Name	Type	Description
Success	Boolean	Whether the operation was successful or not.

接続文字列オプション

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

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

Authentication

プロパティ	説明
AuthScheme	The type of authentication to use when connecting to SurveyMonkey.
AccessToken	The Access Token of the SurveyMonkey application.

OAuth

プロパティ	説明
OAuthClientId	カスタムOAuth アプリケーションに割り当てられたクライアントID（コンシューマーキーとも呼ばれます）を指定します。このID は、認証時にOAuth 認可サーバーにアプリケーションを識別させるために必要です。
OAuthClientSecret	カスタムOAuth アプリケーションに割り当てられたクライアントシークレットを指定します。この機密情報は、OAuth 認可サーバーに対してアプリケーションを認証するために使用されます。（カスタムOAuth アプリケーションのみ）
Scope	The Scope supplied from the app settings.
Datacenter	The originating datacenter of the SurveyMonkey account. It will determine the API access URL to use during authentication and data retrieval.

SSL

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

Firewall

プロパティ	説明
FirewallType	provider がプロキシベースのファイアウォールを介してトラフィックをトンネリングするために使用するプロトコルを指定します。
FirewallServer	ファイアウォールを通過し、ユーザーのクエリをネットワークリソースに中継するために使用されるプロキシのIP アドレス、DNS 名、またはホスト名を識別します。
FirewallPort	プロキシベースのファイアウォールで使用するTCP ポートを指定します。
FirewallUser	プロキシベースのファイアウォールに認証するアカウントのユーザーID を識別します。
FirewallPassword	プロキシベースのファイアウォールで認証するユーザーアカウントのパスワードを指定します。

Proxy

プロパティ	説明
ProxyAutoDetect	provider が、手動で指定されたプロキシサーバーを使用するのではなく、既存のプロキシサーバー構成についてシステムプロキシ設定をチェックするかどうかを指定します。
ProxyServer	HTTP トラフィックをルートするプロキシサーバーのホストネームもしくはIP アドレスを指定します。
ProxyPort	クライアントとの間でHTTP トラフィックをルーティングするために予約された、指定されたプロキシサーバーのTCP ポートを指定します。
ProxyAuthScheme	ProxyServer 接続プロパティで指定されたプロキシサーバーに対して認証する際にprovider が使用する認証方法を指定します。
ProxyUser	ProxyServer 接続プロパティで指定されたプロキシサーバーに登録されているユーザーアカウントのユーザー名を提供します。
ProxyPassword	ProxyUser 接続プロパティで指定されたユーザーのパスワードを指定します。
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

プロパティ	説明
MaxRows	集計やGROUP BY を含まないクエリで返される最大行数を指定します。
Other	特定の問題に対処するため、特殊なシナリオ向けの高度な接続プロパティを指定します。このプロパティは、サポートチームの指示がある場合にのみ使用してください。
Pagesize	provider がSurveyMonkey にデータをリクエストするときに返す、ページあたりの最大レコード数を指定します。
PseudoColumns	テーブルカラムとして公開する擬似カラムを、'TableName=ColumnName;TableName=ColumnName' の形式の文字列で指定します。
ReplaceNullValuesForPK	Update NULL values to 0 for primary keys
ShowCustomVariables	A boolean determining if custom variables and their values should be listed when querying Survey_Responses.
Timeout	provider がタイムアウトエラーを返すまでにサーバーからの応答を待機する最大時間を秒単位で指定します。
UserDefinedViews	カスタムビューを定義するJSON 構成ファイルへのファイルパスを指定します。provider は、このファイルで指定されたビューを自動的に検出して使用します。
UseSimpleNames	テーブルとカラムに簡略名を使用するかどうかを指定します。

Authentication

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

プロパティ	説明
AuthScheme	The type of authentication to use when connecting to SurveyMonkey.
AccessToken	The Access Token of the SurveyMonkey application.

AuthScheme

The type of authentication to use when connecting to SurveyMonkey.

解説

OAuth: Set to this to perform OAuth authentication.
AccessToken: Set this to perform Access Token authentication. Provide value for [AccessToken] connection property.

AccessToken

The Access Token of the SurveyMonkey application.

解説

The Access Token of the SurveyMonkey application.

OAuth

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

プロパティ	説明
OAuthClientId	カスタムOAuth アプリケーションに割り当てられたクライアントID（コンシューマーキーとも呼ばれます）を指定します。このID は、認証時にOAuth 認可サーバーにアプリケーションを識別させるために必要です。
OAuthClientSecret	カスタムOAuth アプリケーションに割り当てられたクライアントシークレットを指定します。この機密情報は、OAuth 認可サーバーに対してアプリケーションを認証するために使用されます。（カスタムOAuth アプリケーションのみ）
Scope	The Scope supplied from the app settings.
Datacenter	The originating datacenter of the SurveyMonkey account. It will determine the API access URL to use during authentication and data retrieval.

OAuthClientId

カスタムOAuth アプリケーションに割り当てられたクライアントID（コンシューマーキーとも呼ばれます）を指定します。このID は、認証時にOAuth 認可サーバーにアプリケーションを識別させるために必要です。

解説

このプロパティは2つのケースで必要となります：

カスタムOAuth アプリケーションを使用する場合。たとえば、Web ベースの認証フロー、サービスベースの認証、またはアプリケーションの登録が必要な証明書ベースのフローなどが該当します。
ドライバーが埋め込みOAuth 資格情報を提供しない場合。

（ドライバーが埋め込みOAuth 資格情報を提供する場合、この値はすでにSync App によって設定されており、手動で入力する必要がないことがあります。）

OAuthClientId は、認証付きの接続を構成する際に、OAuthClientSecret やOAuthSettingsLocation などの他のOAuth 関連プロパティと一緒に使用されるのが一般的です。

OAuthClientId は、ユーザーがOAuth 経由で認証を行う前に設定する必要がある、主要な接続パラメータの1つです。この値は、通常、ID プロバイダーのアプリケーション登録設定で確認できます。 Client ID、Application ID、Consumer Key などとラベル付けされた項目を探してください。

クライアントID は、クライアントシークレットのような機密情報とは見なされませんが、アプリケーションの識別情報の一部であるため、慎重に取り扱う必要があります。公開リポジトリや共有設定ファイルでこの値を露出させないようにしてください。

接続設定時にこのプロパティを使用する方法の詳細については、接続の確立を参照してください。

OAuthClientSecret

カスタムOAuth アプリケーションに割り当てられたクライアントシークレットを指定します。この機密情報は、OAuth 認可サーバーに対してアプリケーションを認証するために使用されます。（カスタムOAuth アプリケーションのみ）

解説

このプロパティ（アプリケーションシークレットまたはコンシューマシークレットとも呼ばれます）は、安全なクライアント認証を必要とするすべてのフローでカスタムOAuth アプリケーションを使用する場合に必要です。たとえば、Web ベースのOAuth、サービスベースの接続、証明書ベースの認可フローなどが該当します。組み込みOAuth アプリケーションを使用する場合は必要ありません。

クライアントシークレットは、OAuth フローのトークン交換ステップで使用されます。このステップでは、ドライバーが認可サーバーにアクセストークンを要求します。この値が欠落しているか正しくない場合、認証はinvalid_client またはunauthorized_client エラーで失敗します。

OAuthClientSecret は、ユーザーがOAuth 経由で認証を行う前に設定する必要がある、主要な接続パラメータの1つです。この値は、OAuth アプリケーションを登録する際にID プロバイダーから取得できます。

Notes：

この値は安全に保管し、公開リポジトリやスクリプト、安全でない環境では決して公開しないようにしてください。
クライアントシークレットは、一定期間が経過すると有効期限が切れる場合もあります。アクセスを中断させないために、有効期限を常に監視し、必要に応じてシークレットをローテーションするようにしてください。

接続設定時にこのプロパティを使用する方法の詳細については、接続の確立を参照してください。

Scope

The Scope supplied from the app settings.

解説

The Scope supplied from the app settings. Recommended to be specified when using a custom app.

Datacenter

The originating datacenter of the SurveyMonkey account. It will determine the API access URL to use during authentication and data retrieval.

解説

US: Set this to use https://api.surveymonkey.com
EU: Set this to use https://api.eu.surveymonkey.com
CA: Set this to use https://api.surveymonkey.ca

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`

Note：'*' を使用してすべての証明書を受け入れるように指定することも可能ですが、セキュリティ上の懸念があるため推奨されません。

Firewall

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

プロパティ	説明
FirewallType	provider がプロキシベースのファイアウォールを介してトラフィックをトンネリングするために使用するプロトコルを指定します。
FirewallServer	ファイアウォールを通過し、ユーザーのクエリをネットワークリソースに中継するために使用されるプロキシのIP アドレス、DNS 名、またはホスト名を識別します。
FirewallPort	プロキシベースのファイアウォールで使用するTCP ポートを指定します。
FirewallUser	プロキシベースのファイアウォールに認証するアカウントのユーザーID を識別します。
FirewallPassword	プロキシベースのファイアウォールで認証するユーザーアカウントのパスワードを指定します。

FirewallType

provider がプロキシベースのファイアウォールを介してトラフィックをトンネリングするために使用するプロトコルを指定します。

解説

プロキシベースのファイアウォール（またはプロキシファイアウォール）は、ユーザーのリクエストとそれがアクセスするリソースの間に介在するネットワークセキュリティデバイスです。プロキシは認証済みのユーザーのリクエストを受け取り、ファイアウォールを通過して適切なサーバーにリクエストを送信します。

プロキシは、リクエストを送信したユーザーに代わってデータバケットを評価し転送するため、ユーザーはサーバーに直接接続することなく、プロキシのみに接続します。

Note：デフォルトでは、Sync App はシステムプロキシに接続します。この動作を無効化し、次のプロキシタイプのいずれかに接続するには、ProxyAutoDetect をfalse に設定します。

次の表は、サポートされている各プロトコルのポート番号情報です。


プロトコル	デフォルトポート	説明
TUNNEL	80	Sync App がSurveyMonkey への接続を開くポート。トラフィックはこの場所のプロキシを経由して行き来します。
SOCKS4	1080	Sync App がSurveyMonkey への接続を開くポート。SOCKS 4 は次にFirewallUser 値をプロキシに渡し、接続リクエストが許容されるかどうかを決定します。
SOCKS5	1080	Sync App がSurveyMonkey にデータを送信するポート。SOCKS 5 プロキシに認証が必要な場合には、FirewallUser およびFirewallPassword をプロキシが認識する認証情報に設定します。

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

FirewallServer

ファイアウォールを通過し、ユーザーのクエリをネットワークリソースに中継するために使用されるプロキシのIP アドレス、DNS 名、またはホスト名を識別します。

解説

プロキシベースのファイアウォール（またはプロキシファイアウォール）は、ユーザーのリクエストとそれがアクセスするリソースの間に介在するネットワークセキュリティデバイスです。プロキシは認証済みのユーザーのリクエストを受け取り、ファイアウォールを通過して適切なサーバーにリクエストを送信します。

プロキシは、リクエストを送信したユーザーに代わってデータバケットを評価し転送するため、ユーザーはサーバーに直接接続することなく、プロキシのみに接続します。

FirewallPort

プロキシベースのファイアウォールで使用するTCP ポートを指定します。

解説

プロキシベースのファイアウォール（またはプロキシファイアウォール）は、ユーザーのリクエストとそれがアクセスするリソースの間に介在するネットワークセキュリティデバイスです。プロキシは認証済みのユーザーのリクエストを受け取り、ファイアウォールを通過して適切なサーバーにリクエストを送信します。

プロキシは、リクエストを送信したユーザーに代わってデータバケットを評価し転送するため、ユーザーはサーバーに直接接続することなく、プロキシのみに接続します。

FirewallUser

プロキシベースのファイアウォールに認証するアカウントのユーザーID を識別します。

解説

プロキシベースのファイアウォール（またはプロキシファイアウォール）は、ユーザーのリクエストとそれがアクセスするリソースの間に介在するネットワークセキュリティデバイスです。プロキシは認証済みのユーザーのリクエストを受け取り、ファイアウォールを通過して適切なサーバーにリクエストを送信します。

プロキシは、リクエストを送信したユーザーに代わってデータバケットを評価し転送するため、ユーザーはサーバーに直接接続することなく、プロキシのみに接続します。

FirewallPassword

プロキシベースのファイアウォールで認証するユーザーアカウントのパスワードを指定します。

解説

プロキシベースのファイアウォール（またはプロキシファイアウォール）は、ユーザーのリクエストとそれがアクセスするリソースの間に介在するネットワークセキュリティデバイスです。プロキシは認証済みのユーザーのリクエストを受け取り、ファイアウォールを通過して適切なサーバーにリクエストを送信します。

プロキシは、リクエストを送信したユーザーに代わってデータバケットを評価し転送するため、ユーザーはサーバーに直接接続することなく、プロキシのみに接続します。

Proxy

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

プロパティ	説明
ProxyAutoDetect	provider が、手動で指定されたプロキシサーバーを使用するのではなく、既存のプロキシサーバー構成についてシステムプロキシ設定をチェックするかどうかを指定します。
ProxyServer	HTTP トラフィックをルートするプロキシサーバーのホストネームもしくはIP アドレスを指定します。
ProxyPort	クライアントとの間でHTTP トラフィックをルーティングするために予約された、指定されたプロキシサーバーのTCP ポートを指定します。
ProxyAuthScheme	ProxyServer 接続プロパティで指定されたプロキシサーバーに対して認証する際にprovider が使用する認証方法を指定します。
ProxyUser	ProxyServer 接続プロパティで指定されたプロキシサーバーに登録されているユーザーアカウントのユーザー名を提供します。
ProxyPassword	ProxyUser 接続プロパティで指定されたユーザーのパスワードを指定します。
ProxySSLType	ProxyServer 接続プロパティで指定されたプロキシサーバーに接続する際に使用するSSL タイプを指定します。
ProxyExceptions	ProxyServer 接続プロパティで設定されたプロキシサーバー経由での接続が免除される宛先ホスト名またはIP のセミコロン区切りのリストを指定します。

ProxyAutoDetect

provider が、手動で指定されたプロキシサーバーを使用するのではなく、既存のプロキシサーバー構成についてシステムプロキシ設定をチェックするかどうかを指定します。

解説

この接続プロパティをTrue に設定すると、Sync App は既存のプロキシサーバー構成についてシステムプロキシ設定をチェックします（プロキシサーバーの詳細を手動で入力する必要はありません）。

この接続プロパティは他のプロキシ設定より優先されます。特定のプロキシサーバーに接続するためにSync App を構成する場合は、ProxyAutoDetect をFalse に設定します。

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

ProxyServer

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

解説

ProxyAutoDetect がFalse に設定されている場合、Sync App はこの接続プロパティで指定されたプロキシサーバーを通じてのみHTTP トラフィックをルーティングします。

ProxyAutoDetect がTrue（デフォルト）に設定されている場合、Sync App は代わりにシステムプロキシ設定で指定されたプロキシサーバーを介してHTTP トラフィックをルーティングします。

ProxyPort

クライアントとの間でHTTP トラフィックをルーティングするために予約された、指定されたプロキシサーバーのTCP ポートを指定します。

解説

ProxyAutoDetect がFalse に設定されている場合、Sync App はこの接続プロパティで指定されたProxyServer ポートを通じてのみHTTP トラフィックをルーティングします。

ProxyAutoDetect がTrue（デフォルト）に設定されている場合、Sync App は代わりにシステムプロキシ設定で指定されたプロキシサーバーポートを介してHTTP トラフィックをルーティングします。

その他のプロキシタイプについては、FirewallType を参照してください。

ProxyAuthScheme

ProxyServer 接続プロパティで指定されたプロキシサーバーに対して認証する際にprovider が使用する認証方法を指定します。

解説

サポートされる認証の種類：

BASIC：Sync App はHTTP Basic 認証を行います。
DIGEST：Sync App はHTTP ダイジェスト認証を行います。
NTLM：Sync App はNTLM トークンを取得します。
NEGOTIATE： Sync App は認証において有効なプロトコルに応じて、NTLM もしくはKerberos トークンを取得します。
NONE：ProxyServer が認証を必要としないことを示します。

NONE 以外のすべての値については、ProxyUser およびProxyPassword 接続プロパティも設定する必要があります。

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

ProxyUser

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 接続プロパティは設定しないでください。

Note：Sync App は、ProxyAutoDetect がFalse に設定されている場合にのみ、このユーザー名を使用します。 ProxyAutoDetect がTrue（デフォルト）に設定されている場合、Sync App は代わりにシステムのプロキシ設定で指定されているユーザー名を使用します。

ProxyPassword

ProxyUser 接続プロパティで指定されたユーザーのパスワードを指定します。

解説

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

ProxyAuthScheme で利用可能な認証タイプを1つ選択した後、このプロパティを以下のように設定します。


ProxyAuthScheme の値	ProxyPassword に設定する値
BASIC	ProxyUser で指定したプロキシサーバーユーザーに紐付けられたパスワード。
DIGEST	ProxyUser で指定したプロキシサーバーユーザーに紐付けられたパスワード。
NEGOTIATE	ProxyUser で指定したWindows ユーザーアカウントに紐付けられたパスワード。
NTLM	ProxyUser で指定したWindows ユーザーアカウントに紐付けられたパスワード。
NONE	ProxyPassword 接続プロパティは設定しないでください。

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

Note：Sync App は、ProxyAutoDetect がFalse に設定されている場合にのみ、このパスワードを使用します。 ProxyAutoDetect がTrue（デフォルト）に設定されている場合、Sync App は代わりにシステムのプロキシ設定で指定されているパスワードを使用します。

ProxySSLType

ProxyServer 接続プロパティで指定されたプロキシサーバーに接続する際に使用するSSL タイプを指定します。

解説

このプロパティは、ProxyServer で指定されたHTTP プロキシへの接続にSSL を使用するかどうかを決定します。この接続プロパティには、以下の値を設定できます。


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

ProxyExceptions

ProxyServer 接続プロパティで設定されたプロキシサーバー経由での接続が免除される宛先ホスト名またはIP のセミコロン区切りのリストを指定します。

解説

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

Note：Sync App はデフォルトでシステムプロキシ設定を使用するため、それ以上の設定は必要ありません。この接続にプロキシ例外を明示的に設定する場合は、ProxyAutoDetect をFalse に設定します。

Logging

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

プロパティ	説明
LogModules	ログファイルに含めるコアモジュールを指定します。セミコロンで区切られたモジュール名のリストを使用します。デフォルトでは、すべてのモジュールがログに記録されます。

LogModules

ログファイルに含めるコアモジュールを指定します。セミコロンで区切られたモジュール名のリストを使用します。デフォルトでは、すべてのモジュールがログに記録されます。

解説

Sync App は、実行する各操作の詳細を Logfile 接続プロパティで指定されたログファイルに書き込みます。

ログに記録される各操作は、モジュールと呼ばれるカテゴリに分類されます。各モジュールには対応する短いコードがあり、個々の Sync App の操作がどのモジュールに属するかを示すラベルとして使用されます。

この接続プロパティにモジュールコードをセミコロン区切りのリストで設定すると、指定したモジュールに属する操作のみがログファイルに書き込まれます。この設定は今後のログ記録にのみ適用され、既存のログファイルの内容には影響しません。例: INFO;EXEC;SSL;META;

デフォルトでは、すべてのモジュールの操作がログに含まれます。

モジュールを明示的に除外するには、先頭に「-」を付けます。例: -HTTP

サブモジュールにフィルターを適用するには、<モジュール名>.<サブモジュール名> の構文で指定します。たとえば、次の値を設定すると、Sync App は HTTP モジュールに属するアクションのみをログに記録し、さらに HTTP モジュールの Res サブモジュールに属するアクションを除外します: HTTP;-HTTP.Res

Verbosity 接続プロパティによるログファイルのフィルタリングは、この接続プロパティによるフィルタリングよりも優先されます。そのため、Verbosity 接続プロパティで指定したレベルよりも高い詳細レベルの操作は、この接続プロパティで指定したモジュールに属していても、ログファイルには出力されません。

使用可能なモジュールとサブモジュールは次のとおりです。


モジュール名	モジュールの説明	サブモジュール
INFO	一般情報。接続文字列、製品バージョン（ビルド番号）、および初期接続メッセージが含まれます。	Connec — 接続の作成または破棄に関連する情報。 Messag — 接続、接続文字列、製品バージョンに関するメッセージの汎用ラベル。これらのメッセージは通常、サービスから直接受信して転送されるものではなく、Sync App 固有のものです。
EXEC	クエリ実行。ユーザーが記述した SQL クエリ、解析済み SQL クエリ、正規化済み SQL クエリの実行メッセージが含まれます。クエリおよびクエリページの成功/失敗メッセージもここに表示されます。	Messag — クエリ実行に関するメッセージ。これらのメッセージは通常、サービスから直接受信して転送されるものではなく、Sync App 固有のものです。 Normlz — クエリの正規化ステップ。クエリの正規化とは、ユーザーが送信したクエリを、最適なパフォーマンスで同じ結果を得られるように書き換える処理です。 Origin — ユーザーの元のクエリ（ユーザーが実行した正確で未変更の非正規化クエリ）を記録するメッセージに適用されるラベル。 Page — クエリのページングに関連するメッセージ。 Parsed — クエリの解析ステップ。解析とは、ユーザーが送信したクエリを、処理しやすい標準化された形式に変換するプロセスです。
HTTP	HTTP プロトコルメッセージ。HTTP リクエスト/レスポンス（POST メッセージを含む）、および Kerberos 関連のメッセージが含まれます。	KERB — Kerberos に関連する HTTP リクエスト。 Messag — HTTP プロトコルに関するメッセージ。これらのメッセージは通常、サービスから直接受信して転送されるものではなく、Sync App 固有のものです。 Unpack — サービス API から返された圧縮データを製品が解凍する際のメッセージに適用されるラベル。 Res — HTTP レスポンスを含むメッセージ。 Req — HTTP リクエストを含むメッセージ。
WSDL	WSDL/XSD ファイルの生成に関するメッセージ。	—
SSL	SSL 証明書メッセージ。	Certif — SSL 証明書に関するメッセージ。
AUTH	認証関連の失敗/成功メッセージ。	Messag — 認証に関するメッセージ。これらのメッセージは通常、サービスから直接受信して転送されるものではなく、Sync App 固有のものです。 OAuth — OAuth 認証に関連するメッセージ。 Krbros — Kerberos 関連の認証メッセージ。
SQL	SQL トランザクション、SQL 一括転送メッセージ、および SQL 結果セットメッセージが含まれます。	Bulk — 一括クエリ実行に関するメッセージ。 Cache — パフォーマンス向上のため、製品のキャッシュへの行データの読み書きに関連するメッセージ。 Messag — SQL トランザクションに関するメッセージ。これらのメッセージは通常、サービスから直接受信して転送されるものではなく、Sync App 固有のものです。 ResSet — クエリの結果セット。 Transc — 実行されたジョブ数やバックアップテーブルの処理に関する情報を含む、トランザクション処理に関連するメッセージ。
META	メタデータキャッシュとスキーマメッセージ。	Cache — パフォーマンス向上のため、製品のキャッシュ内のカラムおよびテーブル定義の読み取りと変更に関連するメッセージ。 Schema — サービススキーマからのメタデータの取得またはサービススキーマの変更に関連するメッセージ。 MemSto — インメモリメタデータキャッシュへの書き込みまたは読み取りに関連するメッセージ。 Storag — メモリ内ではなく、ディスクまたは外部データストアへのメタデータの保存に関連するメッセージ。
FUNC	SQL 関数の実行に関連する情報。	Errmsg — SQL 関数の実行に関連するエラーメッセージ。
TCP	TCP トランスポートレイヤーメッセージでの送受信生バイト。	Send — TCP プロトコル経由で送信された生データ。 Receiv — TCP プロトコル経由で受信した生データ。
FTP	File Transfer Protocol に関するメッセージ。	Info — FTP プロトコルでの通信に関連するステータスメッセージ。 Client — FTP 通信中に FTP クライアント（製品）が実行したアクションに関連するメッセージ。 Server — FTP 通信中に FTP サーバーが実行したアクションに関連するメッセージ。
SFTP	Secure File Transfer Protocol に関するメッセージ。	Info — SFTP プロトコルでの通信に関連するステータスメッセージ。 To_Server — SFTP 通信中に SFTP クライアント（製品）が実行したアクションに関連するメッセージ。 From_Server — SFTP 通信中に SFTP サーバーが実行したアクションに関連するメッセージ。
POP	Post Office Protocol 経由で転送されるデータに関するメッセージ。	Client — POP 通信中に POP クライアント（製品）が実行したアクションに関連するメッセージ。 Server — POP 通信中に POP サーバーが実行したアクションに関連するメッセージ。 Status — POP プロトコルでの通信に関連するステータスメッセージ。
SMTP	Simple Mail Transfer Protocol 経由で転送されるデータに関するメッセージ。	Client — SMTP 通信中に SMTP クライアント（製品）が実行したアクションに関連するメッセージ。 Server — SMTP 通信中に SMTP サーバーが実行したアクションに関連するメッセージ。 Status — SMTP プロトコルでの通信に関連するステータスメッセージ。
CORE	他のモジュールでカバーされていない、さまざまな製品内部操作に関連するメッセージ。	—
DEMN	SQL リモーティングに関連するメッセージ。	—
CLJB	一括データアップロード（クラウドジョブ）に関するメッセージ。	Commit — 一括データアップロードの送信。
SRCE	他のモジュールに属さない、製品が生成するその他のメッセージ。	—
TRANCE	低レベルの製品操作に関する高度なメッセージ。	—

Schema

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

プロパティ	説明
Location	テーブル、ビュー、およびストアドプロシージャを定義するスキーマファイルを格納するディレクトリの場所を指定します。サービスの要件に応じて、これは絶対パスまたは相対パスのいずれかで表されます。
BrowsableSchemas	レポートされるスキーマを利用可能なすべてのスキーマのサブセットに制限するオプション設定。例えば、 BrowsableSchemas=SchemaA,SchemaB,SchemaC です。
Tables	レポートされるテーブルを利用可能なすべてのテーブルのサブセットに制限するオプション設定。例えば、 Tables=TableA,TableB,TableC です。
Views	レポートされたビューを使用可能なテーブルのサブセットに制限するオプション設定。例えば、 Views=ViewA,ViewB,ViewC です。

Location

テーブル、ビュー、およびストアドプロシージャを定義するスキーマファイルを格納するディレクトリの場所を指定します。サービスの要件に応じて、これは絶対パスまたは相対パスのいずれかで表されます。

解説

Location プロパティは、定義をカスタマイズしたり（例えば、カラム名を変更する、カラムを無視するなど）、新しいテーブル、ビュー、またはストアドプロシージャでデータモデルを拡張する場合にのみ必要です。

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


プラットフォーム	%APPDATA%
Windows	APPDATA 環境変数の値
Linux	~/.config

BrowsableSchemas

レポートされるスキーマを利用可能なすべてのスキーマのサブセットに制限するオプション設定。例えば、 BrowsableSchemas=SchemaA,SchemaB,SchemaC です。

解説

利用可能なデータベーススキーマをすべてリストすると余分な時間がかかり、パフォーマンスが低下します。接続文字列にスキーマのリストを指定することで、時間を節約しパフォーマンスを向上させることができます。

Tables

レポートされるテーブルを利用可能なすべてのテーブルのサブセットに制限するオプション設定。例えば、 Tables=TableA,TableB,TableC です。

解説

データベースによっては、利用可能なすべてのテーブルをリストするのに時間がかかり、パフォーマンスが低下する場合があります。接続文字列にテーブルのリストを指定することで、時間を節約しパフォーマンスを向上させることができます。

利用可能なテーブルがたくさんあり、すでに作業したいテーブルが決まっている場合、このプロパティを使用して対象のテーブルのみに表示を制限することができます。これを行うには、カンマ区切りのリストで使用したいテーブルを指定します。各テーブルは、角かっこ、二重引用符、またはバッククオートを使用してエスケープされた特殊文字列を含む有効なSQL 識別子である必要があります。例えば、Tables=TableA,[TableB/WithSlash],WithCatalog.WithSchema.`TableC With Space` です。

Note：複数のスキーマまたはカタログを持つデータソースに接続する場合は、表示する各テーブルを完全修飾名で指定する必要があります。これにより、複数のカタログやスキーマに存在するテーブルが混同されることを防ぎます。

Views

レポートされたビューを使用可能なテーブルのサブセットに制限するオプション設定。例えば、 Views=ViewA,ViewB,ViewC です。

解説

データベースによっては、利用可能なすべてのビューをリストするのに時間がかかり、パフォーマンスが低下する場合があります。接続文字列にビューのリストを指定することで、時間を節約しパフォーマンスを向上させることができます。

利用可能なビューがたくさんあり、すでに作業したいビューが決まっている場合、このプロパティを使用して対象のビューのみに表示を制限することができます。これを行うには、カンマ区切りのリストで使用したいビューを指定します。各ビューは、角かっこ、二重引用符、またはバッククオートを使用してエスケープされた特殊文字列を含む有効なSQL 識別子である必要があります。例えば、Views=ViewA,[ViewB/WithSlash],WithCatalog.WithSchema.`ViewC With Space` です。

Note：複数のスキーマまたはカタログを持つデータソースに接続する場合は、確認する各ビューを完全修飾名で指定する必要があります。これにより、複数のカタログやスキーマに存在するビューが混同されることを防ぎます。

Miscellaneous

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

プロパティ	説明
MaxRows	集計やGROUP BY を含まないクエリで返される最大行数を指定します。
Other	特定の問題に対処するため、特殊なシナリオ向けの高度な接続プロパティを指定します。このプロパティは、サポートチームの指示がある場合にのみ使用してください。
Pagesize	provider がSurveyMonkey にデータをリクエストするときに返す、ページあたりの最大レコード数を指定します。
PseudoColumns	テーブルカラムとして公開する擬似カラムを、'TableName=ColumnName;TableName=ColumnName' の形式の文字列で指定します。
ReplaceNullValuesForPK	Update NULL values to 0 for primary keys
ShowCustomVariables	A boolean determining if custom variables and their values should be listed when querying Survey_Responses.
Timeout	provider がタイムアウトエラーを返すまでにサーバーからの応答を待機する最大時間を秒単位で指定します。
UserDefinedViews	カスタムビューを定義するJSON 構成ファイルへのファイルパスを指定します。provider は、このファイルで指定されたビューを自動的に検出して使用します。
UseSimpleNames	テーブルとカラムに簡略名を使用するかどうかを指定します。

MaxRows

集計やGROUP BY を含まないクエリで返される最大行数を指定します。

解説

このプロパティのデフォルト値である-1 は、クエリに明示的にLIMIT 句が含まれていない限り、行の制限が適用されないことを意味します。（クエリにLIMIT 句が含まれている場合、クエリで指定された値がMaxRows 設定よりも優先されます。）

MaxRows を0より大きい整数に設定することで、クエリがデフォルトで過度に大きな結果セットを返さないようにします。

このプロパティは、非常に大きなデータセットを返す可能性のあるクエリを実行する際に、パフォーマンスを最適化し、過剰なリソース消費を防ぐのに役立ちます。

Other

特定の問題に対処するため、特殊なシナリオ向けの高度な接続プロパティを指定します。このプロパティは、サポートチームの指示がある場合にのみ使用してください。

解説

このプロパティにより、シニアユーザーはサポートチームのアドバイスに基づいて、特定の状況に対応する隠しプロパティを設定できます。これらの設定は通常のユースケースには必要ありませんが、特定の要件に対応したり、追加の機能を提供したりすることができます。複数のプロパティを定義するには、セミコロンで区切られたリストを使用します。

Note：特定のシナリオや問題に対処するためにサポートチームから助言があった場合にのみ、これらのプロパティを設定することを強く推奨します。

統合およびフォーマット


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

Pagesize

provider がSurveyMonkey にデータをリクエストするときに返す、ページあたりの最大レコード数を指定します。

解説

クエリを処理する際、SurveyMonkey でクエリされたデータすべてを一度にリクエストする代わりに、Sync App はクエリされたデータをページと呼ばれる部分ごとにリクエストすることができます。

この接続プロパティは、Sync App がページごとにリクエストする結果の最大数を決定します。

Note：大きなページサイズを設定すると全体的なクエリ実行時間が短縮される可能性がありますが、その場合、クエリ実行時にSync App がより多くのメモリを使用することになり、タイムアウトが発生するリスクがあります。

PseudoColumns

テーブルカラムとして公開する擬似カラムを、'TableName=ColumnName;TableName=ColumnName' の形式の文字列で指定します。

解説

このプロパティを使用すると、Sync App がテーブルカラムとして公開する擬似カラムを定義できます。

個々の擬似カラムを指定するには、以下の形式を使用します。

Table1=Column1;Table1=Column2;Table2=Column3

すべてのテーブルのすべての擬似カラムを含めるには、次を使用してください：

*=*

ReplaceNullValuesForPK

Update NULL values to 0 for primary keys

解説

When set to true null values for composite keys will be replaced with 0. This property affects only the SurveyQuestions and SurveyAnswers views

ShowCustomVariables

A boolean determining if custom variables and their values should be listed when querying Survey_Responses.

解説

A boolean determining if custom variables and their values should be listed when querying Survey_Responses.

Timeout

provider がタイムアウトエラーを返すまでにサーバーからの応答を待機する最大時間を秒単位で指定します。

解説

タイムアウトは、クエリや操作全体ではなくサーバーとの個々の通信に適用されます。例えば、各ページング呼び出しがタイムアウト制限内に完了する場合、クエリは60秒を超えて実行を続けることができます。

タイムアウトはデフォルトで60秒に設定されています。タイムアウトを無効にするには、このプロパティを0に設定します。

タイムアウトを無効にすると、操作が成功するか、サーバー側のタイムアウト、ネットワークの中断、またはサーバーのリソース制限などの他の条件で失敗するまで無期限に実行されます。

Note： このプロパティは慎重に使用してください。長時間実行される操作がパフォーマンスを低下させたり、応答しなくなる可能性があるためです。

UserDefinedViews

カスタムビューを定義するJSON 構成ファイルへのファイルパスを指定します。provider は、このファイルで指定されたビューを自動的に検出して使用します。

解説

UserDefinedViews を使用すると、UserDefinedViews.json というJSON 形式の構成ファイルを通じてカスタムビューを定義および管理できます。これらのビューはSync App によって自動的に認識され、標準のデータベースビューのようにカスタムSQL クエリを実行できるようになります。 JSON ファイルは、各ビューをルート要素として定義し、その子要素として"query" を持ちます。この"query" にはビューのSQL クエリが含まれています。

次に例を示します。

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

このプロパティを使用して、1つのファイルに複数のビューを定義し、ファイルパスを指定できます。次に例を示します。

UserDefinedViews=C:\Path\To\UserDefinedViews.json

UserDefinedViews でビューを指定すると、Sync App はそのビューだけを参照します。

詳しくは、ユーザー定義ビューを参照してください。

UseSimpleNames

テーブルとカラムに簡略名を使用するかどうかを指定します。

解説

SurveyMonkey テーブルでは、標準的なデータベースでは通常許可されない特殊文字を名前に含めることができます。このプロパティを使用すると、Sync App を従来のデータベースツールでより簡単に使用できるようになります。

UseSimpleNames をTrue に設定すると、返されるカラム名をシンプルにします。表示されるカラム名において、アルファベット文字およびアンダースコアのみを有効とするネーミングスキームを強制します。

Notes：

英数字以外の文字はアンダースコアに置き換えられます。
カラム名やテーブル名が128 文字を超える場合は、SQL Server 標準に準拠するために128文字に切り詰められます。

Third Party Copyrights

LZMA from 7Zip LZMA SDK

LZMA SDK is placed in the public domain.

Anyone is free to copy, modify, publish, use, compile, sell, or distribute the original LZMA SDK code, either in source code form or as a compiled binary, for any purpose, commercial or non-commercial, and by any means.

LZMA2 from XZ SDK

Version 1.9 and older are in the public domain.

Xamarin.Forms

Xamarin SDK

The MIT License (MIT)

Copyright (c) .NET Foundation Contributors

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

NSIS 3.10

Copyright (C) 1999-2025 Contributors THE ACCOMPANYING PROGRAM IS PROVIDED UNDER THE TERMS OF THIS COMMON PUBLIC LICENSE ("AGREEMENT"). ANY USE, REPRODUCTION OR DISTRIBUTION OF THE PROGRAM CONSTITUTES RECIPIENT'S ACCEPTANCE OF THIS AGREEMENT.

1. DEFINITIONS

"Contribution" means:

a) in the case of the initial Contributor, the initial code and documentation distributed under this Agreement, and b) in the case of each subsequent Contributor:

i) changes to the Program, and

ii) additions to the Program;

where such changes and/or additions to the Program originate from and are distributed by that particular Contributor. A Contribution 'originates' from a Contributor if it was added to the Program by such Contributor itself or anyone acting on such Contributor's behalf. Contributions do not include additions to the Program which: (i) are separate modules of software distributed in conjunction with the Program under their own license agreement, and (ii) are not derivative works of the Program.

"Contributor" means any person or entity that distributes the Program.

"Licensed Patents " mean patent claims licensable by a Contributor which are necessarily infringed by the use or sale of its Contribution alone or when combined with the Program.

"Program" means the Contributions distributed in accordance with this Agreement.

"Recipient" means anyone who receives the Program under this Agreement, including all Contributors.

2. GRANT OF RIGHTS

a) Subject to the terms of this Agreement, each Contributor hereby grants Recipient a non-exclusive, worldwide, royalty-free copyright license to reproduce, prepare derivative works of, publicly display, publicly perform, distribute and sublicense the Contribution of such Contributor, if any, and such derivative works, in source code and object code form.

b) Subject to the terms of this Agreement, each Contributor hereby grants Recipient a non-exclusive, worldwide, royalty-free patent license under Licensed Patents to make, use, sell, offer to sell, import and otherwise transfer the Contribution of such Contributor, if any, in source code and object code form. This patent license shall apply to the combination of the Contribution and the Program if, at the time the Contribution is added by the Contributor, such addition of the Contribution causes such combination to be covered by the Licensed Patents. The patent license shall not apply to any other combinations which include the Contribution. No hardware per se is licensed hereunder.

c) Recipient understands that although each Contributor grants the licenses to its Contributions set forth herein, no assurances are provided by any Contributor that the Program does not infringe the patent or other intellectual property rights of any other entity. Each Contributor disclaims any liability to Recipient for claims brought by any other entity based on infringement of intellectual property rights or otherwise. As a condition to exercising the rights and licenses granted hereunder, each Recipient hereby assumes sole responsibility to secure any other intellectual property rights needed, if any. For example, if a third party patent license is required to allow Recipient to distribute the Program, it is Recipient's responsibility to acquire that license before distributing the Program.

d) Each Contributor represents that to its knowledge it has sufficient copyright rights in its Contribution, if any, to grant the copyright license set forth in this Agreement.

3. REQUIREMENTS

A Contributor may choose to distribute the Program in object code form under its own license agreement, provided that:

a) it complies with the terms and conditions of this Agreement; and

b) its license agreement:

i) effectively disclaims on behalf of all Contributors all warranties and conditions, express and implied, including warranties or conditions of title and non-infringement, and implied warranties or conditions of merchantability and fitness for a particular purpose;

ii) effectively excludes on behalf of all Contributors all liability for damages, including direct, indirect, special, incidental and consequential damages, such as lost profits;

iii) states that any provisions which differ from this Agreement are offered by that Contributor alone and not by any other party; and

iv) states that source code for the Program is available from such Contributor, and informs licensees how to obtain it in a reasonable manner on or through a medium customarily used for software exchange.

When the Program is made available in source code form:

a) it must be made available under this Agreement; and

b) a copy of this Agreement must be included with each copy of the Program.

Contributors may not remove or alter any copyright notices contained within the Program.

Each Contributor must identify itself as the originator of its Contribution, if any, in a manner that reasonably allows subsequent Recipients to identify the originator of the Contribution.

4. COMMERCIAL DISTRIBUTION

Commercial distributors of software may accept certain responsibilities with respect to end users, business partners and the like. While this license is intended to facilitate the commercial use of the Program, the Contributor who includes the Program in a commercial product offering should do so in a manner which does not create potential liability for other Contributors. Therefore, if a Contributor includes the Program in a commercial product offering, such Contributor ("Commercial Contributor") hereby agrees to defend and indemnify every other Contributor ("Indemnified Contributor") against any losses, damages and costs (collectively "Losses") arising from claims, lawsuits and other legal actions brought by a third party against the Indemnified Contributor to the extent caused by the acts or omissions of such Commercial Contributor in connection with its distribution of the Program in a commercial product offering. The obligations in this section do not apply to any claims or Losses relating to any actual or alleged intellectual property infringement. In order to qualify, an Indemnified Contributor must: a) promptly notify the Commercial Contributor in writing of such claim, and b) allow the Commercial Contributor to control, and cooperate with the Commercial Contributor in, the defense and any related settlement negotiations. The Indemnified Contributor may participate in any such claim at its own expense.

For example, a Contributor might include the Program in a commercial product offering, Product X. That Contributor is then a Commercial Contributor. If that Commercial Contributor then makes performance claims, or offers warranties related to Product X, those performance claims and warranties are such Commercial Contributor's responsibility alone. Under this section, the Commercial Contributor would have to defend claims against the other Contributors related to those performance claims and warranties, and if a court requires any other Contributor to pay any damages as a result, the Commercial Contributor must pay those damages.

5. NO WARRANTY

EXCEPT AS EXPRESSLY SET FORTH IN THIS AGREEMENT, THE PROGRAM IS PROVIDED ON AN "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED INCLUDING, WITHOUT LIMITATION, ANY WARRANTIES OR CONDITIONS OF TITLE, NON-INFRINGEMENT, MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. Each Recipient is solely responsible for determining the appropriateness of using and distributing the Program and assumes all risks associated with its exercise of rights under this Agreement, including but not limited to the risks and costs of program errors, compliance with applicable laws, damage to or loss of data, programs or equipment, and unavailability or interruption of operations.

6. DISCLAIMER OF LIABILITY

EXCEPT AS EXPRESSLY SET FORTH IN THIS AGREEMENT, NEITHER RECIPIENT NOR ANY CONTRIBUTORS SHALL HAVE ANY LIABILITY FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING WITHOUT LIMITATION LOST PROFITS), HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OR DISTRIBUTION OF THE PROGRAM OR THE EXERCISE OF ANY RIGHTS GRANTED HEREUNDER, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.

7. GENERAL

If any provision of this Agreement is invalid or unenforceable under applicable law, it shall not affect the validity or enforceability of the remainder of the terms of this Agreement, and without further action by the parties hereto, such provision shall be reformed to the minimum extent necessary to make such provision valid and enforceable.

If Recipient institutes patent litigation against a Contributor with respect to a patent applicable to software (including a cross-claim or counterclaim in a lawsuit), then any patent licenses granted by that Contributor to such Recipient under this Agreement shall terminate as of the date such litigation is filed. In addition, if Recipient institutes patent litigation against any entity (including a cross-claim or counterclaim in a lawsuit) alleging that the Program itself (excluding combinations of the Program with other software or hardware) infringes such Recipient's patent(s), then such Recipient's rights granted under Section 2(b) shall terminate as of the date such litigation is filed.

All Recipient's rights under this Agreement shall terminate if it fails to comply with any of the material terms or conditions of this Agreement and does not cure such failure in a reasonable period of time after becoming aware of such noncompliance. If all Recipient's rights under this Agreement terminate, Recipient agrees to cease use and distribution of the Program as soon as reasonably practicable. However, Recipient's obligations under this Agreement and any licenses granted by Recipient relating to the Program shall continue and survive.

Everyone is permitted to copy and distribute copies of this Agreement, but in order to avoid inconsistency the Agreement is copyrighted and may only be modified in the following manner. The Agreement Steward reserves the right to publish new versions (including revisions) of this Agreement from time to time. No one other than the Agreement Steward has the right to modify this Agreement. IBM is the initial Agreement Steward. IBM may assign the responsibility to serve as the Agreement Steward to a suitable separate entity. Each new version of the Agreement will be given a distinguishing version number. The Program (including Contributions) may always be distributed subject to the version of the Agreement under which it was received. In addition, after a new version of the Agreement is published, Contributor may elect to distribute the Program (including its Contributions) under the new version. Except as expressly stated in Sections 2(a) and 2(b) above, Recipient receives no rights or licenses to the intellectual property of any Contributor under this Agreement, whether expressly, by implication, estoppel or otherwise. All rights in the Program not expressly granted under this Agreement are reserved.

This Agreement is governed by the laws of the State of New York and the intellectual property laws of the United States of America. No party to this Agreement will bring a legal action under this Agreement more than one year after the cause of action arose. Each party waives its rights to a jury trial in any resulting litigation.

SurveyMonkey Connector for CData Sync

SurveyMonkey Connector for CData Sync

概要

SurveyMonkey バージョンサポート

接続の確立

SurveyMonkey への接続を追加

SurveyMonkey への接続

SurveyMonkey への認証

Basic 認証

OAuth 認証

SurveyMonkey のアンケートからの選択

Creating Surveys

Selecting Responses from Your Survey

Selecting Questions from Your Survey

高度な機能

ユーザー定義ビュー

SSL の設定

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

クエリ処理

ログ

SSL の設定

SSL 設定のカスタマイズ

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

Firewall またはProxy 経由の接続

HTTP プロキシ

その他のプロキシ

データモデル

クエリ処理の使用

フィルタリングの制限

ビュー

ストアドプロシージャ

テーブル

SurveyMonkey Connector for CData Sync テーブル

CollectorDetails

Columns

CollectorMessageDetails

Columns

CollectorRecipientDetails

Table Specific Information

Select

Columns

Collectors

Table Specific Information

Select

Columns

SurveyDetails

Columns

Surveys

Columns

ビュー

SurveyMonkey Connector for CData Sync ビュー

CollectorMessages

Table Specific Information

Select

Columns

CollectorRecipients

Table Specific Information

Select

Columns

CollectorStats

Table Specific Information

Select

Columns

ContactLists

Select

Columns

Contacts

Select

Columns

Pages

Table Specific Information

Select

Columns

RollupQuestions

Select

Columns

Rollups

Table Specific Information

Select

Columns