The application Users database, .ARCHUSERS, is used for two application management purposes:
- to set up and maintain login records for those using the Staff session
- to configure settings in the anonymous-user login record for the Public Catalog session
If you implement different sets of security permissions in your Catalog, you would also use these tasks to create and maintain individual or group login records for the Public Catalog session with the security settings required for users to retrieve only Catalog records for which the permissions match.
- To create login records for Staff session users, use the Edit task to search and recall the standard delivery ID: skca. Copy that record to fill in information specific to one staff member. You can then copy the copied/modified record to create each additional staff record and fill in the fields unique to each person. If you choose to fill in various contact/address fields, this database will also be useful as a "rolodex" source.
- To configure features to be enabled in your Public Catalog session, use the Edit task to search and recall the standard delivery ID that is used for the anonymous login: skcacatremote
Do NOT modify the login password in this record without first consulting Customer Support since a change will render the Session inaccessible.
As you add or modify records, and flag records for deletion, the application automatically updates the USERS databasethe system database used by STAR to authenticate logins and implement users' privileges.
Several of the application Users database fields are the source of values mapped to the USERS records, including those for the repeating Dollar Variable field. Dollar Variables are so-called because they are assigned keyword names that begin with a $. In the USERS database, the Dollar Variable field looks like the one below for the "skca" staff record delivered with the application, where a leading $ has been pre-pended to each variable name:
See the Application Access field group below and the Dollar Variables help for more information about these settings.
Label |
STAR Field |
Description |
User ID |
UID |
Assign a unique identifier login ID for each staff member. Enter an alphabetic, numeric, or alphanumeric character string, without embedded spaces, of no more than 25 characters total. |
Input Values |
VALUE |
This field is populated after a record is updated, with the User ID and constructed full name values, in both "Last, First Middle" and "First Middle Last" name order. Enter any other (unique) values, in separate occurrences, that will be useful shortcuts (e.g., nicknames) in doing data entry in one of the databases that uses the application users records as an authority (e.g.,the Management Notes field in all databases; Accessioned by in Accessions; Inventoried by in the Catalog). Direct input of one of these alternative values will automatically be translated into the official User name in the field or subfield for which the record is an authority. |
Last Name |
LAST |
Enter the user's last name. |
First Name |
FIRST |
Enter the user's first name. |
Middle Name/Initial |
MID |
Optionally, enter the user's middle name or initial. |
User |
USER and USERF |
(not shown in form) The full-name values in these fields are constructed when you update the record to facilitate searching and for use in reports and representing users in the data records:
|
Salutation |
SAL |
Select a title/honorific from the list box. Values: Mr., Mrs., Ms., or Dr. Modify the listbox to add other titles. |
Employee Number |
UNUM |
(optional) Enter the unique identifying number or barcode assigned within your organization to the employee. |
Date Hired/Terminate |
DATE |
(optional) Use the two subfields of this field to maintain a history of start and termination dates. |
Type/Class |
TYPE |
(optional) Use this field to classify the type of employment associated with the staff person. Modify the listbox to reflect the types of values applicable in your institution. Authority. Listbox values (.KCALIST) record: USERCLASSES
|
Lookup/Picklist Settings |
|
Settings in the two fields of this section establish the names that will be displayed in the Picklist and the validation action that will be taken when staff enter valid user names/IDs directly. Valid values i.e., those set to Accept or Confirm will be included in the Picklist display and validated with direct input. |
Action |
ACT |
Select from the list box one of these values:
Confirm: to establish the user as valid but with some conditional-use. The Message (see below) that you fill in to describe the condition will be generated in an information Alert. Reject: to remove the name (e.g., for retired employees) as being valid but to keep the record for historical reasons (see also the Delete option in the Edit form, in the Application Access field group). |
Message |
MSG |
For any records set to Confirm or Reject, use this field to provide an explanatory message that will be generated in the information or error Alert. The field is limited to 1024 characters. |
Security Permissions |
ACCES |
(required) Settings in these two subfields determine the records users have access to among those released to the Public Catalog. (Index displays are also restricted to words and full terms from those records to which the user has access.) Subfields: level |g group
The same field and list of values in each subfield are also used in Catalog records to represent the required access permissions. When Catalog records are created, a QCODE field is constructed that combines the two subfield elements, e.g., Unrestricted-OPENACCESS. This QCODE field is used automatically by STAR when Staff and Public Catalog searches are executed, with $QCODE settings in the current user's login record that are constructed from data you provide in this field. |
Security Level |
ACCES|_ |
In the first subfield, accept the default. If you are implementing record-level restrictions, add new occurrences to assign the user to the one or more other levels that you have established (e.g., for Confidential; Secret). Authority. Listbox values (.KCALIST) record: SECURITY-LEVEL |
Group |
ACCES|g |
In the second subfield, accept the default. If you are implementing record-level restrictions, select from among other groups that you have established (e.g., MGT; LEGAL). Authority. Listbox values (.KCALIST) record: SECURITY-GROUPS |
QCODE |
Security Code |
(not in form; is automatically constructed after you add or edit a record, and constructed $QCODE value is added to the Dollar Variable field of the USERS record) This value is constructed automatically from the occurrences of security level and-group data you specify in the application users record, in a combined form of, e.g: level1-group1\level2-group2. If a user belongs to more than one combination level-group, the list for the USERS record will be constructed with the backslash so that STAR will OR the values together in applying record-level and index display restrictions. |
Acess Codes for Other Systems |
|
(optional) Use this management field to track the assignment of access codes for online systems that require users to identify themselves. |
Code/ID |
SACOD|_ |
Enter in this first subfield separate occurrences for assigned codes/IDs used in accessing one or more of the online services. |
Type |
SACOD|t |
Use this second subfield to relate each code/ID to the online service to which it applies. Authority. Listbox values (.KCALIST) record: USERACCESSCODES |
Back to Top ↑ |
Label |
STAR Field |
Description |
Department |
DPT |
(optional) Use to associate a staff person with his or her department/unit. Authority. Listbox values (.KCALIST) record: DEPARTMENTS |
Address/Mail Stop |
ADDR |
Enter an internal address, e.g., a mailstop, or a full address using individual occurrences for each address line. These data are used in generating a valid address for selected task reports that incorporate data from this database. |
Telephone Number |
TEL |
Enter one or more occurrences of telephone numbers or extensions and, as applicable, use the second subfield for a contact note. |
Mobile Telephone Number |
CELL |
Enter the staff member's cell phones and use the second subfield for a contact note. |
Fax Number |
FAX |
Enter one or more occurrences for fax numbers and applicable notes. |
Email Address |
Enter one or more occurrences for email addresses. |
|
Notes |
NOTES |
Use this long-text field for more contact data or additional information about the user. |
Back to Top ↑ |
Label |
STAR Field |
Description |
Application User Type |
ATYPE |
Except for the anonymous-user login record (or other end-user login records you create for implementing security permissions), choose between the two Staff-... options so that the users will be considered valid (and included in the Picklist) for fields controlled by this database. |
STAR Login Password |
PW |
(required) Passwords can be alphabetic, numeric, or alphanumeric, up to 14 characters in length. |
Delete STAR Application Login Record |
|
[edit form only] When this checkbox is checked, the STAR User ID and Password fields will be emptied and the USERS record deleted in an automatic global operation. Alternatively, to keep the record for historical purposes, change the Picklist Action setting to Reject (see first field group). |
Application Welcome Name |
WNAME |
[$ARCHUSER; Staff session only] Enter the staff member's name or nickname, to be used by the system on the Welcome line in the upper right-hand corner of each session page. |
No. of Logins |
NLOGS |
If you set a number greater than 1, the same STAR Application User ID can be used multiple times, up to the maximum of this value and the availability of license slots at any given time.
In the anonymous-user Public Catalog session login record: Set this field to the maximum of your search-only licenses or a number representing a combined total of search-only and some of your full licenses. |
License Group |
LIC |
If you have implemented groups in the STARLICENSES database to reserve sessions for users in particular groups (e.g., Staff session users), enter a valid Group Name. For more information, see the STAR System Management manual or contact Customer Support to assist you in setting up license reservations. |
Notify Flag |
NOTFY |
This setting is used only in classic STAR and STAR Client to implement the generation of messages to the desktop when globals have been completed. |
Interface |
IF |
This field determines the Interface (and license type) available to the user, from among these choices:
For the anonymous-user Public Catalog session record: set this field to STAR Web Search More information about this field is available in two STARdoc files in the "sysman" folder: the STAR System Management manual section on Security (see secure.pdf or, for STAR/Windows systems, securew.pdf,) and in the Controlling Access to STAR by Interface document (see access.pdf). |
Application Prefix |
APRE |
Unless you have worked with Cuadra Support to replicate the application, assign the default prefix for the Customer Version: LThis prefix ($APP-PREFIX setting) is used to distinguish the CA and Customer versions of the STAR databases and globals. The CA version prefix is: M |
Web Sessions |
WSESS |
This repeating field is used to construct the $WEB setting in the USERS record. Specify whether the user can access one or both of the STAR Web sessions, represented by a path/file name for the .web session file. For staff login records: select the second of the two, to provide access to the Staff session and, in a separate occurrence, the first of the two, to allow access also to the Public Catalog session. |
Web SERVER Database |
WSERV |
(protected) This $WEBSERVER name represents the standard application system database that is used for search-related specifications. |
Web Group |
WGRP |
This $WEBGROUP setting applies only to Staff session users. Use the default at startup for all staff members. Over time, you may decide to set up different group names in the listbox for sharing Staff session saved searches. |
Additional Variables |
ODV |
This field is used to enable and configure features of the Public Catalog session.
If staff members log into the Public Catalog session, the settings in their own records apply. This field is also used to specify the STAR Filing System (SFS) Repository to which the staff member can attach image/electronic documents, in the SFS-defined fields of the Catalog and Accessions databases. If a valid repository is not specified, staff will not be able to use the SFS Import function when creating and editing records. For details, see Dollar Variables. |
Server Log File Settings |
TRACE |
Leave the default setting so that log files (e.g., userid.serlog) will be available for use by Customer Support if problems are reported. |
Idle Timeout |
WIDLE |
This setting defines a first-level timeout for inactive usersi.e., the amount of time that is to elapse before a user is automatically exited from the session if no request has been submitted to STAR from the user's desktop browser. After the "idle" time period has expired, STAR releases the license slot for use by others but continues to remember the user's session if the person returns, so the user can resume where he or she left off. Values are expressed in seconds (e.g., 1200 represents 20 minutes).
For Staff session login ID records: The setting delivered with the "skca" ID uses an 8-hour setting; see discussion below. A Staff session ID will not be "idled" out by STAR Web if there's an open record. |
Kill Timeout |
WKILL |
This setting defines a second-level timeout, also expressed in seconds, after which STAR terminates the session and the user cannot resume where he or she left off when they are logged back in. The termination timeout period is typically set to the same or a larger number than the idle timeout. For Staff session login ID records: If you have a sufficient number of STAR licenses, we recommend that, for staff who will be working with the application throughout the day, you set the time to 8 hours, which represents the number of seconds used in the "skca" startup ID record. If you do not want to use an "all-day" setting, consider one that is sufficiently high to accommodate those staff members who will be browsing a large number of retrieved records in a report to help ensure that the timeout does not get triggered while staff are still working locally. |
Idle Timeout |
IDLE |
(optional, for users authorized to use classic STAR) This field can be filled in with some number of seconds (e.g., 300 for 5 minutes). A minimum of 10 seconds is required if you implement this feature, to have inactive sessions terminated (with an EXIT IGNORE). |
Back to Top ↑ |
Label |
STAR Field |
Description |
Management Notes |
MNOTE |
Use this field for leaving a footprint when making changes in the record. Subfields:
|d. date (populated automatically with "today's" date but can be modified) |n. comments |
Back to Top ↑ |
Label |
STAR Field |
Description |
Record Created |
STAMP |
(Edit form only) This non-editable field represents data captured automatically with the standard STAR Audit Create rule. Subfields (as stored): userID |D yyyy 0m 0d |T hh:mm:ss |
Record Updated |
UP |
(Edit form only) This non-editable field represents data captured automatically with the standard STAR Audit Update rule"last updated" data. Subfields (as stored): userID |D yyyy 0m 0d |T hh:mm:ss |
Back to Top ↑ |