BPC SurveyManager - Creating Surveys - Properties
Standard Properties
| PropertyID | PropGroup | Description | PValue | OpDisplayType | PDefault |
|---|---|---|---|---|---|
| *_TUCount | default | Where '*' is a short string representing a report name, this field represents the total user count query (numerator) for a question based report. Question based reports are invoked with &REP=ucnt,ulist,uresp,rprc,rcnt,rgrph,eulist,*&RMO=all,grp,**. Where REP are selectors for one or more report modes - {Uprc {user percentage responses}, ucnt {user count), ulist {user response list}, uresp {user responses by user}, rprc { user responses percent }, rcnt {user responses count}, rgrph {user responses graph}, eulist {user list outside of exception cond}, * {user defined report matching the * in this field name}. More than one of these can be used in the same report. RMO is either empty {this org onlt}, or 'all' {all orgs in Db}, or grp {the group of orgs of which this org is the parent} or ** {user defined report query defined in another property}. This last can change with each question if it is defined at the question property level. Allowed Qry Fields: SHOrgID, InstanceID,QID,SID | default | ||
| *_URCount | default | Where '*' is a short string representing a report name, this field represents the response user count query (numerator) for a question based report. Question based reports are invoked with &REP=ucnt,ulist,uresp,rprc,rcnt,rgrph,eulist,*&RMO=all,grp,**. Where REP are selectors for one or more report modes - {Uprc {user percentage responses}, ucnt {user count), ulist {user response list}, uresp {user responses by user}, rprc { user responses percent }, rcnt {user responses count}, rgrph {user responses graph}, eulist {user list outside of exception cond}, * {user defined report matching the * in this field name}. More than one of these can be used in the same report. RMO is either empty {this org onlt}, or 'all' {all orgs in Db}, or grp {the group of orgs of which this org is the parent} or ** {user defined report query defined in another property}. This last can change with each question if it is defined at the question property level. Allowed Qry Fields: SHOrgID, InstanceID,QID,SID | default | ||
| *_VWResp | default | Where '*' is a short string representing a report name, this field represents the repsonse query for a question based report. Question based reports are invoked with &REP=ucnt,ulist,uresp,rprc,rcnt,rgrph,eulist,*&RMO=all,grp,**. Where REP are selectors for one or more report modes - {Uprc {user percentage responses}, ucnt {user count), ulist {user response list}, uresp {user responses by user}, rprc { user responses percent }, rcnt {user responses count}, rgrph {user responses graph}, eulist {user list outside of exception cond}, * {user defined report matching the * in this field name}. More than one of these can be used in the same report. RMO is either empty {this org onlt}, or 'all' {all orgs in Db}, or grp {the group of orgs of which this org is the parent} or ** {user defined report query defined in another property}. This last can change with each question if it is defined at the question property level. Allowed Qry Fields: SHOrgID, InstanceID,QID,SID | default | ||
| ActionOnException | default | Define an action to undertake when the response received to a question is outside the acceptable range as defined by the exception flags for a question. | val= | default | nil |
| Admlist | default | Comma separated list of response options available for an arbitary list or drop list adminop. This list defaults to the administration action list, but could be any arbitrary list you want for which you don't want to create a fully blown selectop list. The value that appears in the response table will be the string itself. The selectop has the advantage of ensuring that all the selectable responses for all similar questions will have the same response values, but this property allows a quick & dirty response list to be assembled, with the risk that you will not be consistent across all similar questions, and you will use a lot more space to store the possible responses. Value is a comma delimited list with "" around options containing commas or spaces. | val=publish,distribute,lock,unlock | default | publish,distribute,lock,unlock |
| AllowAdvncdPubOptions | organisation | Survey Manager Maintenance web client only. (Manage Surveys). Allow the use of various advanced publication options including survey responder login. | lst=True,False | default | False |
| AllowAdvncdQEdOptions | organisation | Survey Manager Maintenance web client only. (Edit Surveys). Allow the display of advanced edit capabilities and views during question editing. This primarily relates to the survey header. In other SM clients this is on by default. In the web client the default is off for simplicity. | lst=True,False | default | False |
| AllowAdvncdSEdOptions | organisation | Survey Manager Maintenance web client only. (Edit Surveys). Allow the display of advanced edit capabilities and views during survey editing. In other SM clients this is on by default. In the web client the default is off for simplicity. | lst=True,False | default | False |
| AllowAdvncdUMOptions | organisation | Survey Manager Maintenance web client only. (Manage Users). Allow the display of advanced management capabilities and views during user management. In other SM clients this is on by default. In the web client the default is off for simplicity. | lst=True,False | default | False |
| AllowAdvncdRMSMOptions | organisation | Survey Manager Maintenance web client only. (Various). Allow the display of advanced risk manager survey integration controls and views throughout the web client. This is only relevant with integrated RM - SM databases. In other SM clients this is on by default. In the web client the default is off for simplicity. | lst=True,False | default | False |
| AllowMultiSrvyInstances | organisation | Survey Manager Maintenance web client only. (Manage Surveys). Allow the publication and management of multiple instances of a survey. In other SM clients this is on by default. In the web client instances are hidden by default for simplicity. | lst=True,False | default | False |
| AllowRMSM | default | Survey Engine only. Allow the survey engine to access risk manager tables. When true the survey engine will open a connection to the BPC RMS tables allowing the display and update of RMS tables directly. Tags and properties referring to features of the RMS not generated directly into surveys will be available. This is only relevant with integrated RM - SM databases. In the Survey Engine the default is False for security. | lst=True,False | default | False |
| AllowMultiSrvyInstances | organisation | Survey Manager Maintenance web client only. (Manage Surveys). Allow the publication and management of multiple instances of a survey. In other SM clients this is on by default. In the web client instances are hidden by default for simplicity. | lst=True,False | default | False |
| AllowPubToExstUser | organisation | Survey Manager Maintenance web client only. (Manage Surveys).Allow existing users to be selected for survey publishing in the Survey Manager web client. The default mode is that web maintenance client restrict responders to being specifically imported or manually added for each survey to simplify the interface. It is usually better to turn this on. | lst=True,False | default | False |
| AllowQDIDAutoNumCtrl | organisation | Survey Manager Maintenance web client only. (Edit Surveys). Allow the display of controls that optionally disable auto display numbering, and user defined ids. In other SM clients this is on by default. In the web client the default is autonumber for simplicity. | lst=True,False | default | False |
| AlwaysDo | default | Force the rule associated with a question to always be executed - regardless of whether a response has been received. Normally rules are only executed on questions with a received response. | lst=True,False | default | False |
| AutoPubFailIfNewOrgUser | default | Works with the AutoPublish property. AutoPubFailIfNewOrgUser causes the publication to FAIL if the user does NOT already exist in this organisation. In other words, setting this to true, means the user must already exist for the survey in order for the survey to be published to the user. This effectively stops autopublished surveys from just being published to any user not already a member of the current org. | lst=True,False | default | False |
| AutoPubFailIfNewUser | default | Works with the AutoPublish property. AutoPubFailIfNewUser causes the publication to FAIL if the user does NOT already exist in the database and it has NOT been generated by the UserMakerGenPID property. In other words, setting this to true, means the user must already exist or have been specifically created as an anonymous user iin order for the survey to be published to the user. This effectively stops autopublished surveys from just being published to any new user unless anonymous users are specifically allowed. | lst=True,False | default | False |
| AutoPublish | default | If the AutoPublish flag is set for an org or survey the survey being accessed is automatically published to the current user, and the next currently avai;able instance automatically authorised to the user. AutoPublish also allows for the automatic creation of the user if the UserMakerGenPID property is true, otherwise it validates the user exists and if not creates the user. Uses the UserMaker properties AND AutoPubFailIfNewUser, AutoPubFailIfNewOrgUser. If the user exists, the RK or the Pwd must match for the survey to be published to the user. Setting the AutoPublish flag means the UserMaker question type is not needed. | lst=True,False | default | False |
| CBXShwDistributed | default | Set the survey ID (SID) to show on a CBXUser input operation, where the CBXUser control is being used to manage distribution of surveys. Shows 'distributed' where a reminder has been sent (the last step of a distribution action). If ommitted, no message is displayed. | val= | default | nil |
| CBXShwStarted | default | Set the survey ID (SID) to show on a CBXUser input operation, where the CBXUser control is being used to manage distribution of surveys. Shows 'started' where the user has accessed the SID. If ommitted, no message is displayed. | val= | default | nil |
| CBXUEdEmail | default | Flag User Email Edit on a CBXuser input operation. | lst=True,False | default | False |
| CBXUEdName | default | Flag User Name edit on a CBXUser input operation if true. | lst=True,False | default | False |
| CBXUFilter | default | Set the user filter to determine which users are displayed in a CBXUser input operation (filter string must match a filter held by the desired users). If blank, or ommitted, all users in the current Org will be listed. | val= | default | nil |
| CBXUOrgRole | default | Flag User Orgrole Edit on a CBXUser input operation. | lst=True,False | default | False |
| CBXUPwd | default | Flag password edit on a CBXUser input operation | lst=True,False | default | False |
| CellFrmt | default | Special formats for insertion into the (primarrilly) radio button cells. | val=width="20%" | default | False |
| Checked | default | Sets the checked option on a checkbox if True | lst=True,False | default | False |
| ClearOnNil | default | Determines whethera pre-existing value in the response table should be cleared if no response to a question is provided by the user. This property is most important in textop's where a nil response may mean the user has cleared the text box. For these it should generally be set to true. Default is false. | lst=True,False | default | False |
| ContinueButton | survey | Normally NOT required.The full HTML tag for a continue button (ie. an HTML submit input button), which causes the page to be sent to the SurveyManager in the default case - but can do anything that a submit button can normally do. | val=<input type="submit" value="Continue" > | default | <input type="submit" value="Continue" > |
| ContinueIsEOS | survey | Always force the End Of Survey flag when the continue button is pressed, regardless of what the survey QScript rule is UNLESS question rules for the currently displayed page(s) have generated additional questions. A very useful property when one survey is used to select the questions to display in a second survey. This is most commonly used when the current survey has been branched to from another survey, and the EOS state of the current survey would result in a return to the previous survey, or a previously stacked additional branch. Thus after one page the current survey will always return to the calling or next survey. Normally a flag with this property set would display all questiongroups on a single page, and might use a property based QScript to select the QGroups to display. Currently this flag must be set at the survey level. | lst=True,False | default | False |
| CSSSheet | survey | Cascading Style Sheet values for this survey. Replaces the THTML tag '<#CSSSheet >' in the survey layout. This property must be used if you want to control printing. | val=<style type="text/css" >
</style > | default | nil |
| CSSUse | survey | <br class="breaka">
| val=<br class="breaka"> | default | nil |
| customop | default | HTML string, defining a custom input control. Any HTML block is valid. The customop input type allows custom or dcustom (single or double column) input controls to be defined and inserted where the predefined input controls would normally go for this question type. No tag expansion is performed on these HTML strings. | val= | default | nil |
| DefaultUserEmail | survey | The default email to assign to a new user when the UserMaker (or other user creation method) is used to reate a new user. | val= | default | |
| DONESID | survey | Not a general property as such, but a property parameter of the PreReq property. It is the Survey ID (SID) of the survey that must be completed before the current survey can be attempted. Only one DONESID can be provided. | val=Survey: | prereq | |
| DoQRLif | default | Identifies the question on this page to activate (make visible) if the response is above or below or equal to a specific value. Format of the value to this property is: "[gt/lt/eq/neq/between/nbetween, lowvalue, highvalue, QRLrow]". Options are enclosed in [] and any number can be listed. The result is that the row(s) (or other question containers) containing the invisible question and response parts (etc) identified by the QRL's are made visible if it was previously invisible if the test is true (and vice versa if false). A QRLRow is a QuestionID with "_Row" appended. So the QRLRow for Q001 is Q001_Row. A QRLRow can in fact be any DOM region - it does not have to be a question display area only. A list of QRLRows is separated by ";". If the test does not require a low and high bound, then put the numeric part in the low bound position and 0 in the high bound. For example: "['lt', 4, 0, 'Q01a_Row;Q01b_Row;MyDiv']" in the DoQRLIf propety for a question means "show questions Q01a and Q01b and DOM display object "MyDiv" if the value of the current question response is less than 4". | val=[lt/eq/gt, vallow, valhi, QRLRow] | default | nil |
| DoQRLifWght | default | Identifies the question on this page to activate (make visible) if the response to a user weighting is above or below or equal to a specific value. Format of the value to this property is: "[gt/lt/eq/neq/between/nbetween, lowvalue, highvalue, QRLRow]". Options are enclosed in [] and any number can be listed. The result is that the identified QRL's is made visible if it was previously invisible. Refer to the notes for DoQRLIf. | val=[lt/eq/gt, vallow, valhi, QRLRow ] | default | nil |
| ErrorHTML | default | THTML tag or HTML layout for the question specific error message. Typically used when a required question is omitted. | val=<#ErrorMsg colspan=3 align=center BgColor=yellow style="color:red;font:bold;" > | default | <#ErrorMsg colspan=3 align=center BgColor=yellow style="color:red;font:bold;" > |
| ErrorMsgPos | default | Position of the question specific error message. | lst=above,below | default | below |
| GenPageReqErrorMsg | survey | The HTML message to use for the '<#errormessage >' THTML tag in a survey layout. | val="***Please Note: You have not filled in a required question. Please refer to the identified question below. ***" | default | You ommitted the responses to some required questions on this page. Please refer to the individual highlighted ommissions. |
| GLV | default | Show the last response provided for a question | lst=True,False | default | False |
| Hint | default | If present for a question, a hint button will be inserted and the contents of the property will be displayed in a pop-up window. | val= | default | nil |
| Invisible | default | Control visibility of a question. Use this property to create questions that are displayed when the user performs some action (such as providing an answer to another question in the same question group or page that is outside of a given range). Note: Invisible questions should not have the required property turned on. | lst=True,False | default | |
| ItemFrmt | default | The HTML attribute format values used by selectop controls (buttons, some labels, etc) to control item specific (as opposed to hosting table level) format characteristics. The most common purpose is to make a vertical list of buttons expand to the full width of the hosting table. | val=width="100%" | default | minimum fit |
| JMPACTN | default | The URL or SM param line to which a jump op should jump to for the next page. The content of the property id determined by the type of jump op:
| val= | default | |
| JMPTXT | default | The text or caption to display on a jump op input control (label, button, etc). The equivalent value in a selectop is found in the selectop record for the selectop item, but in jump ops there is no such table available so the value is supplied from this property. | val= | default | |
| JMPATRB | default | The extra attributes to insert in the tag of a jump op input control (label, button, etc). There is no equivalent value in a selectop. | val= | default | |
| LoginRequired | default | Impose login requirement at commencement of survey. If the user has not logged in, or loggin data supplied, a login screen is returned before the survey is displayed. | lst=True,False | default | False |
| LoginRetryCount | default | The count of the maximum login attempts before the authorisation failure message is displayed.. | val= | default | |
| LoginOrgOK | default | Where survey login rquired, survey does not have to be published to the user and access to the org alone is OK, if true. | lst=True,False | default | False |
| Multiple | default | Enable multiple selections (admlist, admdlist, filelist) if true. | lst=True,False | default | False |
| MOHint | default | Enable mouse over hints displayed in a user defined area of the screen for select ops and jump ops. Mouseover hints are drawn from the hint field of the select op table or for jump ops, the MOHintTXT property. Enabled if true. | lst=True,False | default | False |
| MOHintID | default | The ID of the user defined page region into which to write the hint text during mouse over events from select ops and jump ops. Mouseover hints are drawn from the hint field of the select op table or for jump ops, the MOHintTXT property. A DIV is typically used as the hint container referenced by this property. | val= | default | |
| MOHintTXT | default | The Text to display in the user defined page region as the hint text during mouse over events from jump ops. Mouseover hints are drawn from the hint field of the select op table or for jump ops, the MOHintTXT property. A DIV is typically used as the hint container referenced by this property. | val= | default | |
| MOHint | default | Enable mouse over hints displayed in a user defined area of the screen for select ops and jump ops. Mouseover hints are drawn from the hint field of the select op table or for jump ops, the MOHintTXT property. Enabled if true. | lst=True,False | default | False |
| NewUserFilter | survey | This is the filter to add to a new user when suto creating users with a 'usermaker' displayop. While a usermaker is normally used in a dedicated survey, that survey is generally invoked from a survey that offers restricts all but the first couple of questions with this filter, and restricts the first questions to a 'GUEST' PID that has only the 'GUEST' filter attached. You will need this property to be set in order to allow the remainder of the survey to be seen only be the newly created user. | default | ||
| NILDSTR | default | Set the string to display if no selection is made in a drop list or list. the default is Nil and you can not set this value to nothing - Nil will be used instead. | val=Nil | default | Nil |
| NoContinue | survey | Suppress the continue button at that normally appears at the bottom of each page. This button posts the survey responses. | lst=True,False | default | False |
| NoFirstContinue | default | Suppres the first continue button, but allow continues on the following pages (useful when the first page contains a login question) | lst=True,False | default | False |
| NOPRVW | default | Disable preview mode on the survey | lst=True,False | default | False |
| NoTitles | default | Supress Titles on horzontally aligned radio buttons. | lst=True,False | default | False |
| NoWght | default | Supress display of the weight response section for the current question(s). | lst=True,False | default | False |
| NoWghtTitles | default | Supress display of the weight response section options titling when weight options are displayed as the radio button for the current question(s). | lst=True,False | default | False |
| NOXHELP | default | Enable/disable help table xhlp display tag. Must be explicitly set to False to allow tag to be used in a survey (ie. Default is True) | lst=True,False | default | True |
| OIDProp | default | Find the correct OID based on a property of the Person, Survey or Organisation. The Value in OIDProp is the Property to look up. If no valueis found in the associated property, the existing passed OID Value will be used. This mechanism is intended to allow a users survey response to be automatically allocated to an organisation based on a property of the user, the survey or the original named org in the survey). It provides a way to allocate responses across organisations. Two models are supported: 1. Where OIDProp property is assigned in the survey or organisation, use this value as the POIDValue - regardless of the paramvalue; 2. Where the POIDValue is assigned in the survey params (unless supressed by an OIDProp value of 'nil'. You can block Property org selection by setting it to 'nil' in the survey or the org. | val= | default | |
| pexe | default | Replaces the <#pexe > THTML tag used for question specific plugin function calls. The default property name 'pexe' for a plugin function call can be overriden with a call of the form <#pexe pname="mypluginfunc" > where "mypluginfunc" becomes the name of the property. The value of the property should be of the form: exe( plugin_dll_name, plugin_func_name, param1, param2..paramN ) where all values in the brackets are strings (denoted by "" or ) or QRLs containg valid response values and plugin_dll_name and plugin_func_name are as the names imply and param1..paramN are the arguments to the plugin call. The plugin dll must be loaded for the call to work. | val= exe( dll_name, func_name, params ) | default | nil |
| PIDPROPNN | survey | Not a general property as such, but a property parameter of the PreReq property. It is a Property of the user that must have a non empty and non nil value before the current survey can be attempted. Any number of PIDPROPNNs can be provided. | val=Property Name: | prereq | |
| PLGIN | default | Causes a plugin function call result to be inserted in the response field of an input control (text, text area, numeric, date) and the list of an admlist or admdlist. The value of the property should be of the form: exe( plugin_dll_name, plugin_func_name, param1, param2..paramN ) where all values in the brackets are strings (denoted by "" or ) or QRLs containg valid response values and plugin_dll_name and plugin_func_name are as the names imply and param1..paramN are the arguments to the plugin call. The plugin dll must be loaded for the call to work. | val= exe( dll_name, func_name, params ) | default | nil |
| PostAction | survey | Normally NOT required. The address to which to send a page when the continue button is pressed. (In HTML terms this is the action attribute of a form.) Normally NOT required and therefore results in the page being posted back to SurveyManager, but it can be overridden so that a surveymanager form posts to an entirely different application. | default | Post the page to BPC SurveyManager | |
| PostMethod | survey | Sets the method used for sending a page to the survey manager or the target web server/web application. Although a SurveyManager form is normally 'posted' to the SurveyManager application, there is no actual requirement for it to either be posted, or even sent to SurveyManager as the form target. Any web application can be used as a page target. | lst=post,get | default | post |
| PostType | survey | Normally NOT required. Defines the type of data being posted. Normally, NOT required (and therefore defaulting to application/x-www-form-urlencoded), this value MUST be set if the form contains a file displayop because uploading a file to the server requires multipart form posting. For file uploading use the 'multipart' short form, for anything else leave blank or enter the full HTML ENCTYPE attribute value (excluding the word 'ENCTYPE'). | val=multipart | default | application/x-www-form-urlencoded |
| PreReq | survey | A list of prerequisites for the survey / survey instance. Currently supports DONESID (the current responder must have completed the Survey identified as the DONESID property) and PIDPROPNN (the ressponder must have a non-nil and non empty value for the property PIDPROPNN). Only one DONESID can be listed but any number of PIDPROPNN can be included : eg. Usage is PreReq="DONESID=xyz,PIDPROPNN=ROOM"... Which means a reponder must have completed survey "xyz" and have property "ROOM" defined with a value other than "nil" or empty. | val=DONESID=xxx,PIDPROPNN=yyy | default | |
| PRPROPREQD | default | The error message to display if a property noted any of the PIDPROPNN prerequisites is not found or nil for the user. Ie. The prequisit is not satisfied. Can be defined at the Org, Survey or Instance level. If not defined a default message is displayed. | val= | default | At least one prerequisite for completing this survey has not been met. You must complete all prerequisites before taking this survey. |
| PRSIDREQD | default | The error message to display if the SID noted DONESID prerequisite has not been completed by the user. Ie. The prequisit is not satisfied. Can be defined at the Org, Survey or Instance level. If not defied a default message identifying the required survey is displayed. | val= | default | At least one prerequisite for completing this screen has not been met. You must complete ..SID.. |
| RadioAln | default | Either Vert or Horz (or nothing). This property determines wether radio buttons, selectop buttons & selectop labels are presented across the page (the default) or vertically down the page (if Vert). | lst=Vert,Horz | default | Horizontal |
| RadioFrmt | default | The HTML attribute format values for radio buttons and the hosting table of selectop buttons & labels (see ItemFrmt for individual button/label formatting). Use primarily to control the width of the button table. By default, radio button tables are left justified. To spread buttons over the entire response column use "width=100%". | val=width="100%" | default | left justified |
| REPPIDOK | survey | A comma separated list of PIDs that have been granted reporting access for the current survey, that would not otherwise have report access. | val= | default | |
| ReqErrorMsg | default | Replaces the <#ErrorMsg> THTML tag used for question specific error messages. | val=The question above is a required question. Please complete prior to continuing. | default | Error: This field is required - please try again. |
| Required | default | This field is required. A nil response is rejected. | lst=True,False | default | False |
| RMDREdit | default | Enable editing of Survey Reminders, if true. (Requires SIDEOID, SIDESID, SIDERNM ) | lst=True,False | default | False |
| RPTCCellFrmt | default | Table cell format to be used in the survey question list summary report. | val= | default | nil |
| RPTCFields | default | List the fields, separated by ';' to be included in a survey question list summary report. Only the fields available in the selected report are actually displayed. The default fields are:OpDisplayStr;ResponseStr;OpVal;RSCount;ODSCount;OVCount;OVDCount. The count fields count the number of reposnses for various ODSCount;OVCount;OVDCount Used with the RPTTField to calculate ratios etc. | val=OpDisplayStr;ResponseStr;OpVal;RSCount;ODSCount;OVCount;OVDCount | default | OpDisplayStr;ResponseStr;OpVal;RSCount;ODSCount;OVCount;OVDCount |
| RPTCHeadings | default | List the headings, separated by ';' to be included in a survey question list summary report. Only the headings available in the selected report are actually displayed. The default headings are: OpDisplayStr;ResponseStr;OpVal;RSCount;ODSCount;OVCount;OVDCount. | val=OpDisplayStr;ResponseStr;OpVal;RSCount;ODSCount;OVCount;OVDCount | default | OpDisplayStr;ResponseStr;OpVal;RSCount;ODSCount;OVCount;OVDCount |
| RPTRCellFrmt | default | Table cell format to be used in the survey question list report. | val= | default | nil |
| RPTRFields | default | List the fields, separated by ';' to be included in a survey question list report. Only the fields available in the selected report are actually displayed. The default fields are: PID;Person;OpDisplayStr;ResponseStr;OpVal, OpValDate. | val=PID;Person;OpDisplayStr;ResponseStr;OpVal | default | PID;Person;OpDisplayStr;ResponseStr;OpVal |
| RPTRHeadings | default | List the fields, separated by ';' to be included in a survey question list report. Only theList the headings, separated by ';' to be included in a survey question list report. Only the headings available in the selected report are actually displayed. The default headings are: PID;Person;OpDisplayStr;ResponseStr;OpVal, OpValDate. fields available in the selected report are actually displayed. The default fields are: PID;Person;OpDisplayStr;ResponseStr;OpVal, OpValDate. | val=PID;Person;OpDisplayStr;ResponseStr;OpVal | default | PID;Person;OpDisplayStr;ResponseStr;OpVal |
| RPTTField | default | The field name of the total count of user responses used in a survey question list summary report query. Defaults to RCount if not specified. Used as the denominator of a percentage or ratio calculation. | val=RCount | default | RCount |
| SIDEdit | default | Enable editing of Survey Headers, if true. (Requires SIDEOID, SIDESID, SIDEFLD ) | lst=True,False | default | False |
| SIDEFLD | default | Survey Header Field to edit | val=owner | default | nil |
| SIDEOID | default | Org ID for Survey Header & Reminder edits. | val=default | default | Current OrgID |
| SIDERNM | default | Survey Reminder number to edit. | val=1 | default | 1 |
| SIDESID | default | Survey ID for Survey Header and Reminder edits. | val= | default | nil |
| Sidlstfilter | default | Set the filter that determines which surveys are displayed in a sidlist input operation. SIDs must have the mentioned filter in their filter list to be displayed. All SIDs will be listed if ommitted UNLESS the SID has a filter and the user has a filter, in which case only SID's matching a user's filter will be displayed. This property overrides that behaviour. | val= | default | nil |
| SPLGINDLL | survey | Comma separated list of plugin dll names to be used for a specific survey - loaded and unloaded with each page. Do not include the 'dll' extension. These plugins should be stored in the AdHoc directory of the plugins library. | lst= | default | nil |
| SuppressFirstContinue | default | Suppress the first page continue button. | lst=True,False | default | False |
| SuppressFirstHeading | survey | Suppress the heading on the first survey page if true. | lst=True,False | default | False |
| SurveyEnd | survey | The message to be displayed at the end of a survey. | val=<P ><H1 align=center ><font color="blue">The Survey is now complete.</font></H1></P><br><P><H3 align=center >Should you wish to revise your responses, you can do so prior to the survey response cut off date by using<br >
<form method=get action="http://www.acumenalliance.com.au/" ><input type=submit value="Close Survey" ></form><br><br><br><br><br><br><br>.<font color=white > | default | <H1>Survey Finished. Thankyou.</H1> |
| TCELLEND | default | (CellEnd ) Define a question component end string - usually </tr > Only required if you are changing the layout or size of the cells (other than just changing the order of the columns). Must be paired with a TCELLSTART. The HTML code used to mark the end of a cell. A question line consists of components such as displayed ID, question and response, etc. | val=</td > | default | </td > |
| TCELLSTART | default | (CellStart ) Define a question component start string - usually <tr > Only required if you are changing the layout or size of the cells (other than just changing the order of the columns). Must be paired with a TCELLEND, unless you are using the standard cell based cell marker. The HTML code used to mark the start of a cell. A question line consists of components such as displayed ID, question and response, etc. | val=<td > | default | <td > |
| TH | quesgroup | (TableHeading) Define a question group section heading. Options are empty(ignore), Nil(No heading),Default(Survey default), or anything else which will be treated as a heading definition. Note that if you are changing more than just the order of the columns, you should insert a <tr ></tr > row definition pair. | val=<tr ><#ID ><#Question ><#Response ></tr > | default | nil |
| TR | quesgroup | (TableRow) Define a question OR question group standard row definition. Values are any valid cell list reference. | val=<#QuesDisplayID><#Question><#OpType> | default | nil |
| TRC | quesgroup | (TableRowCheckBox) Define a question OR question group checkbox input control row display. Custom input tags are defined in person/question/survey properties entirely. Be careful about naming - the input field MUST use the QID for name and ID or it will not be seen by the response control engine. | val=<#QuesDisplayID><#Question align=right><#OpType> | default | nil |
| TRCOLOUR | quesgroup | (TableRowColour-cycle ) Define a question group colour cycle. Typically this is a list of one or more colours separated by commas. | val=white,silver | default | nil |
| TRDCUS | quesgroup | (TableRowCustom control) Define a question OR question group double width custom input control row display. Custom input tags are defined in person/question/survey properties entirely. Be careful about naming - the input field MUST use the QID for name and ID or it will not be seen by the response control engine. | val=<#QuesDisplayID ><td colspan=2 ><table width="100%" ><tr ><#Question ><#OpType ></tr ></table ></td > | default | nil |
| TRDTA | quesgroup | (TableRowDoubleTextArea )Define a question OR question group double width text area input control row display. Custom input tags are defined in person/question/survey properties entirely. Be careful about naming - the input field MUST use the QID for name and ID or it will not be seen by the response control engine. | val=<#QuesDisplayID ><td colspan=2 ><table width="100%" ><tr ><#Question ><#OpType ></tr ></table ></td > | default | nil |
| TREND | default | (TableRow Row End) Define the table row ending characters for questiongroup/question level format override. Must be paired with TRSTART, unless you are using the standard TREND | val=</tr > | default | </tr > |
| TRL | quesgroup | (TableRowLongLable) Define a question OR question group long info label input control row display. Custom input tags are defined in person/question/survey properties entirely. Be careful about naming - the input field MUST use the QID for name and ID or it will not be seen by the response control engine. | val=<#QuesDisplayID><#Question align=center colspan=2 > | default | nil |
| TRSTART | default | (TableRow Row Start) Define the table row starting characters for questiongroup/question level format override. must be paired with TREND | val=<tr > | default | <tr > |
| TTEND | quesgroup | (TableEnd ) Define a question group section end styring - usually </table > Only required if you are changing the layout or size of the cells (other than just changing the order of the columns) Or have used a TTSTART for this question group.. | val=</table > | default | nil |
| TTSTART | quesgroup | (TableStart ) Define a question group section start string - usually <table > Only required if you are changing the layout or size of the cells (other than just changing the order of the columns). Must be paired with a TTEND | val=<table > | default | nil |
| ULEmail | default | User email name field | val=EMail: | default | EMail: |
| ULPWD | default | User password field name | val=Password: | default | Password: |
| ULUserId | default | UserId field name | val=UserId: | default | UserId: |
| ULUserName | default | User name field name | val=Name: | default | Name: |
| UserAutoLockOn | default | Causes the current survey instance to be responded only once by the current user. The value of UserAutoLockOn is a Filter string that will cause the current instance of the survey to be locked when the current user reaches the end IF the current user has the same string in their filter list. If the same user then attempts to answer the survey again they will be allocated a new instance, if any are available, or blocked from accssing it. | val= | default | |
| UserLogin | default | List of user fields collected in a userlogin adminop | lst="UID,PWD",UID | userlogin | UID,PWD |
| UserMaker | default | List of user fields collected in a usermaker adminop. When the response is processed by the server UserMaker works in conjunction with a number of other optional properties: UserOrgMerge, UserNameIsUserID, NewUserFilter, UserMakerMakeKey, UserMustMatchOrNotExist, UserMakerGenPID, DefaultUserEmail, AutoPublish. It generates a number of input values in fields: UNAME, EMAIL | lst="UID,PWD,UNAME,EMAIL",UID,"UID,UNAME,EMAIL" | usermaker | UID,PWD,UNAME,EMAIL |
| UserMakerCanEditFlag | default | Enable editing of user details on create | lst=True,False | usermaker | False |
| UserMakerGenPID | default | Where AutoPublish is True, AND you do not supply a PID in the call to get survey (to automatically publish the survey and the current instance to a user on access) you can set UserMakerGenPID to auto generate a GUID to uniquely identify the user. This enables anonymous surveys. In this case UserOrgMerge is ignored. Note: You will not be able to track responders with anonymous surveys. | lst=True,False | default | False |
| UserNameIsUserID | default | Set the user name to the PID value on creation. | lst=True,False | usermaker | False |
| UseWeight | survey | Enable the extra weight/importance column for every question in the survey. The results for this are recorded as a floating point number between 0 and 1 in the weight column of each response. Typical use is to get a user importance rating for each question. | lst=True,False | default | False |
| UserOrgMerge | default | Enable adding of the ID entered by a user to the OrgID to create a new user, or login (if True). It is strongly recommended that if you allow autocreation of user ids, AND your orgs are independent entities that do not share responders, you also set this to True as otherwise user ID's across orgs can be shared. This will ensure that ids are unique to this org when the id is reused in another org in the same database. | lst=True,False | default | False |
| WghtInfoOp | default | Force the display of weightings for an InfoOp (non input text or image display). | lst=False,True | default | False |
| WghtOpList | default | Force the displayed names of weightings to be drawn from least to most from a comma separated list provided. The option may be suppressed by setting the property to "Nil", which will result in the default numeric display. Where commas or spaces are required in a list item, surround the item with ". | val= | default | |
| WghtRadioAln | default | Either Vert or Horz (or nothing). This property determines whether weight response section radio buttons & selectop labels are presented across the page (the default) or vertically down the page (if Vert). | lst=Vert,Horz | default | Horizontal |
| WghtScale | default | Set number of discrete weight selection options to be displayed in the weighting response section for this question(s). The resulting value will be an evenly spaced division of the weight value range from 0 to 1 | val=5 | default | 5 |
| WghtType | default | Set display format for entering the discrete weight selection options to be displayed in the weighting response section for this question(s). Text will allow any floating point value to be entered. Other options provide evenly spaced division of the weight value range across 0 to 1 | lst=radio,text,list,droplist | default | radio |
