Skip Headers

Oracle Argus Affiliate User's Guide Release 7.0.3 E40580-01 |
| Contents

Previous | Next |

# 4 Affiliate Configuration

The Affiliate Administrator is responsible for configuring the Argus Affiliate. This section includes discussions of configuration tasks.

## Creating User Groups

Each Argus Safety user can be a member of one or more user groups. The access rights of each user group to the menus in the user interface and specific sections of the Case Form can be configured when the group is created.

The Administrator can configure user groups from Argus Console >Access Management >Argus > Groups. Because user group configuration can only be done from Argus Safety application, the Administrator must be logged on to Argus Safety application.

The following is an illustration of the Groups and Users page.

This section enables the Administrator to configure the security levels for each work group.

Radio buttons enable you to view the group and assign access rights for several specific sections of the case form, menu, case workflow, and report workflow.

Tip: If a user belongs to multiple groups, the access rights for the user will be the sum-total of the individual group access rights. Example: John Smith is an Argus User and his profile has been added to 2 user-groups with different access level permissions for each group. John has access rights to the Patient Tab in one group and access rights to the General Tab in another group. In this case, John will be able to access both the Patient and the General tabs of Argus.

To add/copy/modify/delete user groups navigate to the Access Management->Argus->Groups section.

The following table lists and describes the fields on the Groups and Users page.

Field | Purpose
--- | ---
Group Name | Enables the administrator to enter a unique name for the group
Email | Enables the administrator to add the group email, used for case priority notification and workflow routing notification
Supervisor Email | Enables the administrator to add the Group's Supervisor Email as applicable. This e-mail address is used to send notifications when the maximum time of a case for a particular workflow state is exceeded
Case Form | Lists the different sections and sub sections within a Case Form and enables the Administrator to assign the group Modify; View (Read Only); or No Access Rights (not visible) to each area
Menus | Lists the different menus and sub menus within a Case Form and enables the Administrator to enable or disable each of them
Advanced conditions -- No create Advanced Condition Access | If No Create Advance Condition Access is checked, then the Advance Condition will not appear as an option for any user belonging to the group
Advanced conditions -- No access to share Advanced conditions | If No Access to Share Advance Conditions is checked then any user belonging to the group, will not be able to share the Advance Conditions with others
Advanced conditions -- No Access to view & edit SQL | If No Access to View and Edit SQL is checked, then the SQL button will not appear for the user belonging to the group
Listedness Determination -- Countries | Enables the administrator to assign Argus users to the group that has the rights to change the listedness determination for licenses originating in the selected countries
Restrictions - Products | Product security limits the number of products that can be viewed in the trade name lookup and non-study cases Click the Products checkbox to enable the Select button Click this button to view a security configuration containing a tree view list of available items Select a product family to select all its constituents
Restrictions - Studies | Study security limits the number of studies available for selection and the study cases that can be viewed Click the Studies checkbox to enable the Select button Click this button to view a security configuration containing a tree view list of available items Select a study family to select all its constituents
Default report (Argus Affiliate only) | This field lists the expedited report forms in the drop-down list

To Create a User Group

1. In the Access Management menu, click Argus > Groups.

2. Select the filtering criterion. The left panel now displays the list of Groups or Users based on the filtering criterion.

The filtering criterion is essential as it helps you to search for specific items. The Argus Console provides this option for the Access Management section.

### Using Organized By

The filtering browser is displayed in the top-left corner of the left panel. This section can be filtered on the basis of any of the two combinations displayed below.

For Example: If you enable Organized by Groups, then the output generated will be visible in a tree-format, in the left panel, based on the entire categorization of Groups and Users

Whereas if you enable the Organized by Users, then only the User list will be available in the tree view in the left panel.

Using the "contains" or "starts with" characters enables you can specify whether your search should contain or start with specific characters.

For example, the filtering criterion defined above will search for all Groups that contain the word "administrator".

