Passer au contenu principal

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.

Cette section fournit des guides pour installer manuellement votre application sur un poste de travail local.
L’installation manuelle en mode autonome n’est possible que si vous utilisez Software ou la protection en ligne.
Dans ce scénario, vous déployez votre application sur une instance cloud, une machine virtuelle privée ou un poste de travail local, à l’aide d’un programme d’installation de votre choix, d’un script shell ou en copiant les fichiers manuellement. Vous aurez besoin de :
  • un fichier de jeton de licence en ligne (nommé sous la forme SWRTXXXXXXXXXXXXXXXXXXXX.ABBYY.ActivationToken).
Une connexion Internet est requise lorsque l’application est en cours d’exécution.
Nous recommandons de créer un package ABBYY FineReader Engine (que nous appellerons Package), c’est-à-dire un dossier contenant les fichiers nécessaires au fonctionnement et à la gestion de licence d’ABBYY FineReader Engine.
Pour simplifier la création d’un package personnalisé, extrayez les fichiers à l’aide de l’option /extract d’installRnt**.exe ou d’installLS.exe depuis la ligne de commande, afin de les décompresser dans un dossier donné sans lancer l’installation. Ce dossier contiendra les dossiers suivants :
  1. pour installRnt**.exe :
    • FineReader Engine - avec les fichiers d’ABBYY FineReader Engine
    • Inc - avec le fichier FREngine.tlb (pour l’enregistrement de FREngine.dll)
    • Licensing - avec les fichiers du service de licence
  2. pour installLS.exe :
    • Licensing - avec les fichiers du service de licence
    • License Server - avec les fichiers de License Server
Utilisez ces dossiers et les instructions ci-dessous pour créer votre package License Server.

​
Ajout au package sur votre ordinateur :

  1. Package de la bibliothèque. Il s’agit d’un dossier contenant les fichiers d’ABBYY FineReader Engine répertoriés dans la section ABBYY FineReader Engine Distribution Kit de l’aide du développeur. La liste comprendra :
    • Fichiers marqués comme “obligatoires” dans ABBYY FineReader Engine Distribution Kit. Il s’agit des modules système et des principales bases de données de reconnaissance.
    • Bases de données de reconnaissance pour le texte écrit en lettres moulées, si vous souhaitez reconnaître ce type de texte.
    • Fichiers de ressources pour les langues d’interface qui seront utilisées dans votre application.
    • Fichiers de prise en charge des dictionnaires pour les langues de reconnaissance prises en charge par votre application. Si ces langues incluent des langues utilisant l’alphabet latin, veillez à sélectionner les fichiers Univers.amd et Univers.amm.
    • Modules de numérisation, ressources spécifiques à la numérisation et modules TWAIN si votre application effectue la numérisation via l’interface ABBYY FineReader Engine.
    • Modules Windows Visual Components et ressources spécifiques associées, si votre application utilise les Visual Components d’ABBYY FineReader Engine.
Vous pouvez également créer la liste des fichiers automatiquement à l’aide du fichier FREngineDistribution.csv et du dossier FineReader Engine décompressé.
  1. Package License Server. Il comprend deux dossiers contenant les fichiers du service de licence et de l’utilitaire License Manager :
    • dossier service de licence contenant tous les fichiers copiés à partir du dossier Licensing décompressé.
    • dossier License Manager (License Manager64) contenant les fichiers suivants copiés à partir du dossier License Server décompressé : AbbyyZlib.dll, Awl.dll, concrt140.dll, FineFormats.dll, FineNet.dll, FineObj.dll, LicenseManager.exe, LicenseManager12.chm, LicensingSchema.xe, msvcp140.dll, ProductLicensingSchema.xe, Protection.dll, ProtectionRes0.dll, ProtectionResShared.dll, ProtectionUI.dll, vccorlib140.dll, vcruntime140.dll.
