Importation automatisée de la liste des destinataires

Tim Shelton

Mise à jour 13 mars 2026 20:09

Basé sur fichier

Tâche	Partie responsable
Fournir une décision sur la méthode de livraison: SFTP hébergé par FacilityOS Avec liste d'accès IP Sans liste d'accès IP SFTP hébergé par le client	Client
Fournir les détails d'accès SFTP et les identifiants, selon le cas	FacilityOS ou Client (selon la décision du client ci-dessus)
Spécifier le type de notifications par email et les adresses email des destinataires	Client
Télécharger sur le SFTP un fichier d'importation conforme aux exigences de formatage	Client
Configurer le travail automatisé pour importer les données	FacilityOS
Examiner les données et confirmer leur exactitude	Client
Configurer le travail automatisé pour envoyer le fichier de données	Client
Activer les travaux respectifs pour l'importation planifiée	FacilityOS & Client

La première étape consiste pour le client à sélectionner une méthode de livraison. Veuillez choisir parmi les options suivantes:

Fichier vers le SFTP de FacilityOS – FacilityOS crée un dossier SFTP dédié avec des identifiants uniques et le client télécharge le fichier (LE PLUS COURANT)
1. Avec liste d'accès IP (RECOMMANDÉ)
  1. Pour les scénarios où la machine téléchargeant le fichier aura une adresse IP statique ou une plage d'IP
  2. Le client doit fournir l'adresse IP ou la plage d'IP
2. Sans liste d'accès IP
Fichier vers le SFTP du client – Le client crée un dossier SFTP dédié avec des identifiants uniques et un travail construit par FacilityOS récupère les fichiers

Catégorie	Exigences
Contenu	Liste complète de tous les destinataires actifs (personnes ou emplacements)
Ligne d'en-tête	Obligatoire
Colonnes	Voir le tableau ci-dessous pour les colonnes prises en charge Les noms des colonnes dans la ligne d'en-tête doivent correspondre au tableau ci-dessous Pas sensible à la casse L'ordre des colonnes n'a pas d'importance Le client peut ajouter ou retirer toute colonne non marquée comme obligatoire à tout moment sans avoir à consulter FacilityOS
Dossier SFTP	/RecipientImport
Nom du fichier	(Toute valeur)
Format du fichier	Doit être l'un des suivants: .csv .txt
Séparateurs de champs	Doit être l'un des suivants: Virgule Si vous utilisez des séparateurs virgules, assurez-vous que les virgules sont retirées des valeurs des champs lors de la création du fichier ou utilisez des guillemets doubles comme délimiteurs de texte Barre verticale (pipe) Tabulation
Délimiteurs de texte	Doit être l'un des suivants: Guillemets doubles (aucun)
Fin de ligne	Doit être l'un des suivants: CR LF CRLF

Nom de la colonne	Type de données	Description
EmpID	Nvarchar(50)	OBLIGATOIRE Un identifiant unique alphanumérique pour l'enregistrement. Exemples: ID employé, ID du gestionnaire de temps, nom d'utilisateur AD, et adresse email. Cette valeur ne doit pas changer
FirstName	Nvarchar(50)	Recommandé pour les enregistrements de personnes Prénom légal
LastName	Nvarchar(50)	OBLIGATOIRE pour les personnes et les emplacements Pour les emplacements, utiliser ceci pour le nom de l'emplacement
PreferredName	Nvarchar(50)	À utiliser lorsque le nom préféré est différent du nom légal
CardID	Nvarchar(50)	ID de la carte
Email	Nvarchar(641)	OBLIGATOIRE pour envoyer une notification par email depuis LogisticsOS
PhoneNumber	Nvarchar(50)	OBLIGATOIRE pour envoyer une notification par SMS depuis LogisticsOS
Department	Nvarchar(50)
DeliveryLocation	Nvarchar(50)	OBLIGATOIRE* *Utiliser soit: DeliveryLocation, ou Au moins un des champs Bâtiment, Salle, et Étage
Building	Nvarchar(50)	OBLIGATOIRE* *Utiliser soit: DeliveryLocation, ou Au moins un des champs Bâtiment, Salle, et Étage
Floor	Nvarchar(50)	OBLIGATOIRE* *Utiliser soit: DeliveryLocation, ou Au moins un des champs Bâtiment, Salle, et Étage
Room	Nvarchar(50)	OBLIGATOIRE* *Utiliser soit: DeliveryLocation, ou Au moins un des champs Bâtiment, Salle, et Étage
MailStop	Nvarchar(50)	Extension requise pour utiliser ce champ

Mises à jour une fois par nuit, en dehors des heures ouvrables habituelles (PAR DÉFAUT)
Alternativement, d'autres fréquences peuvent être configurées sur demande du client

La logique d'importation standard est la suivante:

Ajouter de nouveaux enregistrements
Mettre à jour les enregistrements existants qui ont changé
Désactiver les enregistrements qui ne sont plus présents dans le dernier fichier/source de données
- S'applique uniquement aux enregistrements présents dans un fichier précédent
- Par mesure de sécurité, cette étape ne sera appliquée que lorsque le nombre de lignes de données dans le fichier est >50% de la liste des destinataires

Le travail d'importation peut être configuré pour envoyer des notifications email standard pour les événements suivants:

Après une importation réussie, le fichier source sera archivé dans un répertoire dédié
Les fichiers archivés seront supprimés après 14 jours