Inbox

Content [ Hide ]

Description

Depending on the authorization all submitted form records will be displayed clearly in either the default view or project view. In the inbox it is also possible to change the state of form records, upload files, write comments and export form record data.

Structure

Failed to execute the [velocity] macro. Cause: [null]. Click on this message for details.
The inbox consists of (1) the filter menu, (2) the form record list and (3) the review area.

As a whole the inbox consists of three separate parts: the filte menu at the left side, the form record list and the review area. When the inbox is being opened only the filter menu and the form record list are visible. A click on a form record within the form record list opens the review area of that form record.

Filter menu


The filter menu is used for configuring how the form records are being displayed within the form record list. The following filters are provided:

Search

Failed to execute the [velocity] macro. Cause: [null]. Click on this message for details.
Form record search: Form records can be filtered by different search types. The search type can be selected via the arrow symbol which is marked in red.

At the top of the filter menu there is an input field for searching forms. The arrow button to the right of the is being used to select the search type (see figure). The following search types are provided:

  • Subject
    Search for form records with the given subject.
  • Form
    Search for form records with the given form title.
  • Form record ID
    Search for form records with the given ID ID has to be exact..
  • Process ID
    Search for form records with the given process ID.
  • State
    Search for form records that are in the given state.

No search filter is being applied if the input field is empty. In project views the input field is not being displayed.

View


Failed to execute the [velocity] macro. Cause: [null]. Click on this message for details.
There are two different types of views, which can be differentiated by their symbols /: (1) the default view of form records and (2) the project views (marked in red).

The view selection is only available if project views have been configured (for configuring project views see My Forms > Inbox). Which form records are being displayed in the form record list and how they are being displayed depends on the selected view. There are two different types of views:

  • Default
    The default view can not be configured. Depending on the users authorization all submitted form records are displayed in the form record list.
  • Project views
    Project views have the names of the forms they are matched to. These views only contain form records of the appropriate form. The form records will be displayed in a data table. The number of columns depends on the view configuration (see form record list).

Filter

Failed to execute the [velocity] macro. Cause: [null]. Click on this message for details.
Filter: There are four quick filters available.

There are four quick filters available for configuring the form record list.

  • Show all
    All form records of the current view will be displayed.
  • Recently edited
    All form records that have been edited in the past 14 days will be displayed.
  • Edited by me
    All form records that have been edited by the current user will be displayed.
  • Created by me
    All form records that have been created by the current user will be displayed.

Inboxes

Failed to execute the [velocity] macro. Cause: [null]. Click on this message for details.
Only form records within the selected inboxes will be displayed.

Every form record is stored in an inbox. By default this is the Default inbox. What inbox a form record should be stored in can be configured in the inbox settings of the form. By selecting inboxes only the form records within the selected inboxes will be displayed. Next to each inbox a number is diplayed showing the count of unread form records within that inbox. Is no number present than there are no unread form records. Is no inbox selected or the inbox filter is not available (because all form records are stored in the same inbox) than the form records of all inboxes will be displayed.

The inbox filter depends on the selected view. The inbox filter is available if the form records of the form record list are stored in more than one inbox. If this is not the case than the inbox filter is not available.

Submit date

Failed to execute the [velocity] macro. Cause: [null]. Click on this message for details.
The form record list can be filtered by submit date.

The form record list can be filtered by the submit date of the form records. For this there are two input fields available:

  • from
    All form records submitted from the given date will be displayed.
  • until
    All form records submitted until the given date will be displayed.

No submit date filter will be applied if these fileds are empty.

Sorting

Failed to execute the [velocity] macro. Cause: [null]. Click on this message for details.
The default view of the form record list can be sorted by different criteria.

The default view of the form record list can be sorted by different criteria. If a project view is selected this field is not available. Sorting of project views is done by clicking on the column headers. The following criteria (in ascending and descending direction) are available for sorting:

  • Submit date
  • Last change date
  • Subject
  • State

More filters

Failed to execute the [velocity] macro. Cause: [null]. Click on this message for details.
More filters for individual searches.

More filters are provided for further refinement of the search:

  • (Un-)Read
    Only (un-)read form records will be displayed.
  • With/Without attachment
    Only form records with/without attachments will be displayed.
  • (Not) Saved
    Only form records that are (not) saved will be displayed.
  • (No) Double-Opt-In
    Only form records that are in the state Waiting for Opt-In will be displayed (see Double-Opt-In for configuration).

Form record list


Failed to execute the [velocity] macro. Cause: [null]. Click on this message for details.
The form record actions on the left side of the form record list header are displayed if any form records have been selected. General actions on the left side are always visible.

