<section> (FormXml)

Article
11/28/2016

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

Specifies a section within a form.

Syntax

<section
 addedby="String"
 availableforphone=["0" | "1" | "true" | "false"]
 celllabelalignment=["Center"|"Left"|"Right"]
 celllabelposition=["Top"|"Left"]
 columns="Non Negative Integer"
 group="String"
 height="String"
 id="String"
 IsUserDefined="String"
 labelid="String"
 labelwidth="Non Negative Integer"
 layout="String"
 locklevel="Non Negative Integer"
 name="String"
 showbar=["0" | "1" | "true" | "false"]
 showlabel=["0" | "1" | "true" | "false"]
 visible=["0" | "1" | "true" | "false"]>
 <labels />
 <rows />
</section>

Attributes and Elements

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

Attributes

Attribute	Description	Type	Usage
addedby	Identifies the name of the ISV or customizer that added the element.	String	Optional
availableforphone	Whether the element is available for Dynamics 365 for Phones client.	Boolean	Optional
celllabelalignment	Specifies label alignment. Valid Values: Center Left Right	Enumeration	Optional
celllabelposition	Specifies label position. Valid Values: Top Left	Enumeration	Optional
columns	For internal use only.	Non Negative Integer	Optional
group	For internal use only.	String	Optional
height	Contols the height of the section. Set the value to "auto" to make the section expand to fill all the available space.	String	Optional
id	Unique ID for the section. See Remarks.	String (FormGuidType)	Required
IsUserDefined	"1" indicates a custom section. "0" indicates a default section.	String	Optional
labelid	A unique id value for the section label. See Remarks.	String (FormGuidType)	Optional
labelwidth	Defines the horizontal space for a section label in pixels. The default is 110 pixels.	Non Negative Integer	Optional
layout	Defines the section layout property, either variable field width (varwidth) or fixed field width (varheight). The default is varwidth.	String	Optional
locklevel	Prevents the section from being deleted from the form or having its properties modified. This attribute cannot be set in the UI. Valid values: 0 = Do not lock 1= Locked	Non Negative Integer	Optional
name	The name of the section displayed in the section properties.	String	Optional
showbar	Indicates whether to show divider line below the section name. The divider line will only display when the showlabel attribute value is also true.	Boolean	Optional
showlabel	Show the name of this section on the form.	Boolean	Optional
visible	Specifies whether the section is displayed by default.	Boolean	Optional

Child Elements

Element	Description
<labels> (FormXml)	Contains form label definitions.
<rows> (FormXml)	Specifies rows used to compose form layout.

Parent Elements

Element	Description
<sections> (FormXml)	Contains the definitions of sections used in the form layout.

Remarks

If you create a new <tab> (FormXml), <section> (FormXML) or <cell> (FormXml) element by copying from an existing form definition or by manually editing an exported customization.xml file you should create a new GUID value for the id attribute. You should use a tool like guidgen.exe to guarantee a unique valid GUID value. The guidgen.exe is included as part of the Windows SDK.

If you do not specify a new GUID value for the element id, you must create a new GUID value for the labelid attribute and add the labelid attribute. If you have duplicate element id values AND do not specify a unique labelid attribute value you will not be able to uninstall your solution. To address this issue you must export the default solution containing the form definitions, edit each element in the existing forms to add a unique labelid value, and then import those modified form definitions.

Element Information

Schema Type	complexType
Validation File	FormXml.xsd
Number of Occurrences	0 or more
XPath	`//FormXml/forms/systemform/form/tabs/tab/columns/column/Sections/section`