Sample management properties
The SampleManagements collection contains properties related to sample management objects on the server. Each project that uses sample management has its own sample management object.
StatisticsSync
This property can be defined at the top level of a project’s sample management property collection. If set to 1, it forces the dialing provider to reload the MaxPredictiveSilentCalls property that controls the provision of autodialing on a project.
DialingPredictSync
This property can be defined at the top level of a project’s sample management property collection. If set to a nonzero value, it forces a reload of the properties defined in the DialingPredict property collection. This is primarily designed for implementing changes to the predictive dialing script while interviewing is taking place.
Queueing
This property collection stores properties related to the movement of sample records between queues.
The Queueing.QueuesScript property holds the sample management script for the project.
Properties in the Queueing.Queues.Properties
Properties in the Queueing.Queues.Properties collection define parameters for connecting to the queues of participant records in the sample table:
AUTH_INTEGRATED
Whether to log in to SQL Server using Windows or SQL Server authentication. Set to SSPI indicating Windows authentication.
AUTH_PASSWORD
The SQL Server login password. Blank for Windows authentication.
AUTH_PERSIST_SENSITIVE_AUTHINFO
Whether the data source object is allowed to persist sensitive authorization information. Set to 0 so sensitive information is not persisted.
AUTH_USERID
The SQL Server user ID to log in with. Blank for Windows authentication.
AuthenticationFields
The names of the sample management authentication fields.
FieldColumns
The names of the fields in the participant records. Defaults to fields named in the server-level DefaultSampleManagementFields property. Users can view these fields on the Required Columns tabRequired Columns tabRequired Columns tab in the Participants activity.
HistoryTable
The name of the sample management history table.
INIT_CATALOG
The name of the database to connect to; that is, the one that holds the sample table.
INIT_DATASOURCE
The network name of the server on which the database is located.
INIT_LOCATION
This property is not supported by SQL Server so is always blank.
INIT_PROMPT
How to prompt for datasource initialization. Always 4.
PredefinedQueues
The names of the queues that sample management can expect to be available for the project. The list is taken from the server-level WebPredefinedQueues or CATIPredefinedQueues property depending on whether this is an inbound or outbound project. For more information, see
Queues.
PrimaryKeyCheck
Whether to check the primary key in each record (1=check, 0=do not check).
Provider
The name of the database provider to use for connecting to the database.
ReadOnlyFieldColumns
Columns in the sample table that must not be updated by sample management. For more information, see
Using an existing database as a sample database.
Table
The name of the sample table.
TableOwner
The name of the user who owns the table. This is normally [dbo] which represents the database owner.
In telephone interviewing projects, Queueing.SampleRecordReturnCodes stores information about sample record return codes for the current project, and is based on the server-level DefaultCatiSampleRecReturnCodes collection. See the topic for more information. This property is empty for inbound projects.
Properties in the Queueing.CATIParameters collection store information related the scheduling of calls to prospective participants. It is based on the server-level DefaultCatiParameters collection. The CATIParameters collection is empty in inbound projects. If the project uses an autodialer, this collection might contain additional properties related to predictive dialing. For more information, see
CATI parameters for autodialing.
DialerCallOutcomes
Exists only in telephone interviewing projects and stores details of the dialer's call result codes. It is based on the server-level DefaultDialerCallOutcomes collection.
DialingPredict
This property collection is created from the site-level DefaultDialingPredict property collection and contains information specific to dialing using the current sample management object.
See also
See also