1. Select a Group and click to view the group details in the right panel.

   Tip: Select a group under LOCAL AFFILIATE in the left panel to view the details of a Argus Affiliate Group. You can alternatively click Add Group to create a new group. Use Copy to make an editable copy of an existing group. Use Delete to delete a group.

2. Enter the Group Name. This should be a unique name associated with this Group.

3. Enter the Email address, if applicable.

4. Enter the Supervisor Email address, if applicable.

5. In the Case Form section, select the desired access right option ("Modify", "View", or "No Access") for the group's access to each of the listed items of Case Form.

   Caution: The following fields are required in order to save a case: Initial Receipt Date, Country of Incidence, Report Type, Suspect Product, and Event Description as Reported. Therefore, the group responsible for initial case entry must have access to these fields in order to save new cases.

6. In the Menus section, enable or disable access of the group, to particular items in the Argus Safety menu.

   Tip: Refer to the Argus Safety User Guide for information about the functions of the Case Form sections and the menu items in the Argus Safety user interface.

7. In the Listedness Determination section, select a list of countries. This enables the end user to override the listedness determination in the Event Assessment section of the Case Form for product licenses that match the countries selected in this step.

8. In the Advanced Conditions section, select No Create Advanced Condition Access, No Access to Share Advanced Conditions, and/or No Access to View and Edit SQL.

   Tip: If you select the No Create Advanced Condition Access checkbox, the Advanced Conditions button will not appear as an option for that user group. If you select the No Access to Share Advanced Conditions checkbox, the user group will not have access to share Advanced Conditions. If you select the No Access to View and Edit SQL checkbox, the SQL... button will not appear as an option for that user group.

9. In the Restrictions section, select Products.

   If you click Add Product, the following screen appears. Mark the products required by selecting the check box and click OK.

10. In the Restrictions section, select Study.

11. If you click Add Study, the following dialog appears. Mark the studies required by selecting the check box, and click OK.

12. Click Save or Add Group to save the newly created Argus Affiliate group.

    The following table lists and describes the Groups included with factory data:

    Group | Description
    --- | ---
    Administrator | This group has access rights to all areas and all the functionality of Argus Safety.
    Investigator | Receives an e-mail alert that can be set up during Clinical Study Configuration.

## Creating User Accounts

The User Maintenance dialog enables the Administrator to add, copy, or delete users for the system.

Each user must be assigned to at least one group in order to determine their security level. Each group is assigned a specific security level, allowing members of the group view, modify, or have no access rights to various sections of the case form, etc.

Configuration of the users is done from Argus Console > Access Management > Argus > Users.

The following illustration shows the fields associated with this section.

### Field Descriptions

The following table lists and describes the fields in the Administrator section

