This article provides a comprehensive guide to the Org Processor, a key element of EFS Employee software. It covers organizational structure management, user administration, configuration options, and various features for employee surveys.

Organizational structure

When you open the Org Processor, the Organizational Structure tab will be displayed automatically. It shows the organizational structure with the key characteristics of the units and forms the starting point for all subsequent work.

Organizational structure.jpg
  • By summing up the values for online participants and/or paper-pencil questionnaires and comparing them with the preset values you can easily check whether the stored data are correct.
  • By clicking a unit in the organizational structure you can access all the data stored for this unit, i.e., properties such as name or process status, contacts, preset value, participant data, or requisition notes concerning paper-pencil questionnaires.

The data in the overview are updated every five minutes. If necessary, use the Update Participant Numbers icon to trigger an update manually.

Changing the view

Above the organizational structure you will find four buttons with which you can change the display:

  • Expand all: All branches of the organizational structure are opened entirely so that you can see every unit. In large structures, this action requires considerable time: The auto-expansion feature described below presents a time-saving alternative. For very large structures, i.e. structures with 1,000 or more units, both features are hidden for performance reasons. Use the search function to find the desired units in such large structures!
  • Collapse all: All branches of the organizational structure are closed entirely. Only the topmost unit of the hierarchy remains visible.
  • Activate / Deactivate auto-expansion: This function makes sure that the respective branch is always completely expanded upon clicking. You no longer have to click every single node to see the whole branch in its entirety. This function is disabled again by clicking Deactivate auto-expansion. Please mind that auto-expansion is not available for very large structures, i.e. structures with 1,000 or more units, for performance reasons.
  • View: Clicking this button will open a dialog where you can activate or deactivate various table columns (except for the permanent columns “Short form of unit name” and “Actions”). After you have confirmed by clicking on Save settings the table will be modified accordingly.

Opening other structure views

If several structure views are used, you will find a drop-down list above the menu where you can switch back and forth between the different structure views. As soon as you change the setting, the desired structure view will be displayed.

Searching for units

Above the organizational structure, you will find a search function that allows you to browse the structure for a particular unit. This makes it much easier to locate units in complex organizational structures. Depending on the composition of the unit names, you can also use the search function to limit the display to groups of units. Please proceed as follows: Enter the name or part of the name of the desired unit in the field “Organizational unit” and trigger the search process by clicking on Search. The results show all units containing the search term, including their path upwards to the main unit (root unit) – i.e., all units one level up. To display all units again, you have to delete the entry in the text field and click on Search again.

The content of the organizational structure in detail

Column headingMeaning
Short form of the unit nameName of the respective unit.
MetanameUnique identifier of the unit.
ParticipantsEmployees of this unit completed the questionnaire online. This column is only visible for the survey types “Online survey” and “Hybrid survey”
The sum of the online participantsSum of the employees of this unit and all subunits completing the questionnaire online. This column is only visible for the survey types “Online survey” and “Hybrid survey”.Participants with disposition codes 13, 14, and 15 are included.
Paper-pencil questionnairesThe number of paper-pencil questionnaires to be distributed in this unit. This column is only visible if either of the survey types “Paper-pencil survey” or “Hybrid survey” has been selected
Sum of paper-pencil questionnairesThe sum of the paper-pencil questionnaires to be distributed in this unit and all its subunits. This column is only visible if either of the survey types “Paper-pencil survey” or “Hybrid survey” has been selected.
If adjustment of target figures is activated: Correction factorThe direct correction factor, i.e. the value entered for this unit.
If adjustment of target figures is activated: Correction factor abs.Aggregated correction factor, i.e. the sum of correction values for this unit and all its subunits.
NDepending on the survey type chosen and the activation of target figure adjustment, this column contains the following sum:(aggregated target value paper-pencil questionnaire data) + (aggregated target value participant data) + (correction factor abs.)
Staff (preset value)Preset number of employees of the respective unit to participate in the survey.This value is preset when creating the unit and serves to check the target numbers calculated based on the list of participants and the number of requested questionnaires.
Process statusThe icons help you to identify the process status of the units and potential problems at a glance:A white F icon signals that a unit has been released for filtering. If a unit is actually used in a filter definition, the icon is lilac.The lock icon indicates whether the unit is still released for editing or is already locked.The traffic light icon indicates the editing status. The symbols have the following meanings:Red: No preset number of employees has been defined yet, no participant data have been stored, and/or no paper-pencil questionnaires have been requested.Yellow: No participant data have been stored for the current unit and/or no paper-pencil questionnaires have been requested. The preset number has already been defined, though. Also, participant data have been stored, and/or paper-pencil questionnaires have been requested for the subunits.Green: The preset number of employees has been defined for the current unit, participant data have been stored and paper-pencil questionnaires have been requested.Exclamation point: The preset number of employees for this unit is considerably lower than the number of requested paper-pencil questionnaires or the number of registered participants.
ActionsThe icons and checkboxes in this column provide access to a variety of actions

The calculation of the sum of all participants in HR Reporting differs slightly from the Org Processor values. Participants with disposition codes 13, 14, and 15 are not included in this sum in the Org Processor but are included in HR reporting.

Actions

A variety of actions are available that can be applied to individual, selected, or all units of the organizational structure.

Actions for editing individual units

The following actions are used to edit individual units, e.g., to subsequently edit or to move units to another position. They are mostly used during the construction phase.

  • Edit: Opens the dialog with the data of the respective unit for subsequent editing.
  • Create unit: Opens the dialog where you can enter the data for a new unit. By default, this unit is created below the respective unit.
  • Export to Excel: Triggers the export of the respective unit and all subunits.
  • Import structure: Allows the import of new substructures under the respective unit.
  • Participants: Opens the Participants tab in the detailed view of the respective unit.
  • Move up / down: Moves the respective unit and all its subunits up or down one position in its branch. Please note that this will merely modify the display while the structure remains unchanged.
  • Adjust target figure: You can define a correction value that will be applied to the aggregated participant numbers of the respective unit.
  • Delete: This option allows you to delete the respective unit while moving any existing participant data or subunits to another position.

These actions are located in a layer that opens when you click on the Actions icon.

Actions for editing all or selected units

The following actions can be applied to selected or all units. They serve primarily for process control, e.g., for locking units against further editing or for sending e-mails to users.

  • Lock units: With this action, you can protect units against further editing.
  • Lock units and subunits.
  • Release units: With this action, you can undo the locking of units.
  • Release units and subunits.
  • Mail users.
  • Mail users of the selected unit and its subunits.
  • Release units for filtering: Allows access to these units from the condition editor when defining filters and hiding conditions.
  • Revoke filter release for units: Deactivates access to these units from the condition editor.
  • Delete units: This action allows you to delete several units en bloc if these do not yet contain any participant data or subunits.

These actions can be found in the drop-down list below the organizational structure. Select the desired units by ticking the checkboxes in the “Actions” column or via the checkbox “Apply action to the whole organizational structure”. Then specify the desired action and confirm by clicking on Execute.

Detail view

By clicking on a unit in the organizational structure you open its corresponding detail view. The detail view contains all the data stored for the unit, arranged on various tabs.

  • Status information: This tab contains the following information and functions:
    • Name, short form of name, and meta name of the unit. These data can be edited on the Edit unit tab.
    • Buttons for locking and releasing the unit or its subunits for editing.
    • Data that indicate the status of the survey for the unit and its subunits.
  • Edit unit: On this tab, you can subsequently edit basic properties of the unit such as name, meta name, or preset number of staff.
  • Text elements: Unit-specific Org Processor data, such as names and other unit properties, can be inserted into the questionnaire using wildcards. On this tab, the desired data – and in multilingual surveys, their translation – are entered.
  • Participants: On this tab, you create and manage the survey participants of the unit.
  • User management: On this tab, you can view the responsible persons of the unit or define new responsible persons.
  • Paper-pencil questionnaires: If the logistics functions of EFS Employees are activated, you can register your paper-pencil questionnaire requirements or view already existing requisition notes.
  • Import structure: The import dialog on this tab allows the import of new substructures under the current unit.

The tabs of the detail view provide access to a wide range of data and functions. You will find detailed explanations in the respective chapters mentioned above.

View

By clicking on the Show Tree view button you can have the tree view displayed for better orientation. The current unit will be marked with a red arrow. To hide the tree view again, simply click on Hide tree view. The arrow icons allow you to switch to the units located directly above or below the current unit in the tree.

Manually building the organizational structure

The organizational structure in the Org Processor is created top-down, i.e., starting with the topmost unit, the entire corporation, and the corporate structure is mapped down to the smallest unit (depending on the desired level of detail). The organizational structure can either be built up manually, created by import, or
created by a combination of both manual build-up and import. The manual build-up of organizational structures may be rather time-consuming but also offers valuable insight into how to store which data. This will improve your understanding of the import process and facilitate any subsequent manual editing.

If you want users to be able to create units, you need to assign the right structure_add_del_nodes to the appropriate roles.

Up to 40,000 units can be created in a project. But please keep in mind that very complex structures are confusing and difficult to navigate. Also, server performance is negatively affected by very large structures.

Creating units

