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

# Intégration de la relecture manuelle

> Intégrez la relecture manuelle d’ABBYY Vantage à votre application à l’aide du statut de la transaction, de manualReviewLink et de l’intégration d’iframe pour les workflows avec intervention humaine.

Si vous utilisez ABBYY Vantage au sein de votre propre système, vous souhaiterez probablement également tirer parti des fonctionnalités de relecture manuelle. Cette section vous guidera dans l’intégration de la relecture manuelle.

Après avoir envoyé des documents au traitement via l’API Vantage, surveillez le statut de la transaction comme décrit dans [Comment traiter des documents à l’aide de l’API Vantage](/fr/vantage/developer/processing-documents/processing-documents). Si un document doit être relu par un opérateur humain, la réponse sur le statut de la transaction contiendra une clé `manualReviewLink` avec un lien sécurisé, qui permettra au réviseur d’accéder uniquement aux données de cette transaction particulière.

Intégrez une iframe affichant le contenu de ce lien dans la page Web de votre service :

```html theme={null}
<iframe src="manual-review-link"></iframe>
```

Sachez que le lien expirera 168 heures après sa création. Si vous devez poursuivre la relecture, demandez un nouveau lien en envoyant une requête `GET` à la ressource `transactions`, comme précédemment.

<div id="iframe-appearance">
  ## Apparence de l’iframe
</div>

Vous pouvez améliorer l’apparence du service en supprimant le logo Vantage ou en masquant certains volets dans l’interface client de relecture manuelle.

Pour supprimer le logo Vantage, ajoutez un Parameter `displayMode` avec la valeur `iframe` au lien comme suit :

```html theme={null}
<iframe src="manual-review-link&displayMode=iframe"></iframe>
```

Utilisez les options suivantes pour configurer l’interface client de relecture manuelle :

| Key                        | Description                                                                                                                            |
| :------------------------- | :------------------------------------------------------------------------------------------------------------------------------------- |
| **features**               |                                                                                                                                        |
| `batchEditor`              | Définissez sur `false` pour masquer le volet des vignettes de Page.                                                                    |
| `batchEditor.toolbar`      | Définissez sur `false` pour afficher le volet des vignettes de Page mais masquer le volet de la barre d’outils.                        |
| `batchEditor.autoCollapse` | Définissez sur `true` pour afficher le volet des vignettes de Page mais le réduire à l’ouverture de l’interface de relecture manuelle. |
| `docEditor`                | Définissez sur `false` pour masquer le volet de l’image de Page.                                                                       |
| `docEditor.toolbar`        | Définissez sur `false` pour afficher le volet de l’image de Page mais masquer sa barre d’outils.                                       |
| `formEditor`               | Définissez sur `false` pour masquer le volet de la liste des Champs extraits.                                                          |
| `rulesReport`              | Définissez sur `false` pour masquer le volet de la liste des erreurs de règles.                                                        |
| `sendToStageAvailable`     | Définissez sur `true` pour afficher le bouton **Envoyer vers l’étape...**.                                                             |

Ces options sont regroupées dans un unique objet JSON. Le code d’exemple suivant affichera une iframe avec le volet des erreurs de règles masqué et le volet des vignettes de Page réduit :

```json theme={null}
"features": {
   "batchEditor": {
      "autocollapse": true,
   },
   "rulesReport": false,
}
```

Ajoutez un paramètre de requête `settings` contenant le contenu de cet objet JSON à votre lien pour la relecture manuelle :

```html theme={null}
<iframe src="manual-review-link&settings=%7B%22features%22%3A%7B%22batchEditor%22%3A%7B%22autoCollapse%22%3Atrue%7D%2C%22rulesReport%22%3Afalse%7D%7D"></iframe>
```

<div id="iframe-events">
  ## Événements de l’iframe
</div>

L’objet iframe envoie des messages à la fenêtre parente pour vous informer des actions du réviseur dans l’interface du client de relecture manuelle, afin que vous puissiez passer à l’étape suivante au moment opportun.

Les événements sont envoyés avec le Parameter `targetOrigin=parent`. Voici la liste des événements à surveiller :

* `ManualReviewWasPaused`. Envoyé lorsque le réviseur clique sur le bouton **Reject**.
* `ManualReviewWasCompleted`. Envoyé lorsque le réviseur clique sur le bouton **Complete**.
* `ManualReviewWithdrawn`. Envoyé lorsque le réviseur est resté inactif pendant un certain temps et que la tâche du client de relecture manuelle a été retirée et renvoyée dans la file d’attente générale des tâches.

L’exemple de code ci-dessous montre comment afficher une iframe pour la relecture manuelle et la masquer dès que l’un des événements ci-dessus est déclenché.

**Exemple de code pour l’écoute des événements de l’iframe :**

```html theme={null}
<html style="min-height: 100%; height: 100%;">
<head>
  <script>
    var manualReviewLink; // le lien issu de la réponse de statut de la transaction
    window.addEventListener("DOMContentLoaded", init, false);
    function init() {
      var iframe = document.createElement("iframe");
      iframe.src = getUrl();
      iframe.style.width = "100%";
      iframe.style.height = "95%";
      try {
        document.getElementById("main").removeChild(document.querySelector("iframe"));
      } catch (e) { }
      document.getElementById("main").appendChild(iframe);
      window.addEventListener("message", receiveMessage, false);
    }
    function getUrl() {
      return manualReviewLink + "&displayMode=iframe";
    }
    function receiveMessage(event) {
      console.log(event.data);
      if (event.data.target === "parent") {
        if (event.data.eventName === "ManualReviewWithdrawn" || 
            event.data.eventName === "ManualReviewWasPaused" || 
            event.data.eventName === "ManualReviewWasCompleted" ) {
          document.getElementById("iframe").style.display = "none";
        }
      }
    }
  </script>
</head>
<body
  style="background-color: #999999; min-height: 100%; height: 100%; position: relative; margin: 0; padding: 0; background: linear-gradient(to bottom right, #4380bc, #5ba484);">
  <div id="main"
    style="height: 100%; position: relative; padding:20px; -webkit-box-sizing: border-box; -moz-box-sizing: border-box; box-sizing: border-box;">
  </div>
</body>
</html>
```