PeopleTools 8.55, Tile Wizard, FluidOne of the exciting new features of PT 8.55 is the new tile wizard. This wizard lets an end user Create and Publish Fluid tiles using the Fluid front-end. Different types of tiles that can be created using this wizard are as follows:

  • Application Class (based on your own PeopleCode class)
  • Free Text (plain text, html/java script (embedding web content))
  • Navigation Collection
  • OBIEE (Oracle Business Report)
  • Pivot Grid

We shall go through the entire process starting with  the creation of a Tile, publishing it and as an end-user set the tile on a fluid homepage. For the purpose of this demo we will create a Free Text tile where we embed a YouTube movie. This can be useful for tutorial or instruction like purposes.

Creating a fluid tile

The first step is to access the tile wizard using the new navigator or with the Class Menu path: Home > PeopleTools > Portal > Tile Wizard

PeopleTools 8.55, Tile Wizard, Fluid

The first screen seen here is the overview of the tiles that have been created. Options to Edit (continue with previously created and saved tile), delete and Create New Tiles can be selected.

PeopleTools 8.55, Tile Wizard, Fluid

Because we are creating a new tile click on the Create a new Tile button. This actually starts the 5 step Tile Wizard.

PeopleTools 8.55, Tile Wizard, Fluid

This is what the wizard page design looks like. Wizard page design looks as shown below.  We shall now follow each step as explained below.

PeopleTools 8.55, Tile Wizard, Fluid

Step 1 – Tile Basic Information

PeopleTools 8.55, Tile Wizard, Fluid

In this step Name and Tile informtion is entered. The Tile Name will be displayed on the tile overview, so it’s purely for internal use. Make sure you fill it in, because it is a mandatory field to continue with the next step in the wizard. The Title will be displayed on the tile itself. Choose a suitable name. Please enter Embed as Title for this tutorial.

Note:  When you fill in a name you can’t change it afterwards. You actually need to restart the wizard.

PeopleTools 8.55, Tile Wizard, Fluid

Click on Next to continue to the following step.

Step 2 – Data Source Information

PeopleTools 8.55, Tile Wizard, Fluid

At step 2 new navigational options for Previous and Save buttons are available.

PeopleTools 8.55, Tile Wizard, Fluid

With the previous button you’ll go back to the previous step. With the save button you are able to save the progress in the wizard and continue later on.

Note: Keep in mind that saving is different then publishing.

In this step tile type is chosen. As seen in the drop down list, all the options explained earlier are available.

PeopleTools 8.55, Tile Wizard, Fluid

Select the option Free Text. A new text field with the name Free Text will appear.

PeopleTools 8.55, Tile Wizard, Fluid

You have different options here. When you just enter plain text, this text will appear in the tile. You can also choose to enter HTML/JavaScript so you can display markup text or dynamic web content. For our embed tile we enter the embed code from a YouTube movie. Example embedding code (Oracle fluid concept):

<iframe width="560" height="315" src="https://www.youtube.com/embed/o5-wQ2dHKsw" frameborder="0" allowfullscreen></iframe>

PeopleTools 8.55, Tile Wizard, Fluid

Click on Next to continue to the following step.

Step 3 – Target Page Information

PeopleTools 8.55, Tile Wizard, Fluid

In this step, content reference(page in Peoplesoft) is selected for the tile created. Clicking on the magnifier, we can search through all the available content references.

PeopleTools 8.55, Tile Wizard, Fluid

Although we are not referencing the content in PeopleSoft (but to an external website), we still are need to fill in the content reference. For now, choose one. In step 4 we can disable the actual link to the content reference.

The other options have the values from the chosen content reference. These options are set by the content reference itself. For this demo, we would leave these options as default.

PeopleTools 8.55, Tile Wizard, Fluid

Click on Next to continue to the following step.

Step 4 – Tile Display Properties

PeopleTools 8.55, Tile Wizard, Fluid

This step let’s you choose the display options for your tile.

PeopleTools 8.55, Tile Wizard, Fluid

I’ve highlighted the mostly used options:

  • Tile Height and Tile Width; tile size can be set here. Tiles have a default size of 1 x 1 with a maximum of 8 x 8.
  • Image; display a static image to appear on your tile. Images from the database can be chosen.
  • Disable main hotspot; if you link to a content reference in step 3 you can overrule this option by setting this to Yes.
  • Display In; choose how the link to a content reference is displayed for the end-user. By default this is current window.
  • Interactive; select Yes if dynamic content like embedded HTML needs to be displayed. Or end user can resize the tile.
  • Tile autosize and resizable; the created tile will automatically resize to the screen or you can let the end-user resize the tile.

