Developer Documentation Library > Interviewer - Server Admin > UNICOM Intelligence Interviewer - Server Admin architecture > Distributed Property Management (DPM) > Site properties
 
Site properties
Site properties specify settings that apply to your whole site. You can change their values using DPM Explorer.
Properties
AbandonedTaskInterval
Abandons an email job when the LastKeepAliveTime has not been updated in the last AbandonedTaskInterval (in minutes). The object model automatically sends another batch at the NextDueTime. The default value is 60 (minutes).
ActivateSubFoldersExcludeList
The names of subfolders that the activation process will ignore when asked to copy subfolders. The defaults are CacheDir, Logs, and Temp.
ActiveSessionDataExpiresInHours
The number of hours that an activity's record should remain in the session file before being moved to the history file. The default is one hour. For more information, see UNICOM Intelligence Interviewer - Server Admin audit trail.
AllowAddRecordsInInterviewer
Controls whether or not interviewers are prompted to ask contacts for permission to record interviews. The default value is True.
ApplicationLoadBalancing
When set to True, UNICOM Intelligence Interviewer - Server Admin load balancing is enabled for the entire site. The MultiInstance property continues to be used to setup application specific load balancing. The default setting is True, which is also the case when the property is not set.
When the InterviewBuilder application’s MultiInstance property is set to True, load balancing for InterviewBuilder is enabled. When the ManageFiles application's MultiInstance property is set to False, load balancing for ManageFiles is disabled.
ApplicationLoadScript
Performs the same function as the ApplicationSettings element, except the settings are applied at the site level.
The ApplicationSettings element’s LoadingScript property can be set to override the ApplicationLoadingScript property for a specific Interviewer Server Administration activity. For more information about the LoadingScript property, see Load balancing.
ApplicationTimeout
Sets each application’s timeout value. The default value is 5000 milliseconds, which is also the case when the property is not set.
The ApplicationSettings element's Timeout property can be set to effectively override the ApplicationTimeout property. For more information about the Timeout property, see Load balancing.
BlockedScriptMethods
A list of methods that can not be used in the routing script or sample management script. Separate the methods by using semi‑colons.
These methods cannot be executed; if a script tries to use them, they write an error message in the IVW log file. Activation fails, with an error message in the ACT log file.
These methods are also blocked in participant rules. If they are added, you cannot save the script.
Example: “LoginAsTrustedWindowsAccount”
The default value is empty.
Brad_Backups_UNC
The UNC pathname of the folder to use for backing up project folders.
The default value is \\ServerName\SPSSMR_FMROOT\Shared\Backups
Brad_Script_Delete
The script to run when a user deletes a project from UNICOM Intelligence Interviewer - Server Admin.
CacheAceProvider
Controls creation of a dummy connection to the CacheAceProvider.mdb file that is in the following folder:
[InstallFolder]\IBM\SPSS\DataCollection\7\Interviewer Server\Server
This connection is created and held open when the interviewer session engine starts. It prevents the ACE OLE DB provider from unloading while the session engine is running. This works around an issue in the ACE OLE DB provider where a crash can occur if the provider is unloaded.
The default value is True.
CAPIDefaultDisplayFields
By default, the name of the personal project fields that can be displayed in UNICOM Intelligence Interviewer - Offline for Windows.
CAPIDefaultEditableFields
By default, the name of the personal project fields that can be edited in UNICOM Intelligence Interviewer - Offline for Windows.
CAPISMFieldsRequired
The fields that must be present in participant records for personal interviewing projects.
CatiActiveSessionDataExpiresInHours
The number of hours that an activity’s record stays in the CatiInterviewSession, CatiInterviewerSession, or CatiSupervisorSession table before it moves to the appropriate history table. For more information, see UNICOM Intelligence Interviewer - Server Admin audit trail.
The default value is one hour.
CATIDefaultDisplayFields
List of the phone project fields that can be displayed in Phone Participants. This is the default for new projects.
The default value is “Id,PhoneNumber,Comments,PreviousQueue”.
CATIDefaultEditibleFields
List of the phone project fields that can be edited in Phone Participants.
The default value is “Comments”.
CATIPredefinedQueues
The names of the predefined queues for telephone interviewing projects. For more information, see UNICOM Intelligence Interviewer - Server Admin audit trail.
CatiSessionDatabaseName
The name of the database that contains the CATI session tables. For more information, see UNICOM Intelligence Interviewer - Server Admin audit trail.
The default value is mrUserData.
CatiSessionDatabaseServer
The name of the database server. For more information, see UNICOM Intelligence Interviewer - Server Admin audit trail.
The default server is the one that stores the mrUserData database.
CatiSessionHistoryDataExpiresInDays
The number of days that CATI session records can remain in a history table.
CATISMFieldsReqd
The fields that must be present in participant records for telephone projects.
DefaultCAPICanTabulateFields
The name of the personal project fields that can be tabulated in the Interviewer Server Report activity (by default).
DefaultCATICanTabulateFields
The name of the telephone project fields that can be tabulated in the Interviewer Server Report activity (by default).
DefaultWebCanTabulateFields
The name of the sample management project fields that can be tabulated in the Interviewer Server Report activity (by default).
DimensionNetUploadFolder
The name of the folder into which temporary files might be loaded by applications that have to upload files locally (a typical example is the Dialer Administration activity that needs a temporary location for the .xsl configuration file).
The default is c:\InetPub\wwwroot\SPSSMR\Temp.
DimensionsInterviewURL
The URL for starting UNICOM Intelligence interviews.
DimensionsScriptsSupported
True if UNICOM Intelligence interview scripts are supported, otherwise False.
DisableSingleResponseAutoJump
Suppresses automatic jump to next question when a single-choice answer is selected (the user must select an answer and then press Enter).
EmailAccount
The user name that is used to send emails, when authentication is required.
EmailDeliveryMethod
Defines the email delivery method. Valid values are 0 (network delivery) and 1 (specified pickup directory). When the value is set as 1, the property uses the directory that is defined for the EmailPickupDirectory property. The default value is 0. The property applies to both Send now and Schedule email tasks.
EmailPassword
The password that is used to send emails, when authentication is required.
EmailPickupDirectory
Specifies a directory to store emails for the pickup delivery method (EmailDeliveryMethod). The property applies to both Send now and Schedule email tasks.
EmailServerName
The name of the server that the Email activity uses for sending messages.
EmailServerPort
The port on the email server to be used for sending messages. The default is port 25.
EmailUseSSL
Controls whether SSL is used when sending email (true or false).
EmailValidationExpression
The expression string used for email validation. When the value is missing, email addresses are not validated and a warning log is written. The default value is *@-.-.
EncryptionAlgorithm
The algorithm to encrypt users’ passwords:
1: MD5 encryption
2: SHA-2 encryption
3: SHA-2
The default value is 3.
FileManagerWebServiceAllowedActivities
This property controls which activities can access the FileManagerWebService. A user’s access to the File Manager Web Service is based on the activities that they have access to in the FileManagerWebServiceAllowedActivities list and the FileAccess and FileAccessType restrictions for those activities.
Specify a list. Put the list in double quotation marks. Separate the items by using a comma.
For example, if a user has access to only Reporter, the following value gives them read/write access to MTD files:
FileManagerWebServiceAllowedActivities = "Activation,Author,ManageFiles,Reporter,CatiInterview,ReviewInterview"
If you try to access file types that you do not have permission to access, the following message appears:
No permission to File Manager Web Service
The default value is empty, which means no restrictions.
FileManagerWebServiceUrl
The URL of the FileManagerWebService.
For more information, see “File Manager Web Service Component” in the UNICOM Intelligence Developer Documentation Library.
FileMgt_RootFolderLocalPath
The local path to FMRoot.
FileMgt_RootFolderUNC
The UNC path of the FMRoot folder.
FMRootFilesToBeCopied
Files that can be activated into FMRoot’s top-level folder. This applies only when a custom Activate document names FMRoot as the destination folder. The default value is .mdd files only.
GenerateCrossProjectViews
Determines whether the cross project view is generated during activation for a CATI project, or a CAPI with sample project. When set to false, cross project views are not generated during activation. The default value is true.
InstanceRetryTimeout
The expiry time for unavailable instances for the application instance balancer on accessory servers.
>0: The expiry time (in minutes) for unavailable instances. The instances are not be retried until the expiry time is reached.
0: All instances are retried, including unavailable instances.
For instances that are been marked as unavailable, 0 does not allow the instances to be retried until the expiry time is reached, or IIS is reset.
InterviewCacheUNC
The UNC path to the image cache. For more information, see Image/template cache.
InterviewConfigFile
The path and name of the configuration file that controls access to sample management scripts during activation. For more information, see Controlling access to sample management scripts.
The default value is FMRoot\Shared\Config\Interview.Config.xml in the UNICOM Intelligence Interviewer - Server Admin installation folder.
InterviewRespondentFilesFolderUNC
The folder in which files collected during personal interviewing, such as audio and images, are stored in project based subfolders of the project in this folder, specifically \<ProjectName>\__RespondentFiles and then in either an Audio or Image subfolder. For more information about respondent files, see Respondent files.
The default is value is <FMRoot>\Shared\Projects.
InterviewerSyncSessionDataExpiresInDays
How long (number of days) session data is available in UNICOM Intelligence Interviewer - Remote Admin.
The default value is 31.
IVFilesToBeCopied
The file types to be copied when a UNICOM Intelligence project is activated.
IVProjectFilesToBeCopied
Files that can be activated into the Project folder on each of the interviewing servers.
The default is only .mdd files.
IVSMFieldsReqd
The names of the fields required for activation with sample management.
MinimumRingTime
The minimum number of seconds that the phone must ring before a call can be disconnected.
MonitoringApprovalDefaultOption
The default interview recording value. The default value is 0.
0: No default value. Interviewers must select a value.
1: Agree
2: Disagree
mrInterviewReportFilters
The common reporting periods for all users when there are no existing reporting periods.
Name
The site name.
ParticipantsDefaultDisplay
The fields to display on the View tab in the Participants activity. The system defaults are Id, Queue, RecallTime, AppointmentTime, TryCount, AppointmentTryCount, TimeZone, and CallOutcome.
There is no requirement for all fields to be present in a project's sample file, so this list works equally well for Web and telephone interviewing projects.
PercentContactsRecorded
The percentage of surveys that will be recorded. The default value is 0.
PopulateWarning
The table size in Survey Reporter Server Edition. When Survey Reporter Server Edition starts, the TabulationWebService reads the DPM PopulateWarning limit (the default value is 10,000 cells) and passes the value to the application.
When tables are populated in Survey Reporter Server Edition, the total number of cells is calculated. If the cell limit (as defined by PopulateWarning) is reached, the following message appears:
This table, or set of tables, is very large and will take a long time to populate. You can shorten the population time by reducing the number of tables, or reduce the size of individual tables by removing variables, elements, or levels of nesting.
Choose Cancel to edit the tables, or OK to start the long population interval.
PrimaryDPM
The name of the primary DPM server.
ProjectRoleAssignmentFilter
A regular expression that filters the roles available for assignment in Activate, Project Editor, and Promote Project.
The default value is no filter, which displays all roles.
QCFilesToBeCopied
Obsolete.
QuotaCompletesDataFilter
The SQL WHERE clause that calculates the completed data records. It is used by the “Calculate completes for new quota cells based on existing data” feature. If you want change how completed data records are calculated, you can change this WHERE clause.
The default clause is:
"DataCollection.Status =* {Completed} AND NOT (DataCollection.Status =* {Test})"
QuotaCompletesSampleFilter
The SQL WHERE clause that calculates the completed sample records. It is used by the “Calculate completes for new quota cells based on existing data” feature. If you want change how completed sample records are calculated, you can change this WHERE clause.
The default clause is:
Queue = N'COMPLETED'
RecordInterviewOnly
Indicates whether the recording is started when the sample is retrieved or after the survey starts.
False: Recording starts when the sample is retrieved.
True: Recording starts when the interview starts.
SampleMgtConfigFile
The pathname of the sample management configuration file. For more information, see Controlling access to sample data.
The default is FMRoot\Shared\Config\SampleMgtGUI.Config.xml in the UNICOM Intelligence Interviewer - Server Admin installation folder.
SessionDatabaseName
The database containing the session tables. For more information, see UNICOM Intelligence Interviewer - Server Admin audit trail.
The default database is mrUserData.
SessionDatabaseServer
The database server. For more information, see UNICOM Intelligence Interviewer - Server Admin audit trail.
The default is the one that stores the mrUserData database.
SyncRejectFolder
When UNICOM Intelligence Interviewer uploads data by using the synchronization web service, and finds data in conflict, the web service rejects the data, and then puts it in this path. To view rejected synchronization data, see Viewing rejected synchronization data.
The default value is FMRoot\Shared\SyncReject.
SessionHistoryDataExpiresInDays
The number of days that records can remain in a history table. For more information, see UNICOM Intelligence Interviewer - Server Admin audit trail.
TaskTableUpdateFrequency
The interval (in minutes) at which the scheduling tables are updated. This includes updating the SendEmailHistory table with the latest SuccessfulEmailCount/FailedEmailCount, and updating the ScheduleTask.LastKeepAliveTime.
TrackWebSessions
Controls whether the interview session token is tracked in the DataCollection.InterviewerID system variable. This prevents multiple sessions from being started concurrently against the same respondent ID.
1: The interview sessions token is written to DataCollection.InterviewerID.
0: The interview sessions token is not written to DataCollection.InterviewerID.
Unsafe_Script_Functions
List of functions that are prohibited in .mdd files if the web deployed Author user or activate user does not have the “Can edit restricted script” or “Can activate restricted script” access control feature respectively. For more information, see Activities.
The default value is “CreateObject,ShellExecute,GetInterface,Execute,Eval,InputBox,MsgBox”.
ValidateHTMLTemplates
Controls whether the HTML template is validated during project activation.
True: The HTML template is validated during project activation.
False: The HTML template is not validated during project activation.
WebPredefinedQueues
The names of the predefined queues for inbound calling projects. For more information, see Queues.
See also
Database properties
Property collections at the site level
Server properties
Project properties
Sample management properties
DPM Explorer
See also
Distributed Property Management (DPM)