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

# Entrepôt d’analyse des rapports

> Entrepôt d’analyse des rapports dans ABBYY Vantage : suivez les modifications apportées aux champs, l’effort de vérification manuelle et les indicateurs de précision des documents pour les Compétences de processus.

export const VantageRegion = ({children}) => {
  const STORAGE_KEY = "abbyy.vantage.region";
  const REGIONS = [{
    code: "eu",
    label: "Europe"
  }, {
    code: "us",
    label: "North America"
  }, {
    code: "au",
    label: "Australia / Asia-Pacific"
  }];
  const [region, setRegion] = useState("eu");
  const [open, setOpen] = useState(false);
  const containerRef = useRef(null);
  const dropdownRef = useRef(null);
  function safeGetSavedRegion() {
    try {
      const saved = typeof window !== "undefined" ? window.localStorage.getItem(STORAGE_KEY) : null;
      const valid = new Set(REGIONS.map(r => r.code));
      return saved && valid.has(saved) ? saved : "eu";
    } catch {
      return "eu";
    }
  }
  function safeSetSavedRegion(code) {
    try {
      if (typeof window !== "undefined") {
        window.localStorage.setItem(STORAGE_KEY, code);
      }
    } catch {}
  }
  function dispatchRegionChanged(code) {
    try {
      if (typeof window !== "undefined") {
        window.dispatchEvent(new CustomEvent("abbyy:region-changed", {
          detail: {
            code
          }
        }));
      }
    } catch {}
  }
  function replaceRegionInString(text, currentRegion) {
    if (typeof text !== "string") return text;
    const hostRegex = /https:\/\/vantage-(eu|us|au)\.abbyy\.com/gi;
    const tokenRegex = /https:\/\/vantage-\[region\]\.abbyy\.com/gi;
    const bareHostRegex = /vantage-(eu|us|au)\.abbyy\.com/gi;
    const bareTokenRegex = /vantage-\[region\]\.abbyy\.com/gi;
    return text.replace(hostRegex, `https://vantage-${currentRegion}.abbyy.com`).replace(tokenRegex, `https://vantage-${currentRegion}.abbyy.com`).replace(bareHostRegex, `vantage-${currentRegion}.abbyy.com`).replace(bareTokenRegex, `vantage-${currentRegion}.abbyy.com`);
  }
  useEffect(() => {
    setRegion(safeGetSavedRegion());
  }, []);
  useEffect(() => {
    const root = containerRef.current;
    if (!root) return;
    const anchors = root.querySelectorAll("a[href]");
    anchors.forEach(a => {
      const href = a.getAttribute("href");
      if (href) {
        const next = replaceRegionInString(href, region);
        if (next !== href) {
          a.setAttribute("href", next);
        }
      }
    });
    const walker = typeof document !== "undefined" ? document.createTreeWalker(root, NodeFilter.SHOW_TEXT, null) : null;
    if (walker) {
      const toUpdate = [];
      let node = walker.nextNode();
      while (node) {
        const updated = replaceRegionInString(node.nodeValue, region);
        if (updated !== node.nodeValue) {
          toUpdate.push([node, updated]);
        }
        node = walker.nextNode();
      }
      toUpdate.forEach(([textNode, value]) => {
        textNode.nodeValue = value;
      });
    }
  }, [region, children]);
  useEffect(() => {
    const root = containerRef.current;
    if (!root) return;
    const anchors = root.querySelectorAll("a[href]");
    anchors.forEach(a => {
      a.style.fontWeight = "600";
      a.style.textDecoration = "underline";
      a.style.textUnderlineOffset = "2px";
    });
  }, [region, children]);
  useEffect(() => {
    const onRegionChanged = evt => {
      const code = evt && evt.detail && evt.detail.code;
      if (!code || code === region) return;
      setRegion(code);
    };
    if (typeof window !== "undefined") {
      window.addEventListener("abbyy:region-changed", onRegionChanged);
    }
    return () => {
      if (typeof window !== "undefined") {
        window.removeEventListener("abbyy:region-changed", onRegionChanged);
      }
    };
  }, [region]);
  useEffect(() => {
    const onClickAway = e => {
      if (!dropdownRef.current) return;
      if (!dropdownRef.current.contains(e.target)) {
        setOpen(false);
      }
    };
    document.addEventListener("click", onClickAway, true);
    return () => document.removeEventListener("click", onClickAway, true);
  }, []);
  const onSelect = code => {
    setRegion(code);
    safeSetSavedRegion(code);
    dispatchRegionChanged(code);
    setOpen(false);
  };
  const current = REGIONS.find(r => r.code === region) || REGIONS[0];
  return <div className="not-prose">
      <div className="mb-4 inline-flex items-center gap-2" ref={dropdownRef}>
        <span className="text-sm text-zinc-950/80 dark:text-white/80">Tenant Region:</span>
        <div className="relative">
          <button type="button" aria-haspopup="listbox" aria-expanded={open ? "true" : "false"} onClick={() => setOpen(v => !v)} className="h-8 px-3 rounded-md bg-zinc-900/5 dark:bg-white/5 border border-zinc-950/20 dark:border-white/20 text-sm inline-flex items-center gap-2">
            <span className="text-zinc-950 dark:text-white">{current.label}</span>
            <svg width="8" height="24" viewBox="0 -9 3 24" className="transition-transform text-gray-400 overflow-visible dark:text-gray-600 ml-auto" style={{
    transform: open ? "rotate(270deg)" : "rotate(90deg)"
  }}>
              <path d="M0 0L3 3L0 6" fill="none" stroke="currentColor" strokeWidth="1.5" strokeLinecap="round"></path>
            </svg>
          </button>
          {open ? <div role="listbox" className="absolute z-50 left-full top-0 ml-2 w-56 rounded-xl border border-zinc-950/20 dark:border-white/20 bg-white dark:bg-zinc-900 shadow-lg p-2">
              {REGIONS.map(r => {
    const selected = r.code === region;
    return <button key={r.code} type="button" role="option" aria-selected={selected ? "true" : "false"} onClick={() => onSelect(r.code)} className={"w-full flex items-center justify-between px-3 py-2 rounded-lg text-sm hover:bg-zinc-950/5 dark:hover:bg-white/10 text-zinc-950 dark:text-white" + (selected ? " font-medium" : "")}>
                    <span style={selected ? {
      color: "#ff2038"
    } : undefined}>{r.label}</span>
                    <span className={selected ? "ml-3" : "ml-3 invisible"} style={selected ? {
      color: "#ff2038"
    } : undefined}>✓</span>
                  </button>;
  })}
            </div> : null}
        </div>
      </div>
      <div ref={containerRef} className="prose dark:prose-invert max-w-none">{children}</div>
    </div>;
};

