Project Guide XML document elements

The Gbui.xml document is broken into many elements, each with a corresponding design and function within the Project Guide. Some elements invoke an action, such as navigating to an HTML page, while others define the Project Guide's organization and layout (see Figure 25-26). The elements of Gbui.xml are described as follows:

Eile Edit Fflrmat iffew Help

fi?xm1 ver s i on= ' "1. Û " encodi rig=" ' UTF -8 " ?>

<GBUISt ruct ur e>

<vi exchanges> <Vi ewcfiange>

<viev*fType> 0 </v1ewType> <GoalArealD> 1 </GoalArealD> </ylewchange> <vi ev*change>

<vieWType> 1 </ViewType> <GoalAreaiD> 2 </GoaiArearD> </vi e*change> <A1 exchanges >

<Pagechanges> <pageenange>

<ProjectserverPagelE» 1 </Projectserver Page!D> <TasRlD> 19 </TasRl0> </Pagechange>

<ProiectserverPaqelD> 2 </ProjectServerPagelD> <TasklD> 9 </TasilD> </Pagechange>

<ProjectServerPagelD> 3 </ProjectserverPagelD> <TasRlD> 22 </TasklO> </Pagechange>

<ProjectServerPagelD> 4 </ProjectserverPagelD> <TasRlD> 28 <AaskI0> </Pagechange>

<ProiectserverPagelD> 5 </ProjectServerPagelD> <GoalArealD> 2 </GoalAreaiD> </Pagechange>

<ProjectServerPagelD> 6 </ProjectserverPage!D> <GoalAreaiD> 4 </GoalAreaio>


!<l IIU >

Figure 25-26: The Gbui.xml file is comprised of many elements.

Figure 25-26: The Gbui.xml file is comprised of many elements.

♦ ViewChanges: This element defines how the Project Guide should respond as the user changes views in Project. Because the users can switch to a different Project view at any time, the content of the side pane must change in tandem with the Project view so that it is relevant to the view that the user has displayed. For example, if a user is working with the Gantt Chart view, the side pane may show steps that are related to creating task dependencies. If the user changes the view to the Resource Sheet view, the side pane content would need to be refreshed to be applicable to the new view.

♦ PageChanges: This element defines how the Project Guide should respond when the user displays Project Web Access pages within Project. For example, the PageChanges element responds whenever a user displays Project Web Access-based content, such as risks, issues, and documents, from within Project Professional.

♦ GoalArea: Each GoalArea element (see Figure 25-27) defines the Project Guide side panes that are displayed for the tasks or activities in that goal area and creates an entry in the Project Guide toolbar. The default Project Guide includes the GoalAreas as Tasks, Resources, Track, and Report. Each GoalArea element is made up of a GoalAreaID, GoalAreaName, GoalAreaDescription , URL, and RelevantViews. When a user selects a goal area in the Project Guide toolbar, a corresponding HTML page appears in the side pane that displays the steps that are associated to that GoalArea. A GoalArea element consists of the following items:

• GoalAreaID: This is a unique identifier for the goal area.

• GoalAreaName: This is the name of the goal area that is shown on the toolbar, such as Tasks.

• GoalAreaDescription: This text is displayed at the beginning of a goal area side pane.

• URL: This is the reference to the HTML page that is associated with the goal area. When the user clicks a goal area in the Project Guide command bar, the corresponding HTML page is displayed in the side pane. By default, this page displays the list of the tasks within the goal area that are defined in the Gbui.xml document GoalAreaTasks.

• RelevantViews: This element is used to define the views that are relevant to a particular goal area. If the user switches to a view that is not relevant, the ViewChanges element responds and switches the goal area or side pane. This ensures that the content in the side pane is always relevant to the view.

• GoalAreaTask: This element corresponds to an individual Project Guide side pane task. Each GoalArea element can contain one or more GoalAreaTask elements, corresponding to all the tasks within that goal area.

The GoalAreaTask element (refer to Figure 25-27) consists of the following items:

♦ TaskID: This is a unique identifier.

♦ Title: This is displayed in the header area at the top of each Project Guide side pane.

♦ TaskName: This displays in its associated goal area's side pane.

GoalAreaTask RelevantViews URL

GoalAreaDescription GoalAreaName GoalAreaID

TaskID Title TaskName URL


Format View Hetp

L<GoalAreaID> 1 </GaalAreaID>

-<GoalAreaName> Tasks </GoalAreaName>

-<GoalAreaDescr1pt1on>Plan and! schedule your proje

—<url> gbul ://tasks,jiia1n. hxm </url>


<ViewType> 0 </Vie*Type> </Relevant vi aws>

sks Py clicking an Item below. c!1ck1


<T"itle> Define the Project </Title>-

<TaskName> Define the project </TaskName> —

<url> gbui://def1ne_project. htm </url>-


<viewType> -1 </vie*Type> </Relevantviews>


<Tltle> project working Times <A1tle>

<TaskName> Define general vorklng tines </TaskNa<ne>

<ijrl> gbui ://prqject_calendar, htm </url>

<viewType> -1 </vi e*iType> </Relevantviews?

<Goa1At eaTas k>

<TaskiD> 3 -</TaskrD> <Title> List Tasks <A1tle>

<TaskName> the tasks In the project</TaskNania> <URL> gbui://create_tasks_list.htm </URL>

<HelpName> More information </HelpName> <url> gbui://create_casks_l 1sT_hlp.htm </url> </TaskHelp> •<RelatedTask>

-<TaskiD> 6 </TaskiD> </Re1atedTask> •■¡Rel at ad Act i vi ty>

<ActiirityName> Create a Recurring Task ... </Act"wityName> <VBACOinmafid> Recurr1ngTaskmsert*</VBiAiZertriiarid> </Relat edAct 1 v1ty> <Re1evantviews>

<View5creen> 1 </Vi ewScreen> <viewScreen> 2 </viewscreen> -<v1ewsc^een> 5 </v1ewscreeri> -<View5creen:> 14 </v1ewScreen>

RelatedActivity RelatedTask TaskHelp

Figure 25-27: The GoalArea element defines the tasks that appear in the Project Guide side panes.

♦ URL: This is the reference to the HTML page for GoalAreaTasks. Each GoalAreaTask has an HTML page that contains the content that appears in the side pane for that task.

♦ TaskHelp: This is additional Help content for a GoalAreaTask. Project Guide side panes can offer help that can appear as a Help link at the bottom of the side pane. If you include TaskHelp, you must specify a HelpName that contains the URL of the custom help HTML page.

♦ RelatedTask: This element references other GoalAreaTasks that may be related to the GoalAreaTask. RelatedTasks are displayed in the Next Steps and Related Activities menu.

♦ RelatedActivity: This element references related activities that are not defined GoalAreaTasks in the Project Guide but that correspond to VBA methods that are available in Project. The purpose of this element is to provide access to any needed functionality from within Project, including custom VBA sub procedures that you have written. The RelatedActivity element consists of the following items:

• ActivityName: This displays the activity in the Next Steps and Related Activities menu.

• VBAMethod: This is the name of the Project Object Model method that should be executed for this activity.

Project Management Made Easy

Project Management Made Easy

What you need to know about… Project Management Made Easy! Project management consists of more than just a large building project and can encompass small projects as well. No matter what the size of your project, you need to have some sort of project management. How you manage your project has everything to do with its outcome.

Get My Free Ebook

Post a comment