smoBackOfficeClient


Note : Uniquement pour les clients On-Premise.
Definition

smoBackOfficeClient est l'outil utilisé pour exécuter les préimports en dehors de l'ordonnanceur smoBackOffice de Service Manager.

EndDefinition
  • Il peut être lancé à partir d'une ligne de commande pour tester / exécuter immédiatement le préimport.
  • Il peut également être lancé à partir d'un script (Batch, Powershell, ...) exécuté via un ordonnanceur externe ou une application tierce pour une exécution planifiée.

Exemple

L'intégration Nexthink permet d'intégrer dans Service Manager 48 indicateurs de santé relatifs aux matériels. Généralement, elle est lancée toutes les 30 minutes. 

==>  Pour garantir cette fréquence d'exécution, l'outil smoBackOfficeClient est utilisé. Cela permet de lancer immédiatement l'intégration au lieu d'être placée dans la file d'attente de l'ordonnanceur smoBackOffice de Service Manager.

Remarques

  • L'outil smoBackOfficeClient est livré sous la forme d'un exécutable situé dans le répertoire <easyvista>\tools\smoBackOfficeClient. (Note : <easyvista> identifie le répertoire EasyVista sur votre serveur applicatif).
    Note : Si vous êtes client OnPremise, vous pouvez également le télécharger  - Open url.png voir Procédure

Attention

  • Vous devez désactiver l'exécution du préimport par l'ordonnanceur smoBackOffice de Service Manager lorsque vous utilisez l'outil smoBackOfficeClient. Mettez alors en commentaire les lignes d'exécution des fichiers .ini dans le fichier PREIMPORT_SQL.sql (répertoire <easyvista>\tools\smobackoffice\QUERIES\SQL\PREIMPORT).

Bonnes pratiques

Quand utiliser l'outil smoBackOfficeClient ?

  • Lorsque vous souhaitez tester un préimport immédiatement. En effet, si vous utilisez l'ordonnanceur smoBackOffice de Service Manager, le préimport est placé dans la file d'attente des traitements à exécuter, et s'exécute après les tâches en cours.
  • Lorsque vous souhaitez utiliser un ordonnanceur externe ou une application tierce, pour centraliser au sein d'un seul outil toutes les tâches planifiées et/ou disposer d'options de planification plus poussées.

     Open url.png voir procédure Comment automatiser une intégration en utilisant un ordonnanceur externe

Ligne de commande

Syntaxe

smoBackOfficeClient.exe <easyvista>\tools\smobackoffice\QUERIES\SQL\PREIMPORT\<PreimportFileName.ini>
  • <easyvista> : Répertoire EasyVista sur le serveur applicatif.
  • <PreimportFileName.ini> : Nom du fichier de configuration .ini du préimport.

Liste des codes retours (Gestion des erreurs)

Code Description
0 Traitement réalisé sans erreur
1 Les paramètres sont incorrects.
2 Le préimport n'est pas trouvé.
4 La configuration SQL est invalide.
997 Erreur lors de l'exécution d'un script SQL d'une section [PROCESS]. Reportez-vous au fichier de log.
998 Erreur lors du traitement du préimport. Reportez-vous au fichier de log.
999 Erreur générale. Reportez-vous au fichier de log.

Exemples

Ligne de commande

     Exécution du préimport de l'intégration Nexthink (fichier de configuration NEXTHINK_ASSET_STATUS.ini)

smoBackOfficeClient.exe <easyvista>\tools\smobackoffice\QUERIES\SQL\PREIMPORT\NEXTHINK_ASSET_STATUS.ini

Script (Fichier batch)

Best Practice icon.png  Vous pouvez adapter à votre environnement le fichier batch smoBackOfficeClient.bat fourni avec l'outil. Remplacez le nom du fichier .ini par le nom du fichier de configuration utilisé par votre préimport.

@ECHO OFF
c:
cd\
cd C:\easyvista\tools\smoBackOfficeClient
smoBackOfficeClient.exe "C:\EasyVista\Tools\smoBackOffice\QUERIES\SQL\PREIMPORT\IMPORT_LDAP.ini"

Procédure : Comment utiliser l'outil smoBackOfficeClient

Étape 1 : Installation de l'outil smoBackOfficeClient

1. Téléchargez le fichier ci-dessous sur votre ordinateur.
         Download icon.png  smoBackOfficeClient.rar

2. Décompressez le fichier .rar dans un répertoire c:\easyvista\tools\smoBackOfficeClient.

Note : Le fichier smoBackOfficeClient.cfg est une copie du fichier de configuration smoBackOffice.cfg utilisé par l'ordonnanceur smoBackOffice de Service Manager.
 

Étape 2 : Lancement du préimport via l'outil smoBackOfficeClient

Attention : Vous devez désactiver l'exécution du préimport par l'ordonnanceur smoBackOffice de Service Manager lorsque vous utilisez l'outil smoBackOfficeClient. Mettez alors en commentaire les lignes d'exécution des fichiers .ini dans le fichier PREIMPORT_SQL.sql (répertoire <easyvista>\tools\smobackoffice\QUERIES\SQL\PREIMPORT).

Exécution immédiate

1. Ouvrez une fenêtre d'invite de commande Windows.

2. Tapez la ligne de commande en indiquant le nom du fichier de configuration .ini du préimport.

Exécution via un script

1. Créez un fichier batch  - Open url.png voir Exemple

2. Insérez la ligne de commande pour exécuter le préimport.

Tags :
Powered by XWiki © EasyVista 2022