> ## 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.

# IFieldExtractor

> Référence de l'objet IFieldExtractor pour les scripts d'extraction FlexiCapture : méthodes pour rechercher des entités NER, exécuter des requêtes XML et enregistrer des portions de texte dans des champs.

<div id="purpose">
  ## Objectif
</div>

Identifie les champs dans le texte d'un document.

<Note>
  Ne peut être modifié que dans un script d'extraction.
</Note>

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

<table width="100%">
  <thead>
    <tr>
      <th>
        <p>
          <strong>Name</strong>
        </p>
      </th>

      <th>
        <p>
          <strong>Description</strong>
        </p>
      </th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td>
        <p>ExtractRegularExpression( regularExpression : string, resultCollectionName : string )</p>
      </td>

      <td>
        <p>Spécifie une expression régulière pour identifier des portions de texte.</p>

        <p>
          <br />

          Le paramètre resultCollectionName définit le nom de la collection d’objets obtenue. Le nom de la collection peut être utilisé dans les requêtes XML exécutées sur des documents. Vous pouvez également accéder à la
          collection obtenue par son nom.
        </p>
      </td>
    </tr>

    <tr>
      <td>
        <p>ExtractNerObjects()</p>
      </td>

      <td>
        <p>
          Indique au mécanisme d’identification de champs d’identifier les entités NER dans le texte d’un document. Une fois les objets identifiés, le mécanisme d’identification de champs disposera de collections
          portant les noms prédéfinis suivants : NerPerson, NerOrg, NerGeo, NerAddress, NerMoney et NerDate.
        </p>

        <p>
          <strong>Remarque : </strong>Les objets NerMoney et NerDate sont utilisés uniquement dans les <a href="/fr/flexi-capture/nlp-extraction-scripts">scripts d’extraction</a> et ne sont pas disponibles dans ABBYY FlexiLayout
          Studio.
        </p>
      </td>
    </tr>

    <tr>
      <td>
        <p>ExtractWordsFromUserDictionary( userDictionaryName : string, languageName : string )</p>
      </td>

      <td>
        <p>
          Indique au mécanisme d’identification des champs d’identifier les mots d’un dictionnaire utilisateur dans le texte d’un document. Les mots peuvent apparaître dans le texte sous n’importe quelle forme fléchie. Un dictionnaire utilisateur peut être{" "}
          <a href="/fr/flexi-capture/nlp-extraction-scripts#dictionary">sélectionné</a> dans l’onglet Properties de la règle de script. Le dictionnaire est référencé par son nom.
        </p>

        <p>
          <br />

          Le paramètre languageName spécifie la langue dans laquelle les formes fléchies des mots du dictionnaire utilisateur doivent être générées.
        </p>
      </td>
    </tr>

    <tr>
      <td>
        <p>ParseAddress()</p>
      </td>

      <td>
        <p>Analyse le texte d’un champ ou d’une section pour en extraire les composants d’adresse.</p>
      </td>
    </tr>

    <tr>
      <td>
        <p>ParseAddressInPosition( resultCollectionNamePrefix : string, startPos : int, endPos : int )</p>
      </td>

      <td>
        <p>Analyse le fragment de texte compris entre les positions de début et de fin spécifiées dans un champ ou une section afin d’en extraire les composants de l’adresse.</p>
      </td>
    </tr>

    <tr>
      <td>
        <p>ParseAddressInSpan(resultCollectionNamePrefix : string, span : IInterval )</p>
      </td>

      <td>
        <p>Analyse le fragment de texte compris dans un intervalle spécifié d’un champ ou d’une section pour en extraire les composants d’adresse.</p>
      </td>
    </tr>

    <tr>
      <td>
        <p>PutSpanToField( startPos : int, endPos : int, fieldName : IField )</p>
      </td>

      <td>
        <p>Enregistre dans un champ de document le fragment de texte correspondant à la plage spécifiée d’une sous-chaîne de texte.</p>
      </td>
    </tr>

    <tr>
      <td>
        <p>PutTextToField( startPos : int, endPos : int, fieldName : IField )</p>
      </td>

      <td>
        <p>Enregistre dans un champ du document le fragment de texte correspondant à la sous-chaîne définie par les positions de début et de fin spécifiées.</p>
      </td>
    </tr>

    <tr>
      <td>
        <p>
          RunQuery( xmlQuery : string, queryName : string ) : <a href="/fr/flexi-capture/i-extracted-objects">IExtractedObjects</a>
        </p>
      </td>

      <td>
        <p>Exécute une requête XML sur le texte d’un document et les portions de texte identifiées. Renvoie une collection de résultats sous la forme d’un tableau de portions de texte contenant les string résultantes identifiées.</p>
        <p>Le paramètre queryName spécifie un nom pour la requête, qui peut ensuite être utilisé pour récupérer la collection résultante à partir du mécanisme d’identification des champs.</p>
      </td>
    </tr>

    <tr>
      <td>
        <p>RunQueryAndSaveToField( xmlQuery : string, queryName : string, fieldName : string )</p>
      </td>

      <td>
        <p>Exécute une requête XML sur le texte d’un document ainsi que sur les portions de texte identifiées, puis enregistre les résultats dans un champ du document.</p>
      </td>
    </tr>

    <tr>
      <td>
        <p>SaveSpanToField( span : IInterval, fieldName : string )</p>
      </td>

      <td>
        <p>Enregistre le fragment de texte correspondant à l’intervalle spécifié pour une sous-chaîne de texte dans un champ du document.</p>

        <p>
          <strong>Important ! </strong>Cette méthode est obsolète dans FlexiCapture Release 3 Update 4 et les versions ultérieures. Si cette méthode est utilisée dans de nouveaux projets avec FlexiCapture Release 3 Update 4 et les versions ultérieures, ces
          projets seront envoyés dans Exceptions.
        </p>
      </td>
    </tr>

    <tr>
      <td>
        <p>SaveTextToField( startPos : int, endPos : int, fieldName : string )</p>
      </td>

      <td>
        <p>Enregistre dans un champ du document le fragment de texte correspondant à la sous-chaîne définie par les positions de début et de fin spécifiées.</p>

        <p>
          <strong>Important ! </strong>Cette méthode est obsolète dans FlexiCapture Release 3 Update 4 et les versions ultérieures. Si cette méthode est utilisée dans de nouveaux projets avec FlexiCapture Release 3 Update 4 et les versions ultérieures, ces
          projets seront envoyés vers Exceptions.
        </p>
      </td>
    </tr>

    <tr>
      <td>
        <p>
          ExtractedObjects( collectionName : string, \[optional] objectTypeName : VARIANT) : <a href="/fr/flexi-capture/i-extracted-objects">IExtractedObjects</a>
        </p>
      </td>

      <td>
        <p>Permet d'accéder à une collection d'objets identifiés à partir du nom de la collection.</p>
        <p>Pour les collections d'objets NER identifiés comme composants d'adresse, effectuez l'une des opérations suivantes :</p>

        <ul>
          <li>
            Pour collectionName, utilisez le nom passé en tant que resultCollectionNamePrefix aux méthodes ParseAddress... En outre, définissez objectTypeName sur le nom du type de la collection (par ex.
            "NerStreet" ou "NerCity"), ou
          </li>

          <li>Spécifiez collectionName sous la forme \[resultCollectionNamePrefix ]\_\[ objectTypeName] sans indiquer objectTypeName comme argument facultatif.</li>
        </ul>
      </td>
    </tr>

    <tr>
      <td>
        <p>
          QueryResults( queryName : string ) : <a href="/fr/flexi-capture/i-extracted-objects">IExtractedObjects</a>
        </p>
      </td>

      <td>
        <p>Permet d’accéder au résultat d’une requête XML à l’aide du nom de la requête.</p>
      </td>
    </tr>
  </tbody>
</table>

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

<table width="100%"><thead><tr><th><p><strong>Nom</strong></p></th><th><p><strong>Type</strong></p></th><th><p><strong>Autorisations</strong></p></th><th><p><strong>Valeur</strong></p></th></tr></thead><tbody><tr><td><p>SourceText()</p></td><td><p>string</p></td><td><p>Lecture</p></td><td><p>Le texte du document ou du champ sur lequel s’applique le mécanisme d’identification du champ.</p></td></tr><tr><td><p>SourceNode()</p></td><td><p>IField</p></td><td><p>Lecture</p></td><td><p>Le champ ou la section sur lequel s’applique le mécanisme d’identification du champ.</p></td></tr><tr><td><p>SourceDocument()</p></td><td><p>IDocument</p></td><td><p>Lecture</p></td><td><p>Le document qui contient SourceNode.</p></td></tr></tbody></table>