To create a new unit, please proceed as follows:

  • Open the dialog for creating a new unit. There are two ways to do this:
    • By clicking on the Create unit button you can invoke the dialog directly. If the organizational structure is still empty, then this is how you create the main unit (root unit).
    • Look for the unit in the organizational structure below which you want to create the new unit. Click on the Actions icon to open the selection layer and then click on the link Create unit. This approach has the advantage that the correct unit one level up will automatically be preset in the edit dialog.
  • Enter the required data
    • Name of unit: Name of the respective unit
    • Short form of unit name: Name of the respective organizational unit as it is to be displayed in the organizational structure. For greater clarity, a shortened form of the actual name is usually used.
    • Meta name: Unique identifier of the unit. The meta name may contain only the following characters: a-z, A-Z, 0-9, “_”, “-“
    • Parent unit: In this field, you specify the parent unit. If you have opened the dialog via the Actions layer, the correct unit should be preset automatically. If you have used the Create Unit button, you may have to specify the correct unit first. Clicking on the binoculars icon will open a list of all organizational units.
    • Staff (preset value): Preset number of employees for this unit.
    • Permit allocation to units in the questionnaire: Activate this action if participants are to be able to allocate themselves to the units.
    • Create another unit afterward: Activate this option if you wish to manually create further units. Upon saving, the dialog for creating units will open again automatically.
  • Click on Save.
  • After Saving the unit, switch back to the overview by clicking on the link Back to organizational structure. You will see the new unit in the Organizational structure.

Importing an organizational structure

Instead of manually building the structure you can also import the entire structure or parts of it using a CSV or Excel file.

Before you start

  • Do not start preparing the import before you have created all the required structure variables.
  • The organizational structure may have any number of levels.
  • When using Excel, you have to observe the following restrictions due to the specifications of the manufacturer:
    • Only the first sheet of the file will be processed. The maximum number of 256 columns and the maximum number of 65,000 rows should not be exceeded. If you require more columns or rows, choose another program and save the import file in CSV format.
    • When using very large numbers as meta names, please note the following: Depending on the operating system, large numbers may be stored as
      exponential numbers in Excel. When importing, EFS will adopt these exponential numbers as the meta names. You can easily avoid this problem by saving your Excel table in CSV format and then importing this CSV file.
    • Excel import is only possible when using files created or stored with Excel 97+. Excel files that have been created or stored with “Excel for Mac”, “Neo Office”, or “Numbers” cannot be imported as a matter of principle.
    • The file format XLSX, newly introduced by Microsoft with Office 2007, is not supported by EFS. Please save your files as XLS files before starting the import process.

If you want users to be able to import structures, you need to assign the right structure_import to the appropriate roles.

Import process in detail

Download import template

Open the import dialog. There are three different methods to choose from:

  • If there is no organizational structure yet, use the Import structure button. The illustrations in this chapter show such a complete import.
  • Otherwise, you need to locate the reference unit within the organizational structure, i.e., the unit under which to import the new structural portion. Open the Actions layer and click on the link Import structure.
  • If you are already in the detail view of the unit under which to import the new structural portion, open the Import Structure tab.

For each import format, i.e. level import and connected list, there is an already preformatted import template available, containing all the required columns. This
template can be downloaded by clicking on the Import template “Level import” or Import template “Connected list” respectively. The illustrations in this chapter show a level of import.

Format the import file

Open the file in a suitable program, e.g., in Excel.

  • Enter the data.
  • Save the file in Excel or CSV format.

Match the fields of the import file with the database fields

Again, open the import dialog.

  • If you import into an already existing structure instead of performing a complete import, the field “Update existing structure data” will be displayed. Tick this checkbox if you wish to perform an update.
  • Select the appropriate character set.
  • Use the Browse function to select the import file on your PC.
  • Make sure that the checkbox in the field “First row includes column labels” is ticked or unticked accordingly. Usually, it should be ticked.
  • If your import file is formatted as a “Connected list”, activate the checkbox.
  • Automatically generate meta name prefixes: If you are importing an already existing structure, you can modify the meta names and render them unique by entering a prefix in this field. This can be helpful when two subareas of a company have identical substructures which are duplicated by export and import.
  • To start the import process click on Send file.
  • In the next step, the columns of the import file have to be matched to appropriate fields of the database. If you have retained the column labels as recommended, then the software will perform the allocation automatically.
  • After checking the allocation, confirm by clicking on Open Preview.

Check the import data in the preview

The import preview shows all data records as they are imported into the project.  This step allows you to subsequently change data with the aid of the following new information and edit options:

  • Status: The traffic light icon in the “Status” column tells you whether the data record is complete and logically coherent. A red icon indicates an error. Move your mouse pointer over the icon to display the reason for this error.
  • Edit: By clicking on this actions icon you can open a dialog to subsequently change the respective data record.
  • Delete: The respective data record will be deleted after a confirmation prompt.

Perform the import and download the results

If you are satisfied with your data in the preview, click on Import to trigger the actual import process. Following the completion of the import process, the program will indicate how many data records were successfully created and how many were not created due to certain problems. An Excel file containing the following information can be downloaded by clicking on the Download results button:

  • all the data in the import file
  • The “result” column contains the result of the import, i.e., either the message “Data record import successful” or “Data record not imported”.
  • If any problems occur, the reason will be indicated in the “messages” column.

If necessary, you can correct the data records that were not successfully created directly in this file, delete the successfully created data records, and then use the file again for a new import attempt.

Columns of the import file

ColumnLabelExplanationData typeSize
metanameMeta nameUnique identifier of the unit. The meta name may contain only the following
characters: a-z, A-Z, 0-9, “_”, “-“
Text field65,536 characters
labelShort form of the unit nameName of the respective organizational unit as it is to be displayed in the organizational structure. For greater clarity, a shortened form of the actual name is usually used.Text field256 characters
label_externName of unitName of the unitText field256 characters
level_1, level_2,…level_12 Levels of the organizational structure.The short form of the unit described in the respective row is always entered in the
column corresponding to the level of the unit relative to the reference unit.
Text field65,536 characters
status Process status. Indicates whether the unit is released or locked.Available options are:0: Unit is released, i.e., it can be edited.1: Unit is locked.Checkbox 
co_target Preset number of employees for this unit.int(11)max 2,147,483,647
visiblePermit allocation
to unit in the
questionnaire
This variable is only relevant in combination with the special programming for self-allocation. It specifies whether a
participant who is allowed to allocate himself may view and select the respective unit in the questionnaire. Available options are:0: Unit is not offered.1: Unit is offered.
  
historic_codeComparison unit of the preceding yearIn the past, the code of the comparison unit from the previous survey was stored in this variable. The meta names are used to identify comparison unitsint(11)max
2,147,483,647
hide_unitHide unit in questionnaire (including subunits)This variable is only relevant in combination with the selfallocation. It
specifies whether a participant who is allowed to allocate himself may see the respective unit and its subunits in the questionnaire. Available options are:0: The unit including its subunits is displayed.1: The unit including its subunits is hidden.
Checkbox 

Formatting of the import file in detail: Connected List

You can export and if necessary, externally edit and reimport the organizational structure or parts thereof. This can be useful in various situations:

  • You want to check the stored structures and/or numbers or relay these data to third parties for verification.
  • You want to change the names of the units or update already stored numerical values in an already existing structure.
  • You want to reuse parts of the organizational structure elsewhere in the same project. If, for example, two departments have the same or very similar
    substructures, then you can export the completed substructure of the first department, adjust the names and values for the second department in the export file, and subsequently import it into this second department.
  • You want to reuse the entire organizational structure or parts thereof in another project (e.g., in an intermediate survey).

Before you start

Please note: Via import you can insert new substructures in already existing structures, change the names of existing units, or update stored numbers. It is not possible, however, to move, merge, or delete existing units via import.

Exporting, modifying, and reimporting an existing structure

If you want to modify a structure or parts thereof and reuse it elsewhere in the project, please proceed as follows:

  • You want to check the stored structures and/or numbers or relay these data to third parties for verification.
  • You want to change the names of the units or update already stored numerical values in an already existing structure.
  • You want to reuse parts of the organizational structure elsewhere in the same project. If, for example, two departments have the same or very similar substructures, then you can export the completed substructure of the first department, adjust the names and values for the second department in the export file, and subsequently import it into this second department.
  • You want to reuse the entire organizational structure or parts thereof in another project (e.g., in an intermediate survey).

Before you start

Via import, you can insert new substructures in already existing structures, change the names of existing units, or update stored numbers. It is not possible, however, to move, merge, or delete existing units via import.

If you want users to be able to export return data, you need to assign the right structure_export and/or structure_export_full to the appropriate roles

Exporting, modifying, and reimporting an existing structure

If you want to modify a structure or parts thereof and reuse it elsewhere in the project, please proceed as follows:

Exporting

  • Locate the desired unit in the organizational structure. Click on the Actions icon to open the selection layer and then click on the link Export to Excel.
  • Specify the extent of the export data record. The following options are available:
    • Standard export
    • Standard export and user-defined variables: If you have created additional structure variables (see Chapter 4.4, p. 56), this option may be useful.
  • Select the character set.
  • Trigger the export process by clicking on Send.
  • Save the Excel file to your PC.

If an Excel file is opened on a computer running with Windows 7 and Excel 2007, depending on the circumstances, a message may be displayed that notifies you that the file is corrupted. This problem is caused by an extension provided by a third party supplier. Until further notice, please proceed as follows: Save the file locally. Then, open the saved file, allowing Excel to repair it. Finally, save the file again.

