SECURITY

Function

Marks sections of a report for security purposes.

Syntax

SECURITY
[SET=(sid [,sid]...)]
[APPEND=(sid [,sid]...)]
[REMOVE=(sid [,sid]...)]
[MODE=mode]

Arguments

SET

List of security IDs for subsequent commands. The previous list of security IDs is replaced by the specified security IDs. This argument is optional and can only be used once.

sid

Any string literal, column, or variable. The value is case sensitive.

APPEND

Appends the specified security IDS to the current list. This argument is optional and can be used multiple times.

REMOVE

Removes the specified security IDS from the current list. This argument is optional and can be used multiple times.

MODE

Turns on (reactivates) or turns off (suspends) the security feature for the current report. This argument is optional and can only be used once.

mode

Any string literal, column, or variable. The value is not case sensitive and can be either ON or OFF.

Description

SECURITY can be repeated as many times as desired for the current report. After SECURITY is executed, all subsequent commands for the current report are constrained by the designated Security IDS (SIDs) until the report ends or another SECURITY command executes.

You can use multiple SECURITY commands with the SET, APPEND, and REMOVE options. When a SECURITY command with MODE=ON is processed, the resultant access control list (as built by the previous and current command) is used.

Note:

SECURITY is useful only when used in conjunction with EPM Workspace. The Security IDs refer to EPM Workspace groups. To have the Security ID refer to a specific user, prefix it with U#. For example:

sales, marketing, u#King

refers to the sales group, the marketing group, and the user King.

You can use SECURITY wherever you use PRINT.

Examples

Begin-Report
  Security Mode='On' Set=('Directors', 'Vice-Presidents')
    .
    .  ! Only Directors and VPS can see this
    .
  Security Mode='On' Remove=('Directors')
    .
    .  ! Only VPS can see this
    .
  Security Mode='Off'
    .
    .   ! Anybody can see this
    .
  Security Mode='On' Append=('Managers')
    .
    .  ! Only VPs and Managers can see this
    .
  Security Mode='On' Append=('Engineers')
    .
    .  ! Only VPs, Managers, and Engineers can see this
    .
End-report