Utilisez ABBYY FineReader Engine et License Server provenant du même package. Dans le cas contraire, la compatibilité n’est pas garantie.
  1. Autres composants logiciels :
    • La mise à jour KB2999226 ou Microsoft Visual C++ 2015-2019 Redistributable 14.28.29912. Si vous n’installez pas le package Windows Update, vous pouvez installer le package redistribuable à partir du dossier External Components\VC_Redist du package de distribution : vc_redist.x86.exe et vc_redist.x64.exe.
    • .NET Framework 4.6.2 si vous comptez utiliser le module OfficeConverters.

​
Copie du package sur le poste de travail :

Le moyen le plus simple de s’assurer que le programme peut trouver tous les fichiers de ressources consiste à conserver la même structure de dossiers et à inclure dans votre package de distribution le fichier SharedFiles.ini, que vous trouverez dans le dossier Bin (ou Bin64) selon votre système d’exploitation. Si vous préférez ne pas utiliser ce fichier, au lieu de conserver la structure des dossiers, procédez comme suit :
  • Copiez le dossier Data\Resource avec tous ses sous-dossiers dans le dossier suivant :
    • Bin
    • Bin64
  • Copiez directement le contenu du dossier Data\ExtendedDictionaries dans le dossier Bin ou Bin64.
  • Copiez les autres fichiers contenus dans le dossier Data dans le dossier Bin ou Bin64.

​
Installation des composants logiciels nécessaires :

  1. Le package redistribuable Microsoft Visual C++ 2015-2019 14.28.29912.
  2. .NET Framework si nécessaire.
Vous devez copier le dossier contenant les fichiers ABBYY FineReader Engine depuis le Library Package vers le répertoire de la Workstation où vous souhaitez que la bibliothèque soit installée.

​
Enregistrement des bibliothèques dynamiques :

  1. Si votre application charge l’objet Engine via l’interface IEngineLoader, enregistrez FREngine.dll à l’aide de la ligne de commande suivante :
regsvr32 /s /n /i:"<path to the Inc folder>" "<path to FREngine.dll>"
  1. Si votre application utilise des composants visuels, enregistrez VisualComponentsX.dll à l’aide de la ligne de commande suivante :
regsvr32 /s "<path to VisualComponentsX.dll>"
Si vous rencontrez des problèmes lors de l’utilisation des loaders COM ou lorsque vous travaillez avec les composants visuels, veuillez vérifier les chemins d’accès de ces composants dans le registre et, en cas d’erreur, répéter la procédure d’enregistrement.
Création des dossiers qui seront utilisés par ABBYY FineReader Engine :Dans la liste ci-dessous, les valeurs par défaut de ces dossiers sont indiquées :
  • dossier %ProgramData%\ABBYY\SDK\12\FineReader Engine (les droits de contrôle total sont requis)
  • dossier %ProgramData%\ABBYY\SDK\12\Licenses (les droits de contrôle total sont requis pour le serveur de licences, facultatifs pour les postes de travail)
Pour spécifier le dossier des données de licence lors de l’installation, consultez un exemple dans Utilisation du fichier LicensingSettings.xml. Vous pouvez aussi utiliser la fonction InitializeEngine ou la méthode de l’interface IEngineLoader.

​
Installation du License Server :

Des droits d’administrateur sont requis pour l’installation.
  1. Copiez les dossiers du package License Server dans le répertoire de la station de travail destinée à héberger le License Server.
Nous vous recommandons d’organiser les fichiers d’ABBYY FineReader Engine dans une arborescence de dossiers facile à retrouver et à utiliser. Voir l’exemple ci-dessous :
  • <YourApplicationFolder>/ABBYY FineReader Engine Library.
  • <YourApplicationFolder>/License Server/service de licence.
  • <YourApplicationFolder>/License Server/License Manager (License Manager64).
  1. Créez ou choisissez un dossier dans lequel votre application recherche le fichier de jeton de licence, puis placez-y le fichier de jeton. Vous pouvez choisir %ProgramData%\ABBYY\SDK\12\Licenses, qui est le comportement par défaut, ou un autre dossier servant à stocker les données de licence. Le groupe Everyone doit disposer des autorisations de contrôle total sur ces dossiers.
  2. Créez un fichier LicensingSettings.xml avec le contenu ci-dessous. Consultez Utilisation du fichier LicensingSettings.xml pour plus de détails 
