Partager via


<cell> (FormXml)

S'applique à: CRM 2015 on-prem, CRM Online

Élément de disposition de formulaire. Une cellule contient les étiquettes et le contrôle à afficher.

Syntaxe

<cell
 addedby="String"
 auto=["0" | "1" | "true" | "false"]
 colspan=Integer
 id="String"
 ispreviewcell=["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>

Attributs et éléments

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

Attributs

Attribute Description Type Usage

addedby

Identifies the name of the ISV or customizer that added the element.

String

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

ispreviewcell

Used by the dashboard designer to indicate cells in which a user can insert different components.

See Remarks.

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

Éléments enfants

Element Description

<labels> (FormXml)

Contient les définitions de libellé de formulaire.

<control> (FormXml)

Spécifie le contrôle à afficher dans une cellule de formulaire.

<events> (FormXml)

Contient toutes les définitions d'événement pour une cellule ou un formulaire.

Éléments parents

Element Description

<row> (FormXml)

Spécifie une ligne utilisée pour organiser les éléments du formulaire.

Remarques

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.

Informations sur l'élément

Schema Type

complexType

Validation File

FormXml.xsd

Number of Occurrences

0 or more

XPath

//FormXml/forms/systemform/form/tabs/tab/columns/column/sections/section/rows/row/cell |
//FormXml/forms/systemform/form/header/rows/row/cell|
//FormXml/forms/systemform/form/footer/rows/row/cell

Voir aussi

Concepts

Personnaliser les formulaires d’entités

Autres ressources

Form XML reference

Microsoft Dynamics CRM 2015 and Microsoft Dynamics CRM Online
Send comments about this topic to Microsoft.
© 2014 Microsoft Corporation. All rights reserved.