About this guide

This document gives an overview of the installation of PhenixID Identity Manager. Additional information is found on PhenixID web site or through PhenixID support.

Summary

This document explains Presentation Filter in PhenixID Identity Manager. It is assumed reader is familiar with both the Identity Manager and Identity Manager Configurator. The document is a part of a collection of documents explaining how to extend and customize Identity Manager. In addition there is also Javadoc and sample code.

Mentioning of abstract base class assumes these are used when developing custom code.
First time readers are recommended to read overview document, IM Developer Overview.

Definition

A Presentation Filter is linked to a cell in the grid presenting result from when an administrator executed a predefined search or marked a node in the tree.

Typically this means formatting data before presenting it for an administrator. Presentation filters only apply in the right pane in the main views of IM; Main, Browse and Predefined Search.

Developing Presentation Filter

A presentation filter is a Java class. Required source level is version 8. A presentation filter has no interface.

A base class is provided through:

se.nordicedge.misc.tab.DisplayFilterBase

Presentation must however implement one out of two possible signatures:

public String(String attributeValue);
public String(String attributeValue, String attributeName,String objectDN)

The first parameter is always the the current value (anna.larson@mail.se).

The second is the name of the attribute (mail)

The third parameter is the full object DN (cn=anna.soder,ou=people,o=company)

The return should be the the new value shown to the administrator.

The return does not have to be a simple string. It could be formatted as HTML or even as a Javascript.

Flow of Execution

IM will first try executing the method with signature public String(String attributeValue).

If not found, then IM tries

public String(String attributeValue, String attributeName,String objectDN).

Configuration

Linking a presentation filter is done in DSEditor.properties. Read PSD1066 for how it is done.