Importer des données organisationnelles à l’aide de l’importation basée sur l’API (importation ultérieure) (préversion)

Important

Cette fonctionnalité est destinée uniquement aux clients en préversion publique. Les fonctionnalités de la préversion peuvent ne pas être complètes et subir des modifications avant de devenir disponibles dans la version plus large.

Dans cet article, nous abordons deux types d’importations : complètes et incrémentielles. Ces importations actualisent les données que vous avez fournies lorsque vous configurez votre connexion à Viva Insights.

Important

Utilisez uniquement les étapes suivantes si ce n’est pas la première fois que vous importez des données organisationnelles. S’il s’agit de votre première importation, reportez-vous à Importer des données organisationnelles (première importation) pour configurer une connexion, créer une application d’exportation et importer des données dans Viva Insights.

À propos des importations suivantes

Lorsque vous importez des données dans Viva Insights, vous effectuez une actualisation complète ou incrémentielle. Si vous souhaitez supprimer des champs, vous pouvez utiliser une actualisation complète pour ce faire.

L’application d’exportation personnalisée que vous avez créée dans Importer des données organisationnelles (première importation), ainsi que l’application DescriptiveDataUploadApp que nous avons créée sur GitHub, facilitent les actualisations dont nous parlons ci-dessous. En guise de récapitulatif rapide, lorsque DescriptiveDataUploadApp s’exécute, il extrait les données du dossier compressé que vous avez téléchargé à partir de GitHub. Ce dossier compressé contient les fichiers suivants :

• data.csv, qui contient les champs que vous souhaitez importer.
• metadata.json, qui mappe vos champs sources aux champs Viva Insights. Vous utiliserez également metadata.json pour indiquer à Viva Insights si votre actualisation est complète ou incrémentielle, comme nous l’expliquons dans la section suivante.

Comment indiquer une actualisation complète ou incrémentielle

1. Dans metadata.json, passez à la ligne 3.
2. Mettez à jour la “IsBootstrap”: propriété avec l’une des options suivantes :
   • Pour une actualisation complète, utilisez “IsBootstrap” : “true”.
   • Pour une actualisation incrémentielle, utilisez “IsBootstrap” : “false”.

Lorsque DescriptiveDataUploadApp s’exécute, Viva Insights commencez à traiter vos données en tant qu’actualisation complète ou incrémentielle, en fonction de ce que vous avez spécifié ici dans metadata.json.

Important

Veillez à supprimer tous les champs de metadata.json que vous n’incluez pas dans votre fichier data.csv. Si vous avez plus de champs dans votre fichier metadata.json que dans votre fichier data.csv (ou vice versa), le traitement de votre importation échoue.

Reportez-vous à Importer des données organisationnelles (première importation) pour en savoir plus sur metadata.json et comment les utiliser pour mapper des champs.

Types d’actualisation

Complet

Lorsque vous effectuez une actualisation complète, vous remplacez toutes les données de votre organization dans Viva Insights, c’est-à-dire que vous remplacez ce que vous avez déjà importé. Lorsque vous effectuez une actualisation complète, veillez à fournir des données pour tous les employés sous licence et sans licence (c’est-à-dire ceux qui ont un abonnement Viva Insights et ceux qui ne le font pas). Nous décrivons les champs à fournir plus loin dans cet article.

Vous pouvez utiliser une actualisation complète pour supprimer des champs, car les champs que vous ignorez n’apparaissent pas dans vos données. Nous parlons de la suppression de données dans la section suivante.

Suppression de champs avec actualisations complètes

Pour supprimer des champs avec une actualisation complète, exportez vos données en tant que .csv qui contient tous les champs à l’exception des champs que vous souhaitez supprimer. Étant donné qu’une actualisation complète remplace les données existantes, vous vous retrouverez avec tous les champs à l’exception de ceux que vous avez laissés de côté pendant l’importation.

Incrémentielle

Effectuez une actualisation incrémentielle lorsque vous souhaitez uniquement ajouter de nouvelles informations aux données organisationnelles que vous avez déjà chargées dans Viva Insights. Voici ce que vous pouvez faire avec une actualisation incrémentielle :

• Ajouter de nouveaux employés
• Ajouter de nouveaux attributs pour les employés existants
• Ajouter de nouveaux attributs pour les nouveaux employés
• Modifier les attributs des employés existants

Voici quelques exemples de cas où vous pouvez effectuer une actualisation incrémentielle :

Ajout de nouvelles recrues

Supposons que vous souhaitiez ajouter cinq nouveaux employés à vos données organisationnelles. Pendant l’importation, vous devez inclure :

