Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.



Note
titleContent Freeze

As of July 25th, 2023, there is a content freeze on this page.

This document describes the layout of the Atrium database, and how to import users and menu items manually.

Widget Connector
overlayyoutube
_templatecom/atlassian/confluence/extra/widgetconnector/templates/youtube.vm
width

...

640px
urlhttps://www.youtube.com/watch?v=pJOYe0RNHPw
height

...

360px

Users and Groups

In Atrium, each user and group is assigned a unique identifier. The assigned id must be entirely unique. For example, a user id number must be unique not only among other users, but also among any and all groups.

...

This file controls display options in Atrium. Each user or group and have their own settings. Or, they can inherit from their parent groups, or from a set of global defaults.


Option

Description

Values

ACID

This is the unique key for this file.

When the portal loads, Atrium looks for a record in this file with the user id number. This will be present if the user has his own settings.  If not, a record might not be present for the user. In this case, group settings will be checked using the user’s parent group id. This record also may not be present. In this case, prior parent group ids (if any) will be checked.

If nothing is found, the record with ACID = 0 (global settings) will be used.

(warning) This record must always be present, or an error will occur.

any unique user or group id

ACBTITLE

This controls the title displayed in the browser title bar and/or browser tab. Can be set to any desired text.

any valid text

ACBAN

Flag that controls whether a banner is displayed at the top of the portal.

1/0

ACBANHEIGHT

Controls the height (in pixels) of the banner.

(info) If ACBAN = ‘0’,

...

this field is ignored .

any valid pixel value

ACBANURL

Sets the URL of the external HTML file that provides the banner content. The URL can be either a fully qualified URL, or an absolute path to an HTML file within the Profound UI http server’s document root folder.

(info) If ACBAN = ‘0’,

...

this field is ignored .

fully qualified URL or absolute path

ACTHEME

Sets the color theme.

‘blue’, ‘gray’, ‘olive’, or ‘slate’

ACUTHEME

Controls whether or not the user gets an option on the Settings menu to set their own color theme.

1/0

ACSHOWHOME

Controls whether or not a home page is shown automatically when the portal loads.

1/0

ACHOMEURL

Sets the desired homepage.

any unique navigation item number

(field ANITEM in file ATNAVP)

ACNTITLE

Controls the text that is displayed in the title bar of the navigation panel.

any valid text

ACNWIDTH

Sets the starting width (in pixels) of the navigation panel when the portal loads.

(info) The user can resize the navigation panel during the session.

any valid pixel value

ACNTYPE

Controls whether the navigation panel is shown in the Tree or Accordion style.

'T'/'A'

ACNSCLICK

Controls whether navigation items will launch with single (1) or double (0) click.

1/0

ACSEARCH

Controls whether Menu Search feature is enabled.

1/0
default: 1

ACFAV

Controls whether Favorites system is enabled.

1/0
default: 1

ACLIMIT

Limit of number of Atrium sessions, per web browser.

any valid positive number value

0 = no limit

ACMINSRCH

Minimum number of characters for menu search.

any valid positive number value

ACJOBD

Specifies a job description to set the library list from.

(info) *USRPRF can be specified if the Atrium users are IBM i user profiles.

(warning) To use, the field ACLIBL must be blank.

any valid job description

ACJOBDLIB

Specifies the library for the job description.

(info) *LIBL or *CURLIB can be specified.

any valid library

ACCURLIB

Specifies the current library.

any valid library, *USRPRF, or *CRTDFT

ACLIBL

Contains a set of libraries to use as the library list.

(warning)  To use, both ACJOBD and ACJOBDLIB must be blank.

any valid libraries


title
Note

NOTE

To use the Atrium defaults, ACJOBD, ACJOBDLIB, ACCURLIB, and ACLIBL must be blank.

Groups File (ATGROUPSP)

This file contains Atrium groups. Users and other groups can be assigned into a group to inherit display settings and/or menu permissions.

Option

Description

Values

AGGROUP

Specifies a unique group identifier.

(warning) Value 0 is reserved and must not be used as a group id in this file.

any unique and valid positive number value

AGPARENT

Specifies a unique parent group identifier.

(warning) Value 0 is for a top-level group which is not a member of any other.

any unique and valid positive number value

AGNAME

Sets the display name for the group.

any valid text


title
Warning

IMPORTANT!

Identifiers must be unique among users and groups.

Users File (ATUSERSP)

This file contains a repository of users who are capable of signing into Atrium.

Option

Description

Values

AUUSER

Specifies a unique user identifier.

(warning) Value 0 is reserved and must not be used as a group id in this file.

any unique and valid positive number value

AUGROUP

Specifies the unique parent group identifier of the user.

(warning) All users must be assigned to a valid group.

any valid parent group identifier

AUROLE

Sets the user's access role.

0 - user is a User with permission to sign in and use navigation items for which they were given permission to use.

1 - user is a Manager with permission to add, remove, or update users within their own groups and subgroups of their groups.

2 - user is an Administrator with permission to perform any function in the portal.

AUEDIT

Controls whether user can access My Settings option in the Settings menu. My Settings allows the user to control some of their own

1/0

AUNAME

Sets the user's display name.

any valid text

AUPROF

Sets the user's profile name.

(warning) When IBM i profiles are used, this field must be set in uppercase. For all other types of users, the case used must match EXACTLY to the user profile name in the user repository.

any valid name that corresponds to the user repository used to authenticate with the HTTP server.

(i.e. IBM i operating system, Kerberos, LDAP, validation list, etc.)

AULANG

Sets the user's language code. Is used as a key to find menu item translations in file ATNTRANSP .

(info) If the language code is left blank, or there are no matching records in ATNTRANSP, the normal menu item texts are used.

As of Profound UI Version 6 Fix Pack 1.0, if the language code matches a language defined for Atrium, such as de_DE, fr_FR, it_IT, then the Atrium user interface will use that language when pui["language"] is not set in an extensions/atrium/ JavaScript file (e.g. settings.js).

Optional

any valid language code


title
Warning

IMPORTANT!

Identifiers must be unique among users and groups .

Supplemental Groups (ATSUPGRPP)

This file contains supplemental members of groups. Both ASUUSER and ASUGROUP are primary keys; so, a user can be a member of multiple groups.

...

AMAACTN: A single-character Action Id. Valid Actions are:

  • 0: Write a value into a field

  • 1: Press a key

  • 5: Close the browser window or tab

AMAROW: Field Row. Value is 0 unless the action is 0–write a value into a field. For action 0, this identifies the terminal row where the field exists.

...

AMAVARTYPE: Variable Type. A single-character Type Id. This field is ignored when action is 5. This describes the data in the AMAVAR field. Valid Types are:

  • 0: A literal value. When action is 0, the value of AMAVAR is to be entered literally. When action is 1, the value of AMAVAR is the key to be pressed.

  • 1: A variable value. Valid for action 0 or 1. When configuring a navigation item to use this macro, you will be prompted for the variable name. The value entered on the navigation item will be written into the field when the macro is run.

  • 2: The current user profile. Valid only for action 0. Indicates that the current user profile should be entered into a field.

  • 3: The result of a JavaScript expression. Valid only for action 0.

AMAVAR: Variable. This field is ignored when action is 5. This way this field's value is used depends on the Action (AMAACTN) and the variable type (AMAVARTYPE).

...