Field/Control Name | Description
--- | ---
User Name | Enter the full name.
User ID | Enter a unique user identification (ID).
Reset Password | Reset the password of a user to a default value specified in the common profile section.
Email Address | Enter the user's e-mail address.
Site | Assigns the user to a site. The values in this field are populated from the codelist item User Sites.
User Group - Select | Attaches the user to pre-configured user groups.
User Type | Select the type of user, such as an Argus J user from the drop-down list.
Application Access | Configure user access settings for Argus Console and Argus Safety. The default application access for the user can be selected from the list.
Worklist to display at login | Configure users to see their worklists immediately upon login. The options are: None (default) - Does not open any worklist when the user logs into Argus. Displays personal Argus status on login. Action Items - Opens Worklist - Action Items screen for the user on login into Argus New - Opens Worklist - New screen for the user on login into Argus Open - Opens Worklist - Open screen for the user on login to Argus. Reports - Opens Worklist - Reports screen for the user on login into Argus
Enable site security | If Enable Security is checked, the site-based data security will be enabled for the user. If the box is not checked, the user will have full access to data from all sites.
Enable LDAP Login | Authenticates users against the active directory server. When Enable LDAP Login is selected, all fields inside the Access section are disabled, excluding the Account Disabled option.
Account Disabled | When this option is selected, the user account is temporarily disabled to prevent users from logging in. This option is different from deleting a user as it enables the Administrator to re-activate the account at a later date.
Security Disabled Account | When unchecked, the login procedure keeps track of the number of consecutive unsuccessful attempts at logging into the system. If the count reaches three, the login procedure will always fail the password validation to lock the user out. Administrators with rights to user maintenance can reset the login attempts for the user to unlock the account. When checked, the login procedure that tracks the consecutive unsuccessful attempts at logging into the system do not apply.
Force password change at login | If this check box is selected, the users must change the password the first time user logs on to the system after the checkbox is checked.
Force password to expire every | Enables the Administrator to force the user's password to expire in the specified number of days.
Days | Enables the Administrator to enter the number of days after which the password should expire.
__ Days remaining | The field displays the number of days remaining for the password change.
Allow unblinding of cases | Enables the user to unblind a study case. For example, a user without unblinding rights will not see the Study Drug field. A user with unblinding rights sees a yellow Unblind tag next to concentration of product field and the Broken by Sponsor option in Blinding Status drop-down list is enabled. User will have to enter password when user selects Broken by Sponsor' option.
Protect from unblinded information | When checked, the user cannot view any unblinded information.
Protect from printing unblinded information | When checked, the user cannot print any unblinded information.
Allow locking of cases | Enables the user, to lock/unlock the cases.
Allow closing of cases | Enables the user to close the cases.
Route on close case | Opens a routing dialog when the user closes the case.
Enable Checklist on Route | By default, this checkbox is selected. If this checkbox is not selected, the checklist for the Workflow is not displayed to the user while routing the cases, even if the rule that is being used has a checklist.

### Adding Users

This section enables you to add, copy, modify or delete users for the system. When managing user accounts, be aware of the following:

- Each Argus user must be assigned to at least one group in order to determine the user's security level.

- Each group is assigned a specific security level. This enables group members to view/modify or have limited access rights to various sections of the case form, etc.

- To add/copy/modify/delete users navigate to Argus Console>Access Management->Argus->Users section.

To Create a User Group

1. In the Access Management menu, click Argus > Users.

2. Select the filtering criterion. The left panel now displays the list of Groups or Users based on the filtering criterion.

The filtering criterion is essential as it helps you to search for specific items. The Argus Console provides this option for the Access Management section.

#### Using Organized By

The filtering browser is in the top-left corner of the left panel. This section can be filtered on the basis of any of the two combinations displayed below.

For example, if you enable Organized by Groups, the generated data will be visible in a tree-format, in the left panel, based on the entire categorization of Groups and Users

Whereas if you enable the Organized by Users, then only the User list will be available in the tree view in the left panel.

Using the contains or starts with you can specify whether your search should contain or start with specific alphabets.

For example, the filtering criterion defined above will search for all Users that contain the word "admin".

1. Select a User and click to view the user details in the right panel.

   Note: You can alternatively click Add User or Add New User to create a new user. Use Copy to make an editable copy of an existing user. Use Delete to delete a user.

2. Enter the User Name. This should be a unique name associated with this user.

3. Enter the User Id. This is the unique user name associated with the user.

4. Enter the Email Address of the user.

5. Select the Site from the drop-down list. The user is assigned to this site.

6. Select the User Type from the drop-down list.

7. Select the language from the drop-down list in Modify Language Narrative.

8. This is the language the user has access to in the multi-lingual fields.

9. Select the following options in Access, as per your requirements.

   Field Name | Purpose
   --- | ---
   Account Disabled | Enables the administrator to disable the account.
   Security Disabled Account | Enables the administrator to disable the account depending upon the number of consecutive unsuccessful login attempts. When unchecked: The login procedure keeps track of the number of consecutive unsuccessful attempts at logging into the system. If the count reaches three, the login procedure will always fail the password validation and lock the user out. Administrators with rights to user maintenance can reset the login attempts for the user to unlock the account. When checked: The login procedure to keep track of the consecutive unsuccessful attempts at logging into the system does not apply.
   ESM Admin | Enables the administrator to give the Argus user access to the ESM Mapping utility.
   Force Password change at login | Ensures that password is changed at login. Select this field to force Argus users to change their password, when they log in to the application for the first time.
   Force password to expire every x days | Enter the maximum number of days for the user(s) to retain user password.
   Reset Password | Select this field to reset the user password.

