<cell> (FormXml)
Applies To: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online
A form layout element. A cell contains the labels and the control to display.
Syntax
<cell
addedby="String"
availableforphone=["0" | "1" | "true" | "false"]
auto=["0" | "1" | "true" | "false"]
colspan=Integer
id="String"
ischartcell=["0" | "1" | "true" | "false"]
ispreviewcell=["0" | "1" | "true" | "false"]
isstreamcell=["0" | "1" | "true" | "false"]
istilecell=["0" | "1" | "true" | "false"]
labelid="String"
locklevel=Integer
rowspan=Integer
showlabel=["0" | "1" | "true" | "false"]
userspacer=["0" | "1" | "true" | "false"]
visible=["0" | "1" | "true" | "false"]
<control />
<events />
<labels />
</cell>
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 |
Specifies whether the element is available for Microsoft Dynamics 365 for phones. |
Boolean |
Optional |
auto |
Not used. |
Boolean |
Optional |
colspan |
Represents the number of columns used in the row to display the field. |
Nonnegative Integer |
Optional |
id |
Unique identifier for the cell. See Remarks. |
String (FormGuidType) |
Required |
ischartcell |
For internal use only. |
Boolean |
Optional |
ispreviewcell |
Used by the dashboard designer to indicate cells in which a user can insert different components. See Remarks. |
Boolean |
Optional |
isstreamcell |
For internal use only. |
Boolean |
Optional |
istilecell |
For internal use only. |
Boolean |
Optional |
labelid |
A unique id value for the cell label. |
String (FormGuidType) |
Optional |
locklevel |
Matches the field formatting property Lock the field on the form. |
Non Negative Integer |
Optional |
rowspan |
Represents the number of rows used to display the field in the form. |
Non Negative Integer |
Optional |
showlabel |
Determines whether to display the label for the field. |
Boolean |
Optional |
userspacer |
Specifies that the cell contains a spacer. |
Boolean |
Optional |
visible |
Determines whether the cell is visible on the form by default. |
Boolean |
Optional |
Child Elements
Element |
Description |
|---|---|
Contains form label definitions. |
|
Specifies the control to display within a form cell. |
|
Contains all the event definitions for a cell or form. |
Parent Elements
Element |
Description |
|---|---|
Specifies a row used to organize form elements. |
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.
The auto attribute is not used. If you want the control in the cell to expand to use all the available space, set the height attribute of the parent row element to auto.
If the rowspan is greater than 1, the number of row elements within the rows element must be equal to or greater than the value of the rowspan attribute.
The ispreviewcell attribute can be used to define dashboard templates. This attribute is not valid for forms.
Element Information
Schema Type |
complexType |
Validation File |
FormXml.xsd |
Number of Occurrences |
0 or more |
XPath |
|
See Also
Customize entity forms
Form XML reference
Microsoft Dynamics 365
© 2016 Microsoft. All rights reserved. Copyright