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

# Création d’un ensemble de fonctions pour traiter et vérifier un document unique

> Créez les fonctions de bibliothèque Pega pour la capture d’un document unique : SendForProcessing, WaitFirstVerificationOrProcessed et FetchingCapturedData.

Pour implémenter un scénario de traitement d’un document unique, créez les fonctions suivantes :

[SendForProcessing](#sendforprocessing)

[WaitFirstVerificationOrProcessed](#waitfirstverificationorprocessed)

[FetchingCapturedData](#fetchingcaptureddata)

[SingleDocumentBatchIsProcessed](#singledocumentbatchisprocessed)

## <a id="sendforprocessing" />SendForProcessing

La fonction *SendForProcessing* envoie un fichier à FC pour la reconnaissance et renvoie un identifiant de lot.

**Paramètres d’entrée** :

| **Nom**       | **Type Java** | **Description**                     |
| ------------- | ------------- | ----------------------------------- |
| fileName      | String        | Nom du fichier                      |
| base64Content | String        | Contenu du fichier au format Base64 |

**Type du paramètre de sortie** : *int* (identifiant de lot).

**Exceptions levées** : Exception.

**Code source Java** :

```
// Création du client API FlexiCapture Web Services. 
// Veuillez indiquer l'adresse du serveur d'applications FlexiCapture, le nom du tenant, le nom d'utilisateur et le mot de passe ici. 
try (TenantClient tenantClient = new TenantClient(new URI(baseUri), tenantName, userName, password)) {
  // Récupération de l'API de projet FlexiCapture. Veuillez indiquer un nom de projet ici.
  try(ProjectApi projApi = tenantClient.getProjects().getProjectApi(singleFileProjectName)) {
    // Création du lot et du document FlexiCapture.
    Batch batch = new Batch();
    Document doc = new Document();
    // Ajout du lot dans le projet FlexiCapture.
    int batchId = projApi.getBatches().add(batch);
    // Récupération de l'API de lot FlexiCapture. Veuillez indiquer un identifiant de lot ici.
    BatchApi batchApi = projApi.getBatches().getBatchApi(batchId);
    // Création d'une instance de fichier. 
    File file = new File(fileName, Base64.getDecoder().decode(base64Content.replace("\n", "").replace("\r", "")));
    // Ajout du document dans le lot FlexiCapture.
    // Le fichier constitue le contenu du document.
    int docId = batchApi.getDocuments().add(doc, file);
    // Lancement du lot FlexiCapture pour traitement.
    batchApi.start();
    //Renvoi de l'identifiant du lot.
    return batchId;
  }
} catch(Exception ex){
  // Concaténation des messages d'erreur. 
Throwable cause = ex.getCause();
String message = ex.getMessage();
while (cause != null) {
message += " " + cause.getMessage();
cause = cause.getCause();
}
// Levée du message concaténé.
throw new Exception(message);
}
```

## <a id="waitfirstverificationorprocessed" />WaitFirstVerificationOrProcessed

La fonction *WaitFirstVerificationOrProcessed* renvoie une URL de vérification. Si le document n’a pas encore atteint l’étape de vérification, une chaîne vide est renvoyée.

**Paramètres d’entrée** :

| **Nom** | **Type Java** | **Description**    |
| ------- | ------------- | ------------------ |
| batchId | int           | Identifiant du lot |

**Type du paramètre de sortie** : *String* (URL de vérification).

**Exceptions levées** : Exception.

**Code source Java** :

```
// Création du client API FlexiCapture Web Services. 
// Veuillez indiquer l'adresse du serveur d'applications FlexiCapture, le nom du tenant, le nom d'utilisateur et le mot de passe ici. 
try (TenantClient tenantClient = new TenantClient(new URI(baseUri), tenantName, userName, password)) {
  // Récupération de l'API de projet FlexiCapture. Veuillez indiquer un nom de projet ici.
  try(ProjectApi projApi = tenantClient.getProjects().getProjectApi(singleFileProjectName)) {
    // Récupération de l'API de lot FlexiCapture. Veuillez indiquer un identifiant de lot ici.
    BatchApi batchApi = projApi.getBatches().getBatchApi(batchId);
    // Attente de l'arrêt du lot à l'étape de vérification et récupération du document FlexiCapture.
    Document doc = batchApi.getDocuments().waitFirstVerificationOrProcessed();
    // Vérification que l'étape du lot est Verification.
    if (doc.getStageType() == ProcessingStageType.Verification) {
      // Retour de la première URL de vérification pour le lot FlexiCapture.
      return batchApi.getVerificationUrls(WebPageMode.Mini).get(0).toString();
    } 
    //Retour d'une chaîne vide si le lot a été traité sans étape de vérification.
    return "";
  }
}catch(Exception ex){
  // Concaténation des messages d'erreur. 
Throwable cause = ex.getCause();
String message = ex.getMessage();
while (cause != null) {
message += " " + cause.getMessage();
cause = cause.getCause();
}
// Levée du message concaténé.
throw new Exception(message);
}
```

## <a id="fetchingcaptureddata" />FetchingCapturedData

La fonction *FetchingCapturedData* renvoie une liste de champs de sortie au format JSON.

**Paramètres d’entrée** :

| **Nom** | **Type Java** | **Description**    |
| ------- | ------------- | ------------------ |
| batchId | int           | Identifiant du lot |

**Type du paramètre de sortie** : *String* (champs du document au format JSON).

**Exceptions levées** : Exception.

**Code source Java** :

```
// Création du client API FlexiCapture Web Services. 
// Veuillez indiquer l'adresse du serveur d'applications FlexiCapture, le nom du tenant, le nom d'utilisateur et le mot de passe ici. 
try (TenantClient tenantClient = new TenantClient(new URI(baseUri), tenantName, userName, password)) {
  // Récupération de l'API de projet FlexiCapture. Veuillez indiquer un nom de projet ici.
  try(ProjectApi projApi = tenantClient.getProjects().getProjectApi(singleFileProjectName)) {
    // Récupération de l'API de lot FlexiCapture. Veuillez indiquer un identifiant de lot ici.
    BatchApi batchApi = projApi.getBatches().getBatchApi(batchId);
    // Attente du traitement du lot et récupération du document FlexiCapture.
    Document doc = batchApi.getDocuments().waitFirstVerificationOrProcessed();
    // Récupération de l'API de document FlexiCapture. Veuillez indiquer un identifiant de document ici.
    DocumentApi docApi = batchApi.getDocuments().getDocumentApi(doc.getId());
    // Retour des champs capturés sous forme de chaîne JSON.
    return docApi.getExportedFields();
  }
}catch(Exception ex){
  // Concaténation des messages d'erreur. 
Throwable cause = ex.getCause();
String message = ex.getMessage();
while (cause != null) {
message += " " + cause.getMessage();
cause = cause.getCause();
}
// Levée du message concaténé.
throw new Exception(message);
}
```

## <a id="singledocumentbatchisprocessed" />SingleDocumentBatchIsProcessed

La fonction *SingleDocumentBatchIsProcessed* renvoie une valeur indiquant si un lot a été traité ou non.

**Paramètres d’entrée** :

| **Name** | **Type Java** | **Description**    |
| -------- | ------------- | ------------------ |
| batchId  | int           | Identifiant du lot |

**Type du paramètre de sortie** : *boolean* (*true* si le document est à l’étape *Processed* et *false* sinon).

**Exceptions levées** : Exception.

**Code source Java** :

```
// Création du client API FlexiCapture Web Services. 
// Veuillez fournir l'adresse du serveur d'applications FlexiCapture, le nom du tenant, le nom d'utilisateur et le mot de passe ici. 
try (TenantClient tenantClient = new TenantClient(new URI(baseUri), tenantName, userName, password)) {
  // Récupération de l'API de projet FlexiCapture. Veuillez fournir un nom de projet ici.
  try(ProjectApi projApi = tenantClient.getProjects().getProjectApi(singleFileProjectName)) {
    // Récupération de l'API de lot FlexiCapture. Veuillez fournir un identifiant de lot ici.
    BatchApi batchApi = projApi.getBatches().getBatchApi(batchId);
    // Attente de l'arrêt du lot à l'étape de vérification ou de traitement, et récupération du document FlexiCapture.
    Document doc = batchApi.getDocuments().waitFirstVerificationOrProcessed();
    // Vérification que l'étape du lot est Traité.
    return doc.getStageType() == ProcessingStageType.Processed;    
  }
}catch(Exception ex){
  // Concaténation des messages d'erreur. 
Throwable cause = ex.getCause();
String message = ex.getMessage();
while (cause != null) {
message += " " + cause.getMessage();
cause = cause.getCause();
}
// Levée de l'exception avec le message concaténé.
throw new Exception(message);
}
```