For our embed tile we choose the following options:

PeopleTools 8.55, Tile Wizard, Fluid

By default under Tile Repository the options are set to Yes.

PeopleTools 8.55, Tile Wizard, Fluid

These options gives you gives the possibilty where the tile can be chosen by the end user.

  • Homepage; on the default homepage from the end-user.
  • NavBar; on the fluid navigation bar.
  • Dashboard; if your end-users have the possibility to create their own dashboards they can add this tile to their own created dashboard.

For this demo we leave the options to Yes.

Click on Next to continue to the following step.

Step 5 – Review and Submit

PeopleTools 8.55, Tile Wizard, Fluid

This is the final step where summary of the options chosen in the previous steps is displayed.

PeopleTools 8.55, Tile Wizard, Fluid

Observe that the Save button from step 2 – step 4 is not available now and a new button Publish is available. If the tile is not yet ready to be published, go back to step 4 and click the Save button

PeopleTools 8.55, Tile Wizard, Fluid

When you click on Publish the tile is saved and published meaning that an end-user is able to select your created tile. After clicking this button you will return to the tile overview screen. We will publish this tile now.

Set the fluid tile on your homepage

Last step is to Edit the home page and add the newly created tile. On the fluid homepage click on the change homepage icon and choose Personalize Homepage.

PeopleTools 8.55, Tile Wizard, Fluid

Overview of home page with tiles chosen earlier is displayed here.

PeopleTools 8.55, Tile Wizard, Fluid

Click on Add Tile

PeopleTools 8.55, Tile Wizard, Fluid

In step 3, Owner ID and Parent had the default values. This means that when you search for your created tile you look under PeopleSoft Applications. Select your tile.

PeopleTools 8.55, Tile Wizard, Fluid

This would return back to the home page overview where newly added tile can be seen now.

PeopleTools 8.55, Tile Wizard, Fluid

Here, chosen tiles can be either be rearranged by drag & drop or it can be deleted too.

PeopleTools 8.55, Tile Wizard, Fluid

Now, arrange the tile as desired and hit Save. Tile can be seen on the home page and Youtube content can be played too.

PeopleTools 8.55, Tile Wizard, Fluid

If you want to fit the YouTube movie perfectly in a chosen tile dimension you need to change the width and height values in the embed code.

Bonus – creating a navigation collection fluid tile

Using the tile wizard you can simply publish an existing navigation collection as a tile. When end-users click on such a tile you will automatically go to the new navigation collection fluid screen.

Note: Keep in mind that you can only publish a navigation collection using the tile wizard.
You still need to create or change a standard navigation collection.

How to set this up?

In Step 2 choose Navigation Collection as the Data Type and use the prompt to browse for a navigation collection. You can choose different views for the navigation collection to appear after clicking on the tile using The Navigation Collection Type dropdown list.

  • Navigation Collection Optimized > Display as an non sequential activity guide like bar. An extra option appears to choose if you want to let the user collapse the navigation collection.
  • Navigation bar > Display directly on the fluid NavBar

Set it to Navigation Collection Optimized.

PeopleTools 8.55, Tile Wizard, Fluid

Leave step 3 with default values

PeopleTools 8.55, Tile Wizard, Fluid

You can’t change values from step 4 except the image you want to display on the tile

PeopleTools 8.55, Tile Wizard, Fluid

Publish and add to your homepage.

PeopleTools 8.55, Tile Wizard, Fluid

When clicking on the tile you link to the navigation collection.

PeopleTools 8.55, Tile Wizard, Fluid

 