<LocalLicenseServer>
    <ConnectionProtocol ProtocolType="<Protocol type>" />
  </LocalLicenseServer>
Spécifiez la balise OnlineLicensing uniquement si vous utilisez une licence en ligne avec un serveur proxy (dans les autres cas, ne spécifiez pas cette balise) et laissez les autres paramètres à leurs valeurs par défaut (ne les incluez pas dans votre fichier). Le schéma XML auquel ce fichier doit se conformer se trouve dans le fichier LicensingSettings.xsd, situé dans le dossier Inc de votre installation développeur ou dans le dossier CADF\Inc du package de distribution.
  1. Copiez le fichier LicensingSettings.xml une fois configuré dans les dossiers suivants :
    • service de licence.
    • License Manager (License Manager64).
    • Dossier contenant les fichiers ABBYY FineReader Engine, à côté de FREngine.dll.
  2. Lancez LicensingService.exe avec le paramètre “/install” : 
LicensingService.exe /install

​
Activation de la licence :

Une licence en ligne ne nécessite pas d’activation : les informations de licence sont reçues lors de l’exécution de l’application depuis les services de licence en ligne ABBYY. Pour s’authentifier, l’application envoie un fichier de jeton de licence ainsi qu’un mot de passe de licence. Vous devez placer le fichier de jeton à l’emplacement attendu par l’application. Cet emplacement doit être défini par le développeur (par défaut : %ProgramData%\ABBYY\SDK\12\Licenses).Au moment de l’exécution, l’application doit se connecter périodiquement aux services de licence en ligne ABBYY pour recevoir les informations de licence et envoyer des statistiques d’utilisation. Aucune information personnelle n’est échangée avec les serveurs ABBYY.
  • Vérifiez que vous autorisez les connexions à *.abbyy.com sur le port 443 (HTTPS).Si la connexion est perdue, l’application cessera de fonctionner une fois un certain délai de reconnexion dépassé. La période de synchronisation et le délai de reconnexion sont des paramètres spécifiques de chaque licence en ligne.
Vérifiez que le certificat racine GoDaddy est installé dans le magasin de certificats Autorités de certification racines de confiance de la machine locale. Pour plus d’informations sur ce certificat, consultez le site web de GoDaddy.
Il n’est pas possible d’utiliser simultanément deux licences en ligne ou plus sur le même hôte. Lorsque l’application s’exécute et que la connexion aux services de licence ABBYY fonctionne, vous pouvez consulter les informations sur la licence en ligne actuellement active à l’aide de l’Utilitaire du gestionnaire de licences.
Copiez le jeton de licence dans un dossier par défaut sur chaque workstation ou dans un dossier dont le chemin est utilisé par votre application dans la fonction InitializeEngine.
Dans ce scénario, vous installez manuellement votre application utilisant la bibliothèque ABBYY FineReader Engine sur un poste de travail local. Vous aurez besoin de :
  • le numéro de série d’une licence Runtime autonome.
Nous recommandons de créer un package ABBYY FineReader Engine (que nous appellerons Package), c’est-à-dire un dossier contenant les fichiers nécessaires au fonctionnement et à la gestion de licence d’ABBYY FineReader Engine.
Pour simplifier la création d’un package personnalisé, extrayez les fichiers à l’aide de l’option /extract pour installRnt**.exe ou installLS.exe en ligne de commande depuis le package de distribution vers un dossier donné, sans lancer l’installation. Il contiendra les dossiers suivants :
  1. pour installRnt**.exe :
    • FineReader Engine - avec les fichiers d’ABBYY FineReader Engine
    • Inc - avec le fichier FREngine.tlb (pour l’enregistrement de FREngine.dll)
    • Licensing - avec les fichiers du service de licence
  2. pour installLS.exe :
    • Licensing - avec les fichiers du service de licence
    • License Server - avec les fichiers de License Server