Editing the export file

Edit the export file. Please pay special attention to the following:

  • The second row, directly under the column labels, contains the reference unit, i.e., the unit under which the new structure is to be imported.
  • The levels are indicated in relation to this reference unit.
  • If you duplicate an already existing substructure in the same project, e.g. in another department or in another structure view, you have to change the meta names. If you do not want to change each meta name by hand, you can use the option “Automatically generate meta name prefixes” when reimporting.

Importing

Locate the reference unit in the organizational structure, i.e., the unit under which the structure is to be imported. Click on the Actions icon to open the selection layer and then click on the link Import structure.

Using the import function for updating values in an existing structure

If you only wish to update an existing (sub-)structure, please proceed as follows:

  • Export the (sub-)structure as described above.
  • Update the desired data in the export file.
  • Afterward, import the (sub-)structure again under the same parent unit. The option “Update existing structure data” in the import dialog has to be activated during the import process.

The existing structure will now be updated with the contents of the import file. Units that were not part of the existing structure before will be newly inserted. The structure of existing nodes remains unchanged.

If you do not tick the option “Update existing structure data”, the entire import structure will be newly inserted under the specified reference unit as described above in Chapter 4.9.2, p. 80. If there have been units already, they will be newly created nonetheless and automatically assigned new system-generated meta names.

Subsequently editing units

Frequently, stored data need to be subsequently edited due to changing numbers of participants or changed structures in certain business areas, for example. So long as the units have not been locked for editing by the project management or a higher-level responsible person, this can be done without difficulty. You have the following options:

  • You can reopen the edit dialogs and change data in there.
  • You can move units to another position within the structure.
  • You can merge units.
  • You can delete units.

Changing data of a unit

You can subsequently change the data of a unit. There are two ways to open the editing dialogs above:

  • Locate the desired unit in the organizational structure. Click on the Actions icon to open the selection layer and then click on the link Edit. This opens the detailed view of the unit. The Edit unit tab with the dialog is displayed automatically. If you want to edit data on another tab, click on that tab.
  • Locate the desired unit in the organizational structure and click on the title. The detail view is opened, and the Status information tab is displayed automatically. Switch to the desired tab.

If you want users to be able to edit units subsequently, you need to assign the right structure_edit_node to the appropriate roles

Moving units

It may be necessary to move individual units or entire structures within the organizational structure. This is the case, for example, when certain parts of the company have been restructured and the structure needs to be updated accordingly. Instead of deleting the entire affected structure and recreating it elsewhere, you can also move it.

There are two functions for moving files:

  • the function described here allows you to move a unit under another parent unit, i.e., you modify the structure.
  • with the “move up / down” function in the Actions layer you merely change the order in which the units of a branch are displayed in the organizational structure.

Please proceed as follows:

  • Locate the unit you want to move to another position along with its subunits.
  • Click on the title of the unit to open its detail view and select the Edit Unit tab.
  • This takes you to the dialog. In the field “Parent unit” you can select another parent unit. To do so, click on the binoculars icon.
  • This prompts a list of all available units. Browse this list and select the desired new parent unit by clicking on Select.
  • Confirm by clicking on Save.

If there is no Select icon displayed next to a unit, this is usually because it is either the current unit or the currently assigned parent unit.

Merging units

It may be necessary to merge units. This is the case, for example, if parts of a company have been restructured or if, for logistical reasons, a particular department along with its subdepartments is to be mapped as one single unit. The function Merge units allow you to perform two actions in one step: The already existing participants and paper-pencil questionnaire data of the source unit are imported into the target unit and the source unit is then deleted. If the source unit consists of further subunits, then you can either move the contents of these subunits into the target unit as well, subsequently deleting the subunits, or adopt the subunits unchanged into the target unit.

Please proceed as follows:

  • Click on the Merge Units button.
  • Select the target unit, i.e., the unit where you want to move the contents of the source unit.
  • Select the source unit, i.e., the unit the contents of which are to be moved or that is to be deleted itself.
  • Confirm by clicking on Save.
  • In case the source units have subunits, there are two options:
    • Merge units: The online participants and paper-pencil questionnaire data of the subunits are moved to the target unit, and the subunits themselves are deleted. The users of the subunits are not adopted.
    • Move units: The subunits complete with online participants, paper-pencil questionnaire data, and users are moved below the target unit.
  • Confirm again by clicking on Save.

If you want users to be able to merge units, you need to assign the right structure_combine_nodes to the appropriate roles.

The users of the source unit are not adopted in the merging process.

Deleting units

Units can be deleted, for example, if they have been created inadvertently or if the corporate structure has changed and needs to be mapped accordingly. There are two ways to do this, depending on whether you want to delete one or several units and whether these are units with participants and/or subunits:

  • You can delete these units individually and, if necessary, move existing participants, paper-pencil questionnaires, and subunits.
  • If you have to delete several units, you can delete them en bloc. Any existing subunits or requisition notes for paper-pencil questionnaires will be deleted as well. Participants will not be deleted, but the allocation to the deleted unit is lost.

Deleting a unit, but moving subunits and participant data

If you wish to delete a unit without losing any already existing participant data, paperpencil questionnaire data, and/or subunits, please proceed as follows:

  • Locate the desired unit in the organizational structure. Click on the Actions icon to open the selection layer and then click on the link Delete.
  • If the unit contains subunits and/or if participants have already been entered for the online questionnaire, you will be asked how the data is to be handled:
    • If you want to move the participants and the paper-pencil questionnaire data of the current unit, then select the desired target unit in the field “Move the participants of the unit to”.
    • If you do not want to delete the subunits, then leave the checkbox in the field “Delete subunits” unticked. The subunits with their participants will be moved under the next higher unit.
    • If you tick the checkbox “Delete subunits”, the subunits will be deleted and their participants will either be assigned to the specified target unit or also deleted, depending on the setting for the option “Move the participants of the unit to”.
    • The default setting is “Delete assigned participants” and the option “Delete subunits” is deactivated, i.e., the subunits and their participants are moved under the next higher unit.
  • Confirm by clicking on Delete unit now.

Deleting several units en bloc

You can easily delete several units en bloc. Any existing subunits or requisition notes for paper-pencil questionnaires will be deleted as well. Participants are not deleted, but the allocation to the deleted unit is lost.

  • Locate the units to be deleted in the organizational structure and tick the checkboxes in the “Actions” column.
  • Select the “Delete unit” action from the drop-down list.
  • Confirm by clicking on Execute.

If you want users to be able to delete units, you need to assign the right structure_add_del_nodes to the appropriate roles.

Locking units after finishing

Units, subareas, or the entire structure can be locked, i.e., the units in the organizational structure are then clickable and it is no longer possible to view the data or to edit the locked area. This locking is usually done at the end of the preparation stage: It allows for the checking of the structure and the stored data without anybody changing any values in the background.

Locking units

There are two options, depending on whether you want to lock one or several units with or without subunits:

  • Locate the desired unit in the organizational structure and click on the title. This opens the detailed view of the unit. The Status information tab is displayed automatically. Select the appropriate button in the section “Locking and releasing units”. Available options are:
    • Lock current unit: Locks the current unit, but not the subunits.
    • Lock subunits: Does not lock the current unit, but its subunits.
  • Locate the units to be locked in the organizational structure and tick the checkboxes in the “Actions” column. Select either the action “Lock units” or “Lock units and subunits” from the drop-down list. Confirm by clicking on Execute.

If you want users to be able to lock units, you need to assign the right structure_lock to the appropriate roles

Releasing locked units

To re-release locked units, you need to proceed exactly as described above, except for choosing different actions:

  • Locate the desired unit in the organizational structure and click on the title. This opens the detailed view of the unit. The Status information tab  is displayed automatically, however, in the case of locked units and/or subunits there are different buttons in the section “Locking and releasing units”:
    • Release current unit: Releases the current unit, but not the subunits.
    • Release subunits: Does not release the current unit, but its subunits.
  • Locate the units to be released in the organizational structure and tick the checkboxes in the “Actions” column. Select either the action “Release units” or
    “Release units and subunits” from the drop-down list. Confirm by clicking on Execute.

Return

Your users can open the Return tab only if it has been activated for their role in the current phase. In order to allow your users to open not only their respective units but also the corresponding subunits, and to access the return data, you need to activate the right structure_view_down for the appropriate roles. The return view is located on the Return tab of the Org Processor.

  • The organizational structure gives an overview of the return rates.
  • In the detail view, you will find detailed data on the return of online and paperpencil questionnaires for the respective unit and their subunits. Additionally, you can access the user management of the unit from the detail view.

Above the organizational structure you will find the same features for modifying the display that you are already familiar with from the Organizational structure tab:

  • Selection of the structure view, Search, Expand all / Collapse allActivate auto-expansion, and View.
  • The data in the return overview are updated every five minutes. If necessary, use the Update Participant Numbers icon to trigger an update manually.

You can define a special anonymity criterion for the return. As long as a unit and/or its subunits do not satisfy this criterion, some or all data for this unit and/or its subunits will be hidden in the return view. This is to prevent users with access to the return view can limit the display of survey results to a very small set of participants or even to individual participants. The following hiding conditions apply:

  • Return direct less than anonymity criterion → no display of return direct
  • Accumulated return sum less than anonymity criterion → no display of accumulated return sum
  • Difference of accumulated return sum and return direct less than anonymity criterion → no display of return direct
  • Accumulated return sum less than anonymity criterion → no display of return direct and accumulated for subunits

