SysConfig
Purpose
Specifies the setting of an InForm configuration variable.
Syntax
<SYSCONFIG
CONFIGNAME="name"
TYPE="0"
VALUE="text" />
Attributes
CONFIGNAME="name"
Name of the configuration variable. Required.
The InForm application has the following configuration variables:
- AllowPasswordReuse—1 (yes) or 0 (no), indicating whether users can change to a previously used password when performing password updates. The default is 1.
- AllowedRuleObjects—Specifies the scripting objects that can be called by a user-defined rule or execution plan. The default objects are CDO.Message and CDONTS.NewMail.
Note: You must change the HKEY_LOCAL_MACHINE\SOFTWARE\OracleHS\InForm\WhiteListScriptObjects registry key to 0 (zero) before you can update the allowed rules object list. Before modifying the list of allowed rule objects, contact Oracle Global Support for assistance.
- AutoAnswerManualQueries—1 (on) or 0 (off), indicating whether the InForm application automatically answers a manual query when a data item change satisfies the rules on the data item. The default is 1.
- CookServer—Name of the server used for installing MedML metadata definitions.
- DaysPasswordExpiration—Number of days that can pass before the InForm software requires users to change their passwords. The default is 30.
- EnableForgotPassword—1 (yes) or 0 (no), indicating whether to enable the feature that lets users request a password reset if they have forgotten their password. The default is 1.
- EmailForForgotPasswordNotification—The email address of an administrator who receives notification when a user requests a password reset.
- EmailForNewSiteAndUserNotification—The email address of an administrator who receives notification when a new site or new user is added.
- EnforceVisitDate—1 (yes) or 0 (no), indicating whether to require the use of Date of Visit on the first form of every visit. The default is 0. Read only.
- EnrollWithIncompleteForms—1 (yes) or 0 (no), indicating whether the InForm application permits a subject to be enrolled with incomplete screening or enrollment information, after override authorization. The default is 0.
- ExePlanServer—The name of the server(s) defined as the server(s) on which execution plans run.
- FORMSAVEMODE—The location and format of the "Form submitted successfully" message.
- Inline: message displays in the header of the form.
- Popup: message displays as a pop-up. User must click OK in order to proceed. Default.
- FreeCommentTextBox—1 (yes) or 0 (no), indicating whether to enable a text box where users can enter a comment for a form or item.
Tips:
- If you select 1 for RequireCommentForNA, you can't select 0 for FreeCommentTextBox, and vice versa.
- If you select 0 for FreeCommentTextBox, existing comments appear as read-only text, and the option to select Not Applicable, Unknown, or Not Done in the Reason incomplete field is available only for new items.
- InactivateRetryCount—Number of failed login attempts to allow before inactivating the user account. The default is 3.
- INLINEDURATION—1-9, Specifies the number of seconds that the 'Form submitted successfully" message remains visible in the header of the form before it fades. Applies when FORMSAVEMODE is set to Inline.
- MaxNumOfResubmissions—Maximum number of times to retry submission of a failed execution plan before it is logged as an error in the event log and removed from the queue of execution plans to be run. The default is 2.
- MinPasswordLength—Minimum number of characters required for passwords. The default is 6.
- MinutesReauthenticate—Number of minutes of inactivity that can pass before the InForm software requires a user to log in again. The default is 5.
- MinutesReIdentification—Number of minutes that a session can be active before the InForm software requires a user to log in again. The default is 120.
- NavigationMode—1 (enable) or 0 (disable), indicating whether to allow use of the subject ordering feature. When enabled, users who have the Reordering Of Subjects right can change the order of subjects as displayed in the InForm user interface. The default is 0.
- NumOfExePlanListenThreads—Number of threads running in the background to process pending execution plans. The default is 4; at least 1 is required for any execution plans to run.
- NumOfWFUpdateThreads—Number of threads running in the background to process the workflow update. This value is set during study setup, and typically only needs to be set one time per study. The default is 2.
Caution: You should not adjust this setting without input from Oracle Global Support. If the performance of your study deployment or study migration is too slow (for example, timeouts happen), contact Oracle Global Support for assistance.
- OneNonAlphaNumericCharacter—1 (yes) or 0 (no), indicating whether passwords must include at least one special character. The default is 0.
- OneNumericalCharacter—1 (yes) or 0 (no), indicating whether passwords must include at least one numeric character. The default is 0.
- OneUppercaseCharacter—1 (yes) or 0 (no), indicating whether passwords must include at least one uppercase character. The default is 0.
- PatientSequence—Format for assigning subject numbers. Read only.
- PostQueryForConflictResolution—1 (yes) or 0 (no), indicating whether to create a query when during synchronization data is found to be entered into a data item by two different servers. The default is 1.
- QueryMaxLength—Maximum number of characters of query text displayed below an item on a CRF. The default is 350.
- QUERYSELECTION—Specifies whether queries are created in Opened or Candidate state.
- RandCentralStratified—Sequence number format for Central Stratified randomization schemes (multiple drug kit lists, patient assigned a drug kit based on stratification criteria).
- RandomizationSrc—Name of the randomization source manager (COM object) that accesses the default randomization source database. The default name is "Inform.PFRandomization.1." Read only.
- RandSimpleCentral—Sequence number format for Simple Central randomization schemes (one central drug kit list from which numbers are assigned sequentially). Read only.
- RandSimpleCentralSRC—Name of the randomization source manager (COM object) that accesses the randomization source database for Simple Central randomization schemes. Read only.
- RandSimpleSite—Sequence number format for Simple Site randomization schemes (drug kit list for each site, patient assigned sequentially to drug kit on list for their site). Read only.
- RandSimpleSiteSRC—Name of the randomization source manager (COM object) that accesses the Simple Site randomization source database. Read only.
- RandStratifiedBySite—Sequence number format for Site Stratification randomization schemes (multiple drug kit lists for each site, patient assigned a drug kit based on site and stratification criteria). Read only.
- RandStratifiedBySiteSRC—Name of the randomization source manager (COM object) that accesses the Site Stratification randomization source database. Read only.
- REPORTINGINTERNALURI—Cognos parameter that is set when running the CRNConfig installer. It is an internal URI that the InForm server uses to communicate to the Cognos server. The information can be found in cogstartup.xml. Example: http://appsru02.north.pf.com:9300/p2pd/servlet/dispatch.
- REPORTINGSERVER—The URL for the Cognos Web service.
- REPORTINGAUTHENTICATIONNAMESPACE—The LDAP namespace that is used to authenticate InForm users on the reporting server.
- REPORTINGUSERROOT—The top-level reporting folder for the company. Use this field only if you are hosting several companies on one reporting server and have set up reporting folders for each company. Leave this field blank if you are not hosting studies for different companies, or if you have not set up separate reporting folders for each company.
- RequireCommentForNA—1 (yes) or 0 (no), indicating whether InForm requires a user to enter a comment when entering Not Applicable, Unknown, or Not Done in response to a question on a form. The default is 0.
- ScreeningSequence—Sequence number format for assigning screening numbers. Read only.
- SponsorEditFrozen—1 (yes) or 0 (no), indicating whether sponsors can edit a form after it has been marked as frozen. The default is 0.
- ShowUnscheduled—1 (yes) or 0 (no), indicating whether to show the word Unscheduled in the visit title of unscheduled visits.
- SSLFlag—1 (on) or 0 (off), indicating whether Secure Socket Layer is enabled to provide encryption of data. The default is 1.
Note: Before this option can take effect, you must stop and restart the study.
- SVFIRSTNSUBJECTS—The number of subjects to source verify in order, based on the time when the subject is assigned the status Enrolled. For example, to indicate that you must source verify the first seven subjects enrolled in a study, specify SVFIRSTNSUBJECTS=7. The default value is defined in Central Designer. This can’t be less than zero (0). If the system does not contain a SVFIRSTNSUBJECTS setting, the default value will be zero (0).
Note: This is also a Site property. A user with the Change Site SV Settings right can change the value at Site level. When a new system level First N is applied through deployment, InForm compares the value of each site with the current system value. If the three SV setting attributes (SVAUTOSELECTRATE, SVFIRSTNSUBJECTS, and SVDEFAULTINCLUDE) match the current system value, they will all be updated if new values are updated or deployed. If one of the attributes is different than the current system value, none will be updated.
- SVAUTOSELECTRATE—The auto select percentage of the subjects to be included in Partial SV. The default value is defined in Central Designer. The value must be in the range of 0 to 100. If the system does not contain a SVAUTOSELECTRATE setting, the default value will be one hundred (100).
Note: The auto select percentage is also a Site property. A user with the Change Site SV Settings right can change the value at the Site level. When a new system level percentage is applied through deployment, InForm compares the value of each site with the current system value. If the three SV setting attributes (SVAUTOSELECTRATE, SVFIRSTNSUBJECTS, and SVDEFAULTINCLUDE) match the current system value, they will all be updated if new values are updated or deployed. If one of the attributes is different than the current system value, none will be updated.
- SVDEFAULTINCLUDE—Indicates whether the default is eligible or excluded from the SV Pool—eligible (1) or exclusion (0). The default value is defined in Central Designer. If the system does not contain a SVDEFAULTINCLUDE setting, the default value will be eligible (1).
Note: The default of whether to include or exclude subjects from the SV Pool is also a Site property. A user with the Change Site SV Settings right can change the value at the Site level. When a new system level percentage is applied through deployment, InForm compares the value of each site with the current system value. If the site value equals the system value, the new system value will be applied to the site. Otherwise, the site value will not be changed.
- TrialDateFormat—"Month_Day_Year", "Day_Month_Year" or "Year_Month_Day", indicating the format in which you want the date to appear in the trial. The default is Month_Day_Year.
- TrialOrgID—Company identifier for the associated with the study.
Note: Reserved for Oracle-hosted studies in a single sign-on environment.
- UNC_DownloadDirectory—Full path name of the physical InForm server directory used to download data listings with the Listings button. Read only.
- UniqueIntlDOBSwtch—Study, site or none, indicating whether the InForm application requires a unique combination of subject initials and date of birth for a study, a site, or not at all:
- 0 (default)—Initials and DOB combination is not required to be unique.
- 1—Initials and DOB combination must be unique within a site.
- 2—Initials and DOB combination must be unique within a study.
Note: If you specify that unique initials and date of birth is not required and subjects with duplicate initials and date of birth are entered and then you specify that unique IDs are required, the previously entered duplicate information will not be reported. If you plan to allow the transfer of subjects from one site to another, be aware that if a user transfers a subject to a site where another subject exists with the same initials and date of birth, and the study does not require unique initials and date of birth or only requires site uniqueness, the subject transfer fails. The user must change the subject initials to make the combination unique.
To prevent this situation, set the UniqueIntIDOBSwitch attribute to require unique initials and DOB across the study. - UniquePatIDSwtch—Study, site, or none, indicating whether the InForm application requires a unique subject ID for a study, a site or not at all:
- 0—Subject ID is not required to be unique.
- 1—Subject ID must be unique within a site.
- 2 (default)—Subject ID must be unique within a study.
Notes:
If you are using the Data Viewer in the InForm application, you must configure your system to require unique subject IDs within each site or each study.
If you specify that unique initials and date of birth is not required and subjects with duplicate initials and date of birth are entered and then you specify that unique IDs are required, the previously entered duplicate information will not be reported. If you plan to allow the transfer of subjects from one site to another, be aware that if a user transfers a subject to a site where another subject exists with the same initials and date of birth, and the study does not require unique initials and date of birth or only requires site uniqueness, the subject transfer fails. The user must change the subject initials to make the combination unique.
To prevent this situation, set the UniqueIntIDOBSwitch attribute to require unique initials and DOB across the study. - UserNameOrder—F,L or L,F, indicating the order in which the user's given and surnames are presented in a signature affidavit. The default is the user name order specified for the study on the System Configuration page. The order specified for the site overrides the order specified for the study.
- ViewCRFSignList—1 (yes) or 0 (no), indicating whether a list of required signatures should appear on each CRF for which a signature is required. The default is 1. Read only.
- Virtual_DownloadDirectory—Full path name of the InForm server virtual directory used to download data listings with the Listings button. Read only.
- VISITCALCULATORENABLED—1 (yes) or 0 (no), indicating whether to enable the visit calculator for a subject after the subject is enrolled. The default is 0.
Note: You can set the Server Friendly Name parameter, which provides a user-friendly server name to be displayed on Query Details and Signing Details screens, only through the Admin user interface of the InForm application. There is no equivalent MedML variable.
TYPE="0"
0 is the only value currently accepted. Required.
VALUE="n"
Value to assign to the configuration variable. Required.
Example
<SYSCONFIG CONFIGNAME="MinutesReauthenticate" TYPE="0" VALUE="5"/>
<SYSCONFIG CONFIGNAME="DaysPasswordExpiration" TYPE="0" VALUE="30"/>
<SYSCONFIG CONFIGNAME="MinutesReIdentification" TYPE="0" VALUE="120"/>
<SYSCONFIG CONFIGNAME="MinPasswordLength" TYPE="0" VALUE="6"/>
<SYSCONFIG CONFIGNAME="InactivateRetryCount" TYPE="0" VALUE="3"/>
<SYSCONFIG CONFIGNAME="OneNumericalCharacter" TYPE="0" VALUE="0"/>
<SYSCONFIG CONFIGNAME="OneUppercaseCharacter" TYPE="0" VALUE="0"/>
<SYSCONFIG CONFIGNAME="OneNonAlphaNumericCharacter" TYPE="0" VALUE="0"/>
<SYSCONFIG CONFIGNAME="AllowPasswordReuse" TYPE="0" VALUE="1"/>
<SYSCONFIG CONFIGNAME="EnableForgotPassword" TYPE="0" VALUE="1"/>
<SYSCONFIG CONFIGNAME="EmailForForgotPasswordNotification" TYPE="0" VALUE=""/>
<SYSCONFIG CONFIGNAME="EmailForNewSiteAndUserNotification" TYPE="0" VALUE=""/>
<SYSCONFIG CONFIGNAME="EnrollWithIncompleteForms" TYPE="0" VALUE="0"/>
<SYSCONFIG CONFIGNAME="NumOfExePlanListenThreads" TYPE="0" VALUE="4"/>
<SYSCONFIG CONFIGNAME="MaxNumOfResubmissions" TYPE="0" VALUE="2"/>
<SYSCONFIG CONFIGNAME="RequireCommentForNA" TYPE="0" VALUE="0"/>
<SYSCONFIG CONFIGNAME="SSLFlag" TYPE="0" VALUE="1"/>
<SYSCONFIG CONFIGNAME="RandomizationSrc" TYPE="0" VALUE="Inform.PFRandomization.1" />
<SYSCONFIG CONFIGNAME="RandSimpleCentral" TYPE="0" VALUE="SC:RND-%q"/>
<SYSCONFIG CONFIGNAME="AutoAnswerManualQueries" TYPE="0" VALUE="1"/>
<SYSCONFIG CONFIGNAME="QueryMaxLength" TYPE="0" VALUE="80"/>
<SYSCONFIG CONFIGNAME="EnforceVisitDate" TYPE="0" VALUE="0"/>
<SYSCONFIG CONFIGNAME="SPONSOREDITFROZEN" VALUE="0"/>
<SYSCONFIG CONFIGNAME="UNIQUEPATIDSWTCH" VALUE="2"/>
<SYSCONFIG CONFIGNAME="UNIQUEINTLDOBSWTCH" VALUE="0"/>
<SYSCONFIG CONFIGNAME="PostQueryForConflictResolution" VALUE="1"/>
<SYSCONFIG CONFIGNAME="SVFIRSTNSUBJECTS" VALUE="5" TYPE="0" />
<SYSCONFIG CONFIGNAME="SVAUTOSELECTRATE" VALUE="20" TYPE="0" />
<SYSCONFIG CONFIGNAME="SVDEFAULTINCLUDE" VALUE="1" TYPE="0" />
<SYSCONFIG CONFIGNAME="TrialDateFormat" VALUE="MONTH_DAY_YEAR"/>
<SYSCONFIG CONFIGNAME="FORMSAVEMODE" VALUE="1"/>
<SYSCONFIG CONFIGNAME="INLINEDURATION" VALUE="3"/>
<SYSCONFIG CONFIGNAME="ViewCRFSignList" VALUE="1"/>
<SYSCONFIG CONFIGNAME="QUERYSELECTION" VALUE="QUERYACTION_CREATEOPEN"/>