All form records are displayed in the form record list depending on the set filters. There are two different views of the form record list: the default view and the project view. The view can be changed in the filter menu.
Clicking on a form record in the form record list opens it in the review area. If the review area is not visible, it will be opened by clicking on a form record. After opening a form record it will be marked as read and the font weight will be set from bold to normal. When filtering unread form records this record will be excluded. For marking a form record unread click the appropriate button   in the header of the form record list.
The form record list header consists of two button rows (see figure). On the left are form record actions and on the right are general actions.

Form record actions

Which form record actions will be displayed depends on the currently selected form records.

 Select all form records

Selects all form records based on the currently set filters. This may take a while if there is a large number of form records within the list. This checkbox is always available.

  Export

Exports all selected form records or all form records based on the currently set filters if there are no form records selected.

Example:

No form records are selected and filter is set to the inbox "Default inbox". Performing an export action will export all form records that are stored in the inbox "Default inbox". For exporting the form records of all inboxes the filter on "Default inbox" needs to be removed.

There are three different types of exporting form records:

  XML

Failed to execute the [velocity] macro. Cause: [null]. Click on this message for details.
XML-Export of selected form records: Optionally an XSL-Template may be selected for transforming the resulting XML file into the desired format (XSL-Templates can be defined under XSL transformation).

Form record data of all form elements will be exported flat in an XML structure.

<xfc-data xfc-version="3.x.x" generation-date="yyyy-mm-dd HH:mm:ss.ms TZ">
<processes>
 <process process-uid="xxx" creation-date="yyyy-mm-dd HH:mm:ss.ms TZ" project-name="yyy" status="zzz">
  <form version="1">
   <field name="elName">
    <plainValue><![CDATA[Wert]]></plainValue>
    <values count="1">
     <value index="0"><![CDATA[]]></value>
    </values>
    <label><![CDATA[]]></label>
   </field>
    ...
  </form>
 <process ...>
</processes>
</xfc-data>

Using an optional XSL template (see figure) the exported XML can be transformed into the desired format. The appropriate template can be selected using the combobox. For further information on XSL templates look here.

  Excel

Failed to execute the [velocity] macro. Cause: [null]. Click on this message for details.
Excel export of the selected form records: Column names can be configured for every export.

All data will be exported to an Excel file. If form records of multiple forms have been selected than a new worksheet will be created for every form within the Excel file. All values of dynamic form elements will be put into the same cell, separated by commas. If this is not desired the export option Excel (multiline) is recommended.
The column names of the resulting Excel file may configured using the following options:

  • Name of the form element
    The element names that are used in the Xima® Formcycle Designer will be used for the Excel columns (e.g.: tf1, sel1, ...).
  • Alias of the form element
    The element alias that is used in the Xima® Formcycle Designer will be used for the Excel columns.
  • Column name of the data table
    The column names that have been set in the inbox configuration will be used for the Excel columns. This selection is only available in the project views.

  Excel (multiline)
This Option is not available in project views.
The export works the exact same way as the simple Excel export, except that the values of dynamic form elements will be put into separate rows.

 Move

Failed to execute the [velocity] macro. Cause: [null]. Click on this message for details.
Moves the selected form records to a different inbox.

Clicking the move button (see figure) opens a dialog in which the desired inbox must be chosen. All selected form records will be moved to that inbox after confirming. Moving form records does not trigger any action of the workflow.

 /  (Un-)Read

Clicking the Read or Unread button markes the selected form records as read or unread.

 Delete

Clicking this button deletes the selected form records. This function is only available if all selected form records are deletable. A form record is deletable if the state, it is currently in, allows for it to be deleted. In the state configuration or access configuration the option Form records can be deleted or Form records deletable needs to be activated in order for the form record to be deletable. If this is not the case the form record can not be deleted.

General action

On the right side of the form record list header there are a number of general actions which are always available:

 New form record

Opens up a menu through which existing forms may be called for submitting new form records.

  Refresh

Refreshs the view.

/ Position of the review area

Toggles the position of the review area. The review area can be positioned at the right side or bottom of the window.

Default view

Failed to execute the [velocity] macro. Cause: [null]. Click on this message for details.
A form record in the default view: Clicking the inbox (in blue) sets an inbox filter. The attachment page of the form record can be accessed directly be clicking the paperclip icon .

In contrast to the project views and depending on the set filters, all form records are being displayed in the default view. Form records with attachments are marked by a paperclip icon (see figure). Clicking the icon opens the attachment page of the form record directly. Every record entry consists of the subject, submit date, state as well as the inbox (in blue, see figure). Clicking the inbox sets an inbox filter.

