Web service configuration
The Web.config file for the Web Service is in:
[INSTALL_FOLDER]\IBM\SPSS\DataCollection\<version>\Interviewer Server\Server\mrIWeb
Settings
AllowXHTMLParameters
False: All URL parameters and the fields of the authentication page are checked to see if they contain any HTML markup or script. If any HTML is found, it is escaped, so that the markup displays as text if it is ever redisplayed in an HTML page.
True: The URL parameters and the fields of the authentication page are not checked; they might contain XHTML.
Default: False
BrowserCapabilities
When enabled, instructs the Web service to generate and pass the BrowserCapabilities string to the Interview Tier.
When disabled, instructs the Web service to not generate and pass the BrowserCapabilities string to the Interview Tier.
Default: Enabled
CreateInterviewWithAuthenticationTimeout90
The number of seconds to wait before calling the CreateInterviewWithAuthentication web service for an active session engine
Default: ""
Doctype
The HTML Doctype to use in the rendered HTML page. If a Doctype is not specified, the XHTML (Transitional) Doctype is used. The default Doctype when rendering the HTML page is:
<!Doctype html
PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
To define a custom Doctype, you can replace the special characters with HTML entity codes. For example, you can change the default Doctype in the Web.config file to:
<!Doctype html
PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
Default: ""
EngineMaxRetries
The maximum number of retries before an interviewer session engine is considered unavailable.
Default: 6
EngineRetryTimeout
The number of minutes to wait before retrying a failed interviewer session engine. Retries are not attempted if there is no activity on the cluster.
Default: 5
HTMLOptions
One or more of the following HTML options for the rendered HTML. Multiple options can be specified using a comma-delimited list.
ApplySubTemplatesInGrids: Enables and disables the effects of sub-templates in grid and loop questions.
ApplySubTemplatesInNestedBlocks: Question sub-templates are applied to questions in nested blocks.
NoExpiryMetaTags: Exclude the following meta tags from the rendered HTML:
<meta http-equiv="Expires" content="-1"/>
<meta http-equiv="Pragma" content="no-cache"/>
WebTVSupport: Make the rendered HTML compatible with WebTV browsers.
NoAutoJump: suppress automatic jump to next question when a single-choice answer is selected (the user must select an answer and then press Enter).
UseGlobalTemplates: Whether to search for templates from the global location before checking the project location. The default value is False.
UsePredefinedKeyCodes: Use predefined key codes for CATI Player questions.
UseTablesLayout: Use table layout for single row/column category lists. This setting effectively reverts HTML rendering to pre-UNICOM Intelligence 6 behavior.
ImageLocation
The relative path to the folder from which images should be retrieved if the image cache is not being used (UseImageCache is False; see below).
Default: Images
ImageCacheURL
The URL for the image cache. This setting is used only if the image cache is used (UseImageCache is True; see below). The settings support both full and relative URLs.
Full URL:
<appSettings>
<add key="ImageCacheURL" value="http://WebServer/SPSSMR/ImageCache/ImageCache.aspx"/>
</appSettings>
Relative URL:
<appSettings>
<add key="ImageCacheURL" value="../ImageCache/ImageCache.aspx" />
</appSettings>
Default: The default is based on the incoming URL. This is useful in scenarios where local testing requires http and a local server name while external use requires https and a domain‑based name. The default is:
%1/SPSSMR/ImageCache/ImageCache.aspx
The substitution is based on the incoming URL. The incoming URL is used to specify http or https; the server identification; and a port number, if required.
InterviewReview
This setting has been deprecated in lieu of the Review Interviews activity.
Determines whether interviews may be reviewed (specifically, enables or disables the use of the Review and Serial parameters):
Enabled: Completed interviews may be reviewed.
Disabled: Completed interviews may not be reviewed.
Default: Disabled
IsActiveFailedEngineTimeout
The number of seconds to wait before calling the IsActive web service for a failed session engine.
Default: 2
IsActiveTimeout
The number of seconds to wait before calling the IsActive web service for a registered session engine.
Default: 3
LocalImageCacheURL
The local URL for the image cache. Used if the server and client use different URLs to access the image cache.
Default: ImageCacheURL setting
Mode
The UNICOM Intelligence Interviewer Web configuration for running interviews:
SingleServer: The session engine is created in-process to IIS. The session engine registration web service is not available.
Distributed: The web and interview tiers are distributed. This is the required setting for telephone interviewing.
If the Web and Interviewing tiers are running on a single server and you are not running telephone interviews, performance may be better if you use SingleServer mode.
Default: Distributed
PageExpiryTimeout
Specifies the number of minutes until the page expires. The default value of -1 indicates that the page will expire immediately and that a no-cache pragma will be added. If set to any other value, the Expires and Pragma: no-cache metadata tags are not added to the HTML page, and an appropriate Expires header value is added to the HTTP response.
The PageExpiryTimeout value should normally be set to-1, and the NoExpiryMetaTags HTML option should not be used. Interview pages are dynamically generated and the settings prevent HTTP proxies from attempting to cache interview pages. However, when the HTTPS protocol is used, HTTP proxies do not cache responses. Browsers will also not cache responses when no-cache and expires=-1 are specified. Defining PageExpiryTimeout adds an Expires header to the response, which allows the browser to cache pages for a limited length of time. This caching activity allows respondents to use the forward and back browser navigation features (the HTTP proxy will not cache because the HTTP protocol is used).
Default: -1
PercentLoadedTimeout
The number of seconds to wait before calling the PercentLoaded web service for an active session engine.
Default: 5
PostInterviewEventTimeout
The number of seconds to wait before calling the PostInterviewEvent web service for an active session engine.
Default: 60
RegisteredEngines
Names interviewer session engines for automatic reregistration whenever the Interviewing Service starts. Names must be enclosed in single quotation marks and separated with commas. See
Session engine registration for more information.
Default: ""
RegistrationPW
The password used to register session engines with mrInterviewWeb.
Default: mrIWeb
RegistrationWS
Enables or disables the session engine registration web service:
Enabled: The web service is enabled.
Disabled: The web service is disabled.
Default: Enabled
TemplateLocation
The relative path from which templates should be retrieved if the image cache is not being used (UseImageCache is False; see below).
Default: Templates
UseImageCache
Whether to use the image cache when loading project specific templates.
True or 1: Use the image cache.
False or 0: Use the local file system.
The image cache is used only to specify the project template/image locations. If a project-specific template cannot be found, the default template location is used. If the image cache is not used, the project template location is specified as TemplateLocation\ProjectName
The default image cache setting can be overridden on a project by project basis in DPM.
The image cache is not used in a single computer configuration.
Default: True
X-Frame-Options
This custom header prevents the UNICOM Intelligence application HTML code from being encapsulated within a frame-set. Websites that are vulnerable to being encapsulated in a frame-set are susceptible to a variety of vulnerabilities including but not limited to cross-frame scripting, and user interface redress attack.
Use one of the following methods configure the setting:
▪Add the following <customHeaders> section to the mrIWeb web.configfile:
<httpProtocol>
<customHeaders>
<add name="X-Frame-Options" value="deny" />
</customHeaders>
</httpProtocol>
The value options are:
deny: The page cannot be displayed in a frame, regardless of the site attempting to do so.
sameorigin: The page can only be displayed in a frame on the same origin as the page itself. sameorigin is the recommended value.
allow-from uri: The page can only be displayed in a frame on the specified origin.
▪Change the setting's value to deny in Microsoft Internet Services (IIS) under: [Your_Server_Name] > Sites > mriWeb > HTTP Response Headers > X-Frame-Options
Default: The is no default value, which means that rendering is allowed within frames.
Notes
▪The Web Service reads Web.config from the installed folder only. The hierarchical configuration architecture of ASP.NET is not implemented.
▪Some special characters have a different meaning when used in XML. To avoid mistakes, use the following entity references to replace the special characters in the Web.config file:
Entity reference
|
Special character
|
Description
|
<
|
<
|
Less than
|
>
|
>
|
Greater than
|
&
|
&
|
Ampersand
|
'
|
'
|
Apostrophe
|
"
|
"
|
Quotation mark
|
See also