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.
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:
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.
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.
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.
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.
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.
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.
Syntax
Syntax
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.
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
%This.hasLiveDataDescr= “True”;
%This.setTileLiveData(“Y”); /* Enables the Live Data Area */
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.
Y – Badge area is enabled.
N – Badge area is disabled.
%This.setTileHasCount(“Y”); /* Enables the badge area. */
%This.TileTransCount = MY_REC.COUNT;
%This.hasLiveDataCount = True; /* Enables the badge area. */
%This.TileTransCount = MY_REC.COUNT;
PeopleCode setting Live Data for Dynamic tile.
Dynamic tile with Male/Female percentage as Live Data.
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.
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.
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.
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