The overview of the return data in detail

Column headingMeaning
Sum of the participants directSum of the existing online participants, the existing offline participants (i.e. participants with “Offline” flag) and requested paper-pencil questionnaires directly allocated to this unit.
Return directDirect return of this unit, i.e., the sum of those online participants who have already completed the survey with disposition codes 31 or 32, and of those paper-pencil questionnaires whose data have already been scanned or imported into the system (with disposition codes 31 or 32).This sum includes the completed paper-pencil questionnaires: When scanning or importing the data, participant accounts with offline flag are created.
Return rate directDirect return rate in percent, i.e., (Return direct / Sum of the participants direct) * 100
Sum of the participantsSum of the existing online participants, the existing offline participants (i.e. participants with “Offline” flag) and requested paper-pencil questionnaires allocated to this unit and all subunits.
NCorrected sum of online participants and paper-pencil questionnaires, if target figure adjustment is activated.
Accumulated return sumAccumulated return for this unit and all subunits, i.e., the sum of those online participants who have already completed the survey with disposition codes 31 or 32, and of those paper-pencil questionnaires whose data have already been scanned or imported into the system (with disposition codes 31 or 32).This sum includes the completed paper-pencil questionnaires: When scanning or importing the data, participant accounts with offline flags are created.
Accumulated return rateAccumulated return rate in percent, i.e., (Accumulated return sum / Sum of the online participants) * 100 
ActionsBy clicking on the icons in this column you can trigger the actions

The calculation of the sum of all participants in HR Reporting differs slightly from the Org Processor values. Participants with disposition codes 13, 14 and 15 are not included in this sum in the Org Processor, but are included in HR reporting.

The overview with a separate display of online and offline participants

In hybrid surveys, you can optionally activate an alternative return view which displays the data of online and offline participants separately.

  • In this view, the sum of existing online participants and those offline participants for whom a participant account already exists is used as the base value when calculating the return rate. I.e. it is assumed that participant accounts with the “Offline” flag have already been created for the offline participants, for example via project data import. Date from logistics, i.e. in particular numbers for requested paper-pencil questionnaires, are not considered, in contrast to the default return view.
  • To be considered as completed interviews for the return and the return rate, the offline interviews must have disposition code 31 or 32.

The alternative return view is activated in the Org Processor → Configuration menu on the Options tab in the „Display return of online and offline participants separately“ field.

Column headingMeaning
Sum of the participants directSum of the online participants and offline participants directly allocated to the current unit.
Online returnDirect return of the current unit, i.e., the sum of those online participants who have already completed the survey with disposition codes 31 and 32.
Online return rateDirect online return rate in percent, i.e. (Online return / Sum of the participants direct) * 100
Return of unit for paperpencil questionnairesDirect offline return of the current unit, i.e. the sum of offline participants (characterized by flag “Offline”) with disposition codes 31 or 32.
Return rate of unit for paper-pencil questionnairesDirect offline return rate in percent, i.e., (Return of unit for paper-pencil questionnaires / Sum of the participants direct) * 100
Sum of the participantsSum of the existing online participants and the existing offline participants allocated to the current unit and all subunits.
Online total returnAccumulated online return, i.e., the sum of those online participants who have already completed the survey with disposition codes 31 or 32, for the current unit and all subunits.
Accumulated online total return rateAccumulated return rate in percent, i.e., (Online total return / Sum of the participants) * 100
Total return paper-pencil questionnairesAccumulated offline return, i.e. the sum of offline participants (characterized by flag “Offline”) with disposition codes 31 and 32 for the current unit and all subunits.
Accumulated total return rate paper-pencil questionnairesAccumulated return rate in percent, i.e., (Total return paper-pencil questionnaires / Sum of the participants) * 100
ActionsBy clicking on the icons in this column, you can trigger the actions

Actions

The following Action icons are available:

  • Participants: This icon takes you directly to the desired unit’s return statistics.
  • Export: This icon takes you directly to the export options.

Return data of a unit

By clicking on the name of a unit you can open the unit-specific detail view. This view contains

  • the respective unit’s return statistics described below.
  • the export options.
  • the user management.

Viewing the return statistics of a unit

On the Return tab of the detail view, you will find the return statistics of the respective unit. Listed are the number of employees, the return, and the return rate for the unit itself (i.e., “directly assigned”) and also accumulated for the unit including all subunits. In the case of hybrid surveys, the values for online and paper-pencil questionnaires are listed separately in addition to the aggregate values.

The return rates for the paper-pencil questionnaires always refer to those paper-pencil questionnaires whose data have already been scanned or imported into the system.

Exporting return data

The return data can be exported. This may be useful, for example, if you want to evaluate or present the data using third-party applications.

  • There are two export options:
    • Small export: This data record contains the aggregate values for all units (return overview: accumulated sum of the participants, accumulated return, accumulated return rate).
    • Expanded export: This data record lists all data in detail (return overview, return of the respective unit, and separate values for online and paper-pencil questionnaires).
  • The export always comprises the current unit and all subunits to which you hold the relevant access rights.
  • The formatting of the Excel files allows them to be presented or relayed to third parties without further preparation.

To export the return data, locate the desired unit on the Return tab. Click on the Export icon. Select the desired export option and the character set, and confirm by clicking on Send.

If you want users to be able to export return data, you need to assign the right field_export_response_short and/or field_export_response_full to the appropriate roles.

When presenting or relaying survey data, please observe the data protection regulations applying to your employee survey.

Report Overview

Upon completion of the survey, results reports are generated and made available for download to the responsible persons. The distribution process is usually managed directly in the Org Processor via the Report Overview tab. Your users can open the Report Overview tab only if it has been activated for their role in the current phase. To allow your users to open and edit not only their respective units but also the corresponding subunits, you need to activate the right structure_view_down for the appropriate roles.

  • The organizational structure, which opens automatically, will show you whether there are any reports for the individual units and if so, how many.
  • In the detail view, you will find the list of reports and the user management of the respective unit.
  • As a project manager, you can download all available reports.

Above the organizational structure, you will find the same features for modifying the display that you are already familiar with from the Organizational structure tab: Selection of the structure view, Search, Expand all / Collapse allActivate auto-expansion, and View.

The data in the report overview are updated every five minutes.

The report overview in detail

Column headingMeaning
Number of reportsNumber of available reports for this unit.
Accumulated return sumReturn of this unit and all subunits.
ActionsBy clicking on the icon in this column you can call up the actions

Actions

The following actions are available in the Actions layer:

  • Reports: This link takes you directly to the selected unit’s report overview.
  • Export list of reports: This link takes you to the export options for the list of reports

Reports of a unit

By clicking on the name of a unit you can open the unit-specific detail view. This view contains

  • the reports of the unit.
  • the list of reports 
  • the user management 

Downloading reports

Select the desired report and the desired language, then click on Download.

If you want users to be able to download reports, you need to assign the right reporting_download to the appropriate roles. The users will then be able to download the reports that are available for their role in their units in the current phase.

Exporting the list of reports

You can export a list of the available reports. This is useful, for example, if you want to check whether all the required reports are available as desired.

  • The export always comprises the current unit and all subunits to which you hold the relevant access rights.
  • There are two export options:
    • The standard list of reports: This data record contains the report ID, unit, report type, and name, status, date of creation, file type, and language for each report.
    • Expanded list of reports: This data record also lists report size and number of downloads. (The number of downloads includes both the downloads via the Org Processor and the download platform.)

To export the list of reports, locate the desired unit on the Report Overview tab. Click on the Actions icon and select the link Export list of reports. Select the desired export option and the character set, and confirm by clicking on Send.

Alternatively, you can download the list via the Export List of Reports button on the Reports tab.

Org Processor users

EFS Employee allows you to delegate data entry and maintenance for individual organizational units to staff that usually belong to the respective units. Via the separate Org Processor login, these staff members – the so-called users – have access to those Org Processor views and functions required for their work, restricted to their respective areas of responsibility. This chapter tells you how to manage the users of your project in their everyday work.

The Org Processor from the user’s perspective

As a member of the project management, you have an administrator account for EFS Employee. This allows you to log into the admin area of EFS Employee and, for example, configure the survey process, work on the questionnaire, or view the list of participants for the entire project. Staff members who merely maintain or retrieve data of a specific unit have a different type of account: the so-called user account. This account allows them to log into the Org Processor and, within the confines of their role, view and maintain data for their area of responsibility. However, they are not granted access to the admin area. In order to allow the optimum management of these users, you should know how they access the Org Processor and which features are available to them.

Opening the Org Processor from the user’s perspective

By default, there is always a user account for you in the Org Processor. If you have created the project and activated Logistics, this account is also the person responsible for the default logistics site. You can use this account to test the separate Org Processor login:

  • In the Survey menu of the project, you see the URL of the questionnaire. Open a second browser window. Copy the URL into the address bar, add /orgprocessor, and click on Enter: This opens the Org Processor login.
  • Open the menu Org Processor → Org Processor users. Locate your user account and open the detail view by clicking on the Edit icon. Use the given initial password to log in.

