Passer au contenu principal

​
Configuration du service ABBYY FlexiCapture 12 Reporting Service

Le service stocke toutes les informations dans une base de données distincte. Par conséquent, une fois l’installation terminée, vous devez créer une base de données dans laquelle seront stockées les données de traitement des documents. Pour ce faire, procédez comme suit :
  1. Sur l’ordinateur où ABBYY FlexiCapture 12 Reporting Service est installé, lancez PowerShell avec des privilèges d’administrateur.
  2. Accédez au dossier CreateDb situé dans le répertoire où le service a été installé. Vous pouvez également utiliser cette commande si le service a été installé dans le chemin d’accès par défaut : 
    cd C:\inetpub\wwwroot\FlexiCapture12Reporting\CreateDb
  3. Exécutez le script CreateEventLogDb.ps1 avec les paramètres requis. Par exemple : 
    CreateEventLogDb.ps1 HostName\SQLInstanceName DATABASENAME user password
    Les paramètres de ce script doivent être remplacés par le nom de la base de données que vous créez et par vos propres identifiants.
    User et Password sont des paramètres facultatifs à utiliser uniquement dans le cas de l’authentification Microsoft SQL. Si aucun paramètre User ou Password n’est spécifié lors de l’exécution du script, le programme utilisera le compte Windows sous lequel le Reporting Service s’exécute. Assurez-vous que ce compte Windows dispose des autorisations d’accès à la base de données du Reporting Service.
  4. Ajoutez la clé suivante à la section AppSettings du fichier web.config de l’Administration and Monitoring Console, puis enregistrez vos modifications : 
    <add key="ExternalLogServiceSettingEnabled" value="true" />
  5. Ouvrez l’Administration and Monitoring Console et accédez à Settings → Event Logging Mode. Dans le champ ABBYY FlexiCapture 12 Reporting Service, indiquez l’adresse du Reporting Service au format suivant : http://<ServiceAddress>:8001. Assurez-vous que le port 8001 n’est utilisé par aucune autre application
  6. Dans Internet Information Services (IIS), recyclez le pool du serveur d’applications « FlexiCapture 12 Reporting »
Une fois ces étapes terminées, le programme enregistrera les données de traitement des documents pour le tenant par défaut dans les tableaux DocumentEditingStatistic et EventLog de la base de données.

​
Configuration de l’accès aux données du Reporting Service

Une fois le Reporting Service prêt, configurez le composant d’accès aux données si vous avez choisi d’installer et d’utiliser ce composant :
  1. Accédez au répertoire dans lequel le composant d’accès aux données a été installé. Le répertoire par défaut est C:\inetpub\wwwroot\FlexiCapture12ReportingDataAccess.
  2. Ouvrez le fichier appsettings.json et spécifiez les paramètres suivants :
    • DecryptionKey du fichier web.config du serveur d’applications. Par défaut, ce fichier se trouve dans C:\inetpub\wwwroot\FlexiCapture12\Server.
    • ValidationKey du fichier web.config du serveur d’applications.
    • ConnectionString pour se connecter à la base de données de reporting. Elle se trouve dans le fichier appsettings.json du Reporting Service (le chemin par défaut est C:\inetpub\wwwroot\FlexiCapture12Reporting).
    • ReportingDataPath — le chemin du dossier vers lequel les données doivent être exportées. S’il existe plusieurs tenants, les données de chaque tenant seront stockées dans un sous-dossier distinct.
    • RunTenantsDataGenerationPeriodSec — le délai, en secondes, entre les exportations automatiques des nouvelles données de reporting. La valeur par défaut est 14400, soit 4 heures.
Les paramètres ValidationKey, ConnectionString, RunTenantsDataGenerationPeriodSec et ReportingDataPath ne sont pas inclus dans le fichier appsettings.json installé avec le composant d’accès aux données. Vous devrez ajouter ces paramètres manuellement après le paramètre DecryptionKey, en les séparant par une virgule.
  1. Redémarrez le service web ABBYY FlexiCapture ReportingResults dans IIS.
  2. Redémarrez le service ABBYY FlexiCapture ReportingResults dans Services.
Une fois les étapes ci-dessus terminées, le programme exportera automatiquement les données de reporting vers le dossier spécifié dans appsettings.json. Veuillez noter qu’en cas d’exportation automatique, le Reporting Service exportera les données de reporting accumulées la veille. Cela signifie que la première exportation des données de reporting aura lieu un jour après l’installation et la configuration du Reporting Service. Vous pouvez également exporter les données de reporting manuellement à tout moment à l’aide de l’API (voir accès aux données via la REST API pour des instructions détaillées).

​
Modification de la base de données utilisée par ABBYY FlexiCapture 12 Reporting Service

Pour changer la base de données utilisée par le Reporting Service, vous devez modifier le fichier appsettings.json. Cette opération peut être effectuée manuellement ou, dans ABBYY FlexiCapture 12 Release 4 Update 2 et les versions ultérieures, à l’aide de l’utilitaire EventLogApiCreateDb.exe associé au script ConnectEventlogDb.ps1. Vous pouvez soit passer à une base de données existante contenant déjà des données, soit utiliser une nouvelle base de données vide. Si vous passez à une nouvelle base de données vide, l’utilitaire EventLogApiCreateDb.exe initialisera d’abord la base de données. Les instructions détaillées sont fournies ci-dessous.
  • Pour changer la base de données manuellement :
    1. Sur l’ordinateur où ABBYY FlexiCapture 12 Reporting Service est installé, lancez PowerShell avec les privilèges d’administrateur.
    2. Ouvrez le fichier appsettings.json, qui se trouve dans C:\inetpub\wwwroot\FlexiCapture12Reporting, et apportez les modifications nécessaires.
  • Pour changer la base de données à l’aide de l’utilitaire EventLogApiCreateDb.exe :
    1. Exécutez la commande appropriée de l’utilitaire :
      • Pour initialiser une nouvelle base de données vide : EventLogApiCreateDb.exe [ServerName] [NewDatabaseName] [User Password] init
      • Pour vous connecter à une base de données existante contenant déjà des données : EventLogApiCreateDb.exe [ServerName] [NewDatabaseName] [User Password] connect
L’utilitaire lira la chaîne de connexion dans le fichier appsettings.json.
  1. Exécutez le script ConnectEventlogDb.ps1 pour modifier la chaîne de connexion dans le fichier appsettings.json. La syntaxe générale du script est la suivante :
ConnectEventlogDb.ps1 ServerName OtherDatabaseName [User Password]
Par mesure de sécurité, le mot de passe du fichier appsettings.json sera chiffré. Le script ConnectEventlogDb.ps1 redémarrera ensuite le Reporting Service.

​
Activation du Reporting Service pour un tenant autre que le tenant par défaut

Par défaut, le Reporting Service s’exécute uniquement pour le tenant par défaut. Pour activer le Reporting Service pour un tenant autre que le tenant par défaut, définissez le premier bit correspondant au tenant approprié dans le champ Flags de la table dbo.Tenant. Le programme enregistrera alors les données de traitement des documents pour le tenant non par défaut spécifié dans les tables DocumentEditingStatistic et EventLog de la base de données.