10. Select the following options in Case Form, as per your requirements.

    Field Name | Purpose
    --- | ---
    Allow unblinding of Cases | Select this to allow the user to unblind a study case. A user with no rights of unblinding a case cannot see the Study Drug field. Users with Unblinding rights see a yellow tag "Unblind" adjoining the Concentration of product field. The Broken by Sponsor' option in Blinding Status drop-down is enabled. User has to enter password when on selecting the "Broken by Sponsor" option
    Protect from unblinded information | Allows the Administrator to protect a user from unblinding information such as Study Drug, Concentration, Dosage Regimens and Total Dosage.
    Protect from printing unblinded information | Select this to disable the user from printing unblinded information.
    Allow locking of cases | Select this to allow the user to lock cases.
    Allow closing of cases | Select this to allow the user to close cases.
    Route on Close Case | Select this to disable the case routing dialog which appears when the users selects Case Actions -- Close Case on the case form.

11. Select the User Group.

12. Enable the Application Access for different applications such as Argus, Power Reports or Console.

13. Select the Default application access from the drop-down list, for the user.

14. Select the default worklist to be displayed on logging onto Argus from the Worklist to display at login drop-down list, for the user.

15. Select the Workflow manager checkbox to give the user more rights within the system.

16. Select the Enterprise checkbox to configure a 'Workflow Manager' user as an 'Enterprise user'. The user can view cases of any site outside its site too. This field is enabled only when the 'Workflow Manager' field is checked.

17. Select the Enable Site Security checkbox to enable site based security data for the user.

18. This is made possible through the Site Access Configuration dialog.

19. The Site Access Configuration section enables a user to get access to additional sites.

20. The administrator can select the access level by selecting from the options available in this dialog.

    The following table describes the access levels in this dialog:

21. Select the Enable LDAP Login checkbox to allow the user to be authenticated against the active directory server.

22. Click Save to add the newly created Argus Affiliate user.

### Configuring the Affiliate System Numbering

The system provides the ability to use multiple case numbering schemes for globally. For example, if site is used in the numbering, the system provides the option to keep separate sequences for each site. However, Affiliate System Numbering configuration can only be done from Argus Safety application. Therefore, to configure the Affiliate System Numbering, the Administrator must be logged on to Argus Safety application.

Select Argus Console >System Configuration > LAM System Numbering to view the Affiliate System Numbering screen. The following is an illustration of the LAM System Numbering page.

The following table lists and describes the fields on the LAM System Numbering page.

