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

# Configurer le Reporting Service

> Créez la base de données de reporting, configurez le composant d’accès aux données, basculez entre les bases de données et activez ABBYY FlexiCapture 12 Reporting Service pour les tenants.

Le Reporting Service stocke toutes les informations dans une base de données distincte. Une fois l’installation terminée, créez cette base de données et configurez le service pour qu’il l’utilise.

<div id="create-the-reporting-database">
  ## Créer la base de données de reporting
</div>

<Steps>
  <Step title="Lancer PowerShell en tant qu’administrateur">
    Effectuez les opérations sur l’ordinateur où ABBYY FlexiCapture 12 Reporting Service est installé.
  </Step>

  <Step title="Accéder au dossier CreateDb">
    Ce dossier se trouve dans le répertoire d’installation du service. Si le service est installé dans le chemin d’accès par défaut, utilisez la commande suivante :

    ```powershell theme={null}
    cd C:\inetpub\wwwroot\FlexiCapture12Reporting\CreateDb
    ```
  </Step>

  <Step title="Exécuter le script CreateEventLogDb.ps1">
    Remplacez les paramètres par le nom de la base de données à créer et vos identifiants.

    ```powershell theme={null}
    CreateEventLogDb.ps1 HostName\SQLInstanceName DATABASENAME user password
    ```

    `user` et `password` sont facultatifs et s’appliquent uniquement à l’authentification Microsoft SQL. Si vous les omettez, le programme utilise le compte Windows sous lequel s’exécute le Reporting Service. Assurez-vous que ce compte dispose des autorisations d’accès à la base de données du Reporting Service.
  </Step>

  <Step title="Ajouter la clé de configuration à web.config">
    Ajoutez la clé suivante à la section **AppSettings** du fichier `web.config` de l’Administration and Monitoring Console, puis enregistrez vos modifications.

    ```xml theme={null}
    <add key="ExternalLogServiceSettingEnabled" value="true" />
    ```
  </Step>

  <Step title="Spécifier l’adresse du service">
    Ouvrez l’Administration and Monitoring Console, puis accédez à **Settings > Event Logging Mode**. Dans le champ **ABBYY FlexiCapture 12 Reporting Service**, saisissez l’adresse du Reporting Service au format `http://<ServiceAddress>:8001`.

    Assurez-vous que le port 8001 n’est pas utilisé par une autre application.
  </Step>

  <Step title="Recycler le pool d’applications">
    Dans Internet Information Services (IIS), recyclez le pool de serveur d’applications **FlexiCapture 12 Reporting**.
  </Step>
</Steps>

Le programme enregistre désormais les données de traitement des documents du tenant par défaut dans les tableaux **DocumentEditingStatistic** et **EventLog** de la base de données.

<div id="configure-reporting-service-data-access">
  ## Configurer l’accès aux données du Reporting Service
</div>

Configurez le composant d’accès aux données une fois le Reporting Service prêt, si vous avez choisi d’installer ce composant.

<Steps>
  <Step title="Ouvrir appsettings.json">
    Accédez au répertoire dans lequel le composant d’accès aux données a été installé. Par défaut, il s’agit de `C:\inetpub\wwwroot\FlexiCapture12ReportingDataAccess`.
  </Step>

  <Step title="Spécifier les paramètres">
    Définissez les paramètres suivants dans `appsettings.json`.

    | Paramètre                             | Valeur                                                                                                                                                                                           |
    | ------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
    | **DecryptionKey**                     | À récupérer dans le fichier `web.config` du serveur d’applications. Par défaut, ses paramètres se trouvent dans `C:\inetpub\wwwroot\FlexiCapture12\Server`.                                      |
    | **ValidationKey**                     | À récupérer dans le fichier `web.config` du serveur d’applications.                                                                                                                              |
    | **ConnectionString**                  | Permet de se connecter à la base de données de reporting. Se trouve dans le fichier `appsettings.json` du Reporting Service, situé par défaut dans `C:\inetpub\wwwroot\FlexiCapture12Reporting`. |
    | **ReportingDataPath**                 | Chemin d’accès au dossier dans lequel les données sont exportées. S’il existe plusieurs tenants, les données de chaque tenant sont placées dans un sous-dossier distinct.                        |
    | **RunTenantsDataGenerationPeriodSec** | Intervalle, en secondes, entre les exports automatiques de nouvelles données de reporting. La valeur par défaut est `14400`, soit 4 heures.                                                      |

    Le fichier `appsettings.json` installé avec le composant d’accès aux données contient uniquement **DecryptionKey**. Ajoutez manuellement **ValidationKey**, **ConnectionString**, **RunTenantsDataGenerationPeriodSec** et **ReportingDataPath** à sa suite, en les séparant par des virgules.
  </Step>

  <Step title="Redémarrer les services">
    Redémarrez le service web ABBYY FlexiCapture ReportingResults dans IIS, puis le service ABBYY FlexiCapture ReportingResults Service dans Services.
  </Step>
