> ## Documentation Index
> Fetch the complete documentation index at: https://docs.abbyy.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Field

> L’objet Field — propriétés et méthodes pour examiner et modifier un champ de document lors de l’exécution des règles.

`Field` permet d’accéder à un champ de document — sa valeur, ses paramètres et sa structure. Dans un script, vous pouvez modifier la valeur d’un champ ou ajouter des valeurs suggérées qui sont affichées aux opérateurs de relecture manuelle.

<div id="properties">
  ## Propriétés
</div>

<div id="children">
  ### Children
</div>

**Type:** `Field[]` — **Access:** Lecture seule

Le tableau des champs enfants. Valide uniquement pour les champs de groupe.

<div id="datatype">
  ### DataType
</div>

**Type:** [DataType](/fr/vantage/documentation/skill-designer/document/rule-verification/data-type) — **Accès:** Lecture seule

Le type de données du champ.

<div id="fieldtype">
  ### FieldType
</div>

**Type:** [FieldType](/fr/vantage/documentation/skill-designer/document/rule-verification/field-type) — **Access:** Lecture seule

Le type de champ — par exemple, du texte, une coche ou un tableau (contenant des cellules qui représentent d’autres champs).

<div id="fullname">
  ### FullName
</div>

**Type:** `string` — **Access:** Lecture seule

Le chemin complet du champ depuis la racine du document. Utilise une barre oblique (`/`) comme Separator — par exemple, `Vendor/Address/Street`.

<div id="hasregion">
  ### HasRegion
</div>

**Type:** `bool` — **Access:** Lecture/écriture

`true` si le champ a été trouvé dans le document (une région lui est associée sur l’image). `false` signifie qu’aucune région correspondante n’a été trouvée.

<div id="hassuspicioussymbols">
  ### HasSuspiciousSymbols
</div>

**Type:** `bool` — **Access:** Lecture seule

`true` si la valeur du champ contient des caractères reconnus avec un faible niveau de confiance.

<div id="id">
  ### Id
</div>

**Type:** `string` — **Accès:** Lecture seule

L’identifiant du champ, unique dans le document.

<div id="imageregions">
  ### ImageRegions
</div>

**Type:** [ImageRegionList](/fr/vantage/documentation/skill-designer/document/rule-verification/image-region-list) — **Access:** Lecture/écriture

Tableau des régions du champ sur l’image.

<div id="instanceindex">
  ### InstanceIndex
</div>

**Type:** `int` — **Access:** Lecture seule

L’indice de l’instance actuelle d’un champ répétitif. Défini sur `-1` pour les champs non répétitifs.

<div id="instances">
  ### Instances
</div>

**Type :** `Field[]` — **Accès :** Lecture seule

Le tableau de toutes les instances de ce champ (champs répétitifs uniquement). Utilisez `Instances` pour accéder aux instances de champs répétitifs dans un conteneur obtenu via [`GetField`](/fr/vantage/documentation/skill-designer/document/rule-verification/context#getfield).

<div id="isconfirmed">
  ### IsConfirmed
</div>

**Type:** `bool` — **Access:** Lecture/écriture

`true` si le champ a été vérifié par un opérateur ou par une règle de validation.

<div id="isrepeatable">
  ### IsRepeatable
</div>

**Type :** `bool` — **Access :** Lecture seule

`true` si le champ est répétitif.

<div id="issuspicious">
  ### IsSuspicious
</div>

**Type:** `bool` — **Access:** Lecture seule

`true` si un ou plusieurs caractères de la valeur du champ ont été reconnus avec un faible niveau de confiance. Ces champs doivent faire l’objet d’une relecture manuelle ou être vérifiés par une règle.

<div id="isvalid">
  ### IsValid
</div>

**Type:** `bool` — **Access:** Lecture seule

`true` si le texte reconnu dans `Text` a été converti avec succès en une valeur du type spécifié dans `Value`.

<div id="isvisible">
  ### IsVisible
</div>

**Type:** `bool` — **Access:** Lecture seule

`true` si le champ est visible sur le document.

<div id="name">
  ### Name
</div>

**Type :** `string` — **Accès :** Lecture seule

Le nom du champ, unique dans son groupe.

<div id="parent">
  ### Parent
</div>

**Type:** `Field` — **Access:** Lecture seule

Le champ parent.

<div id="readonly">
  ### ReadOnly
</div>

**Type:** `bool` — **Access:** Lecture seule

`true` si le champ est en lecture seule et ne peut pas être modifié pendant la relecture manuelle.

<div id="symbols">
  ### Symbols
</div>

**Type:** [Symbol](/fr/vantage/documentation/skill-designer/document/rule-verification/symbol)`[]` — **Access :** Lecture seule

Tableau des caractères qui composent la valeur d’origine du champ au format texte.

<div id="text">
  ### Text
</div>

**Type:** `string` — **Access:** Lecture seule

La valeur d’origine du champ au format texte (générée lors de la reconnaissance du document).

<div id="value">
  ### Value
</div>

**Type:** `object` — **Accès :** Lecture/écriture

La valeur du champ au format spécifié (générée lors de la conversion du texte reconnu).

<Note>
  Contrairement à `Text`, la propriété `Value` stocke la valeur normalisée. Si un script modifie `Value` en une autre valeur normalisée, `Text` est mis à jour avec la nouvelle forme normalisée. Si `Value` reste inchangé après l’exécution du script, `Text` n’est pas mis à jour.
</Note>

<div id="methods">
  ## Méthodes
</div>

<div id="addsuggestion">
  ### AddSuggestion
</div>

```javascript theme={null}
void AddSuggestion(string value);
```

Ajoute une valeur suggérée au champ. Lors de la relecture manuelle, les opérateurs peuvent la sélectionner dans la liste des valeurs suggérées.

<Note>
  Non pris en charge pour les groupes de champs ou les conteneurs de champs répétitifs.
</Note>

<div id="copyto">
  ### CopyTo
</div>

```javascript theme={null}
void CopyTo(Field field);
```

Copie `Text`, `Value`, `ImageRegions` et `Symbols` du champ passé en argument vers le champ actuel. Renvoie une erreur si les deux champs ont des types de données différents.

<div id="getchild">
  ### GetChild
</div>

```javascript theme={null}
Field GetChild(string fieldName);
```

Renvoie le champ enfant portant le nom spécifié. Utilisez `GetChild` pour accéder aux éléments d’une liste — par exemple, à différentes cellules d’une même ligne.

<Warning>
  Passez le nom du champ sous la forme d’un littéral de chaîne, et non d’une variable. Le préprocesseur de script remplace le nom littéral par l’identifiant du champ avant l’exécution — les variables ne sont pas traitées.
</Warning>

<div id="related-topics">
  ## Rubriques connexes
</div>

* [Modèle objet](/fr/vantage/documentation/skill-designer/document/rule-verification/object-model)
* [Context](/fr/vantage/documentation/skill-designer/document/rule-verification/context)
* [FieldType](/fr/vantage/documentation/skill-designer/document/rule-verification/field-type)
* [DataType](/fr/vantage/documentation/skill-designer/document/rule-verification/data-type)