Portlet Factory, Version 6.1.2

 

Using the advanced technique for locating builders

The Advanced page location technique allows you to create complex page location strings to locate control builder calls on multiple pages in multiple ways. You can use the Advanced technique after using the On Tag or Relative to Named Tag techniques to build up a page location expression and then build on that expression using the Advanced technique.

The following page location examples are meant to show the flexibility of the page location syntax:

  • Page StartingPage NameSearch firstBuilder

    The firstBuilder tag on the StartingPage page.

  • AllPages NameSearch firstBuilder

    All locations named firstBuilder on all (non-generated) Pages

  • Page StartingPage NameSearch firstBuilder else XPath HTML/BODY InsertInsideBottom firstBuilder

    In StartingPage, search for an element named firstBuilder. If it is found, that is the node. If not found, search for the XPath "HTML/BODY" and use InsertInsideBottom to insert a new node and name it firstBuilder.

  • (Page StartingPage NameSearch theBody else XPath HTML/BODY) InsertInsideBottom firstBuilder

    In StartingPage, search for an element named theBody. If it is not found, search for the XPath "HTML/BODY." In either case, use InsertInsideBottom to insert a new node and name it "firstBuilder."

  • AllPages XPath HTML/BODY InsertInsideBottom Foo

    In all pages, just inside the BODY tag insert a new node at the bottom and name it Foo

  • (Pages where (Public = true), Page Extra) XPath HTML//FORM InsertInsideTop Header

    In all public pages and in Page named Extra, use XPath to search for a FORM tag, then insert a new node inside it at the top. Name the new node Header.

  • ((Page A, Page B) NameSearch OKButton, Page C NameSearch OK) TableWrapRight Cancel

    At the three elements named (the element named OKButton on Pages A and B, and the element named OK on Page C), create a new element to the right, and name it Cancel.

  • PagesWhere (true & TopLevel = true) NameSearch AdvancedButton

    For all pages with the property TopLevel set to true, search for a node with the name "AdvancedButton."

  • PagesWhere (TopLevel = true | AddAdvanced = true) NameSearch AdvancedButton

    For all pages with the property TopLevel set to true, or the property AddAdvanced set to true, search for a node with the name AdvancedButton.

Parent topic: Locating control builder calls on pages

Library | Support |