Project view

Failed to execute the [velocity] macro. Cause: [null]. Click on this message for details.
Form records in a project view. Project views can be displayed using the filter menu.

Project views are data table views which are available as soon as display columns have been configured for the form (see Form > Inbox). The values of the configured form elements as well as additional form information will be displayed in the data table. Every column can be filtered and sorted. Form records containing attachments are marked by a paperclip icon (see figure). Clicking the icon opens the attachment page of the form record directly.

Review area


Failed to execute the [velocity] macro. Cause: [null]. Click on this message for details.
The review area of the inbox can be split into a (1) header and (2) content part.

Form records selected by a mouse click will be displayed in the review area of the inbox. Submitted form data can be reviewed here. Additionally a number of form record actions ma be performed. The review area consists of a header and content part (see figure).


Failed to execute the [velocity] macro. Cause: [null]. Click on this message for details.
The header can be split into three rows: (1) title row, (2) navigation row, (3) action row.

The header is used for navigating the selected form record and performing form record actions. It consists of a title row, a navigation row and an action row. Depending on the selection in the navigation row different aspects of the form record will be displayed in the content area. Also the available form record actions in the action row change depending on the selection in the navigation row.

Title row

Failed to execute the [velocity] macro. Cause: [null]. Click on this message for details.
Clicking the expand icon   reveals further form record information: form name, form record ID, process ID, review link, state.
Failed to execute the [velocity] macro. Cause: [null]. Click on this message for details.
All form pages can be accessed by clicking the expand icon   at the right side of the page tab.

The title row provides meta information about the form record. To the left is the form record subject in bold. To the right there are three buttons:

  •   Details
    Expands the title row to reveal further meta information about the form record (see figure).
  • Open in new tab
    Opens the current form record in a new tab.
  • Close
    Closes the review area.

Navigation row

The navigation row provides a number of tabs for displaying different aspects of the form record. Depending on the selected navigation tab the available actions in the action row change as well as the displayed information in the content area.

  • Form page
    Clicking this tab shows the filled out form. If the selected form consists of multiple pages the user can access in the current state, than an expand icon   appears on the right side of this tab. Different form pages can be accessed by clicking the icon. It is also possible to show all pages at once (see figure).
    In some case not all pages should be displayed when clicking All pages. To allow this it is possible to set the attribute force_summary_hiden in the Designer for elements that should be hidden.
    This tab provides the following form record actions:
  • Datatable
    The submitted form record data will be displayed in a data table.
  • History
    Shows the protocol entries (history) of the current form record. State changes, executed actions, attached files, etc. will be logged and displayed here. This tab provides the following form record actions:
  • Attachments
    If the form record contains attachments this tab will be displayed and allows access to the form record attachments.

Action row

  • State change
    Saves changes in the form data, changes the state of the form record and executes the actions of the selected state. This action is only available if the state can be changed by the user. The state can only be changed if:
    • the current state of the selected form record has a follow-up state.
    • the user is allowed to change the state (can be configured in the workflow).
  •   Save
    Saves changes to the form data.
  • Delete
    Deletes the form record and closes the review area.
  • Erweiterte Optionen
    Öffnet einen Dialog, welcher erweiterte Vorgangsänderungen ermöglicht:
    • Formulardatenkorrigieren: Speichert Änderungen im Formular mit der Option die Formulardaten (nicht) zu validieren.
    • Aktionen des aktuellen Status erneut ausführen: Führt die Aktionen des aktuellen Status erneut aus. Dabei kann konfiguriert werden, ob Änderungen im Formular gespeichert und validiert werden sollen.
    • Statuswechsel: Analog zum normalen Statuswechsel, wobei konfiguriert werden kann, ob die Aktionen des Zielstatus ausgeführt werden sollen und ob Änderungen im Formular gespeichert und validiert werden sollen.
  • Eintrag hinzufügen
    Öffnet einen Dialog, welcher es ermöglicht dem Vorgang Protokolleinträge bzw. Bemerkungen hinzuzufügen. Protokolleinträge werden im Verluaf des Vorgangs dargestellt. Ausgewählte Datein werden an den Vorgang angehangen.
  •   Download von Anhängen
    Lädt die ausgewählten Anhänge herunter.
  • Anhänge löschen
    Löscht die ausgewählten Anhänge.
Created by gru on 25.03.2019, 12:10
Translated into en by gru on 25.03.2019, 12:10

Navigation

Copyright 2000-2025