L’Entrepôt d’analyse des rapports stocke des données qui peuvent être utilisées pour analyser l’efficacité du traitement des documents dans le système. Grâce à ces données, vous pouvez identifier les documents qui nécessitent plus de temps pour la vérification manuelle et en comprendre les raisons.

Les statistiques sont collectées pour les Compétences de processus qui comportent au moins une étape de relecture manuelle et incluent au moins une Compétence de document. Le système compare l’état initial du document avant la relecture manuelle à son état après traitement.

L’Entrepôt d’analyse des rapports est l’un des deux entrepôts de rapports de Vantage. Pour une vue d’ensemble des deux — ainsi que de l’entrepôt [Rapport sur le traitement métier](/fr/vantage/developer/reporting/business-reporting) pour les données au niveau des transactions — consultez le [service de reporting](/fr/vantage/developer/reporting/reporting-service).

L’Entrepôt d’analyse des rapports stocke les données suivantes :

* Informations sur les modifications apportées aux documents
* Informations sur les champs des documents :
  * Le nombre de valeurs de champs extraites
  * Le nombre de valeurs de champs modifiées
  * Le statut de chaque champ (indiquant s’il est correct, s’il présente des problèmes de reconnaissance, s’il a été mal localisé ou s’il n’a pas été détecté)

<div id="migrating-from-v1-to-v2">
  ## Migration de v1 vers v2
</div>

Seul le chemin a changé, passant de « /v1/ » à « /v2/ ». Il n’y a aucune modification des champs de requête/réponse ni du comportement.

<div id="downloading-a-data-report">
  ## Téléchargement d’un rapport de données
</div>

<Note>
  Seuls les utilisateurs ayant les rôles **Tenant Administrator** ou **Processing Supervisor** peuvent télécharger des rapports de données. Pour plus d’informations, voir [Contrôle d’accès fondé sur les rôles (RBAC)](/fr/vantage/documentation/tenant-admin/tenant-management/role-based-access).
</Note>

Pour obtenir des données depuis l’Entrepôt d’analyse des rapports, envoyez une requête **GET** à l’une des ressources suivantes, selon le type de rapport dont vous avez besoin :

<div id="obtaining-data-about-documents-processed-by-a-process-skill">
  ### Récupération des données sur les documents traités par une compétence Process
</div>

<VantageRegion>
  ```
  GET https://vantage-us.abbyy.com/api/reporting/v2/qa/process-skills/documents
  ```
</VantageRegion>

<div id="obtaining-data-about-fields-processed-by-process-and-document-skills">
  ### Récupération des données concernant les champs traités par les Compétences de processus et de document
</div>