This will take you to the start page of the separate Org Processor area where the users work. Usually, there will be no other tabs activated besides the start page. To activate more tabs, you have to allocate an area of responsibility and a role to your test user. The example below shows the start page of an owner, who can access Organizational structureReturn, and Report overview during the pre-test phase.

Your automatically created user account exists separately from your staff account for the www area of EFS Employee, i.e., the accounts have different
passwords, among other things. You can’t log into the separate Org Processor area with your staff account.

Differences between project manager and user perspective

The table provides an overview of the most important differences between the project manager and user perspective.

 Project managerUser
Work area: Admin area (www login)x 
Work area: Org Processor (separate login)with automatically created user accountx
Work area: Download platform)with automatically created user accountx
Access rights: ACL rights and object rights define the rights for teamsx 
Access rights: The Org Processor rights administration defines the rights for roles x
Centralized participant administrationx 
Unit-specific list of participantsxx
Centralized user managementx 
Unit-specific user managementxx
Importing usersx 
Org Processor start pageConfiguration in the
menu Org Processor→ Configuration → Org Processor
interface
x
Writing e-mails to usersxOnly using the mail templates provided by the project manager


Editing user variables

Before creating users, you should adjust the structure of the user management to the requirements of your current project. This is done in the menu Org Processor → Org Processor users → User variables. The following table lists the variables of the user management in the standard configuration.

VariableLabelMeaningFile typeSize
u_firstnameFirst nameFirst nameText field255 characters
u_nameNameNameText field255 characters
u_emailE-MailE-mail. Serves as the unique identifier in the system.Text field255 characters
u_genderGenderGenderText field255 characters
u_unitOrganizational unitThis field can be used to specify the membership in a subsidiary or a department.Text field255 characters
u_cityCityCityText field255 characters
u_countryCountryCountryText field255 characters
langlangThe language of the user interface in the Org Processor upon login. You can choose between:English (code: en)German (code: de)Text field255 characters
m_dateDate of changeThe date of the last change.Text field255 characters
u_initial_passwordInitial passwordInitial password of the users. You can view the initial password via the user
interface. Once the users have
changed the initial password, you cannot see it anymore. Then you can only reset the password or generate a new one.
  
c_dateDate of creationDate of creation  

The central user list

You will find the centralized user management in the Projects → {Selected project} → Org Processor → Org Processor users menu. It allows you to view and edit all users in the project. The complete user list is displayed automatically when you open the menu. The table lists each user along with the following additional information and actions:

  • The user’s login status, is indicated by the traffic-light icon in the “Info” column (white: did not login yet; green: login possible; red: login not possible).
  • All user data
  • An overview of the user’s roles. If the logistics are activated, the allocations to logistics sites and reshipment points are also listed.

Click on the Edit icon to view the details of a particular user.

Display

Above the user list, you will find the simple and extended search functions, as usual. Clicking on the View button will open a dialog where you can activate or deactivate various table columns (except for the permanent columns “Short form of unit name” and “Actions”). After you have confirmed by clicking on Save settings the table will be expanded accordingly.

Detailed view in the centralized user management

In the centralized user management, you open the detail view by clicking on the Edit icon. The detail view contains all the data stored for the user, arranged on various tabs.

  • Edit user: This tab contains the following information and functions:
    • The account data.
    • The initial password and a function for resetting or generating a new password
    • Login information and a function for locking the account.
  • Organizational units: Via this tab you can view and change the allocation of the user to his units.
  • Reports: On this tab, you can see which reports have been stored for the user.

The unit-specific User List

To view or edit the users of a particular unit, open the User Management tab in the detail view of this unit. The user list lists all the participants of the unit with their first names, last names, email addresses, and roles. Click on the Edit icon to view the details of a particular user.

Display and search functions

As usual, you can modify the list display with the help of different display and search functions:

  • The search function above the list allows you to easily locate any particular user.
  • By clicking on the View button you can display a dialog that allows you to specify whether the various table columns are to be shown or hidden. You can also change the number of rows per page. After you have confirmed by clicking on Send the table will be expanded accordingly.
  • With the Show users from subunits button, you can expand the display by the users of the subunit. (This button is only visible if you hold access rights to the subunits.)

If you want users to be able to view the user list, you need to assign the right manager_view to the appropriate roles.

Detail view in the unit-specific User List

In the unit-specific user management, you also open the detail view by clicking on the Edit icon. Here you will find:

  • the account data
  • the role in the current unit

Actions of the user management

Both in the centralized user management and in the unit-specific lists various actions are available to be applied to individual, selected, or all users.

Actions for editing individual users

The following actions that you can call up by clicking the icons in the “Actions” column are used for editing individual users, such as, for example, to subsequently edit or view the allocated units.

  • Edit: Opens the edit dialog
  • Show allocated reports: A pop-up window shows a list of the reports stored for the respective user. If you want users to be able to use this function, you need to assign the right manager_view_report_alloc to the appropriate roles.
  • Show allocated units: A pop-up window shows a list of the units that the respective user is allocated to. If you want users to be able to use this function, you need to assign the right manager_view_node_alloc to the appropriate roles.
  • Delete user allocations: This function is located in the unit-specific user management. The function removes the allocation of the users to the current unit. Please note: The user accounts are not deleted, the users can still log into the Org Processor and see at least the start page, and maybe also other units that they have not allocated to yet. If you want to prevent this, use the action “Lock accounts” (see below). If you want to remove users from the system completely,_use the Delete function of the centralized user management.
  • Delete: This function is only available in the centralized user management. The desired users are deleted from the system following a security prompt. Please note: Users that are allocated to a reshipment point or a logistics site cannot be deleted. You have to assign the responsibility to another user first.

Actions for editing all or selected users

The following actions can be applied to selected or all users:

  • Mail users: This function allows you to contact the selected users via e-mail. How you can enable your users to e-mail other users in turn.
  • Generate passwords: This function allows you to change the selected users’ passwords or to generate new ones. If you want users to be able to use this function, you need to assign the right manager_set_pw to the appropriate roles.
  • Reset passwords: This function allows you to reset the selected users’ passwords to the initial password. If you want users to be able to use this function, you need to assign the right manager_reset_pw to the appropriate roles.
  • Lock accounts: The locked users can no longer log into the Org Processor. This function is only available to the project management in the centralized user management.
  • Unlock accounts: This function is only available to the project management in the centralized user management.
  • Export users: This function allows you to download the account data of the selected users. This can be useful, for example, if you want to communicate not just via email but also via regular mail. Thus you can download the stored address data. If you want users to be able to use this function, you need to assign the right manager_export to the appropriate roles. If the password is also to be included in the export, this requires the right manager_export_with_pw.
  • Delete user allocations: This function is located in the unit-specific user management. The function removes the allocation of the users to the current unit. The user accounts will remain intact. Please note: The user accounts are not deleted, the users can still log into the Org Processor and see at least the start page, and maybe also other units that they have not allocated to yet. If you want to prevent this, use the action “Lock accounts” (see above). If you want to remove users from the system completely,_use the Delete function of the centralized user management. If you want users to be able to use this function, you need to assign the right manager_alloc to the appropriate roles.
  • Delete: This function is only available in the centralized user management. The desired users are deleted from the system following a security prompt. Please note: Users that are allocated to a reshipment point or a logistics site cannot be deleted. You have to assign the responsibility to another user first.

These actions are located in the drop-down list below the user list. Select the desired users by ticking the checkboxes in the “Actions” column. Alternatively, you can also use the options “Mark all users on this page” or “Mark all found users”. Then specify the desired action and confirm by clicking on Execute.

Creating users

As a project manager, you can both add new users individually and import them.

  • Manual creation is useful, for example, if you want to subsequently add individual persons.
  • Otherwise, using the import function is more effective in most cases.

Depending on whether you work in the centralized user management or a particular unit, the process may be slightly different. If you work in centralized user management, you have to explicitly allocate the users to one or several units, whereas the allocation is done automatically in unit-specific user management. The allocations can also be imported.

Before you start

  • The system is designed for up to 10,000 users. With higher numbers, depending on the circumstances, you might experience performance issues.
  • If you partly delegate the creation of user accounts to users, please note that your users have no access to the import function but have to create all user accounts manually.

Creating users manually in the centralized user management

Creating user accounts from the centralized user management – whether manually or by import – requires two steps:

  • the actual creation of the accounts.
  • the allocation to units. (Depending on how the project is organized, the allocation may be done by import, at a later date, or delegated to users.)

Creating user accounts manually

Please proceed as follows:

  • Open the Projects → {Selected project} → Org Processor → Org Processor users menu.
  • Use the search function to check whether there is already a user account for the respective person.
  • If this is not the case, click on the Add User button.
  • Enter the data. The following rules apply:
    • First name, last name, and e-mail address are mandatory.
    • Use of the other fields is optional.
  • If the project management has activated the semi-automatic delivery of login details, you will also find a checkbox “Send account data automatically when saving”. If you tick this checkbox, the new user will automatically receive an e-mail with his login details.
  • Confirm by clicking on Save.

Allocating users to a unit manually