Field | Description
--- | ---
Manually Number Cases | The option enables the user to manually number the cases on booking or while copying the case, using the "save as" option on the case form.
Automatically Number Cases | On selection, the system automatically numbers the cases as defined by the user in the numbering format.
Start at | Enables the user to initialize the counter of the sequence number.
Separate sequence for each site | Enables the user to separate the sequence numbering for cases on site by site basis. If there are cases being entered from two different sites then each site will have different sequencing of case numbers.
Separate sequence for each report type | Enables the user to separate the sequence numbering for cases by the report type of the case.
Separate sequence for each year | Enables the user to reset the sequence numbering for cases after each year, based on the initial receipt date of the case.
Separate sequence for each month | Enables the user to reset the sequence numbering for cases after each month, based on the initial receipt date of the case.
Separate sequence for each product abbreviation | Enables the user to reset the sequence numbering for cases for each different product abbreviation.
Numbering Format | Enables the user to select the numbering format by selecting the different placeholders. Define the numbering format by typing in custom keywords to print on every case number & selecting different placeholders. [YY][MM]-[###] is the default format.
Placeholder | Enables the user to enter a placeholder. Placeholders are used to pickup values from the database to be used in the Case numbering format. The possible values populated in this list are: . # -- Number: defines the digits to be used as the sequence number in the format. The field is used to display the sequence number on the case numbers. CC-- Country code: When selected, this uses the A2 code for the country of incidence for the case number. DD -- Day: When selected, this uses the date of the "Initial receipt date" field of the case. MM -- month: When selected, this uses the month of the "Initial receipt date" field of the case. P -- When selected, this uses either of the two values: a. If report type is "Spontaneous" or " other" during booking: the system uses the value of the "Product Abbreviation" field specified in the Product configuration for the selected Primary suspect product. b. If report type is of the type "report from study" during booking: the system uses the "Product Abbreviation" field specified in the study configuration. SSS -- User Site: When selected this uses the Site abbreviation of the site belonging to the user who booked in the case TTT -- Report Type: When selected this uses the report type abbreviation of the report type selected during bookin of the case YY -- Year: When selected, this uses the year of the "Initial receipt date" field of the case.

To Configure Affiliate system numbering

1. Select the Numbering feature as required. This can be manual numbering or automatic numbering of cases.

2. Select the Sequencing Options as required.

3. Select the Numbering Format. Use Placeholders to enter the required format.

   Note: To customize the Numbering Format, use the placeholder values. Example: To select Country Code, Month and Year (as values to be incorporated from the database) as the Case numbering format, execute the following steps. Click on Country Code. This appears in the Numbering Format field. Click on Month. This appears in the Numbering Format field next to the Country Code. Click on Year. This appears in the Numbering Format field next to the Country Code and Month. The final data listed in the Numbering Format field is the Case Numbering Format.

4. Click Save to save the changes made.

## Viewing the Audit Log

The LAM Audit Log can only be viewed from the Argus Safety application. The following is an illustration of the LAM Audit Log.

To View the Affiliate Audit Log

1. Go to Utilities > Logs > LAM Audit Log to open the LAM Audit Log.

2. The following table lists and describes the fields in the LAM Audit Log.

   Field | Description
   --- | ---
   Search Conditions |
   From | Enter the initial date of the time period to be searched
   To | Enter the end date of the time period to be searched
   Search button | Displays the results of the specified search criteria.
   Total Number of Rows |
   Action | Displays the Audit Log Details screen
   Activity | Displays the status of the activity. Displays whether it has changed or not.
   Audit Data | Displays the audit data
   User | Displays the last user who made changes to the case
   Field | Description
   Date/Time | Displays the last time the case was changed. Note: The time displayed is as per GMT.
   Print List button | Prints the list of all the logs.

### Searching the Audit Log

Use the following procedure to search the Audit Log.

To search the audit log:

1. Enter a date range for which the audit log is to be viewed. A date range can also be selected from the Range list.

2. Click Search.

3. A list of LAM Audit Log items matchin`g the search criteria appears in Total Number of Rows.

4. Click the Action icon displayed against each search result in Total Number of Rows to open the Audit Log Details screen.

   Note: The lower half of the Audit Log Details screen displays the list of all the revisions made in the case.

   The following table lists and describes the fields on the Audit Log Details screen.

   Field | Description
   --- | ---
   Total Number of Rows | Displays the total number of rows in the list
   Parent | Displays the parent page where the change has been made.
   Field | Displays the field where the change has been made.
   Old Value | Displays the previous value.
   New Value | Displays the new, changed value.
   Rev | Displays the revision number. The list is sorted in descending order of the revisions that have been made so the latest revision is displayed at the top.
   User Name | Displays the name of the last user who made a change.
   Revisions Date | Displays the last date when the change was made.
   User | Displays the name of the user who last made the revision.

5. Click a row displaying a revision.

6. The system displays the details in the upper half of the screen.

Tip: Multiple selections can be made to view the details of revisions.