====== Administration ======
The following explains the administrative functions in Reitec.PMM.

===== Options =====
Reitec.PMM can be customised using numerous settings. These settings can be found under "Extras-->Options"

==== General ====
{{de:pmm:administration:administration_options_01_de.png?200 |}}
In the "General" section you can determine whether a notification window should be displayed when the computer is started. In addition, you can set advance warning time for test equipment due for calibration/testing.

In the "Security" area, you can disable/enable automatic login and set password rules. \\

In the area "Preview" you can define the size of the preview image for a test equipment.
\\ \\ \\ \\
In the area "Field designations" you can define the names for the fields "Test equipment number" and "Inventory number". In addition, the checkboxes "Unique" can be used to enforce that the field content is unique. 

In the area "Names" you can define the designations for the elements "Test equipment" and "Laboratory". The singular and plural must be specified here. 

In the area "Interface language" you can define the language of the interface. This can be different from the database language.

=== Password rules ===
{{de:pmm:administration:password01_de.png?400 |}}
When password rules are active, a user must choose an appropriate password. The possible rules are minimum number of characters, upper and lower case letters, special characters and numbers. 
\\ \\ \\ \\

==== Database ====

=== Overview ===
{{de:pmm:administration:database01_de.png?200 |}}
In the "Database" section you can manage the database connections. \\ \\ 
You can create new connections, edit or delete existing connections.
\\ \\ \\ \\ \\ \\ \\ \\

=== Create new connection ===
{{de:pmm:administration:database02_de.png?200 |}}
To create a new database connection, please enter a unique name. Then select whether it is a file-based database - in this case please select a location. \\ \\
In the case of a Microsoft (r) SQL server database, you can specify the connection data in the subsection "Connection settings".\ \

By clicking on the button "Test connection" you can check the connection data. \\ \\ \\ \\

=== Edit existing connection ===
To edit a database connection, please select the corresponding database from the list and click on the "Edit" button. After you have adjusted the settings, they are saved by clicking on "OK".
\\

=== Delete connection ===
To delete a database connection, please select the corresponding database from the list and click on the "Delete" button. \\
Note: If there is only one entry left in the list, then this connection cannot be deleted.

<note>
Creating a new connection and using a Microsoft (r) SQL server database is only possible in the PRO version.
</note>

==== Licensing ====
{{:de:pmm:administration:administration_options_03_de.png?200 |}}
In the "Licensing" section you can set the licensing method.

Three different licensing methods are available:

Cloud licensing \\
Single-user licensing \\
Network licensing \\
 
For more information about licensing, see [[pmm:administration:licensing|here]].\\ \\ \\

<note>
These settings are only available in the PRO version.
</note>
==== Mail-server====
{{:de:pmm:administration:administration_options_04_de.png?200 |}}
In the "E-mail server" section you can set the server name and the port for sending e-mails. In case your e-mail server expects authentication, you can set the required properties domain, SSL, user name and password here.
In the subsection "Mailing list" you can create, edit and delete new mailing lists. Users are assigned to a mailing list in the user administration. The assignment of the mailing list to a location is done in the options area "Default values". \\ \\ \\ \\ \\

<note>
These settings are only available in the PRO version.
</note>
==== Location ====
{{de:pmm:administration:administration_options_05_de.png?200 |}}
Set the location for the report templates here.  \\ \\ \\ \\ \\ \\ \\ \\ \\ \\ \\

<note>
We recommend choosing the location so that it is covered by the backup or backing up this folder manually.
</note>


==== Default values ====
Selection lists are available for some fields: Test equipment type, Calibration Cycle, Location, Countries and File Class. These can be customised in the Defaults section. For all defaults, the visibility as well as the order can be adjusted.

<note>
Only list elements that are no longer used can be deleted. Otherwise, only the visibility can be changed.
</note>

=== Test equipment type ===
{{:de:pmm:administration:administration_options_06_de.png?200 |}}
The test equipment type is a multi-level selection structure. Here, new roots and elements can be created, edited and deleted. In addition, the arrangement of the structure can be edited. Some of the functions are only available in the PRO version. \\ \\ \\ \\ \\ \\ \\ \\

=== Calibration cycle/intervals ===
{{:de:pmm:administration:administration_options_07_de.png?200 |}}
For the interval, in addition to the display text and visibility, the number of days the interval lasts can also be specified.  \\ \\ \\ \\ \\ \\ \\ \\ \\ \\

=== Location ===
{{:de:pmm:administration:administration_options_08_de.png?200 |}}
In addition to the display text and visibility, a scanner code ([[pmm:use|Quick-Task-Window]]) can also be specified for the location and an e-mail mailing list can be assigned. If the box "No increase in usage" is activated, the usage counter will not be increased when a piece of test equipment is handed out to this location. \\ \\ \\ \\ \\ \\ \\ \\

=== Country ===
{{:de:pmm:administration:administration_options_09_de.png?200 |}}
In addition to the display text and the visibility, the country abbreviation can also be specified for the country. \\ \\ \\ \\ \\ \\ \\ \\ \\ \\