The user account has been created but has not been allocated to any units yet.

  • You can perform this allocation on the Organizational Units tab. Locate the desired unit(s) and tick the respective “Action” checkbox(es). Select the respective role from the drop-down list that you want the user to have in this unit, and confirm by clicking on Execute.
  • If another user already has the desired unit allocation, EFS allows you to adopt this for new users. For users that have not been allocated to any unit yet, the corresponding function “Copy role of following account” can also be found on the Organizational Units tab. With the binocular icon, you can select the user account with the desired unit and role allocation. Please note: The purpose of this function is to copy the unit allocations listed on the Organizational Units tab. Allocations of users to logistics sites or reshipment points cannot be adopted.
  • You can also perform this allocation by import for all users of the entire project.
  • Alternatively, you can also leave it to already existing users of the higher levels to allocate additional users within their areas of responsibility.

Creating users Manually in the unit-specific user management

To create a new user in the unit-specific user management, please proceed as follows:

  • Open the desired unit.
  • Click on the User Management tab in the detail view.
  • Click on the Add user button.
  • Check first whether an account already exists for the respective person.
    • To do so, click on the binoculars icon in the “Name” field.
    • This will prompt a list of all the users that have already been stored to be displayed. Search this list. If the desired person is present on this list, transfer the data by clicking on Select.
  • Enter the data if the desired user does not exist yet. The following rules apply:
    • First name, last name, and e-mail address are mandatory.
    • Use of the other fields is optional: Please follow the instructions of the project management regarding the data to be maintained.
  • Select the role you want the user to have in the current unit.
  • If the project management has activated the semi-automatic delivery of login details, you will also find a checkbox “Send account data automatically when saving”. If you tick this checkbox, the new user will automatically receive an e-mail with his login details.
  • Confirm by clicking on Save.

If you want users to be able to manually create other user accounts, you need to assign the right manager_add to the appropriate roles.

If there is no Select icon available for a user, this usually means that this user has already been allocated to the current unit: Double allocation to the same unit is not possible.

Importing users

As a project manager, you can import new user accounts instead of creating each account individually. The import process is analogous to the participant import: To open the import dialog click on the Import users button in the Projects → {Selected project} → Org Processor → Org Processor users menu. Here, click on the Download import template to download the already pre-formatted import template. Fill this out and then import as usual. The formatting of the import file is also similar to that of the participant import file and follows the same rules.

Importing the allocation of users to units

The allocation of the users to the units can also be defined by import. The import process is analogous to the participant import. Only the formatting of the import file differs from the usual procedure: There are no account data to be entered, but allocations between user accounts, units, and roles. The import file contains the following columns:

  • The column “u_email”: The e-mail address serves as the linking variable.
  • The column “metaname”: The meta name indicates which unit the user is to be allocated to.
  • The column “role”: In this column, you enter the abbreviation for the role the user is to assume in the unit identified by the meta name.

The rows list the individual allocations user:unit.

If a user is to be allocated to multiple units, you have to list him multiple times. In the example shown, the user “Frank Sample” is allocated to one unit as owner and to a second unit as a report recipient.

Please note:

  • A user can not assume multiple roles within one unit.
  • A user cannot assume the same role twice within a branch of the structure, i.e., he cannot have the same role in a unit and in its parent unit.

Subsequently editing user data

From time to time, you may have to edit existing user accounts, for example, due to changes in the roles of users. The most important edit options are described in the following.

Changing account data

If you want to change the account data of a user, open the detail view of this user (either in the centralized user management or in the unit-specific user list). Here you can edit the account data of the user.

Changing roles and allocations to units

If you want to change or delete the unit allocation of a user, there are two alternatives to choose from, depending on whether only the allocation to one unit is to be changed or multiple allocations.

  • If you want to change the role of a user within a particular unit, locate this user in the user list.
    • Open the detail view as described above (either in the centralized user management or in the unit-specific user list). Here you can change the role of this user within the current unit.
    • If you want to delete this allocation altogether, select the user from the list and use either the Delete icon or the action Delete user allocations.
  • If you want to view and edit the allocations of a user to organizational units in a centralized manner, do this via the Organizational Units tab in the detail view in the centralized user management. The search function in the upper section allows you to restrict the list of organizational units. For example, with “Show only linked units” you can restrict the list to those units that the user is already allocated to.

Editing passwords

Occasionally, you may have to provide “first aid” to users working with the Org Processor. One of the most common problems is forgotten passwords. In this case, you can help by resetting the initial password or generating a new password and then mailing it to the user:

  • If you want to reset the initial passwords of one or more users, or if you want to generate a new password, locate the respective users in the user list and then use either the action “Generate passwords” or the action “Reset passwords”. After that, mail the passwords to the users again.
  • The detailed view of the users offers you additional edit options:
    • As long as the user has not logged in, i.e., as long as he has not changed his initial password, you can view the initial password.
    • As soon as the user has changed the password, you cannot view it any longer. So, if the user loses or forgets his password, you have to either reset the password or generate a new one and mail it to the user.
  • Alternatively, refer your users to the “Reset password” dialog.

If you want users to be able to change the account data and allocations of other users, you need to assign the right manager_edit and/or manager_alloc to the appropriate roles.

Please note:

  • A user can not assume multiple roles within one unit.
  • A user cannot assume the same role twice within a branch of the structure, i.e., he cannot have the same role in a unit and in its parent unit.

If you want users to be able to (re-)generate or reset the passwords of other users, you need to assign the right manager_set_pw and/or manager_reset_pw to the appropriate roles.

Initial passwords and passwords that were generated anew are visible for the project managers in the admin area and can be dispatched by mail. As soon as a user has changed their password, though, you can not access it via the admin area anymore. Dispatch per mail is not possible anymore, either: the characters are replaced by *****.

Viewing a user’s reports in a centralized manner

On the Reports tab in the detail view in the centralized user management, you can see which reports have been stored for the respective user.

Sending E-Mail in Org Processor

In the course of the project, you will both write to users and manage users who in turn write to other users. You usually write to users in the following situations:

  • You have created new user accounts and want to provide the owners with their login information.
  • If the login information is not delivered by e-mail but by other means, you might use e-mail to notify the new users that they will soon receive a letter with their login information through their company’s in-house mail.
  • You want to notify the users of the project start or the start of a new phase.
  • You want to ask the users to start with a particular job or to finish a job in due time.

The necessary tasks are presented in the following:

  • Creating mail templates to be used in the Org Processor and linking them with the project.
  • Mailing users from the admin area

Depending on how you organize your project, your users may be required to e-mail other users in turn:

  • The users have created new user accounts for their area of responsibility and want to provide these new users with their login information.
  • The owner of a higher-level unit wants to ask the users in the subunits to conclude a particular work phase.

This is also possible in the Org Processor: You can create mail templates for typical contact situations and make these available to the users. You have access to the main function of the Org Processor from all views and menus where the sending of e-mail makes sense (e.g. organizational structure, user management, logistics sites).

Mailing users

If you want to e-mail users in your area of responsibility, please proceed as follows:

  • Open the appropriate area of the Org Processor. In the example shown a project manager e-mails a user from the Organizational Structure tab.
  • Select the units (or logistics sites) whose users you wish to contact, and tick the respective checkboxes in the “Actions” column.
  • Select the action “Mail users” or “Mail users from the selected unit and its subunits”.
  • Confirm by clicking on Execute.
  • This prompts a list of users meeting your criteria.
  • Optionally, you can restrict this list further with the help of the Extended search function by setting stricter criteria and confirming your selection with Search: You can, for example, have only users with a specific role displayed.
  • Tick the “Actions” checkbox for those users that you really wish to e-mail.
  • Confirm by clicking on Execute.
  • The standard mail form will open. Select the appropriate mail template and upload the template by clicking on Apply.
  • Make all the required additional settings and enter the contents.
  • Click on the Preview mail button to check the result. In particular, check whether the wildcards are replaced correctly.
  • If you are satisfied, click on Send.

Please note: Batches of more than 10 mails are not sent directly, but are first placed in a queue to reduce server load, and processed successively. By default, EFS sends up to 1,000 emails from this queue every ten minutes.

Allowing users to mail other users

You can allow your users to e-mail other users. To prevent errors and abuse the following restrictions apply:

  • Access to the mail function is protected by the right manager_email_readonly. Assign this right only to those roles that are allowed to send mail.
  • Users can only e-mail users within their own area of responsibility.
  • The users do not really write mails themselves but select from mail templates provided by you.

The following illustrations show what your users are able to see in such a mailing process. Two preparatory steps are necessary, which are described in the following:

  • Creating mail templates
  • Assigning mail templates to the project

Creating mail templates to be used in the Org Processor

In the Options → Mail templates menu, create a new mail template of the “Org Processor mail” type. Make all the necessary settings, select an appropriate mail sender, and enter the contents. Please pay special attention to the following:#

  • The mail templates should have meaningful titles.
  • They should contain all the necessary wildcards. An overview of the available wildcards is given in the mail form below the question mark icon.
  • Often, you will want to insert the URL of the Org Processor. From EFS 7.0 on, insert it using the wildcard #url_orgprocessor#. In older versions of EFS, proceed as follows to construct the URL: Copy the URL of the project from the Survey menu. Add the string /orgprocessor. This is the URL of the Org Processor login. (The otherwise frequently used wildcard #code_complete# is not supported in the Org Processor.)

Assigning mail templates to a project

Switch back to your project and open the project’s Mail templates menu. Mail templates of the “Org Processor mail” type which you assign to your project in this menu can be used by the users in the Org Processor. Locate the mail template you have just created. Its current status is indicated in the column “Project template”:

  • Yes = linked to the current project
  • No = not linked to the current project