Utilisez ces dossiers et les instructions ci-dessous pour créer votre package License Server.

​
Ajout au package sur votre ordinateur :

  1. Package de la bibliothèque. Il s’agit d’un dossier contenant les fichiers d’ABBYY FineReader Engine répertoriés dans la section ABBYY FineReader Engine Distribution Kit de l’Aide du développeur. La liste comprendra :
    • Fichiers marqués comme “obligatoires” dans ABBYY FineReader Engine Distribution Kit. Il s’agit des modules système et des principales bases de données de reconnaissance.
    • Bases de données de reconnaissance pour le texte écrit en lettres moulées, si vous souhaitez reconnaître ce type de texte.
    • Fichiers de ressources pour les langues d’interface qui seront utilisées dans votre application.
    • Fichiers de support des dictionnaires pour les langues de reconnaissance prises en charge par votre application. Si ces langues incluent des langues utilisant l’alphabet latin, veillez à sélectionner les fichiers Univers.amd et Univers.amm.
    • Modules de numérisation, ressources propres à la numérisation et modules Twain si votre application effectue la numérisation via l’interface ABBYY FineReader Engine.
    • Modules des composants visuels Windows et ressources spécifiques correspondantes, si votre application utilise les composants visuels ABBYY FineReader Engine.
Vous pouvez également créer la liste de fichiers automatiquement à l’aide du fichier FREngineDistribution.csv et du dossier FineReader Engine décompressé.
  1. Package License Server. Il comprend deux dossiers contenant les fichiers du service de licence et de l’utilitaire License Manager :
    • Dossier service de licence contenant tous les fichiers copiés depuis le dossier Licensing décompressé.
    • Dossier License Manager (License Manager64) contenant les fichiers suivants copiés depuis le dossier License Server décompressé : AbbyyZlib.dll, Awl.dll, concrt140.dll, FineFormats.dll, FineNet.dll, FineObj.dll, LicenseManager.exe, LicenseManager12.chm, LicensingSchema.xe, msvcp140.dll, ProductLicensingSchema.xe, Protection.dll, ProtectionRes0.dll, ProtectionResShared.dll, ProtectionUI.dll, vccorlib140.dll, vcruntime140.dll.
Utilisez ABBYY FineReader Engine et le License Server issus du même package. Dans le cas contraire, la compatibilité n’est pas garantie.
  1. Autres composants logiciels :
    • La mise à jour KB2999226 ou Microsoft Visual C++ 2015-2019 Redistributable 14.28.29912. Si vous n’installez pas le package Windows Update, vous pouvez installer le redistribuable à partir du dossier External Components\VC_Redist du package de distribution : vc_redist.x86.exe et vc_redist.x64.exe.
    • .NET Framework 4.6.2 si vous prévoyez d’utiliser le module OfficeConverters.

​
Copie du package sur le poste de travail :

Le moyen le plus simple de s’assurer que le programme peut localiser tous les fichiers de ressources consiste à conserver la même structure de dossiers et à inclure dans votre package de distribution le fichier SharedFiles.ini que vous trouverez dans le dossier Bin (or Bin64), selon votre système d’exploitation. Si vous préférez ne pas utiliser ce fichier, au lieu de conserver la structure de dossiers, procédez comme suit :
  • Copiez le dossier Data\Resource avec tous ses sous-dossiers dans le dossier suivant :
    • Bin
    • Bin64
  • Copiez le contenu du dossier Data\ExtendedDictionaries directement dans le dossier Bin ou Bin64.
  • Copiez les autres fichiers du dossier Data dans le dossier Bin ou Bin64.