Share on social media
Showing 18 comments
  • Colin

    Works fine while building but when you deploy to the user base who don’t and will never have the Role Portal Administrator there’s a bug in 8.55 that means the weblib_pgtplt access required does not build so users get an error instead

  • Samantha

    This is GREAT! I created both a tile and a nav collection. I see Colin talks of a bug in 8.55. We are moving to 8.55 2/16/2017, I am hoping this bug was addressed by now!

  • Ankur jain

    I have created tile with navigation collection but i don’t know how to migrate it to another instance. I tried to add all content reference of tile and nav coll to my application designer’s project and migrated it. When i checked target environment content reference was there where i have registered tile even it was visible on homepage as well in target instance but when i clicked on tile on homepage then it shows blank.

    Navigation collection links were not appearing to me.

  • Ganapathy

    Hello Sir, Really nice one it is.
    And I’ve doubt on external link in tiles which I’ve created. I’ve enabled the new window option. But When I’ve tried with small and medium form factor(for mobile device) , the external link is opening outside of the mobile window. Can you guide me on this.

    • Elmer Mackor
      Elmer Mackor

      Hi Ganapathy,

      The opening of the links actually depends on how your device or browser interprets the new_window option. How did you test this? On a real mobile device or using a desktop browser and simulate a mobile device? The default option for most desktop browsers by default is to open a new_window in a new tab. If you simulate a mobile device on Chrome it will actually open the link in a new tab but without the mobile device view. What happens if you setup the link in the tile to open in a current window, do you still have the same issue?

  • Nathan Donovan

    Hi Elmer, i’m wondering if you’ve encountered this problem.
    We’re on 8.55.08 and have successfully enabled fluid using page tiles as well as nav collection tiles.
    When we went to migrate all of our objects to our next Dev instance, we found that none of the tiles we migrated were coming up in the tile wizard list in our target instance. Did we miss something? Normally in App Designer, we just grab the definitions out of portal registry structure (and include all child objects), and compare before and after the move.

    With Fluid tiles, is there a secondary table somewhere that contains other information about the tiles that also has to get migrated? I can’t seem to find anything helpful in Oracle’s documentation about this.

    Thanks,
    Nate

    • Elmer Mackor
      Elmer Mackor

      Hi Nate,

      Yes I have. You need to use the data migration workbench for this. PTPPB_GROUPLET is the delivered dataset for the pagelet wizard tiles.

      Navigation : Peopletools -> Lifecycle Tools -> Migrate Data -> Data Migration WorkBench

  • Hannah Baker

    Hi Elmer,

    About Colin’s issue above, do you have any idea regarding that? Why non-power users (without psoft user/admin) are unauthorized to access the tile with nav collection?

    • Elmer Mackor
      Elmer Mackor

      Hi Hannah,

      This is indeed a bug in PT8.55 (Doc ID 2158993.1 on Oracle support) that will be solved in PT8.56. There are two workarounds:

      – Give the users the portal administrator role OR
      – Change a line of code in the PTPPB_GROUPLET application package, see below:

      Launch App Designer
      1) Open Application Package: PTPPB_GROUPLET
      2) Open the Application Class within: Grouplet (at the top)
      3) Look for property method: “get Authorized”
      4) You will see within it this code:

      If IsUserInRole(“Portal Administrator”, “PeopleSoft Administrator”) Then
      Return True;
      End-If;

      5) Change the If Condition PeopleCode to add a Role that your users will have access to. For example, if your users will have Role “EmployeeRole”, then change the code to:

      If IsUserInRole(“Portal Administrator”, “PeopleSoft Administrator”, “EmployeeRole”) Then
      Return True;
      End-If;

      6) Save changes, re-test online

  • Shantanu

    Hi,

    Not able to copy project from file post creating project in “Data Migration WorkBench”.

    I have added one tile and took copy to file, then same project is not showing any option in copy project from file.

  • Marie Burbach

    Hello Elmer,

    This is a wonderful article that provides a lot of helpful information. I thank you for taking the time to share it with us all. As you’re most likely aware, PT 8.55 no longer allows pagelet processing. What would your suggestion be for converting a pagelet that ran a PSQUERY using a few system variables for inputs and resulted in a grid that displayed on the main page? PivotGrid won’t work due to the variables. I was thinking an app class, but am running into some issues. Have you heard of anything attempting to display a grid on a tile? Any assistance/knowledge/references you could provide would be absolutely amazing. I’ve been searching and haven’t been able to find any instances of this being done as of yet.

    Thanks,
    Marie

    • Elmer Mackor
      Elmer Mackor

      Hi Marie,

      Actually we’re having the same question and we haven’t seen any other example yet. The workaround for now would be to link a tile to a workcenter or homepage but then you won’t have the nice fluid design. This is one of the things we’re going to look into the coming months so stay tuned for an update about this.

  • Baahubali

    Good Post,

    Can you also please tell us how to remove a page from a tile?
    Ex: I want to remove “DISABILITY” page form Personal Details tile on ESS.

    Thanks.

  • Joanne Smart

    We are on PeopleTools 8.55.13.
    Is it possible to have a tile point to a navigation collection of just external links?
    I know you can have a tile go to 1 external link, but we would like it to go to a grouping of external links.

  • Phil Wilkinson

    Interestingly, if you make a navigation tile collapsible as you describe above, it appears to disable the fluid auto-collapse when the browser size shrinks. Not sure it that’s expected behaviour or not.

  • Kimberley OConnor

    Hello Elmer,

    I have created a Navigation collection and I created the corresponding Tile. The problem I am having is that some of the Folders and pages I have in my Navigation collection are not displaying when my user clicks on the Tile. I have checked security, I have run the Navigation Collection Sync, Portal sync and it doesn’t matter the stuff will not appear.

Leave a Comment