Usually, a new template has the status “No”. If you click on the status link, it will change to “Yes”.

Configuration

The Org Processor allows you to realize different survey types that are described in the table below. First, you select the type that suits your requirements on the Options tab in the Org Processor → Configurations options menu, the appropriate functions will then be released.

Survey typeExplanationFunctions activated automaticallyAdditionally required
Hybrid surveyThe survey is conducted partly online and partly using paper-pencil questionnaires.The following functions are activated automatically:Participant administration: Allows you to manage the data of those respondents who participate online.Logistics: Supports the distribution of paper-pencil questionnaires.The following additional tools should also be activated:EFS Hybrid Extension: Additional module for generating paperpencil questionnaires, mandatory when using the logistics tool.
Online surveyThe survey is conducted exclusively online, no paper-pencil questionnaires are used.The following functions are activated automatically:Participant administration: Allows you to manage the data of those respondents who participate online.Logistics: Supports the distribution of paper-pencil questionnaires 
Paper-pencil surveyThe survey is conducted exclusively with paperpencil questionnaires, online participation is not possible.No participant administration.The following additional tools should also be activated:EFS Hybrid Extension: Additional module for generating paperpencil questionnaires,
mandatory when using the logistics tool.

Consider carefully which survey type fits for your project, and select the appropriate type now at the very start of the setup phase. We strongly advise against a change of survey type at a later date: Depending of the target type already-created data might be deleted.

  • When changing from a paper-pencil or hybrid to an online survey, all paper-pencil questionnaire data will be deleted: they are superfluous in an online survey.
  • When changing from an online or hybrid survey to a paper-pencil questionnaire, all data of online participants will be deleted.

Additional options in detail

On the Options tab of the Org Processor → Configuration menu you can activate basic functions and extensions which are required only in certain situations.

FieldMeaning
Only in EFS Employee installations
with Action Planner: Activate Action Planner
The Action Planner is an optionally leasable additional tool for logging the follow-up measures of the employee survey.When activated, the Action Planner is displayed on an additional tab in the Org
Proceulrissor.The menu Org Processor → Configuration contains the submenu Action Planner configuration where you can configure the Action Planner
Only in EFS Employee installations
with Closed Loop Feedback
CLF is an extension of the traditional customer survey, enabling direct customer dialog by responding individually to the specific case and solving it.The menu Org Processor → Configuration contains the submenu CLF configuration overview where you can configure the Action Planner.
Activate manual adjustment of target figureActivates manual adjustment of target figuresWhen activated, the action Adjust target figures are displayed on the Organizational Structure tab.The adjusted figures are displayed on the Organizational Structure and Return tabs.
Administration modeBy selecting the appropriate administration mode you can restrict or expand the complexity of the user management.
Activate the feature “Sending account data”Activates the semi-automatic dispatch of access data.
Mail templateIn this field, you select the mail template for semiautomatic dispatch of login data.
Anonymity criterion for the returnThe return is protected by a specific anonymity criterion which you can define for the entire project.
Include units with a return rate of 0 for the remainder rule 
Only in hybrid surveys: Display the return of online and offline participants separatelyAlternative return view:The data of online and offline participants are displayed separately.The sum of online participants and those offline participants for whom a participant account exists is used as the base value when calculating the return rate. (In the default return view, on the other hand, the sum of online participants and requested paper-pencil questionnaires is used.)

If you inadvertently deactivate the Action Planner, the data will be preserved. However, we strongly advise against deactivating these functions in a live project: This will limit your edit options.

Security settings

On the Security settings tab in the Org Processor → Configuration menu, you can modify the behavior of the system during login. The following processes cannot be configured:

  • The “Recover password” function of Org Processor: It is the same that is used for the admin area. Processes and mails cannot be configured.
  • The security routine triggered at first login: It enforces a change of password analogous to the admin area. This process cannot be modified either.
  • In contrast to the admin area, a monthly change of the password is not required for Org Processor. This cannot be changed.
FieldMeaningSetting optionsDefault settings
Password checkYou can choose from several
sets of security requirements for
the password.This setting affects both Org Processor
and download platform.
Various options are available:Upper and lowercase,
numbers or special characters and at least 8 characters longCharacters and numbers or characters and special characters, at least 8 characters longUpper and lower case, numbers and at least 8 charactersCharacters, numbers, and at least 8 characters
Upper and lower
case, numbers, or special characters
and at least 8 characters long
Number of wrong loginsTo protect the download platform against brute force attacks, you can define the maximum number of permitted wrong logins. If, after reaching this number, a further wrong login occurs, the account will be blocked for a defined period of time. 0, i.e. the number of wrong logins is not limited.
How long is the
account blocked?
If the number of wrong logins exceeds the permitted maximum number defined above, the account is blocked for the period of time defined in this field.Seconds0, i.e. the account will not be blocked.


Org Processor messages

You can also modify the info texts on the most important Org Processor tabs to meet the requirements of your project. These texts are visible both in the separate Org Processor login and in the admin area. Switch to the Org Processor → Configuration menu. Open the Org Processor messages tab. Here you will find two fields for each of the following Org Processor tabs, where you can edit the German and English info texts:

  • Organizational structure tab
  • Return tab
  • Report overview tab
  • If Action Planner is activated: Action Planner tab and overview of the actions in the detail view of a unit.

Historical assignment

It is possible to compare the current structure to its historical version. Historical comparisons can be created automatically if both projects were created through an Orbit snapshot. Historical comparisons can be used e. g. in the Data Voyager Analyst, to compare the survey results of both structures.

  • Go to the Org Processor‘s Configuration settings and select the Historical Assignment tab.
  • Choose a specific historical project from all projects available.

If the project selected has been created with Orbit, two algorithms will be available for mapping.

  • Historical comparison based on people: This algorithm is set to compare participants to those in units contained in the historical structure. Once a match has been found where two units are considered identical in regard to their participants, the historical comparison will be saved. You may further refine the precision of the comparison by setting a specific percentage that must be met.
  • Historical comparison based on identical metanames: The second algorithm creates a mapping based on identical meta names. Metanames can be selected individually, additionally, additionally added information from re-imported Excel files can be available for selection.

In historical comparisons, both algorithms fill their results into empty fields only. However, note that the order of the execution will influence your results. The first algorithm selected and executed will provide results for the variable concerning the historical meta names, while the second algorithm executed will apply only to the remaining empty fields.

Structure administration

By default, the Org Processor shows the primary structure. If further views are available, you will find a drop-down list in the upper sections of the tabs Organizational StructureReturn, and Report Overview, where you can select the desired view.

Administrating structure views

The structure views are administrated in the menu Projects → {Selected project} → Org Processor → Configuration → Structure administration. The overview table provides the following information for each view.

  • ID
  • Name
  • Type
  • Identifier
  • Multiple allocations of participants allowed?

Via the icons in the “Actions” column you can open the views for editing or delete them (except for the primary structure).

Creating additional structure views

  • Click on the Create Structure view button.
  • You have to specify:
    • Name
    • Identifier: The identifier is used, for example, for the import. The identifier must not contain any special characters or blank spaces. It must be unique. Example: “FunctionalStructure”.
    • Multiple allocation of participants allowed: Activates additional features that allow you to allocate individual participants to multiple units within the same structure.
    • Use “Function”: Activates additional features that allow you, in the matrix representation, to differentiate between the various functions a participant
      has. For example, a participant may be the “Manager” in one department while counting only as “Staff” within the product line.
  • Confirm by clicking on Save settings.

Manual allocation to multiple structure views

If there are multiple structure views, additional functions allowing you the manual allocation of the participants to the structures will be displayed in the following locations:

  • Centralized participant administration->Form for adding a new participant → Section “Allocation of the participant to structure views”: In this section, you can
    allocate the participants to one node per structure view (more nodes are possible when using multiple allocations, see below).
  • Centralized participant administration->Detail view of the participant → Section “Allocation of participant to structure views”: Here you can also allocate the participants to one node per structure view.

Importing into multiple structure views

Via the centralized participant administration, you can import participants into multiple views simultaneously. When doing so, the variable containing the unit allocation – usually metaname – is formatted as follows:

  • Multiple structure views and/or multiple allocation: metaname1;metaname2
  • Multiple structure views, multiple allocation, and/or function: metaname1:u_function:code;metaname2:u_function:code;metaname3:u_function:code

Please note that every participant data record can only be imported once: All the desired allocations should be performed in this one permitted import. Decentralized import is not possible, i.e. you cannot separately import the same participants into the lists of participants of units in different structure views. If you want to subsequently allocate an already imported participant to additional units, you can do so in the participant’s detail view in the centralized participant administration as described above.

Exporting the allocation to multiple views

If you want to export the allocation of the participants to the various structure views, download the central list of participants from the menu Projects → {Selected project} → Participant administration by clicking on either of the buttons labeled Excel export or CSV export. The column metaname contains the comma-separated meta names of the units to which the participant is allocated.

Multiple allocation of participants within one structure

Optionally, you can modify the organization as to allow the allocation of individual participants to multiple units within the same structure. Such duplicate allocations can be useful, for example, in product or project structures: The multiply allocated participant continues to receive only one questionnaire, but all his allocations are available to you for filtering or report generation.

Activation

This additional feature is activated via the field “Multiple allocation of participants allowed” in the detailed view of the desired structure.

