The GridComponents component provides a section of the homepage that can mimic the output of the “My Dashboard” SAXT page. By copying the XML format of widgets created in dashboard.aspx, those widgets can be displayed on the SAXT homepage for all users to view and use as a Team Dashboard.
The following code section shows some examples of XML used inside the GridComponents component for all different types of widget output including Report, Link, Diagram, and Pivot chart.
<component header="All Analytics" type="Pivot" width="4" height="4" x="" y="" savedconfigstr="" target="1" selectFields="" whereFields="" runAcrossWS="" workspaces="" restrictToRecsInWS=""><report>SELECT "Name", "Type", "Audit" WHERE Class = "Definition" WHERE "Type Number" = "798" ORDERBY "Name"</report></component>
</component>
. . .
</page>
</pages>
Each widget component inside the GridComponents element has its own specific set of properties. To guarantee a working configuration, the suggested method is to open the My Dashboards page (dashboard.aspx), and go through the process of adding the widget to a tab, configuring it the way it is expected to look on the Home Page. When configured, click the dropdown next to the open Dashboard tab name, and then click View Widget XML. This will give you a list of all the widgets on the tab, and its corresponding XML that can be copied and pasted into the GridComponents section of the page file. You can then delete the widget or tab from the dashboard.aspx page if you do not need it.
Changing location of GridComponents widgets
Each widget component inside GridComponents uses four properties to determine where it will be drawn on the homepage: width, height, x, and y.
Regardless of how large the GridComponents page section actually is, the section as a whole is considered 12 squares wide. This allows for the widgets to be scalable regardless of web browser size. To arrange the widgets, it might help to imagine a graph sheet with 12 squares wide. A default widget is width="4", height="4", which will fit three widgets across the 12 square field. For a half page, use "6" and for a full page, use "12", and so on.
When it is decided how large widgets should be, if you set x="" and y="" then the widgets will be filled into the space automatically, in the order they are in the page file. To specify exactly where widgets should be, set the x and y values based on how they would fit on the 12 square wide grid taking into consideration other widgets height and widths. Consider the following example:
Widget 1: width="4" height="4" x="0" y="0"
Widget 2: width="8" height="4" x="4" y="0"
Widget 3: width="6" height="2" x="0 y=4"
Widget 4: width="6" height="2" x="6" y="4"
This draws two rows of widgets, the first row is four squares high, the left widget is 33% wide, the right widget is 66% wide. The second row is two squares high, and each widget is 50% wide.