Table des matières

Comment paramétrer un flux de données pour piloter les données utilisateurs à partir d'un fichier .xml ?

Etape 1 : Préparation de l'import

Principe d'exécution de l'interface

:!: Veillez à nommer correctement les répertoires dans votre SFTP.
Nous vous recommandons 4 répertoires :
- Un répertoire « depot/prod/ » : destiné à l’usage en environnement de production,
- Un répertoire « depot/test/ » : destiné aux environnements de recette de l’application,
- Un répertoire « archives/prod/ » : destiné à l’usage en environnement de production,
- Un répertoire « archives/test/ » : destiné aux environnements de recette de l’application.

Spécifications générales du fichier d'échange

:!: En revanche, dans le cas où votre application comporte plusieurs sociétés, il est possible que deux utilisateurs affectés à deux sociétés différentes aient le même matricule. Cela ne pose pas de problèmes.

Contenu du fichier

Attibut XML Format Obligatoire Commentaires
matricule varchar(255) Oui Matricule paie de l'utilisateur (peut être utilisé comme critère de recherche).
nom varchar(255) Oui Nom de l'utilisateur (peut être utilisé comme critère de recherche).
prenom varchar(255) Oui Prénom de l'utilisateur (utilisé dans les mails).
genre enum (‘male’,’female’) Oui Genre de l’utilisateur (utilisé pour les statistiques et certains contrôles au dépôt d’absence).
login varchar(180) Oui Identifiant permettant de se connecter à oHRis (Renseigner l'identifiant de votre authentification spécifique si différente de l'authentification oHRis).
L’identifiant dans oHRis est une donnée unique, il n’est pas possible que 2 utilisateurs possèdent le même, même s'ils sont dans 2 sociétés différentes.
adresseMail varchar(255) Non Permet de recevoir les mails du workflow ainsi que les rappels.
typeContrat varchar(255) Oui Le flux ne créé pas de « type de contrat » : seuls les types de contrat présents dans oHRis sont acceptés. Si une autre valeur est envoyée, un message d'erreur est enregistré.
Permet de mettre en place des règles :
- de restrictions d'accès aux types d'absences
- d'option pour la gestion du CET (Exemples : Contractuel/Titulaire ou CDI/CDD/Stagiaires.
groupe varchar(255) Oui Le flux ne créé pas de « groupe » : seuls les groupes présents dans oHRis sont acceptés. Si une autre valeur est envoyée, un message d'erreur est enregistré.
Permet de mettre en place :
- des calculs de droits différentes
- des restrictions d'accès aux types d'absences \\- d'option pour la gestion du CET.
La notion de groupe permet de filtrer dans les écrans de recherche.
societe varchar(255) Oui Libellé court de la société d'appartenance de l'utilisateur.
Le flux ne créé pas de « société » : seuls les sociétés présentes dans oHRis sont acceptées. Si une autre valeur est envoyée, un message d'erreur est enregistré.
services>service>libellelong varchar(255) OuiLibellé long du service d'appartenance de l'utilisateur.
services>service>code varchar(255) OuiLibellé court du service d'appartenance de l'utilisateur.
dateDebutContrat date (AAAA-MM-JJ) Oui Date de début du contrat en cours. Permet d’activer le compte de l’utilisateur, de borner le dépôt des absences, et le calcul des droits par oHRis.
dateFinContrat date (AAAA-MM-JJ) Non Date de fin du contrat. Permet de borner le dépôt des absences, de désactiver le compte de l’utilisateur dans oHRis, d’afficher les périodes hors contrat dans les plannings collectifs, et de borner le calcul des droits par oHRis.
responsable varchar(180) Non Identifiant du responsable de l'utilisateur.Le connecteur affecte en cascade le responsable en tant que valideur de chaque module.
cycle varchar(255) NonQu'est ce qu'un cycle de travail ?.
Renseigner le libellé d'un cycle présent dans oHRis. Le flux ne crée pas de “cycle”. Si une autre valeur est envoyée, un message d'erreur est enregistré. Ce cycle sera affecté à partir de la date indiquée dans la colonne “DateAffectationCycle” dans le cas où aucun cycle n'est affecté à partir de cette date dans oHRis.
Le flux ne supprime pas de cycles présents dans oHRis. Si un cycle a été importé par erreur, le gestionnaire devra le retirer directement dans la fiche de l'utilisateur.
dateAffectationCycle date (AAAA-MM-JJ) Non
joursFeries varchar(255) NonLibellé du calendrier de jours fériés oHRis à affecter à l'utilisateur. Si une autre valeur est envoyée, un message d'erreur est enregistré. Lors de la création de l'utilisateur, le calendrier de jours fériés renseigné est affecté à partir de la date de début de contrat de l'utilisateur. Il n'y a pas de mise à jour du calendrier si l'utilisateur est déjà dans oHRis.
module enum (‘Absence’, ’Activity’, ’ExpenseReport’, ’Payslip’, ’CET’, ’Time’, ’Interview’, ’HRFile’) OuiPermet d'indiquer les modules à activer pour l'utilisateur séparé par des :
- Absences : module Absences
- Activity : module Activités
- ExpenseReport : module Notes de frais
- Payslip : module e-bulletins
- CET : module CET
- Time : module Temps
- Interview : module Entretiens
- HRFile : Suivi RH
enfants date (AAAA-MM-JJ) Non Date de naissance du/des enfants de l’utilisateur. Donnée utile uniquement pour les établissements relevant de la fonction publique dans le cas où le type d'absence Garde d'enfants est paramétrée (Comment activer la gestion de garde d'enfants ?)

Modèle de fichier

<?xml version="1.0"?>
  <utilisateurs>
    <utilisateur>
      <matricule>1007</matricule>
      <nom>DUPONT</nom>
      <prenom>CORINE</prenom>
      <genre>female</genre>
      <login>cdupont</login>
      <adresseMail>corine.dupont@mail.fr</adresseMail>
      <typeContrat>CDD</typeContrat>
      <groupe>Apprenti</groupe>
      <societe>SOC-A</societe>
      <services>
          <service>
              <libellelong>DIRECTION GENERALE</libellelong>
              <code>DG</code>
          </service>
          <service>
              <libellelong>SECRETARIAT</libellelong>
              <code>SEC</code>
          </service>
      </services>
      <dateDebutContrat>2022-01-01</dateDebutContrat>
      <dateFinContrat></dateFinContrat>
      <responsable>pmartin</responsable>
      <cycle>100% lundi au vendredi</cycle>
      <dateAffectationCycle>2022-01-01</dateAffectationCycle>
      <joursFeries>France</joursFeries>
      <modules>
          <module>Absence</module>
      </modules>
      <enfants>
          <enfant>2006-08-17</enfant>
          <enfant>2010-04-08</enfant>
      </enfants>
  </utilisateur>
  <utilisateur>
      <matricule>1009</matricule>
      <nom>MARTIN</nom>
      <prenom>PATRICK</prenom>
      <genre>male</genre>
      <login>pmartin</login>
      <adresseMail>patrick.martin@mail.fr</adresseMail>
      <typeContrat>CDI</typeContrat>
      <groupe>Cadre</groupe>
      <societe>SOC-B</societe>
      <services>
          <service>
              <libellelong>DIRECTION GENERALE</libellelong>
              <code>DG</code>
          </service>
          <service>
              <libellelong>DIRECTION FINANCIERE</libellelong>
              <code>DF</code>
          </service>
      </services>
      <dateDebutContrat>2010-05-09</dateDebutContrat>
      <dateFinContrat></dateFinContrat>
      <responsable></responsable>
      <cycle>100% lundi au vendredi</cycle>
      <dateAffectationCycle>2010-05-09</dateAffectationCycle>
      <joursFeries>France</joursFeries>
      <modules>
          <module>Absence</module>
          <module>Activity</module>
      </modules>
      <enfants>
          <enfant>1995-11-17</enfant>
      </enfants>
  </utilisateur>
</utilisateurs>

Règles de gestion à la création de l'utilisateur

Les paramètres suivant lui sont affectés :

Règles de gestion à la mise à jour de l'utilisateur

Etape 2 : Paramétrer le flux

Rendez-vous dans l'écran de gestion des connexions externes :


1. Depuis la page d'accueil, cliquez sur “Paramétrage” depuis le bandeau supérieur.



2. Cliquez sur “Général” pour dérouler le menu, puis sur “Connexions externes”.



3. Cliquez sur “Ajouter”.



4. Cliquez sur “Standard”.


Vous arrivez sur l'écran de paramétrage du connecteur :


5. Renseignez les informations de connexion à votre SFTP.
:!: Si vous n'avez pas de SFTP, nous pouvons vous en mettre un à disposition. Il suffit d'en faire la demande en envoyant un mail à support@ohris.fr.



6. Dans le menu déroulant “Données à importer” cochez “Utilisateurs”.



7. Sélectionnez l'heure à laquelle l'import devra s'effectuer quotidiennement.
8. Indiquez la durée de conservation des logs.


Ignorez la rubrique “Paramétrage Absences”.

Enfin, cliquez sur Enregistrer en bas de page.

Votre import automatique est paramétré. Le premier import aura lieu le lendemain à l'heure d'exécution paramétrée.

Si vous souhaitez désactiver l'import automatique, il vous suffit de décocher les données dans le champ “Données à importer