​
Installation des composants logiciels nécessaires :

  1. Le redistribuable Microsoft Visual C++ 2015-2019 14.28.29912.
  2. .NET Framework si nécessaire.
Vous devez copier le dossier contenant les fichiers ABBYY FineReader Engine depuis le Library Package vers le répertoire de la Workstation où vous souhaitez que la bibliothèque soit installée.

​
Enregistrement des bibliothèques dynamiques :

  1. Si votre application charge l’objet Engine via l’interface IEngineLoader, enregistrez FREngine.dll à l’aide de la ligne de commande suivante :
regsvr32 /s /n /i:"<path to the Inc folder>" "<path to FREngine.dll>"
  1. Si votre application utilise les composants visuels, enregistrez VisualComponentsX.dll à l’aide de la ligne de commande suivante :
regsvr32 /s "<path to VisualComponentsX.dll>"
Si vous rencontrez des problèmes lors de l’utilisation des chargeurs COM ou lorsque vous travaillez avec des composants visuels, veuillez vérifier les chemins d’accès à ces composants dans le registre et, en cas d’erreur, recommencez la procédure d’enregistrement.

​
Création des dossiers qui seront utilisés par ABBYY FineReader Engine :

Dans la liste ci-dessous, les valeurs par défaut de ces dossiers sont indiquées :
  • dossier %ProgramData%\ABBYY\SDK\12\FineReader Engine (des droits de contrôle total sont requis)
  • dossier %ProgramData%\ABBYY\SDK\12\Licenses (une autorisation de contrôle total est requise pour le serveur de licences, facultative pour les postes de travail)
Pour spécifier le dossier des données de licence lors de l’installation, reportez-vous à l’exemple présenté dans Utilisation du fichier LicensingSettings.xml. Vous pouvez également utiliser la fonction InitializeEngine ou la méthode de l’interface IEngineLoader.

​
Installation du License Server

Des droits d’administrateur sont nécessaires pour l’installation.
  1. Copiez les dossiers du package License Server dans le répertoire du poste de travail destiné à héberger le License Server.
Nous vous recommandons d’organiser les fichiers ABBYY FineReader Engine dans une arborescence de dossiers facile à retrouver et à utiliser. Voir l’exemple ci-dessous :
  • <YourApplicationFolder>/ABBYY FineReader Engine Library.
  • <YourApplicationFolder>/License Server/service de licence.
  • <YourApplicationFolder>/License Server/License Manager (License Manager64).
  1. Créez un fichier LicensingSettings.xml et spécifiez les paramètres dans la balise LocalLicenseServer si nécessaire. Le schéma XML auquel il doit se conformer se trouve dans le fichier LicensingSettings.xsd, situé dans le dossier Inc de votre installation développeur ou dans le dossier CADF\Inc du package de distribution. Consultez Utilisation du fichier LicensingSettings.xml pour plus de détails
  2. Copiez le fichier LicensingSettings.xml configuré dans les dossiers suivants :
    • service de licence.
    • License Manager (License Manager64).
    • Dossier contenant les fichiers d’ABBYY FineReader Engine, à côté de FREngine.dll.
  3. Lancez LicensingService.exe avec le paramètre “/install” : 
LicensingService.exe /install

​
Activation de la licence

Exécutez LicenseManager.exe. Cliquez sur le bouton Activate License… et suivez les instructions de l’assistant pour activer votre licence. Si votre ordinateur dispose d’un accès à Internet, il vous suffit de saisir le numéro de série et d’attendre quelques instants. Pour plus d’informations sur le License Manager, consultez Utilitaire du gestionnaire de licences.Vous pouvez également activer la licence via la ligne de commande. Pour plus de détails, consultez Utilisation du License Manager depuis la ligne de commande.