=== File class===
{{:de:pmm:administration:administration_options_10_de.png?200 |}}
With the help of the file class, the files assigned to a gauge can be classified. Only the display text and visibility can be defined here.  \\ \\ \\ \\ \\ \\ \\ \\ \\ \\ \\

==== Test cylces (PRO) ====
By default, there are three cycle definitions: Management Cycle, Calibration Cycle, Test Cycle. Each definition consists of different status values and status transitions to change the status. The following diagrams show the default cycle definitions in detail.

{{:pmm:administration:calibrationcycle.png?200 |}}
{{:pmm:administration:testcycle.png?200 |}} 
{{:pmm:administration:managementcycle.png?200 |}}
 \\ \\ \\ \\ \\ \\ \\ \\ \\

=== Hide gauges with certain status ===
Gauges which are neither in a calibration nor a release status can be hidden. To do this, the check mark "Hide status in test equipment list" must be set. The respective statuses can be selected via the "Add" and "Remove" buttons. If a piece of test equipment has several cycles, these are only hidden if all applicable statuses are in the list.

{{de:pmm:administration:definition01_de.png?200|}}

=== Create and edit cycle definition ===
Cycle definitions can be created and edited. To do this, select the desired definition in the options dialogue or create a new definition via the "New" button. After clicking on the button "Edit" the dialogue "Edit cycle definition" opens.

{{de:pmm:administration:definition_de.png?200|}}

In the upper area (cycle definition) you can define the name of the cycle definition and the initial status. The initial status is set by default when creating a new gauge.

In the middle area (Status) you can see all status values created for this definition. Using the function buttons (New, Edit, Delete), the selected status can be edited or deleted or a new status can be created.

In the dialogue "Edit status" the name and the assigned colour can be defined. There are four different status types:
  * Calibration status: Gauges with this status require calibration or testing.
  * Release status: Gauges with this status are released and no release warning appears during output, provided this function is activated via the options.
  * Pause status: A piece of test equipment can only assume the pause status if it has been calibrated or tested beforehand. If a piece of test equipment is in pause status, then the next due date is calculated using the date of reactivation instead of the day of the last calibration or test.
  * Not defined: None of the three previously mentioned statuses apply.

{{de:pmm:administration:definition02_de.png?200|}}

The status transitions defined for the selected status are displayed in the lower area (Status transitions) of the "Edit cycle definition" dialogue. Here, too, new transitions can be created or existing transitions deleted using the function buttons (New, Edit, Delete).


In the "Edit status transition" dialogue, the designation and the target status can be defined. The property "Time-based" indicates that this transition automatically changes to the target status depending on the interval assigned to the test equipment. Usage-based status transitions automatically change to the target status when the maximum usage number stored for the test equipment is reached. The "Reset interval" property indicates that when this transition is triggered, the usage counter is set to 0 and the "Last execution" date of the test equipment is set.

{{de:pmm:administration:definition03_de.png?200|}}

<note tip>If, in addition to a time-based or usage-based transition, it should also be possible to switch manually to the target status, several transitions must be defined. This can be seen, for example, in the calibration cycle in the "Released" status - here there are two "Request calibration" transitions (time-based and manual).</note>

<note warning>We recommend making a data backup before changing the cycle definitions.</note>

==== User-defined fields (PRO) ====
{{de:pmm:administration:administration_options_11_de.png?200 |}}

With the help of user-defined fields, further data can be stored for a piece of test equipment. There are global fields that are valid for all gauges regardless of the gauge type and local fields that are only available for the gauge type selected under "Filter". 


Each field consists of a data type (Boolean (Yes/No), Date, List, Numeric, Text), a display name, a precision (data type: Numeric) and an associated selection list (data type: List). 

In the "User-defined tabs" area, another tab can be created for the local fields if required.


===== User administration =====
The user administration consists of four (two in the Free version) different views:
  * Tasks (Executor): All tasks for which the currently logged-in user is the executor are listed here.
  * Tasks (Creator): All tasks are listed here that the currently logged in user has created.
  * Users: All users of the programme are listed. In this menu item new users can be created {{de:pmm:administration:user_add.png?16|}}, existing users can be edited {{de:pmm:administration:user_edit_36.png?16|}}, users can be deleted {{de:pmm:administration:user_delete_36.png?16|}}, locks can be reset {{de:pmm:administration:lock_open.png?16|}} and permissions can be managed.
  * User group: All created user groups are listed. New user groups can be created {{de:pmm:administration:group_add_32.png?16|}}, existing user groups can be edited {{de:pmm:administration:group_edit_32.png?16|}} and user groups can be deleted {{de:pmm:administration:group_delete_32.png?16|}}.

==== Users ====
{{de:pmm:administration:user01_de.png?800 |}} \\ \\ \\ \\ \\ \\ \\ \\ \\ \\ \\ \\ \\ \\ \\ \\ \\ \\ \\ \\ \\ \\ \\ \\ \\


