Manage Facility Users: Difference between revisions

From Network for Advanced NMR
Jump to navigationJump to search
Line 4: Line 4:
== User Mapping Overview ==
== User Mapping Overview ==


Each spectrometer workstation has its own set of '''local users''' (i.e., UNIX accounts). For proper data attribution, NDTS provides a mechanism to map each local workstation user to a specific '''NAN user account'''. When such a mapping exists, NDTS will automatically select the appropriate NAN user in the NDTS-GUI.
Each spectrometer workstation has its own set of '''local users''' (i.e., Linux/Windows accounts). For proper data attribution, NDTS provides a mechanism to map each local workstation user to a specific '''NAN user account'''. When such a mapping exists, NDTS will automatically select the appropriate NAN user in the NDTS-GUI.


Facility managers can control whether users are allowed to:
Facility managers can control whether users are allowed to:

Revision as of 20:36, 9 June 2025

Overview

This page describes how facility managers can manage users for NDTS, the application that automatically harvests data from NMR spectrometers into the NAN archive. NDTS includes a graphical interface (NDTS-GUI) that runs on each spectrometer workstation and allows users to view and change harvesting settings, including the selection of a NAN user to associate with each dataset.

User Mapping Overview

Each spectrometer workstation has its own set of local users (i.e., Linux/Windows accounts). For proper data attribution, NDTS provides a mechanism to map each local workstation user to a specific NAN user account. When such a mapping exists, NDTS will automatically select the appropriate NAN user in the NDTS-GUI.

Facility managers can control whether users are allowed to:

  • Change the NAN user associated with an experiment.
  • Change whether data from their account is harvested.

User behavior can be configured individually or by email domain to simplify administration.

Managing the User Table

User mappings and behavior settings are defined in a user management table accessible through the Manage Spectrometer Users page.

The table includes the following columns:

Column Description
Workstation User The local user account on the spectrometer workstation. Optional if only a NAN user is being defined.
NAN User The account on the NAN portal to which the data will be attributed. Optional if behavior is being defined for an unmapped workstation user.
Transport Default Whether NDTS should Capture or Exclude data by default for this user.
Can Change Collection Settings Yes allows the user to enable/disable data harvesting from NDTS-GUI; No locks the setting.
Can Change Username Yes allows the user to change the selected NAN user in NDTS-GUI; No disables this option.
  • Each row can be deleted using the trash icon.
  • New users can be added using the Add User button.
  • The table supports sorting by any column.
  • A Search Users field allows quick filtering.
  • Pagination is available for large user lists.

Email Domain Auto-Discovery

To simplify management, administrators may specify one or more email domains (e.g., university.edu). Any user with a verified NAN account matching that domain will automatically appear in the user list within NDTS-GUI. This avoids the need to enter each user individually.

However, for finer control (e.g., setting behavior flags or mappings), users should be added explicitly to the table.

Unknown Users

Administrators can configure NDTS behavior when a user not in the table launches an acquisition:

  • Harvesting may be enabled or disabled by default.
  • The NDTS-GUI will display limited options depending on the global policy and facility preference.

Usage Examples

Scenario Configuration
Exclude a commercial user from harvesting
  • Workstation User: com_user
  • NAN User: (leave blank)
  • Transport Default: Exclude
  • Can Change Collection Settings: No
  • Can Change Username: No

→ NDTS will never harvest data from this user.

Force harvesting for a PI’s trainee
  • Workstation User: trainee1
  • NAN User: pi_user
  • Transport Default: Capture
  • Can Change Collection Settings: No
  • Can Change Username: No

→ Data will always be harvested and attributed to the PI.

Standard user with flexibility
  • Workstation User: user123
  • NAN User: user123@university.edu
  • Transport Default: Capture
  • Can Change Collection Settings: Yes
  • Can Change Username: Yes

→ Default harvesting is enabled, but the user can turn it off or switch identity if permitted.

Summary

This user management system allows flexible yet precise control over who can use NDTS, how data is harvested, and which NAN user identities are associated with datasets. It balances convenience (via domain-based auto-discovery) with granular configuration (via explicit mappings and permissions).