Control-S : Import des rapports de contrôle SOCOTEC

Le connecteur SOCOTEC porte la classe d'intégration permettant l'import des données SOCOTEC dans CARL Source.

Ce connecteur permet de définir les paramètres techniques et fonctionnels d'intégration des rapports de contrôle.
Ces éléments ne doivent en aucun cas être modifiés.

Ce connecteur précise le système externe EXTSYS_SO faisant référence à l'interface spécifique SOCOTEC.
Ces éléments ne doivent en aucun cas être modifiés et doivent conserver leur code donné par défaut.

L’interface porte des données spécifiques à SOCOTEC non accessibles par l’IHM (génération de mémo, etc.). Ces éléments ne doivent pas être modifiés.

Le système externe EXTSYS_SO doit contenir seulement l'interface SOCOTEC.

Le point de connexion spécifique pour SOCOTEC se nomme SO-SFTP ; il utilise une classe d'handler pour se connecter à un serveur SFTP.

Dans le cas où vous possédez votre propre serveur SFTP, la classe de handler du point de connexion peut être laissée à la valeur « Fichier SIMPLE ».

L'add-on SOCOTEC a été développé pour une connexion en FTP, avant la mise en place des connexions SFTP.
Certains codes font donc référence à la notion « FTP » mais il ne s'agit que d'un nommage de CODE, cela ne bloque pas le fonctionnement en SFTP (si le paramétrage a été correctement réalisé pour un échange vers un serveur SFTP).
Il est fortement conseillé de ne pas modifier ces codes de « *_FTP » à « *_SFTP ».

Si vous utilisez l'import manuel d'un rapport de contrôle XML de SOCOTEC via l'action Import de rapports de contrôle de la fonctionnalité Interventions (pour tester l'option), il est alors impératif de créer/utiliser un point de connexion avec « Classe du handler = Fichier SIMPLE » à la place de la classe dédiée aux échanges avec un serveur SFTP (uniquement pour la durée du test).

Configuration des imports de contrôles du prestataire

A partir de la fiche détaillée du prestataire SOCOTEC qui a été ajouté par l'add-on SOCOTEC, appeler la fonction Configuration des imports de contrôle.
L'add-on SOCOTEC fournit une configuration complète qui peut être ajustée selon vos besoins (pour une installation initiale pré-version 7.2).

Si le prestataire SOCOTEC n'est pas présent, il est nécessaire de créer un prestataire avec la configuration adéquate. (Voir "Configuration d'un prestataire SOCOTEC" ci-dessous)

Configuration du Point de Connexion

Sur le point de connexion SO_SFTP, il est nécessaire de configurer :

L'URL et le port d'accès au serveur SFTP ADVANTAGE de SOCOTEC.
Les répertoires d'entrée, de sortie et de sauvegarde accessibles par l'application CARL Source.
Les répertoires d'entrée et de sortie sur le serveur SFTP.
Le login et le mot de passe à utiliser pour la connexion au serveur SFTP.

Dans le cas d'un test avec un point de connexion configuré en Fichier Simple :

La valeur pour le répertoire d'entrée et de sortie est sensible à la casse.
L'extension du fichier est également sensible à la casse; SOCOTEC fournit des fichiers avec l'extension .XML (et non .xml).
Le répertoire de stockage des fichiers temporaire (UploadTempDir) doit être renseigné et accessible par l'application CARL Source.

Import automatique

Dans ce mode, aucune visualisation au travers de l’IHM ne sera proposée.

Les traitements sont alors programmés au travers d’un Traitement automatique à déclarer dans le module système.

L'add-on SOCOTEC fournit le traitement IMPORT_CTRL_SOCOTEC.
Le traitement automatique s’appuie sur la classe PROVIDCTRLIMPORTJOB.

La configuration de ce traitement se fait au travers de ces paramètres :

Code du prestataire : code du prestataire (Fournisseur) déclaré dans CARL Source.
Code de l'organisation : code de l'organisation sur laquelle seront générées les interventions.
Chaine d'authentification : mot de passe simple (en clair) ou crypté (crypt:........) de l'utilisateur exécutant ce traitement.
Exemple pour le mot de passe "demo", il faudra renseigner simple:demo ou crypt:fe01ce2a7fbac8fafaed7c982a04e229.
Doit obligatoirement correspondre à un utilisateur utilisant une authentification interne.

Il est possible d'attacher le traitement automatique à la configuration par Organisation telle que définie dans la configuration d’import sur le prestataire.
Il est nécessaire de créer autant de tâches automatiques que de configurations d’Organisation différentes à traiter.

L’import automatique doit être paramétré entre 2h et 6h depuis le serveur SFTP de SOCOTEC.

Configuration d'un prestataire SOCOTEC

S'il n'existe pas de prestataire SOCOTEC par défaut dans l'application et que l'import SOCOTEC est nécessaire il faut configurer un prestataire dédié :

Créer un fournisseur dédié qui peut se nommer "SOCOTEC" (code et nom libre).
Depuis le détail du fournisseur, aller sur le menu configuration et activer l'entrée de menu "Configuration des imports de contrôles".
Renseigner le connecteur associé "SOCOTEC".
Garder la configuration de toutes les organisations ou décliner la configuration des étapes suivantes sur chaque organisation si nécessaire.
Définir une Gamme avec une nature du regroupement diagnostique (ex : "DIAG") qui sera utilisée pour la création des interventions importées.
Définir une opération de catégorie "Diagnostique" obligatoirement.
Définir le centre de coût par défaut souhaité pour les interventions SOCOTEC importées.
Cocher les options "Document à lier" et "Générer les suites à donner".
Indiquer le traitement automatique dédié IMPORT_CTRL_SOCOTEC.
Concernant les points de connexions, indiquer pour l'import et le retour d'information le même point de connexion SO-SFTP.