DocumentationCampaignCampaign Classic v7 Documentation

Filter schemas filtering-schemas

Last update: Thu Apr 11 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

CREATED FOR:

  • Developer

System filters system-filters

You can filter schema access to specific users, depending on their permissions. System filters let you manage the read and write permissions of entities detailed in schemas, using readAccess and writeAccess parameters.

NOTE
This restriction applies only to non technical users: a technical user, with related permissions, or using a workflow, will be able to retrieve and update data.

  • readAccess: provides read only access to schema data.

    Warning - All linked tables must be set with the same restriction. This configuration can impact performances.

  • writeAccess: provides write access to schema data.

These filters are entered at the main element level of the schemas and, as shown in the following examples, can be formed to restrict access.

  • Restrict WRITE permissions

    Here, the filter is used to disallow WRITE permissions on the schema for operators without the ADMINISTRATION permission. This means that only administrators will have write permissions on entities described by this schema.

    code language-none 
    
<sysFilter name="writeAccess">
 <condition enabledIf="hasNamedRight('admin')=false" expr="FALSE"/>
</sysFilter>

  • Restrict READ and WRITE permissions:

    Here, the filter is used to disallow both READ and WRITE permissions on the schema for all operators. Only the internal account, represented by the expression “$(loginId)!=0”, has these permissions.

    code language-none 
    
<sysFilter name="readAccess">
 <condition enabledIf="$(loginId)!=0" expr="FALSE"/>
</sysFilter>

<sysFilter name="writeAccess">
 <condition enabledIf="$(loginId)!=0" expr="FALSE"/>
</sysFilter>

    Possible expr attribute values used to define the condition are TRUE or FALSE.

NOTE
If no filter is specified, all operators will have read and write permissions to the schema.

Protect built-in schemas protecting-built-in-schemas

By default, built-in schemas are only accessible with WRITE permissions for operators with ADMINISTRATION rights:

  • ncm:publishing
  • nl:monitoring
  • nms:calendar
  • xtk:builder
  • xtk:connections
  • xtk:dbInit
  • xtk:entityBackupNew
  • xtk:entityBackupOriginal
  • xtk:entityOriginal
  • xtk:form
  • xtk:funcList
  • xtk:fusion
  • xtk:image
  • xtk:javascript
  • xtk:jssp
  • xtk:jst
  • xtk:navtree
  • xtk:operatorGroup
  • xtk:package
  • xtk:queryDef
  • xtk:resourceMenu
  • xtk:rights
  • xtk:schema
  • xtk:scriptContext
  • xtk:specFile
  • xtk:sql
  • xtk:sqlSchema
  • xtk:srcSchema
  • xtk:strings
  • xtk:xslt
IMPORTANT
READ and WRITE permissions for the xtk:sessionInfo schema are only accessible by the internal account of an Adobe Campaign instance.

Modify system filters of built-in schemas modifying-system-filters-of-built-in-schemas

You can still modify the system filters of the out-of-the-box schemas which are by default protected due to compatibility issues with older versions.

NOTE
However, Adobe recommends you not to modify the default parameters to guarantee optimal security.
  1. Create an extension for the concerned schema or open an existing extension.
  2. Add a child element <sysfilter name="<filter name>" _operation="delete"/> in the main element to delete application of the filter under the same in the origin schema.
  3. If you like, you can add a new filter, as detailed in System filters.
recommendation-more-help
601d79c3-e613-4db3-889a-ae959cd9e3e1