<NavBarItem> (FormXml)

Article
11/28/2016

Applies To: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online

Specifies a navigation item to display in a form. Use this element when the navigation item is not associated with an entity relationship.

Syntax

<NavBarItem
  Area = ["Details" | "Info" | "Sales" | "Service" | "Marketing" | "InternetMarketing" | "Processes"]
  AvailableOffline=["0" | "1" | "true" | "false"]
  Client= ["Web" | "Outlook"]
  Icon="String"
  Id="String"
  PassParams="Unsigned Byte"
  Sequence="Non Negative Integer"
  Url="String" >
  <Titles />
 </NavBarItem>

Attributes and Elements

The following describes the attributes, child elements, and parent elements.

Attributes

Attribute	Description	Type	Usage
Area	Specifies which area to include the element. See Remarks.	String	Optional
AvailableOffline	Specifies whether the item should be displayed while the user is not connected to the server. The default is ‘true’.	Boolean	Optional
Client	Specifies the intended client for the control. Valid Values: Web Outlook	String	Optional
Icon	Specifies the image Web Resource to be displayed. The icon should be 16x16 pixels.	String	Required
Id	A unique id for the item.	String	Required
PassParams	Valid Values: 0 = do not pass parameters [default] 1 = pass parameters	Unsigned Byte (FormCRM_Boolean)	Optional
Sequence	Indicates the order to display the item relative to other items.	Non Negative Integer	Optional
Url	Specifies the URL or Web Resource to display.	String	Optional

Child Elements

Element	Description
<Titles> (FormXml)	Contains definitions of Title elements.

Parent Elements

Element	Description
<NavBar> (FormXml)	Represents a container for items added to the navigation pane in a detail form window.

Remarks

For each entity there is an Area attribute on the navigation area. This corresponds to the expandable areas in the navigation pane on a form. You can add a new NavBarItem to each area described here.

The possible values are shown in the following table.

Area value	Description
“Info” or “Details”	The item is added under Common. This is the default.
Sales	The item is added under Sales.
Service	The item is added under Service.
Marketing	The item is added under Marketing.
InternetMarketing	The item is added under Internet Marketing.
Processes	The item is added under Processes.

Element Information

Schema Type	complexType
Validation File	FormXml.xsd
Number of Occurrences	0 to 100000
XPath	`//FormXml/forms/systemform/form/Navigation/NavBar/NavBarItem`