Survey object

The survey object defines what information is available on survey objects during survey processing. More specifically it defines which properties are available on the survey target object.

There are two survey specific properties available on all survey objects. These are Action and Action comment. Action is a set property with the values Keep and Remove that is (in the sample surveys and out-of-the-box post action handlers) used to mark resource assignment as approved or rejected. The Action comment is a value text field that is used in the sample surveys to add a comment to the survey object.

The survey object is not visible through the Omada Identity user interface. However, it is created when a survey template is published or updated. The survey objects can be used for setting up event definitions that trigger certain actions when a survey object is updated in a specific way.

info

A typical usage of event definitions would be to configure email templates to be sent to the users requesting access every time their access request has been approved through a survey.

Object type markup language

A survey template is authored in the SurveyTemplateML xml language. The schema definition file, SurveyTemplateML.xsd.

The objectType describes the survey objects that will be processed in a survey. An objectType has a number of property tags that refers properties in Omada Identity. The only attribute available for the property tag is name, which must be the system name of property in Omada Identity.

warning

You must add all properties you want to use in the survey. All types of properties are allowed with the following exceptions: Value properties of data type Timespan, Hyperlink, MultiLangText or Xml. Properties with control type Listbox or Tablelookup. Reference properties with Attributes.

Here you can find an example:

  <objectType>

    <properties>

      <property name="NAME" />

      <property name="SYSTEMREF" />

      <property name="ROLETYPEREF" />

      <property name="ROLECATEGORY" />

      <property name="ROLEFOLDER" />

      <property name="SURVEY_DESCRIPTION" />

      <property name="OWNERREF" />

      <property name="SURV_PROPOSEDOWNER" />

      <property name="SURV_ACTIONCOMMENT" />

      <property name="SURV_ACCEPTOWNERSHIP" />

      <property name="SURV_ACCEPTDATA" />

    </properties>

  </objectType>