=== Create new user ===
{{de:pmm:administration:user03_de.png?800 |}} \\ \\ \\ \\ \\ \\ \\ \\ \\ \\ \\ \\ \\ \\ \\ \\ \\ \\ \\

The window to create a new user consists of four sections. These are, from left to right:
  * General
  * User group
  * Rights
  * E-mail distribution lists

== General ==

The general data consists of the user name, an e-mail address, the unique scanner code for the [[pmm:use|Quick-Task-Window]] and the [[pmm:administration#password rules|password]]. The user name is used when displayed in the selection lists.

== User group ==
Here the rights from one or more user groups can be assigned to the current user. If several user groups are selected, the user receives all rights that were granted in at least one of these user groups.

== Rights ==
The calculated rights from the selected user groups are displayed here. It is possible to grant a user additional rights that are not covered by a user group. However, it is not possible to deselect rights that have been granted via a user group. A user can also be granted rights without selecting a user group.

== E-mail distribution lists ==
This list contains all created [[pmm:administration#E-Mail-Server|E-Mail distribution lists]]. To assign a user to a distribution list, select it accordingly.


==== User group ====
{{de:pmm:administration:user05_de.png?800 |}} \\ \\ \\ \\ \\ \\ \\ \\ \\ \\ \\ \\ \\ \\ \\ \\ \\ \\ \\ \\ \\ \\
Different user groups can be created with corresponding rights. A created user group can be assigned to a user.


{{de:pmm:administration:user04_de.png?200 |}}
Special right "Edit only own test equipment": If this right is selected, then a user only has the corresponding rights to test equipment for which he is entered as the person responsible.
\\ \\ \\ \\ \\ \\ \\ \\ \\ \\ \\ \\ \\ \\ \\
===== e-mail reports =====
The report templates for sending e-mails can be customised. It is also possible to create new report templates.
\\ \\
For more information on creating e-mail report templates, see [[pmm:mailreports|E-Mail-Reports]].
<note>Only available in the PRO version.</note>
===== Reportdesigner =====
All report templates can be customised. In addition, new report templates can be created. \\ \\
For more information on using the report designer, see [[pmm:reportdesigner|Reportdesigner]].
\\
\\
===== Logging =====
A log file can be created for error analysis. To do this, logging must be activated in the file "Reitec.PMM.exe.config" in the programme directory.

**Procedure**
  - Copy the file "Reitec.PMM.exe.config" from the programme directory to the desktop.
  - Open the file in the editor
  - Change the value from "ERROR" to "ALL".
<code>
    <root>
      <level value="ERROR"/>
      <appender-ref ref="PMMFileAppender"/>
    </root>
</code>
  - Save the file and copy it back to the programme directory
\\
Now a log file is created in the directory "C:\Users\{USERNAME}\AppData\Roaming\Reitec\Reitec.PMM".
<note>
An activated logging has a negative effect on the speed. Therefore, deactivate logging after creating the error log.
</note>
===== Switching from Access to SQL server =====
When switching from Access to an SQL server, the following things must be observed.
  - The SQL database must be set up with the script SQLSERVER_INIT_XX.sql. The script can be found in the programme folder in the subfolder "DatabaseScripts".
  - Save the old database. You can see the storage location in the options under the menu item Storage location.
  - In the options under Database, set to Microsoft SQL Server and enter the corresponding data.
  - After restarting the programme, select 'Migrate database' under the menu item File and select the saved database.mdb. This process may take a few minutes.
  - After restarting the programme, the data from the old database is available.


===== Setting up the Temeka.Net interface =====
With the Temeka.Net interface, test protocols can be called up directly in the file list of a Temeka.Net test equipment. To set up the interface, access data to Temeka.Net is required. You can obtain these directly from Temeka.Net.

The settings can be made in the options under Temeka.

{{de:pmm:administration:administration_options_15_de.png?600|}}

The following is an overview of the available settings values.

^Name ^ Description ^
|TemekaUser ^ User name you received from Temeka.Net|
|TemekaURLPattern | Access URL to Temeka.Net. Normally does not need to be changed. |
|TemekaIdentField | Field in Reitec.PMM that contains the Temekea-Id of the test equipment. For possible field names, please refer to the instructions for creating [[en:pmm:mailreports|E-Mail-Reports]]. For example, the value "InventoryNumber" corresponds to the field "inventory number". |
|TemekaActive | Activates the Temeka.Net interface. |
|TemekaPassword | Password you received from Temeka.Net. |
|TemekaFileNamePattern | Defines the pattern of the file name under which the retrieved test protocol is saved in Reitec.PMM. Placeholders are noted in curly brackets "{}". Currently there is only "{DATE}" for the current date and {INVENT} for the value from the field "Inventory number". Further placeholders are available on request. |
| Default proxy authentification | Select if you want the default proxy to be used |

If everything is configured correctly, the inspection protocol can be retrieved via the context menu in the file list of an item of test equipment:

{{de:pmm:administration:administration_options_16_de.png?400|}}

----
The content refers to version 3.1.0.0