• Cinq lignes qui contiennent les données des nouveaux employés.
• Attributs obligatoires : PersonId, ManagerId, Organization et EffectiveDate.
• Tous les champs facultatifs réservés (par exemple, HireDate) que vous avez déjà importés dans Viva Insights.

Une fois l’importation terminée, la seule modification que vous remarqueriez est cinq nouvelles lignes et leurs valeurs.

Ajout d’un nouvel attribut

Peut-être souhaitez-vous ajouter un attribut réservé facultatif qui n’était pas dans vos données auparavant (par exemple , Emplacement) pour tous les employés existants. Lorsque vous importez vos données, vous incluez uniquement les valeurs Location, PersonId et EffectiveDate, avec les valeurs actuelles et historiques pour chaque employé, dans votre fichier .csv. Une fois l’importation terminée, vous trouveriez les mêmes données qu’auparavant, à l’exception d’une nouvelle colonne pour chaque employé, Emplacement.

Champs à inclure dans data.csv pour les actualisations complètes et incrémentielles

Pour les types d’actualisation répertoriés ci-dessous, incluez les champs suivants dans votre fichier data.csv. Veillez à :

• Mettez en forme ces champs conformément à nos instructions dans Préparer les données organisationnelles.
• Supprimez les champs que vous n’incluez pas de votre fichier metadata.json.
• Conservez les fichiers data.csv et metadata.json dans le dossier compressé que vous avez téléchargé à partir de GitHub. Lorsque vous exécutez DescriptiveDataUploadApp, vous fournissez le chemin du dossier compressé. Viva Insights extrayez ensuite vos données à partir de cet emplacement.

Pour ce type d’actualisation	Inclure ces champs dans data.csv	Avec ces valeurs	Pour ces employés
Full	PersonId	Current Tous les historiques (reportez-vous à la note ci-dessous)	tous
	ManagerId	Current Tous les historiques	tous
	Organization	Current Tous les historiques	tous
	EffectiveDate	Current Tous les historiques	tous
	Tous les champs facultatifs réservés (par exemple, HireDate) que vous avez déjà importés dans Viva Insights	Current Tous les historiques	tous
Complet (pour supprimer des champs facultatifs réservés)	PersonId	Current Tous les historiques	tous
	ManagerId	Current Tous les historiques	tous
	Organization	Current Tous les historiques	tous
	EffectiveDate	Current Tous les historiques	tous
	Tous les champs facultatifs réservés (par exemple, HireDate) que vous avez déjà importés dans Viva Insights, à l’exception des champs facultatifs réservés que vous souhaitez supprimer	Actuel (à l’exception des champs à supprimer) Tous les historiques (à l’exception des champs à supprimer)	tous
Incrémentiel (pour ajouter de nouveaux champs ou modifier des champs existants, mais pas pour ajouter de nouveaux employés)	PersonId	Current Tous depuis le dernier chargement (reportez-vous à la remarque ci-dessous)	tous
	EffectiveDate	Current Tous depuis le dernier chargement	tous
	Tous les champs facultatifs réservés (par exemple, HireDate) que vous souhaitez ajouter	Current Tous depuis le dernier chargement	tous
Incrémentiel (pour ajouter de nouveaux employés)	PersonId	Current Tous depuis le dernier chargement (reportez-vous à la remarque ci-dessous)	Nouveaux employés uniquement
	ManagerId	Current Tous depuis le dernier chargement	Nouveaux employés uniquement
	Organization	Current Tous depuis le dernier chargement	Nouveaux employés uniquement
	EffectiveDate	Current Tous depuis le dernier chargement	Nouveaux employés uniquement
	Tous les champs facultatifs réservés (par exemple, HireDate) que vous avez déjà importés dans Viva Insights	Current Tous depuis le dernier chargement	Nouveaux employés uniquement

Notes

• « Tout historique » : valeurs pour les périodes précédentes. Par exemple, si vous incluez des données mensuelles, vous devez inclure des valeurs pour chaque mois précédant celui-ci. Lorsque vous commencez à utiliser Viva Insights, il est recommandé d’utiliser 13 mois de données. Après cela, il est recommandé de mettre à jour régulièrement les données afin qu’elles soient générées en 27 mois de données.
• « Toutes les valeurs depuis le dernier chargement » : valeurs pour la période entre les chargements. Par exemple, si le dernier chargement a eu lieu en mars et qu’il s’agit maintenant de juillet, incluez des valeurs pour avril, mai et juin.