<VantageRegion>
  ```
  GET https://vantage-us.abbyy.com/api/reporting/v2/qa/process-skills/fields
  ```
</VantageRegion>

La requête accepte les paramètres suivants :

* **startDate**. Premier jour de la période pour laquelle les données doivent être téléchargées (exemple de format : 2022-01-07T13:03:38, l'heure doit être en UTC). Il s'agit d'un paramètre obligatoire.
* **endDate**. Dernier jour de la période pour laquelle les données doivent être téléchargées (exemple de format : 2022-09-07T13:03:38, l'heure doit être en UTC).
* **processSkillId**. L'ID de la Compétence de processus pour laquelle les données doivent être téléchargées. Il s'agit d'un paramètre obligatoire.
* **documentSkillId**. L'ID de la Compétence de document pour laquelle les données doivent être téléchargées.

<Info>
  Vous pouvez inclure ce paramètre uniquement dans la requête `/api/reporting/v2/qa/process-skills/fields`.
</Info>

* **imageType**. Le type d'image du document. Valeurs possibles : Unknown, Receipt, A4, BusinessCard, Book, Id, PassportRus, DiscountCard, BankCard, NotDocument, PassportPage.
* **imageColority**. Indique si la première page du document est en couleur, en niveaux de gris ou en noir et blanc. Valeurs possibles : BlackWhite, Gray, Color.
* **imageSource**. La source de l'image du document. Valeurs possibles : Unknown, Photo, Scan, Synthetic, Screenshot, Pdf.
* **wasCorrectedInManualReview**. Indique si les champs du document ont été corrigés lors de la relecture manuelle.
* **wasDocumentTypeChangedInManualReview**. Indique si le type de document a été modifié lors de la relecture manuelle.

Le fichier CSV obtenu contiendra les informations suivantes, organisées en colonnes.

<div id="report-about-changes-in-documents">
  ### Rapport sur les modifications apportées aux documents
</div>

| Column                                  | Description                                                                                                                                          |
| :-------------------------------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------- |
| `ProcessSkillId`                        | L'ID de la compétence Process.                                                                                                                       |
| `ProcessSkillVersion`                   | La version de la compétence Process.                                                                                                                 |
| `ProcessSkillName`                      | Le nom de la compétence Process.                                                                                                                     |
| `DocumentSkillId`                       | L'ID de la compétence Document.                                                                                                                      |
| `DocumentSkillVersion`                  | La version de la compétence Document.                                                                                                                |
| `DocumentSkillName`                     | Le nom de la compétence Document.                                                                                                                    |
| `TransactionId`                         | L'ID de la transaction.                                                                                                                              |
| `HasManualReview`                       | Indique si le document a fait l'objet d'une revue manuelle. Valeurs possibles : 1 ou 0.                                                              |
| `DocumentId`                            | L'ID du document envoyé pour traitement.                                                                                                             |
| `DocumentName`                          | Le nom du document envoyé pour traitement.                                                                                                           |
| `PageSize`                              | La taille en pixels (largeur et hauteur) de la première page du document.                                                                            |
| `ImageColority`                         | Indique si la première page du document est en couleur, en niveaux de gris ou en noir et blanc.                                                      |
| `ImageSource`                           | La source de l'image de la première page du document. Par exemple : scan, photo, fichier PDF, capture d'écran, etc.                                  |
| `ImageType`                             | Le type d'image de la première page du document. Par exemple : A4, reçu, carte bancaire, etc.                                                        |
| `DPI`                                   | Le nombre de points (ou pixels) sur la première page du document.                                                                                    |
| `TransactionParameter1..N`              | Paramètres de transaction envoyés pour traitement. Si le document ne contient aucun paramètre de transaction, la valeur dans le rapport sera `null`. |
| `DimensionField1..MValue`               | Champs de dimension envoyés pour traitement. Si le document ne contient aucun champ de dimension, la valeur dans le rapport sera `null`.             |
| `DocumentSkillChanged`                  | Indique si le type de document a été modifié lors de la revue manuelle. Valeurs possibles : true, false.                                             |
| `DocumentSkillIdUsedBeforeManualReview` | La compétence Document appliquée au document avant l'étape Manual Review.                                                                            |
| `NumberOfExportedFields`                | Le nombre de champs exportés dans le document.                                                                                                       |
| `NumberOfChangedFields`                 | Le nombre de champs modifiés manuellement dans le document.                                                                                          |

Les données de ce rapport seront conservées pendant 12 mois.

<div id="report-about-changes-in-fields">
  ### Rapport sur les modifications apportées aux champs
</div>

| Column                     | Description                                                                                                                                                                                                                                                                                                                                                            |
| :------------------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `ProcessSkillId`           | L'ID de la Compétence de processus.                                                                                                                                                                                                                                                                                                                                    |
| `ProcessSkillVersion`      | La version de la Compétence de processus.                                                                                                                                                                                                                                                                                                                              |
| `ProcessSkillName`         | Le nom de la Compétence de processus.                                                                                                                                                                                                                                                                                                                                  |
| `DocumentSkillId`          | L'ID de la Compétence de document.                                                                                                                                                                                                                                                                                                                                     |
| `DocumentSkillVersion`     | La version de la Compétence de document.                                                                                                                                                                                                                                                                                                                               |
| `DocumentSkillName`        | Le nom de la Compétence de document.                                                                                                                                                                                                                                                                                                                                   |
| `TransactionId`            | L'ID de la transaction.                                                                                                                                                                                                                                                                                                                                                |
| `HasManualReview`          | Indique si le document a fait l'objet d'une relecture manuelle. Valeurs possibles : 1 ou 0.                                                                                                                                                                                                                                                                            |
| `DocumentId`               | L'ID du document envoyé pour traitement.                                                                                                                                                                                                                                                                                                                               |
| `DocumentName`             | Le nom du document envoyé pour traitement.                                                                                                                                                                                                                                                                                                                             |
| `PageSize`                 | La taille en pixels (largeur et hauteur) de la première page du document.                                                                                                                                                                                                                                                                                              |
| `ImageColority`            | Indique si la première page du document est en couleur, en niveaux de gris ou en noir et blanc.                                                                                                                                                                                                                                                                        |
| `ImageSource`              | La source de l'image de la première page du document. Par exemple : scan, photo, fichier PDF, capture d'écran, etc.                                                                                                                                                                                                                                                    |
| `ImageType`                | Le type d'image de la première page du document. Par exemple : A4, reçu, carte bancaire, etc.                                                                                                                                                                                                                                                                          |
| `DPI`                      | Le nombre de points (ou pixels) sur la première page du document.                                                                                                                                                                                                                                                                                                      |
| `TransactionParameter1..N` | Paramètres de transaction envoyés pour traitement. Si le document ne contient aucun paramètre de transaction, la valeur dans le rapport sera `null`.                                                                                                                                                                                                                   |
| `DimensionField1..MValue`  | Champs de dimension envoyés pour traitement. Si le document ne contient aucun champ de dimension, la valeur dans le rapport sera `null`.                                                                                                                                                                                                                               |
| `NumberOfExportedFields`   | Le nombre de champs exportés dans le document.                                                                                                                                                                                                                                                                                                                         |
| `NumberOfChangedFields`    | Le nombre de champs modifiés manuellement dans le document.                                                                                                                                                                                                                                                                                                            |
| `FieldID`                  | L'ID du champ du document.                                                                                                                                                                                                                                                                                                                                             |
| `FieldName`                | Le nom du champ du document.                                                                                                                                                                                                                                                                                                                                           |
| `Correct`                  | Informations sur l'état de correction des champs non répétitifs et sur le nombre d'instances de champs répétitifs qui n'ont pas été corrigées. Valeurs possibles :<br />- 1, si le champ non répétitif n'a pas été corrigé lors de la relecture manuelle.<br />- Le nombre d'instances d'un champ répétitif qui n'ont pas été corrigées lors de la relecture manuelle. |
| `RecognitionIssue`         | Informations sur les problèmes de reconnaissance survenus lors du traitement des champs du document. Valeurs possibles :<br />- 1, si la valeur du champ non répétitif a été corrigée, mais pas la région.<br />- Le nombre d'instances où les valeurs d'un champ répétitif ont été corrigées lors de la relecture manuelle.                                           |
| `DetectedIncorrectly`      | Informations sur les corrections qui ont été effectuées lors de la relecture manuelle. Valeurs possibles :<br />- 1, si la région et la valeur d'un champ non répétitif ont été corrigées.<br />- Le nombre d'instances où les régions et les valeurs d'un champ répétitif ont été corrigées lors de la relecture manuelle.                                            |
| `NotDetected`              | Informations sur les valeurs de champ qui n'ont pas été extraites avant la relecture manuelle. Valeurs possibles :<br />- 1, si la valeur d'un champ non répétitif n'a pas été extraites avant la relecture manuelle et a été créée par un validateur.<br />- Le nombre d'instances des valeurs d'un champ répétitif qui ont été créées lors de la relecture manuelle. |
| `IsInDocument`             | Indique si le champ possède au moins une instance dans le document. Valeurs possibles : true, false.                                                                                                                                                                                                                                                                   |

Les données de ce rapport seront conservées pendant 14 jours.

Les données obtenues au format CSV peuvent ensuite être analysées dans n'importe quel outil de BI.
