This blog details the implementation and utilization of Dynamic Tile in PeopleSoft
In PeopleSoft, dynamic tiles are a type of tile that offer real-time or dynamically generated content on the homepage or landing page of a user’s PeopleSoft environment. Unlike static tiles, which display predefined information or links, dynamic tiles provide personalized and dynamic data based on specific criteria or user preferences.
Introduction:
A tile on a fluid homepage is similar to a pagelet on a classic homepage. It leverages the ability to display dynamic content from PeopleSoft, which includes visual content from pivot grids or other information sources.
We can show dynamic data on tile by specifying an application class as the data type in Tile Wizard. In addition to specifying the application class ID, we also specify these options in Tile Wizard:
- Tile content type
- Live data (on/off)
- Badge data (on/off)
Configuring Tile Options:
We can configure the looks and behavior of tiles in PeopleSoft via ‘Fluid Attribute’ tab of target content reference. Dynamic content on tile is achieved by specifying an application class as the data type in Tile Wizard.
Navigation: Menu -> PeopleTools -> Portal -> Structure and Content and drill down to appropriate folder to get the target content reference.
Click on Fluid Attribute tab to create and configure the look of the tile which in case on Classic component is usually absent.
These options determine what dynamic content and data will appear in the tile. Our implementation of the application class in PeopleCode will determine the specifics of the dynamic content and data. However, our PeopleCode implementation will override the options chosen in Tile Wizard.
1. Tile Title
The tile’s title appears in the title bar at the top of the tile. The title is defined at Step 1 in Tile Wizard,and cannot be overridden in People Code.
2. Tile Content
The tile content consumes the majority of the face of the tile, beneath the title bar and above the live data and badge areas on the tile. While the tile content type is specified at Step 2 in Tile Wizard, it can be overridden in PeopleCode. The specific tile data for any tile content type must be defined in PeopleCode.
3. Live Data
The live data region appears at the bottom of the tile. Whether live data is displayed on a tile is specified at Step 2 in Tile Wizard; this setting can be overridden in PeopleCode.
Live data consists of four elements, each of which is optional:
Live data value 1 + Trend image + Live data value 2 + Live data value 3.
Creating Application Package for the Dynamic Tile:
To implement an application class for tile content, do the following in your application class definition:
1. Import the base class (also referred to as the superclass):
import PTGP_APPCLASS_TILE:Tiles:Tile;
Note: Make sure the App Package contains a Sub Package. Otherwise, we might run into errors.
2. In the class declaration, do the following:
a. Indicate that your class (the subclass) extends the base class.
class TileD1 extends PTGP_APPCLASS_TILE:Tiles:Tile
b. Declare the constructor method for your class.
method TileD1();
c. Declare the required getTileLiveData method.
method getTileLiveData();
d. (Optional) Declare any additional private methods and properties required by your implementation.
3. In the constructor method for your class, instantiate an object of the superclass:
method TileD1
%Super = create PTGP_APPCLASS_TILE:Tiles:Tile();
end-method;
4. In your implementation of the required getTileLiveData method, do the following:
a. (Optional) Override the content type by invoking one of the optional SetTileContentAs* methods.
b. (Optional) Override whether live data is displayed on the tile by invoking the setTileLiveData method or setting the hasLiveDataDescr property.
c. (Optional) Override whether badge data is displayed on the tile by invoking the setTileHasCount method or setting the hasLiveDataCount property.
d. For the tile content type selected, invoke any require methods and set all required properties for that content type.
See Properties and Methods Required by Tile Content Type for more information.
e. If live data is enabled for the tile, set all required properties for live data. See Live Data for more information.
f. If badge data is enabled for the tile, set all required properties for badge data. See Badge Data for more information.
g. (Optional) Implement error handling by setting the hasContent property.
5. Create a tile definition in Tile Wizard. At Step 2, specify your custom application class.
Defining Application Class and Tile Content:
Defining the Application Class when the Tile content is Image
Invoke the SetTileContentAsImage method within your implementation of the getTileLiveData method only if you wish to dynamically override the tile content type to display an image at runtime. When the tile content is specified to be an image, either setTileImageRef method or the ImageReferenceField property is required.
When the user want to use image as tile content, the following methods and property can be used to define the Tile Content.
Methods
Syntax
- SetTileContentAsImage() – invoked in getTileLiveData() to dynamically override the tile content type at runtime.
- SetTileImageRef(image_name) – This method is used to specify the image to be displayed when the tile content is chosen as image.it is equalivalent to specifying the value for property.
- ImageReferenceField – Either of the two can be used when the tile content is specified as image.
Properties
Syntax
- ImageReferenceField –It is used to specify the image field property when the tile content is specified as image. As it is a Field object, we can give value property as follows:
- %This.ImageReferenceField.Value=Image.IMG_ID;
- TileImageReferenceLabel – This property is used to set tooltip (Hovertext) for the image set as tile content.It is visible by the user when the image is hover over.
- %This.TileImageReferenceLabel(“This is a image hover text”);
Dynamic tile with Image as tile content, the tile content consumes the majority of the face of the tile, beneath the title bar and above the live data and badge areas on the tile.
Application Package PeopleCode.
Setting Live Data
Live Data is displayed at the left bottom of the tile. 3 Live data can be displayed on the dynamic tile. Live data can be enabled from Step 2 of Tile Wizard or we can also override it through PeopleCode.
Live data consists of four elements, each of which is optional:
Live data value 1 + Trend image + Live data value 2 + Live data value 3
Method and Properties used to define Live Data
- hasLiveDataDescr– This property is used to enable the Live Data area. It returns a Boolean value. It is equivalent to setTileLiveData method.
%This.hasLiveDataDescr= “True”;
%This.setTileLiveData(“Y”); /* Enables the Live Data Area */
Setting Badge Data
It is the data which appear at the botton right of the tile , right of Live Data.It is a simple interger, typically a count of item.
First we need to enable the badge area (whether the user want the badge area to be displayed).This can be done using delivered method as well as property.
Methods
- setTileHasCount(badge_display – Y/N)
Y – Badge area is enabled.
N – Badge area is disabled.
- We invoke this method in ‘getTileLiveData’ to override whether the badge area should enabled or not. We can enable it using hasLiveDataCount property also. After the badge area is enabled , the badge data needs to be set through TileTransCount Property.
%This.setTileHasCount(“Y”); /* Enables the badge area. */
%This.TileTransCount = MY_REC.COUNT;
Properties
- hasLiveDataCount – Use the hasLiveDataCount property to set or return a Boolean value indicating whether the badge area is enabled.
%This.hasLiveDataCount = True; /* Enables the badge area. */
%This.TileTransCount = MY_REC.COUNT;
- TileTransCount –this property is used to set the badge data when the badge area is enabled.
PeopleCode setting Live Data for Dynamic tile.
Dynamic tile with Male/Female percentage as Live Data.
Creating a tile definition in Tile Wizard
Navigation : Navigator – > PeopleTools – > Portal – > Tile Wizard
Step 1: Give the tile Name and its Title and click on Next.
Tile Wizard – Basic Information.
Step 2: Specify the Data Source for the Tile Wizard .Select the Application Package , Sub-package and Class in this step. We also specify the tile content (chart , chart&KPI, 1KPI etc.) along with whether the tile has Live Data and Badge or not.
- Root Package ID – Select a custom application package that includes the class that implements the PTGP_APPCLASS_TILE:Tiles:Tile base class and one of its required SetTileContentAs methods.
- Qualified Package/Class Path -Select the package name or package path to the implemented class.
- Application Class ID – Select the class that implements the required getTileLiveData method.
Tile Wizard – Selecting Data Source.
Tile Wizard – Select Tile Content Options.
Step 3: Specify the Content Reference which you want see when the tile is tapped. Choose it through the prompt given beside the field. Give the Owner Id and Parent folder being mandatory.
You can provide security to the tile of who can access and who can not by selecting the required Permission & Role for the tile.
Tile Wizard – Selecting Target Page information and adding security.
Step 4: Specify the width and height of the tile which could be (1:1, 1:2, 2:1, 2:2). An image for it which could be overided through PeopleCode. This width and height of the tile is datatype dependent.
- Image – Select an image (in SVG format only) from the database to display a custom static image as the fluid content. Otherwise the default image is displayed.
- Tile Refresh Timer (Seconds) -Enter the time in seconds to set an automatic refresh period for dynamic content on a tile. When the timer limit has been reached, the system re-draws the tile so that it displays the current data, such as in the case with chart.
Note: If any Event Name is selected this field is disabled. Also the system enforces a 10 second minimum limit. Any value entered less than 10 seconds is ignored and is treated as 10 seconds.
The default value of 0 disables any automatic refresh.
- Disable Main Hotspot – Select this option to ‘Yes’ to disable displaying the target content defined for the tile when the tile is tapped. However, any links displayed dynamically (dynamic data /content) within the tile are not disabled.
- Display In – Control how the content appears once a user taps n the tile.
- Cur Window – target content opens up in current window.
- Modal – target content opens up in model window. We get extra Modal Parameter to specify on select this option.
- NavBar – target content appears in NavBar only when the tile is added in NavBar else it will open in the current window.
- New Window – target content opens up in a new window.
- Interactive – Select this option to display the fluid content as interactive, which allows users to enter data or click buttons within the fluid content.
It is disabled for Pivot grid tiles and OBIEEE tiles.
Tile Wizard – Setting Tile Display Properties.
Step 5: Review all the settings given for the tile in the last step and Publish the Tile Wizard.
Tile Wizard – Review the settings.
After saving the Tile Wizard, it can added to any Homepage from Structure and Content Fluid HomePages Manager Self Service Tile Content , selecting the tile from the folder it was saved in.
Author: Megha Singh, PeopleSoft Consultant