Security Group - List Level

You can package and deploy the list level Security Group definition and its associated artifacts from one environment or repository to another environment or repository using the Package feature in AVEVA Work Tasks.

To add List Level Security Group to Package Template

Complete the following tasks to add security group definition to package template:

1. Go to the List which contains the security group that you want to package. For example, Workflow List.

2. Click Security on the ribbon bar.
   The security settings window opens.

3. Click Advanced Settings tab.

4. Click Customize Security Group for this List.
   The security group list at list level window appears.

5. Select the Security Group that you want to package.

6. Right-click and then select Add to Package Template.
   The Add to Package Template dialog box appears with the List Level Security Group.
   For more information about adding artifacts to Package Template, see Adding Artifacts to a Package Template.

The following shows the tree view format of the list level security group, for example, Add to Package Template: <Security Group Name - List  - List name>:

Associated Artifacts for Security Group Definition

A List Level Security Group can have the following Associated Artifacts:

• Repository Level Security Group

• List Specific Custom Security Right

• Workflow

• Form Link

• Dynamic Lists

• Form

Child Artifacts for Security Group Definition

Security Group does not have any child artifacts.

Configuration Settings for Security Group

The Manage Security Group definition has an unique set of configuration settings required for installing, updating, and uninstalling the Package.

You can view and edit the configuration settings from one of the following windows:

• Source Environment > Package Template window

• Target Environment > Manage Package window

You can use the Settings tab of the Manage Security Group definition artifact to define the configuration settings. The Associated Artifacts tab displays the associated artifacts of the Manage Security Group definition.

The Package Template configuration window contains the following tabs:

• Settings

• Associated Artifacts

• Child Artifacts

Settings Tab

You can use the properties in the Settings tab to take appropriate actions to install, update, or uninstall the package.

Install:

While installing the security group, the package checks whether the security group customization is enabled the list level. If the security group customization is not enabled, then the package first enables the security group customization. Then the package overwrites the security group definition. If the security group customization is already enabled, then the package overwrites the security group.

The configuration settings in the Install tab is referred to when installing the package.

• Security Group Exists: This property allows you to take appropriate action when the Security Group definition specified in the package is already present in the target environment.

  • Do not install Security Group: Select this option to use the Security Group definition that is present in the target environment.

  • Install to overwrite existing Security Group: Select this option to overwrite the Security Group definition that is present in the target environment with the one in the package.

    By default, Install to overwrite existing Security Group is selected, since the security group will be available in the target environment and on installing the package it will be overwritten. If the security group is not available in the target environment then prior to installing the package the security group will be enabled, hence the security group will be overwritten.

• Associated Artifacts Not Present: This property allows you to take appropriate action when the associated artifacts of the Security Group is not present in the target environment.

  • Install Security Group: Select this option to install the Security Group, even if the associated artifacts are not present in the target environment.

  • Do not install Security Group: Select this option if you do not want to install the Security Group artifact as its associated artifacts are not present.

Update

The settings in this tab is referred to when the same Package is installed for the consecutive time.

• Delete Security Group: Select this option to delete the Security Group definition that is present in the target environment.

  • Yes: Select this option to remove the Security Group definition in the target environment.  On selection of this option, the Security Group is Modified option appears.

    Security Group is Modified

    • Retain: Select this option to retain the Security Group definition along with the modifications, in the target environment even after the Package is updated.

    • Rollback to Original State: Select this option to roll back to the original state. All modifications that were done to the Security Group definition after it was installed in the target environment will be reverted. However, the Security Group definition will be retained in the target environment.

    • Delete: Select this option to delete the Security Group definition from the target environment when updating the Package.

  • No: Select this option to retain the Security Group definition in the target environment. On selection of this option, the Security Group Exists option appears as shown in the following table:

    Security Group Exists

    • Do not install Security Group: Select this option to use the Security Group definition that is present in the target environment.

    • Install to overwrite existing Security Group: Select this option to overwrite the Security Group that is present in the target environment with the one present in the package.

      Associated Artifacts not present

    • Update Security Group: Select this option to update the Security Group even though no associated artifacts are present.

    • Do not update Security Group: Select this option if you do not want to update the Security Group when the associated artifacts are not present.

Uninstall

You can refer to the following settings in the Uninstall tab to uninstall a package from a target environment:

• Delete Security Group: Select this property to retain or delete the Security Group definition in the target environment even after the Package is uninstalled.

  • Yes: Select this option to remove the Security Group definition from the target environment when the Package is uninstalled.

    When you select Yes, the Security Group is Modified option appears as shown in the following table:

    Security Group is Modified

    • Retain: Select this option to retain the Security Group definition along with the modifications in the target environment even after the Package is uninstalled.

    • Rollback to Original State: Select this option to roll back the Security Group to the original state. All modifications that were done to the Security Group definition after it was installed in the target environment will be reverted. However, the Security Group definition will be retained in the target environment.

    • Delete: Select this option to delete the Security Group definition from the target environment while uninstalling the package.

  • No: Select this option if you want to retain the Security Group definition in the target environment even after the Package is uninstalled.

Remove Security Group Customization at List Level

While uninstalling the security group at list level, the security group artifact checks whether the security group customization is enabled by the current security group artifact.

• If not, then uninstall rolls back the security group definition to the original state, but does not remove the security group customization as it was not enabled by it.

• Otherwise, the security group artifact checks whether any other security group is modified at the list level.

  • If yes, then uninstall does not remove the security group customization, but rolls back the security group definition to the original state.

  • Otherwise, uninstall removes the security group customization.

• Consider that a custom security group is packaged at list level and a repository level security group is an associated artifact. While installing, both the security groups are installed. While uninstalling, select the "Delete" option for the repository level security group and "Retain" option for the list level security group. Then, the list level security group artifact is uninstalled or retained first, followed by the repository level security group artifact which is deleted while uninstalling. As the repository level security group is deleted, it removes the complete definition of the security group from all the levels.

  • Thus, the list level security group gets uninstalled, though the delete option is to "Retain" the security group. However, the security group customization is retained.

  • The security group customization cannot be removed by the package, even if you uninstall the package again. So it is advisable to select the "Delete" option for list level security group. If you select the "Delete" option for repository level security group, irrespective of the option that is selected for list level security group, the security group as a whole is deleted.

Associated Artifacts

This tab displays all the associated artifacts of the selected Security Group definition.

If a Form link with the same name is already present in the target environment and it is not overwritten, then the security right might not work as expected if the form link in the target environment is of a different type and different mode, and if the mode is Pop-Up.

If the Security Group at repository level is not available in the target environment, then the security group at list level will not be installed.

Child Artifacts

Security Group does not have any child artifacts.

Security Artifacts

The Security Artifacts tab displays the security artifacts of a database connection, if any.