Configuration des programmes externes

Avant de démarrer les tâches de configuration d'une étape externe, vous devez configurer le programme externe appelé par cette étape.
Installez le programme externe et, le cas échéant, le logiciel de serveur d'applications/secondaire avant de démarrer cette procédure.

Points importants à prendre en compte lors de l'installation du produit de base ou des serveurs d'applications/secondaire et d'un programme externe:

  • Lorsque vous installez le logiciel RICOH ProcessDirector sur un système Linux, le programme d'installation crée l'utilisateur système RICOH ProcessDirector (aiw1 par défaut). Lorsque vous vérifiez le fonctionnement d'un programme externe exécuté sous Linux, utilisez l'utilisateur système RICOH ProcessDirector pour effectuer votre test de vérification.
  • RICOH ProcessDirector ne crée pas automatiquement de compte utilisateur système pour RICOH ProcessDirector sur un serveur d'applications Windows. Le programme d'installation demande le nom du compte utilisateur à utiliser comme utilisateur RICOH ProcessDirector. Vérifiez le fonctionnement du programme externe à partir du compte de l'utilisateur RICOH ProcessDirector sur le serveur d'applications Windows.
  • Si l'ordinateur principal RICOH ProcessDirector est un système Linux, assurez-vous que l'utilisateur système RICOH ProcessDirector et l'utilisateur associé aux autres applications disposent des droits suffisants sur les répertoires et les systèmes de fichiers qu'ils utilisent.
  • Assurez-vous que l'utilisateur système RICOH ProcessDirector peut trouver et exécuter l'autre application. Utilisez l'une des méthodes suivantes :
    • Spécifiez, dans la commande que vous créez, le chemin d'accès complet vers l'application.
    • Ajoutez l'application à la variable d'environnement PATH de l'utilisateur système RICOH ProcessDirector.

      Cette option fonctionne mieux lorsque le programme externe s'exécute sur le même système que le serveur principal. Si le programme externe s'exécute sur un serveur secondaire ou d'applications, cette option ne fonctionne que si vous montez le répertoire d'installation du programme externe.

    • Créez un lien symbolique vers le programme externe et placez ce lien dans /aiw/aiw1/bin.

      La présence d'un lien symbolique dans ce répertoire offre des avantages importants. RICOH ProcessDirector ajoute ce répertoire à la variable d'environnement PATH lorsqu'il crée l'utilisateur système RICOH ProcessDirector, ce qui permet de reconnaître l'application sans modification distincte de la variable PATH. Le répertoire n'est pas supprimé lorsque vous appliquez le service, bien que certains des fichiers qu'il contient puissent être mis à jour. Le fichier de lien ne devrait pas être affecté.

      De plus, les serveurs d'applications et secondaires peuvent accéder à ce répertoire. Ils peuvent donc eux aussi utiliser le lien symbolique pour trouver le programme externe s'il se trouve dans le système de fichiers /aiw. Le programme externe ne peut pas s'exécuter à la fois sur un ordinateur principal Linux et un serveur d'applications Windows.

Pour configurer le programme externe, procédez comme suit :

  1. Reportez-vous à la documentation du programme externe et vérifiez qu'il s'exécute sans erreurs en tant que programme autonome.
  2. Si vous devez utiliser RunExternalProgram :
    1. Connectez-vous à l'ordinateur sur lequel s'exécute l'application en tant qu'utilisateur système RICOH ProcessDirector ou sous l'ID utilisateur Windows sous lequel s'exécute le serveur d'applications.
    2. Composez la commande permettant de lancer le programme depuis la ligne de commandes et utilisez-la pour passer un fichier d'entrée au programme.
      Notez la commande qui fonctionne pour l'utiliser comme référence lors de la configuration du modèle d'étape.
    3. Créez un modèle de fichier de contrôle pour l'étape.

      Si le programme externe doit lire les valeurs de propriété dont il a besoin à partir d'un fichier de paramètres accompagnant le fichier d'impression, l'étape RunExternalProgram peut générer ce fichier. Pour générer le fichier, l'étape utilise un modèle de fichier de contrôle. est un modèle de fichier de contrôle non valide.

      1. Faites une copie d'un fichier de paramètres, que le programme externe peut utiliser.
      2. Remplacez toutes les valeurs de propriété dans le fichier par la représentation en notation symbolique RICOH ProcessDirector de la propriété. Si la valeur correspond au nom d'un fichier compris dans le travail, remplacez-la par l'appel de méthode RICOH ProcessDirector approprié pour déterminer le nom de fichier.

        Lors du traitement, les étapes utilisent le modèle pour générer le fichier de paramètres en résolvant toutes les références et en insérant les valeurs pour le travail en cours.

      3. Copiez le modèle de fichier de contrôle dans un répertoire du système de fichiers partagé RICOH ProcessDirector (/aiw/aiw1/.)Tous les serveurs connectés au serveur principal peuvent accéder au fichier à cet emplacement.

        Les exemples de modèles de fichier de contrôle pour programmes externes sont installés dans /aiw/aiw1/samples/external_programs/. Vous pouvez copier ces fichiers vers le répertoire /aiw/aiw1/control_files/external_programs/ et les personnaliser, ou ajouter vos propres fichiers de contrôle au répertoire /aiw/aiw1/control_files/external_programs/. Notez l'emplacement du répertoire de votre modèle de fichier de contrôle.

      4. Sur un système Linux, vérifiez que les droits d'accès aux fichiers correspondant au modèle de fichier de contrôle permettent d'accéder à la classe other d'utilisateurs du système. Par exemple, définissez les droits d'accès correspondant au modèle de fichier de contrôle sur 666.
      5. Assurez-vous qu'une commande externe transmet le fichier de contrôle dans le paramètre qu'il attend (l'option-o pour l'inclusion de propriétés de travail supplémentaires, par exemple).

    4. Sur un système Linux, créez un lien symbolique vers l'application sur l'ordinateur principal :
      1. Connectez-vous au système sur lequel est exécuté le produit de base RICOH ProcessDirector en tant qu'utilisateur système RICOH ProcessDirector.
      2. Utilisez la commande stopaiw pour arrêter le serveur principal.
      3. Utilisez la commande suivante pour créer le lien symbolique : 
        ln -s application_file /aiw/aiw1/bin/link_file
        Remplacez application_file par le chemin complet du fichier exécutable de l'application et remplacez link_file par le nom du fichier de lien symbolique à créer. Le fichier exécutable doit se trouver dans le système de fichiers /aiw.
      4. Utilisez la commande startaiw pour démarrer le serveur principal.
  3. Si vous comptez utiliser RunHotFolderApplication :
    1. Connectez-vous à l'ordinateur principal en tant qu'utilisateur système RICOH ProcessDirector.
    2. Copiez ou déplacez un fichier d'impression dans le dossier d'entrée de l'application.
    3. Vérifiez que le programme externe commence bien à traiter le fichier.
    4. Vérifiez le fichier résultant dans le dossier de sortie. Lorsque le fichier est là, copiez ou déplacez-le dans un autre répertoire puis vérifiez qu'il est correct.
    5. Ouvrez le répertoire contenant les fichiers journaux du programme externe et vérifiez que vous pouvez ouvrir et afficher ces fichiers journaux.

Other topics in this section:

Configuration de modèles d'étapes externes
Définition de flots de travaux pour des étapes externes
Test du traitement des étapes externes via RICOH ProcessDirector

Related information:

Exemples de modèles de fichier de contrôle pour programmes externes
Rubrique parente : Étapes externes