</Steps>

Le programme exporte désormais automatiquement les données de reporting dans le dossier spécifié dans `appsettings.json`.

Un export automatique porte sur les données de reporting accumulées la veille. Le premier export a donc lieu un jour après l’installation et la configuration du Reporting Service. Pour exporter des données de reporting à tout moment, utilisez l’API. Pour plus d’informations, consultez [REST API data access](/fr/flexi-capture/reporting-service/reporting-data-access-rest-api).

<div id="change-the-database-used-by-the-reporting-service">
  ## Changer la base de données utilisée par le Reporting Service
</div>

Pour changer la base de données utilisée par le Reporting Service, modifiez le fichier `appsettings.json`. Effectuez cette opération manuellement ou, dans ABBYY FlexiCapture 12 Release 4 Update 2 et les versions ultérieures, utilisez l’utilitaire **EventLogApiCreateDb.exe** associé au script **ConnectEventlogDb.ps1**.

Vous pouvez passer à une base de données existante contenant déjà des données ou à une nouvelle base de données vide. Si vous passez à une nouvelle base de données vide, l’utilitaire **EventLogApiCreateDb.exe** l’initialise d’abord.

<div id="change-the-database-manually">
  ### Modifier la base de données manuellement
</div>

<Steps>
  <Step title="Lancez PowerShell en tant qu’administrateur">
    Sur l’ordinateur où ABBYY FlexiCapture 12 Reporting Service est installé.
  </Step>

  <Step title="Modifiez appsettings.json">
    Le fichier se trouve dans `C:\inetpub\wwwroot\FlexiCapture12Reporting`. Apportez les modifications nécessaires.
  </Step>
</Steps>

<div id="change-the-database-with-the-eventlogapicreatedbexe-utility">
  ### Modifier la base de données à l’aide de l’utilitaire EventLogApiCreateDb.exe
</div>

<Steps>
  <Step title="Exécuter la commande de l’utilitaire">
    Pour initialiser une nouvelle base de données vide :

    ```text theme={null}
    EventLogApiCreateDb.exe [ServerName] [NewDatabaseName] [User Password] init
    ```

    Pour vous connecter à une base de données existante contenant déjà des données :

    ```text theme={null}
    EventLogApiCreateDb.exe [ServerName] [NewDatabaseName] [User Password] connect
    ```

    L’utilitaire lit la chaîne de connexion dans le fichier `appsettings.json`.
  </Step>

  <Step title="Exécuter le script ConnectEventlogDb.ps1">
    Le script modifie la chaîne de connexion dans `appsettings.json`. Utilisez le modèle suivant :

    ```powershell theme={null}
    ConnectEventlogDb.ps1 ServerName OtherDatabaseName [User Password]
    ```

    Par mesure de sécurité, le mot de passe dans `appsettings.json` est chiffré. Le script redémarre ensuite le Reporting Service.
  </Step>
</Steps>

<div id="enable-the-reporting-service-for-a-non-default-tenant">
  ## Activation du Reporting Service pour un tenant autre que le tenant par défaut
</div>

Par défaut, le Reporting Service s’exécute uniquement pour le tenant par défaut.

Pour l’activer pour un autre tenant, définissez le premier bit correspondant à ce tenant dans le champ **Flags** de la table `dbo.Tenant`. Le programme enregistrera alors les données de traitement des documents pour ce tenant dans les tables **DocumentEditingStatistic** et **EventLog** de la base de données.