Manual multiple allocation

If multiple allocation is activated, then additional functions allowing you the manual allocation of participants will be displayed in the following locations:

  • Centralized participant administration → Form for adding a new participant → Section “Allocation of participant to structure views”: In the structure for which multiple allocation is activated, you can allocate the participants to any number of nodes.
  • Centralized participant administration → Detail view of the participant → Section “Allocation of the participant to structure views”: Here you can also allocate the participants to any number of nodes.

Importing multiple allocations

Multiple allocations can be imported into the centralized participant administration. When doing so, the variable containing the unit allocation – usually metaname – is formatted as follows:

  • Multiple structure views and/or multiple allocation: metaname1;metaname2
  • Multiple structure views, multiple allocation, and/or function: metaname1:u_function:code;metaname2:u_function:code;metaname3:u_function:code

Please note that every participant data record can only be imported once: All the desired allocations should be performed in this one permitted import. Decentralized import of multiple allocations is not possible, i.e. you cannot separately import the same participants into the lists of participants of different units. If you want to subsequently allocate an already imported participant to additional units, you can do so in the participant’s detail view in the centralized participant administration as described above.

Exporting multiple allocations

Download the central list of participants as already described for the allocation to multiple structure views. The column metaname contains the comma-separated meta names of the units to which the participants are allocated.

Additional Feature: allocation of functions to the participants

If you are using multiple structure views and/or multiple allocations, you can differentiate between the different functions that a participant may have. The following functions can be allocated:

  • Staff
  • Manager

Thus, for example, you can mark a participant as “Manager” in a hierarchical structure view while counting him only as “Staff” in a project structure.

Activation

This additional feature is activated via the field “Use Function” in the detailed view of the desired structure.

Manual function allocation

If function allocation is activated, then additional functions permitting the manual allocation of participants will be displayed in the following locations:

  • Centralized participant administration → Form for adding a new participant → Section “Allocation of the participant to structure views”: In the structure for which the function allocation is activated you can allocate a function to the participants.
  • Centralized participant administration → Detail view of the participant → Section “Allocation of the participant to structure views”: Here you can also allocate a function to the participants.
  • Decentralized participant administration (both in the www area and in the Org Processor) → Detail view of the participant → Section “Functions”: Both you and the users can allocate a function to the participants.

Importing function allocations

Function allocations can be imported into the centralized participant administration. When doing so, the variable containing the unit allocation – usually metaname – is formatted as follows:

  • Multiple structure views, multiple allocation, and/or function: metaname1:u_function:code;metaname2:u_function:code;metaname3:u_function:code

Decentralized import of function allocations is not possible. If you want to subsequently change the function allocation of an already imported participant, you can do so in the participant’s detail view in the centralized participant administration as described above.

Exporting function allocations

Download the central list of participants as already described for the allocation to multiple structure views. In addition to the meta names of the units, the column metaname also contains the function(s).

Structure variables

Prior to building the organizational structure, check whether the data structure meets the requirements of your current project, and adjust it if necessary.

  • Variables for storing basic properties of the units, such as name or target number, can be relabeled or otherwise modified.
  • If you want to store additional unit-specific properties, you can create additional variables. If, for example, you want to label the organizational units in a second language, you can create a specific variable for this purpose. Properties common to all participants of a unit can also be stored in user-defined variables on the unit level.

The editing of the variables and the creation of additional variables is done in the menu Org Processor → Configuration → Structure variables.

Overview of the existing structure variables

Switch to the menu Org Processor → Configuration → Structure variables. Here you will find an overview table listing the already existing structure variables.

VariableLabelMeaningData typeSize
label_externName of unitName of the respective organizational unit.Text field256 characters
labelShort form of unit nameName of the respective organizational unit as it is to be displayed in the organizational structure. For greater clarity, a shortened form of the actual name is usually used.Text field256 characters
metanameMeta name (Unique Ident.)Unique identifier of the unit. The meta name may contain only the following characters: a-z, A-Z, 0-9, “_”, “-“Text field65,536 characters
co_targetStaff (preset value)Preset number of employees for this unit.int(11)max 2,147,483,647
visiblePermit allocation to unit in the questionnaireThis variable is only relevant in combination with the selfallocation. It specifies whether a participant who is allowed to allocate himself may select
the respective unit in the questionnaire. Available options are:0: The unit cannot be selected. If the participants can see it at all, depends of the value of “Hide unit in questionnaire (including subunits)”.1: It is possible to select the unit.
Checkbox 
historic_codeComparison unit of the preceding yearThis variable was used for storing the code of the comparison unit from the previous survey in the past. The meta
names are used for comparison.
int(11)max 2,147,483,647
u_adjust_membersCorrection factorThis variable is only relevant in combination with the manual adjustment of target figures. It contains the direct correction factor.Text 
u_adjust_members_aggCorrection factor abs.This variable is only relevant in combination with manual adjustment of target figures, It contains the absolute correction factor.Text 
hide_unitHide unit in questionnaire (including subunits)This variable is only relevant in combination with the selfallocation. It
specifies whether a participant who is allowed to allocate himself may see the respective unit and its
subunits in the questionnaire. Available options are:0: The unit including its subunits is displayed.1: The unit including its subunits is hidden.
Checkbox 

Action Planner configuration

The Action Planner and the add-on module CLF are activated. In the sidebar, two new menus are displayed: the Action Planner configuration menu and the CLF configuration overview. Also, if you go back to the Org Processor menu, you will find the Action Planner itself on a newly inserted tab. The configuration options in this menu, which will be introduced in the following Chapters, enable you to adapt the Action Planner to your specific survey process. The CLF configuration overview gives you an overview of the configuration process of CLF related applications in the context of preparing the Action Planner. With the Action Planner, you can create new tasks in Portals. Furthermore, you gain insight into statistic overviews of your tasks. You can export your tasks and statistics to organizational units and have additional access to the user administration.

Action Planner configuration.jpg

CLF configuration overview

After activating the add-on module CLF, you can consult the CLF configuration overview as a guideline when preparing the Action Planner and implementing CLF in your project settings. This EFS page gives you an overview of required and optional settings. The fields are highlighted in color to show the status of each setting in your current project: blue fields indicate settings in your Employee project which already have been configured, red fields indicate settings (still) not set. All settings required should be highlighted in blue at the end of the configuration process.

CLF overview.jpg

You can reach the CLF configuration overview over two different paths:

Path 1:

  1. In the EFS admin area, open Projects → {Selected project} → Org Processor → Configuration.
  2. In the sidebar Configuration, click on the button CLF configuration overview.

The CLF configuration overview of your Employee project is displayed.

Path 2:

  1. In the header menu, hover over the tab System and click on the button Options.
  2. In the sidebar Options, click on the button CLF configuration overview.
  3. Select your Employee project from the drop-down list.

The CLF configuration overview of your Employee project is displayed.

For access to the CLF configuration overview, the prior activation of the add-on module CLF is required

Accessing Org Processor Data in Condition Editor

You can access Org Processor data when defining filters, hiding conditions, etc. in the condition editor. The following Org Processor data are available:

  • org_code_structureID (Primary Structure.OrgCodePreAllocation): Unit in the named structure to which the participants have been allocated. E.g. org_code_1 is the unit of the participants in the primary view (structure ID = 1).
  • org_allocation_structureID (Primary Structure.OrgCodeSelfAllocation): Unit in the named structure to which the participants have allocated themselves. E.g. org_allocation_1 is the self-allocated unit of the participants in the primary view (structure ID = 1.
  • org_function_structureID (Primary Structure.OrgFunction): Function of a participant in the named structure. E.g. org_function_1 is the function of the participant in the primary structure (Struktur-ID = 1).

The following operators have been created specifically for filtering on Org Processor data:

  • in: The variable selected must contain the unit named in the “code” field.
  • in or below: The variable selected must contain either the variable named in the “code” field or one of its subunits.
  • in branch: The variable selected must contain either the unit named in the “code” field or any other unit from the complete branch (from the root unit down to the lowest level). This operator is usually not used for routing purposes in the questionnaire but for report definitions.

Releasing units for filtering

Only project management can release units for filtering. Users can not access this function.

To display the Org Processor data described above in the code drop-down list in the condition editor, you have to explicitly release the unit(s) required for filtering. Otherwise, you have to enter the data manually, you cannot select them from the list.

This limitation has been introduced for two reasons. First, it helps to improve the performance: querying all possible units in complex structures requires considerable server resources. Second, by releasing only units that are actually required, you can improve transparency in the condition editor.

The actions “Release units for filtering” and “Revoke filter release for units” on the Organizational Structure tab are used to release units. If a unit has been released, it is marked by a white F icon in the organizational structure.

If a unit has been released and you select one of the variables named above in the condition editor, you can access the units as usual via the Binoculars icon. Units used in a filter definition are marked by a lilac F icon in the organizational structure.

FAQ

How many users can the system handle?

The system is designed for up to 10,000 users. With higher numbers, you might experience performance issues depending on the circumstances.

Can users have multiple roles within a unit?

No, a user cannot assume multiple roles within one unit. Additionally, a user cannot have the same role twice within a branch of the structure.

How often are return data updated?

The data in the return overview are updated every five minutes. You can use the “Update participant numbers” icon to trigger a manual update if necessary.

Leave a Reply

Your email address will not be published. Required fields are marked *