Procédure d'importation de données

Lorsque vous souhaitez ajouter ou mettre à jour des données, importez-les dans CA APM à l'aide de l'importateur de données. Les données que vous importez sont insérées ou mettent à jour des données existantes dans CA MDB.
casm173
Lorsque vous souhaitez ajouter ou mettre à jour des données, importez-les dans CA APM à l'aide de l'importateur de données. Les données que vous importez sont insérées ou mettent à jour des données existantes dans CA MDB.
Dans ce scénario, l'administrateur système effectue l'importation de données. Toutefois, il peut accorder l'accès utilisateur ou administrateur à l'importateur de données à un rôle d'utilisateur de CA APM. L'accès utilisateur permet aux utilisateurs de créer des importations, de modifier ou de supprimer leurs propres importations ainsi que d'afficher une importation créée par un autre utilisateur. L'accès administrateur permet aux utilisateurs de créer des importations et de modifier ou supprimer une importation créée par un utilisateur.
Le diagramme suivant illustre la procédure appliquée par un administrateur système pour importer des données.
Diagramme illustrant la procédure d'importation de données
Diagram depicting how to import data
Pour importer des données CA APM, procédez comme suit :
Exemple : importation de nouveaux employés
Sam est l'administrateur système CA APM de la société Document Management Company et veut importer un groupe de nouveaux employés. Les nouveaux employés utilisent le produit pour gérer des actifs matériels. Sam a reçu un fichier de données de source CSV (valeurs séparées par des virgules) du service des Ressources humaines qui contient des informations sur les employés. Tous les nouveaux employés utilisant le gestionnaire d'actifs appartiennent au département informatique et travaillent au siège de l'entreprise. Toutefois, le fichier de données sources contient également des données sur quelques nouveaux employés qui travaillent à d'autres emplacements et ne font pas partie du département informatique.
SAM veut importer uniquement les données des employés du département informatique travaillant au siège. A l'aide de l'importateur de données et du fichier de données sources, il crée une importation de données pour intégrer les nouveaux employés dans CA MDB. Pour veiller à importer seulement les employés du service informatique du siège, il crée un filtre d'exclusion. Une fois l'importation exécutée, Sam vérifie les statistiques d'importation, le fichier journal d'importation et l'interface utilisateur pour s'assurer que l'importation s'est correctement effectuée.
Vérification des prérequis
Pour importer les données, veillez à effectuer d'abord les tâches suivantes :
  • Préparez un fichier de données sources au format texte délimité (par exemple, par des tabulations ou des virgules). Ce fichier contient les données que vous souhaitez importer.
    Il est recommandé d'inclure l'objet de destination principal dans le nom du fichier de données sources. Cette convention d'attribution de nom de fichier permet de rechercher vos fichiers de données lors de la création de l'importation. Une valeur NULL dans votre fichier de données sources efface la valeur du champ de destination correspondant. Un champ vide dans le fichier de données sources ne modifie pas la valeur du champ de destination correspondant.
    Si une valeur de données de votre fichier de données sources contient le délimiteur sélectionné, vous devez placer cette valeur entre guillemets. Par exemple, vous sélectionnez une virgule comme délimiteur pour l'importation de sociétés. Vous souhaitez inclure la valeur de données Document Management Company, Inc. dans le fichier de données sources. Spécifiez cette valeur de données entre guillemets : "Document Management Company, Inc".
  • (Facultatif) Copiez vos fichiers de données sources de votre serveur local vers l'un des emplacements suivants. Vous pouvez accéder à ces emplacements sur le serveur d'applications CA APM sur lequel est installé le service du gestionnaire de stockage. L'emplacement dépend de l'utilisation de l'hébergement multiclient.
    [ITAM Root Path]\Storage\Common Store\Import [ITAM Root Path]\Storage\Tenant_Name\Import
    Si vous copiez le fichier de données avant de créer une importation, vous pouvez spécifier le nom du fichier lors de la création de l'importation. Sinon, vous pouvez charger le fichier à partir de votre serveur local lors de la création de l'importation.
  • (Facultatif) Copiez vos fichiers de mappage hérité d'une version antérieure du produit (si vous disposez de ces fichiers) à partir de votre serveur local vers l'un des emplacements suivants. Vous pouvez accéder à ces emplacements sur le serveur d'applications CA APM sur lequel est installé le service du gestionnaire de stockage. L'emplacement dépend de l'utilisation de l'hébergement multiclient.
    [ITAM Root Path]\Storage\Common Store\Import [ITAM Root Path]\Storage\Tenant_Name\Import
Création d'une importation de données à partir d'un fichier de données
Créez une importation de données à l'aide d'un fichier de données sources (fichier texte délimité) qui contient les données que vous voulez importer. Sélectionnez le fichier, configurez les paramètres d'importation et spécifiez le délimiteur (par exemple, une virgule ou une tabulation) pour séparer les données dans le fichier.
Vous pouvez également créer une importation de données à l'aide d'un fichier de mappage hérité d'une version antérieure du produit. Pour plus d'informations, reportez-vous à la section Création d'une importation de données à partir d'un fichier de mappage hérité.
Procédez comme suit :
  1. Connectez-vous à CA APM en tant qu'administrateur.
    Dans ce scénario, l'administrateur système effectue l'importation de données. Toutefois, il peut accorder l'accès utilisateur ou administrateur à l'importateur de données à un rôle d'utilisateur de CA APM. L'accès utilisateur permet aux utilisateurs de créer des importations, de modifier ou de supprimer leurs propres importations ainsi que d'afficher une importation créée par un autre utilisateur. L'accès administrateur permet aux utilisateurs de créer des importations et de modifier ou supprimer une importation créée par un utilisateur.
  2. Cliquez sur Administration, Importateur de données.
  3. Cliquez sur Nouvelle importation.
  4. Entrez les informations requises dans la zone Informations de base et indiquez d'autres informations facultatives si nécessaire. Les champs suivants doivent faire l'objet d'une explication :
    • Fichier de données
      Spécifie le fichier de données sources que vous voulez importer.
      Si ce fichier est disponible sur le serveur d'applications CA APM, recherchez le fichier de données et sélectionnez-le. Sinon, chargez-le.
    • Fichier de chargement
      Accédez à votre serveur local pour rechercher un fichier de données sources que vous souhaitez importer ou un fichier de mappage hérité que vous souhaitez utiliser pour créer des mappages. Ce fichier est chargé sur le serveur d'applications CA APM.
      La taille du fichier est limitée par les paramètres de l'environnement du produit. Pour plus d'informations, contactez votre administrateur.
    • Objet de destination principal
      Permet de spécifier l'objet principal de l'importation.
      Les objets Actif et Modèle sont répertoriés avec leurs familles correspondantes. Vous pouvez également spécifier Toutes les familles. Les objets Document juridique sont répertoriés selon le modèle juridique. Vous pouvez également spécifier Tous les modèles. Les objets incluent tous ceux pouvant être importés.
      Pour les actifs ou modèles qui incluent plusieurs types de famille d'actifs ou des documents juridiques comprenant plusieurs modèles juridiques, utilisez les sélections suivantes pour ce champ. Spécifiez la famille ou le modèle pour chaque enregistrement dans le fichier de données sources.
      • Pour un actif, sélectionnez Actif (toutes les familles).
      • Pour un modèle, sélectionnez Modèle (toutes les familles).
      • Pour un document juridique, sélectionnez Document juridique (tous les modèles).
      Veillez à sélectionner l'objet principal de destination approprié pour l'importation. Vous ne pouvez pas modifier l'objet de destination principal après l'enregistrement ou la copie d'une importation.
    • Noms de colonnes sur la première ligne
      Spécifie si la première ligne du fichier de données sources contient les noms de colonnes. Si ce n'est pas le cas, les noms s'afficheront sous forme de noms génériques, tels que champ 1 et champ 2.
    • Client hébergé
      Spécifie le client hébergé qui s'applique à l'importation (si vous utilisez l'hébergement multiclient).
      Vous pouvez sélectionner un client hébergé uniquement lorsque l'hébergement multiclient est activé dans CA APM et que vous êtes autorisé à accéder à différents clients hébergés. Si vous disposez de l'accès aux données publiques et que vous disposez de plusieurs clients hébergés, vous pouvez sélectionner tous les clients hébergés.
      Si vous spécifiez tous les clients hébergés, votre fichier de données sources doit contenir une colonne de nom des clients hébergés que vous mappez vers le champ Nom du client hébergé.
      Si vous spécifiez un seul client hébergé, vérifiez que toutes les données de votre fichier de données sources appartiennent au client hébergé sélectionné.
      Si vous disposez de données pour plusieurs clients hébergés, les données de tous les clients hébergés sont importées dans le client hébergé sélectionné.
    • Délimiteur de données
      Permet de spécifier le délimiteur (par exemple, une virgule ou une tabulation) utilisé dans le fichier de données sources.
      Si une valeur de données de votre fichier de données sources contient le délimiteur sélectionné, vous devez placer cette valeur entre guillemets. Par exemple, vous sélectionnez une virgule comme délimiteur pour l'importation de sociétés. Vous souhaitez inclure la valeur de données Document Management Company, Inc. dans le fichier de données sources. Spécifiez cette valeur de données entre guillemets :
      "Document Management Company, Inc"
    • Paramètres régionaux du fichier de données
      Spécifie les paramètres régionaux pour le fichier de données sources. Ce paramètre détermine le format de date et d'heure.
  5. Entrez les informations requises dans la zone Paramètres avancés et d'autres informations facultatives si nécessaire. Les champs suivants doivent faire l'objet d'une explication :
    • Seuil d'erreur maximum (en %)
      Permet de définir le nombre d'erreurs entraînant l'interruption de l'importation. Le seuil est basé sur le pourcentage d'enregistrements traités. Il est recommandé d'utiliser un seuil minimum de 15 %.
      L'importateur de données traite le nombre d'enregistrements spécifiés dans Administration, Configuration du système, Importateur de données (champ Taille maximum de l'enregistrement du lot) avant de déterminer si le seuil d'erreur a été atteint.
    • Type de traitement appliqué à l'objet de recherche principale
      Permet de spécifier le type d'activité d'importation (par exemple, insertion ou mise à jour).
    • Créer un objet de recherche secondaire
      Permet de créer des objets de recherche secondaire lors du processus d'importation. Si cette option n'est pas sélectionnée et qu'un objet secondaire n'existe pas, une erreur se produira.
    • Mettre à jour l'objet de recherche secondaire
      Permet de mettre à jour les objets de recherche secondaire existants lors du processus d'importation. Si aucun objet secondaire n'existe, une erreur se produira.
    • Erreur liée à des erreurs d'objet de recherche secondaire
      Indique qu'en cas d'échec du processus de l'objet secondaire, l'importateur de données ne traitera pas l'insertion ou la mise à jour d'un objet principal. Si l'insertion ou la mise à jour d'un objet secondaire échoue et que cette case à cocher est sélectionnée, l'insertion ou la mise à jour de l'objet principal échouera également. Si cette case à cocher n'est pas sélectionnée, l'objet principal sera créé ou mis à jour (à condition qu'il ne soit pas dépendant d'un objet secondaire). Toutefois, la valeur de l'objet secondaire n'est ni créée ni modifiée. Dans les deux cas, l'erreur de l'objet secondaire sera journalisée dans le fichier journal d'importation.
      Exemple
      : vous importez un emplacement et celui-ci comprend un pays. Si l'importation échoue lors de la tentative de mise à jour de l'objet pays et que cette case à cocher est sélectionnée, l'enregistrement de l'emplacement ne sera pas créé. Si cette case à cocher n'est pas sélectionnée, l'enregistrement de l'emplacement sera créé et les informations sur le pays ne seront pas mises à jour.
    • Comportement de normalisation
      Spécifie si vous souhaitez normaliser les données ou écrire un message d'erreur dans le fichier journal sans effectuer de normalisation.
      Ce champ apparaît uniquement si vous avez défini des règles de normalisation.
      • Erreur lors la normalisation
        Permet d'écrire un message d'erreur dans le fichier journal de l'importateur de données lorsque des données pouvant faire l'objet d'une normalisation sont comprises dans les données que vous importez. Les données concernées ne sont pas importées. Le message d'erreur du fichier journal comprend les informations sur les données.
        Par exemple, vos données incluent le nom de société Microsoft. Les règles de normalisation de société créées permettent d'identifier Microsoft comme valeur collectée (ne faisant pas autorité) et de spécifier Microsoft Corporation comme valeur normalisée (faisant autorité). Si vous sélectionnez cette option lors de l'importation des données, l'objet portant le nom de société Microsoft ne sera pas importé et un message d'erreur sera écrit dans le fichier journal.
      • Appliquer la normalisation sans erreur
        Permet d'utiliser les règles de normalisation pour normaliser les données que vous importez. Si des données pouvant être normalisées sont disponibles, elles seront normalisées et importées. Aucun message d'erreur sur les données ne sera écrit dans le fichier journal.
        Par exemple, vos données incluent le nom de société Microsoft. Les règles de normalisation de société créées permettent d'identifier Microsoft comme valeur collectée (ne faisant pas autorité) et de spécifier Microsoft Corporation comme valeur normalisée (faisant autorité). Si vous sélectionnez cette option lors de l'importation des données, l'objet portant le nom de société Microsoft sera normalisé. Dans cet exemple, le nom de société est remplacé par Microsoft Corporation et l'objet associé est importé.
  6. Cliquez sur Enregistrer.
    L'importation est enregistrée. Les zones Mappage, Filtre d'exclusion et Planification de la page sont maintenant disponibles pour la saisie de données.
Exemple : Création d'une importation de données des nouveaux employés à partir d'un fichier de données
Sam est l'administrateur système de CA APM et effectue les actions suivantes pour créer l'importation de données :
  1. Elle accède à Administration, Importateur de données et clique sur Nouvelle importation.
  2. Il saisit New Employees.csv dans le champ Fichier de données.
    Ce fichier CSV est le fichier de données sources que Sam a reçu du service des Ressources humaines avec les informations sur les nouveaux employés.
  3. Il sélectionne Contact pour l'objet de destination principal et la virgule comme délimiteur de données.
  4. Il sélectionne Insérer ou Mettre à jour dans le champ Type de traitement appliqué à l'objet de recherche principale, puis clique sur Enregistrer.
Création d'une importation de données à partir d'un fichier de mappage hérité
Vous pouvez créer une importation de données à l'aide d'un fichier de mappage hérité d'une version antérieure de CA APM. Le fichier de mappage définit le fichier de données correspondant et les paramètres d'importation.
Il est recommandé de copier vos fichiers de mappage hérités et les fichiers de données correspondants sur le serveur d'applications CA APM avant de créer les importations de données. Toutefois, si nécessaire, vous pouvez suivre la procédure facultative pour charger un fichier de mappage hérité.
Vous pouvez également créer une importation de données uniquement à l'aide d'un fichier de données. Pour plus d'informations, reportez-vous à la section Création d'une importation de données à partir d'un fichier de données.
Procédez comme suit :
  1. Cliquez sur Administration, Importateur de données, Nouvelle importation.
  2. Cliquez sur Rechercher et charger un mappage pour sélectionner un fichier de mappage hérité déjà disponible sur le serveur d'applications CA APM.
    Le fichier de données correspondant doit également être disponible sur le serveur d'applications CA APM.
    Si le fichier de mappage hérité n'est pas disponible sur le serveur d'applications CA APM, chargez-le à l'aide du champ Charger le fichier.
  3. (Facultatif) Pour charger un fichier de mappage hérité non disponible sur le serveur d'applications CA APM, procédez comme suit :
    1. Dans le champ Charger le fichier, accédez à votre serveur local et sélectionnez un fichier de mappage hérité.
      Le fichier de mappage hérité est chargé et s'affiche dans le champ Charger le fichier.
    2. Cliquez sur Rechercher et charger un mappage et sélectionnez le fichier de mappage hérité que vous venez de charger.
      Le fichier de mappage hérité s'affiche dans le champ Fichier de mappage hérité.
      Les informations de base sont chargées.
    Si vous recevez un avertissement concernant le fichier de données sources, chargez le fichier de données à l'aide du champ Charger le fichier.
  4. Spécifiez les paramètres avancés et cliquez sur Enregistrer.
    Le filtre d'exclusion et le mappage de données sont chargés. Les zones Mappage, Filtre d'exclusion et Planification de la page sont maintenant disponibles pour la saisie de données. Les zones Mappage et Filtre d'exclusion contiennent les données du fichier de mappage hérité.
    Pour obtenir des informations sur la spécification des paramètres avancés, reportez-vous à la section Création d'une importation de données à partir d'un fichier de données.
Mappage de colonnes de fichier de données vers des champs de données
Vous pouvez mapper les colonnes du fichier de données sources vers les champs de CA APM. Effectuez le mappage de colonnes pour spécifier l'emplacement d'importation de la source de données. Vous pouvez sélectionner la plupart des objets et des champs associés comme champs de destination lors du mappage de colonnes.
Si vous avez créé une importation de données à partir d'un fichier de mappage hérité, le mappage de colonnes sera disponible. Si vous souhaitez modifier les valeurs, vous pouvez modifier les règles du mappage existant. Vous pouvez également ajouter ou supprimer des filtres et des règles de mappage.
Lorsque vous vous connectez, le rôle d'utilisateur affecté par votre administrateur permet de déterminer les objets et les champs que vous pouvez afficher et utiliser. Si votre rôle spécifie que vous ne disposez pas d'autorisations pour un champ d'objet, ce champ ne sera pas disponible pour un mappage. Vous pouvez créer un mappage et importer des données uniquement pour les objets et les champs pour lesquels vous disposez d'autorisations.
Avant de mapper les données, consultez l'interface utilisateur de CA APM afin de déterminer les informations requises pour le mappage. Par exemple, consultez la page Actif pour vérifier que le nom de l'actif, la famille d'actifs, le modèle et la classe sont obligatoires. Un modèle est requis pour créer un actif. Vous devez donc vérifier la page de modèle pour déterminer si le nom de modèle et la famille d'actifs sont obligatoires. Vérifier l'interface utilisateur avant de créer un mappage vous permet de confirmer que vous disposez de toutes les informations requises pour cette opération.
Procédez comme suit :
  1. Dans l'onglet Administration, page Importateur de données, accédez à la zone Mappage d'une importation sélectionnée, cliquez sur Nouveau ou sur Charger les champs sources.
    • L'option Créer permet de sélectionner les champs sources spécifiques à partir du fichier de données sources.
    • L'option Charger les champs sources permet d'ajouter tous les champs sources à partir du fichier de données sources.
    Si vous disposez déjà de mappages, l'option Charger les champs sources permet de les remplacer par les champs sources du fichier de données sources. Cette option permet également d'ajouter les champs sources à partir du fichier de données sources non encore disponibles dans vos mappages.
    1. Si vous avez cliqué sur Charger les champs sources, cliquez sur l'icône Modifier un enregistrement située près d'un champ.
  2. Cliquez sur l'icône Sélectionner près du champ source (si ce champ est vide), sélectionnez une colonne dans votre source de données et cliquez sur OK.
    Si ce champ contient déjà un champ source (en cas de chargement préalable de l'ensemble des champs de sources), vous pouvez ignorer cette étape.
    Les signes de pourcentage qui s'affichent avant et après les noms de colonnes permettent d'identifier les en-têtes de colonne dans votre fichier de données sources. Vous pouvez également spécifier une valeur codée de manière irréversible dans le champ source que vous souhaitez appliquer à tous les enregistrements de votre fichier de données sources. Vous pouvez ensuite mapper la valeur codée de manière irréversible vers un champ Destination. Les valeurs codées de manière irréversible ne s'affichent pas entre des signes de pourcentage afin de les distinguer des noms de colonne du fichier de données sources. Pour plus d'informations, reportez-vous à la section Valeurs codées de manière irréversible.
  3. Cliquez sur l'icône Sélectionner près du champ Destination, sélectionnez un champ de destination pour le champ Source sélectionné et cliquez sur OK.
    Les champs de destination qui s'affichent dépendent de l'objet de destination principal sélectionné.
    Les champs de destination s'affichent par ordre hiérarchique. Par exemple, les champs répertoriés sous Hiérarchie des types d'actif sont Famille d'actifs, Classe et Sous-classe. L'ordre des champs dans la liste représente la hiérarchie des champs. Suivez cette hiérarchie lors de la spécification de règles de mappage. Par exemple, pour Hiérarchie des types d'actif, spécifiez une règle pour la classe avant de spécifier la sous-classe.
  4. Sélectionnez les cases à cocher Recherche principale et Recherche secondaire si nécessaire.
    1. Sélectionnez une case à cocher Recherche principale pour chaque champ de destination que vous souhaitez utiliser pour rechercher l'objet principal. Suivez les directives suivantes lorsque vous sélectionnez cette case à cocher :
      • Sélectionnez au moins une case à cocher Recherche principale dans le mappage de colonnes d'une importation.
      • Ne sélectionnez pas cette case à cocher si le champ de destination est Texte de la note (sous l'objet Note). Le type de données de base de données du champ Texte de la note ne lui permet pas de fonctionner comme champ de recherche.
    2. Sélectionnez une case à cocher Recherche secondaire pour chaque champ de destination que vous souhaitez utiliser pour rechercher les objets secondaires. Suivez les directives suivantes lorsque vous sélectionnez cette case à cocher :
      • Ne sélectionnez pas cette case à cocher si le champ de destination n'est pas un champ de recherche de l'objet secondaire.
      • Ne sélectionnez pas cette case à cocher si le champ de destination est Texte de la note (sous l'objet Note). Le type de données de base de données du champ Texte de la note ne lui permet pas de fonctionner comme champ de recherche.
  5. Cliquez sur l'icône Terminer la modification de l'enregistrement.
  6. Pour spécifier des règles de mappage supplémentaires, cliquez à nouveau sur Créer ou sur l'icône Modifier un enregistrement située près d'un autre champ source.
    Pour supprimer une règle de mappage de la liste des colonnes mappées, cliquez sur l'icône Suppression près de la règle de mappage. La règle de mappage de colonne est supprimée de la liste.
  7. Cliquez sur Enregistrer.
    Le mappage de colonnes est enregistré.
Exemple : mappage de colonnes d'un fichier de données vers des champs de données
Sam effectue les opérations suivantes pour mapper les colonnes du fichier de données sources vers les champs de données CA APM :
  1. Elle clique sur Créer dans la zone Mappage de la page Détails de l'importation.
  2. Il sélectionne
    %ID_connexion%
    dans Champ source en cliquant sur l'icône Sélectionner à côté du champ source et en sélectionnant cet élément dans la boîte de dialogue.
    Les éléments répertoriés dans la boîte de dialogue sont les colonnes du fichier de données sources.
  3. Il clique sur l'icône Sélectionner près du champ Destination pour sélectionner l'objet ID d'utilisateur dans la boîte de dialogue.
  4. Elle sélectionne la case à cocher Recherche principale.
  5. Il poursuit le mappage des colonnes restantes du fichier de données sources avec les champs de données CA APM et clique sur Enregistrer une fois terminé.
Vérification des composants de référence de mappage
Référencez les informations suivantes lorsque vous configurez le mappage de colonnes pour l'importation ou la suppression des données.
Combinaisons de recherche principale et secondaire
Les champs que vous sélectionnez en tant qu'élément de recherche principale et secondaire dans le mappage de colonnes sont utilisés pour rechercher des données dans la base de données de produit.
  • Mappage simple
    Dans un mappage simple, vous spécifiez uniquement l'élément de recherche principal. Par exemple, vous importez ou supprimez un ensemble d'enregistrements de la société à partir d'un fichier texte dans la base de données du produit. Vous spécifiez le nom de société comme élément de recherche principal. Si une société avec un nom particulier n'existe pas dans la base de données lorsque vous importez des données, un enregistrement est créé pour la société. Le tableau suivant présente un exemple de recherche pour un mappage simple.
Champ source
Champ de destination
Recherche principale
Recherche secondaire
%Nom de la société%
société.nom_société
Oui
Non
  • Mappage de champ de référence
    Dans un mappage de champ de référence, vous spécifiez les valeurs des éléments de recherche principal et secondaire. Pour rechercher un objet unique, spécifiez plusieurs éléments de recherche principaux. Par exemple, pour rechercher une société, vous pouvez spécifier son nom, la société mère et le type de société comme éléments de recherche principaux. Dans cet exemple, l'importateur de données recherche une société avec le nom, la société mère et le type de société spécifiés. Si l'objet n'existe pas et que vous importez des données, l'enregistrement est créé (en fonction de l'option d'insertion ou de mise à jour sélectionnée dans les paramètres avancés). Le tableau suivant présente un exemple de recherche pour le mappage de champ de référence.
Champ source
Champ de destination
Recherche principale
Recherche secondaire
%Nom de la société%
société.nom_société
Oui
Non
%Société mère%
société.société_mère.nom_société
Oui
Oui
%Type de société%
société.type de société.valeur
Oui
Oui
Les cases à cocher Recherche principale et Recherche secondaire sont sélectionnées pour ce mappage pour la société mère et le type de société. L'importateur de données utilise le nom de société pour rechercher la société mère et utilise la société mère pour rechercher le nom de société.
  • Mappage d'objets secondaires
    Si une règle de mappage mappe vers une propriété d'objet secondaire, les valeurs de recherche principale établissent une relation entre un objet secondaire et les champs de référence. Le tableau suivant présente des exemples de recherche pour le mappage d'objets secondaires.
Champ source
Champ de destination
Recherche principale
Recherche secondaire
%Commentaire%
document_juridique.partie_juridique.commentaire
Non
Oui
%ID du document juridique%
document_juridique.ID_document
Oui
Non
%Nom de la société%
document_juridique.partie_juridique.partie_juridique.nom_société
Oui
Oui
%Modèle juridique%
document_juridique.modèle_juridique.modèle
Oui
Oui
Dans la première règle de mappage, Document juridique est l'objet principal et Partie juridique est l'objet secondaire. Commentaire est une propriété de Partie juridique.
Dans la troisième règle de mappage, Document juridique est l'objet principal et Partie juridique est l'objet secondaire. En outre, la partie juridique a un champ de référence dans la table Société. La case Recherche secondaire indique que le nom de la société est utilisé pour rechercher l'objet Société. La case Recherche principale indique que l'objet Société est utilisé pour rechercher l'objet Partie juridique.
Valeurs codées de manière irréversible
Dans le mappage de colonnes, les signes de pourcentage qui s'affichent avant et après les noms de colonnes permettent d'identifier les en-têtes de colonne dans votre fichier de données sources. Vous pouvez également spécifier une valeur codée de manière irréversible dans le champ source que vous souhaitez appliquer à tous les enregistrements de votre fichier de données sources. Vous pouvez ensuite mapper la valeur codée de manière irréversible vers un champ Destination. Les valeurs codées de manière irréversible ne s'affichent pas entre des signes de pourcentage afin de les distinguer des noms de colonne du fichier de données sources.
Hard_coded_values.PNG
  1. En-tête de colonne du fichier de données sources
  2. Valeur codée de manière irréversible
Vous pouvez définir une valeur codée de manière irréversible dans le champ source pour développer les données sources et vous assurer que vous incluez tous les champs obligatoires. Les valeurs codées de manière irréversible ne commencent et ne se terminent généralement pas par un signe de pourcentage (%). Si vous avez des valeurs codées de manière irréversible avec des signes de pourcentage, les valeurs ne peuvent pas correspondre aux noms de champ dans votre fichier de données sources.
Exemple : utilisation des valeurs codées de manière irréversible pour la famille d'actifs
Dans cet exemple, les actifs de votre fichier de données sources ne contiennent pas de famille d'actifs, bien qu'elle soit nécessaire pour la création d'actif. Vous pouvez ajouter une valeur codée de manière irréversible à votre mappage. Si tous les actifs sont matériels, vous pouvez entrer Matériel dans le champ source. Vous pouvez mapper cette valeur dans le champ Famille d'actifs. Si vos actifs appartiennent à des familles différentes, ajoutez une colonne à votre fichier de données sources avec les familles d'actifs correspondantes avant d'importer ou de supprimer des données.
Les informations suivantes illustrent la différence entre les valeurs de votre fichier de données sources et les valeurs ajoutées via des valeurs codées de manière irréversible :
  • Vous disposez d'une colonne Famille d'actifs dans votre fichier de données sources. La sélection dans le champ source est %Famille d'actifs%.
Vous n'avez aucune colonne Famille d'actifs dans votre fichier de données sources. Toutefois, tous vos actifs sont des actifs matériels. Vous spécifiez la valeur codée de manière irréversible Matériel dans le champ source.
Vous pouvez également utiliser l'objet de destination principal pour indiquer que tous les enregistrements du fichier de données sources appartiennent à une famille ou à un modèle. Par exemple, la sélection d'actif (Matériel) pour l'objet de destination principal indique que tous les enregistrements sources appartiennent à la famille d'actifs Matériel.
Valeurs multiples pour un champ unique
Vous pouvez ajouter un mappage avec plusieurs valeurs de champs sources mappés vers un champ de destination unique.
Exemple : utilisation de plusieurs valeurs pour un champ unique
Les fichiers de données sources comportent deux colonnes : Fabricant et Nom du catalogue. Combinez ces colonnes en les sélectionnant dans le champ source. Dans cet exemple, la sélection du champ source est %Fabricant% %Nom du catalogue%.
Vous pouvez également entrer plusieurs valeurs codées de manière irréversibles dans le champ source. Par exemple : Document Management Company %Nom du modèle% Département informatique).
Filtrage des données dans l'importation
Vous pouvez identifier un sous-ensemble d'enregistrements dans le fichier de données sources à exclure de l'importation. Le filtre d'exclusion de l'importateur de données permet de filtrer une partie de votre source de données à l'aide de règles de filtre d'exclusion.
Exemple : définition d'un filtre d'exclusion pour le traitement d'actifs renvoyés
Un fichier CSV que vous recevez de votre fournisseur de matériel comprend les actifs commandés et renvoyés au fournisseur. Vous souhaitez traiter uniquement les actifs renvoyés ; vous souhaitez donc importer des données pour mettre à jour uniquement ces enregistrements. Vous définissez un filtre d'exclusion pour exclure les enregistrements dont le statut n'est pas défini sur Renvoyé.
Procédez comme suit :
  1. Dans l'onglet Administration, page Importateur de données, zone Filtre d'exclusion d'une importation sélectionnée, sélectionnez Type de filtre.
    • Et
      Exclut un enregistrement du fichier de données sources uniquement si toutes les règles spécifiées sont valides pour l'enregistrement.
    • OU
      Exclut un enregistrement du fichier de données sources si l'une des règles spécifiées est valide pour l'enregistrement.
  2. Cliquez sur Nouveau.
  3. Cliquez sur l'icône Sélectionner près du champ Source, sélectionnez une colonne dans votre fichier de données sources et cliquez sur OK.
    Les signes de pourcentage placés avant et après les noms de colonne permettent de les identifier comme colonnes de votre fichier de données sources.
  4. Sélectionnez l'opérateur.
    Pour spécifier l'opérateur non égal à, sélectionnez les signe <>.
  5. Entrez une valeur de filtre pour la règle.
    Vous pouvez utiliser des caractères spéciaux et des caractères génériques dans la valeur de filtre. Les règles peuvent traiter des champs de texte, numériques et de date.
  6. Cliquez sur l'icône Terminer la modification de l'enregistrement.
  7. (Facultatif) Cliquez sur Créer et spécifiez des règles de filtre d'exclusion supplémentaires.
  8. Cliquez sur Enregistrer.
    Les règles de filtre d'exclusion sont enregistrées et appliquées lors de l'exécution de l'importation.
Exemple : Création d'un filtre d'exclusion
Sam applique la procédure suivante pour créer un filtre d'exclusion. Le filtre permet de supprimer les employés qui ne travaillent pas pour le service informatique ni au siège de la société de l'importation de données.
  1. Il sélectionne Et comme type de filtre et clique sur Créer dans la zone Filtre d'exclusion de la page Détails de l'importation.
  2. Il sélectionne
    %Département%
    pour le champ Source.
  3. Il sélectionne <> comme opérateur.
  4. Il saisit IT comme valeur de filtre.
  5. Il clique sur l'icône Terminer la modification de l'enregistrement, puis sur Créer.
  6. Il sélectionne %Emplacement% pour le champ Source.
  7. Il sélectionne <> comme opérateur.
  8. Il saisit Siège comme valeur de filtre.
  9. Il clique sur l'icône Terminer la modification de l'enregistrement, puis sur Enregistrer.
Soumission de l'importation
Pour lancer une importation immédiatement, cliquez sur Soumettre dans la zone Planification de la page. Les enregistrements de source de données du fichier de données pour l'importation sélectionnée sont traités.
Si vous souhaitez utiliser un fichier de données autre que le fichier par défaut (à partir des informations de base), vous pouvez le spécifier.
Vous pouvez également planifier l'importation pour un jour et une heure spécifiques. Pour plus d'informations, reportez-vous à la section Planification de l'importation.
Pour afficher les jobs pour l'importation actuellement sélectionnée, cliquez sur Jobs associés dans la partie gauche de la page. Pour afficher tous les jobs pour toutes les importations, cliquez sur Jobs d'importation dans la partie gauche de la page. Dans la liste des jobs d'importation qui s'affiche, cliquez sur Message de statut pour afficher le statut d'une importation.
Pour plus d'informations sur l'activité d'importation, vous pouvez également afficher le fichier journal. Dans la liste des jobs d'importation, cliquez sur Afficher les journaux pour l'importation sélectionnée.
Planification de l'importation
Vous pouvez planifier une importation à une heure spécifique et spécifier l'intervalle d'importation (par exemple, quotidienne ou hebdomadaire). Vous pouvez planifier le traitement simultané de plusieurs importations.
Procédez comme suit :
  1. Dans l'onglet Administration, page Importateur de données, zone Planification d'une importation sélectionnée, sélectionnez la case à cocher Planifié.
  2. Renseignez les informations de la planification. Les champs suivants doivent faire l'objet d'une explication :
    • Heure d'exécution
      Spécifie l'heure du jour, au format 24 heures, pour le traitement de l'importation. Lorsque vous planifiez des importations, utilisez le fuseau horaire local du serveur d'applications CA APM.
    • Jour d'intervalle
      Spécifie le jour pour le type d'intervalle pour le traitement de l'importation. Par exemple, si le type d'intervalle est Mois et le jour d'intervalle est défini sur 1, l'importation sera traitée le premier jour du mois.
    • Fichier de données
      Permet de spécifier un nom de fichier de données différent de la valeur par défaut (à partir des informations de base) si vous souhaitez utiliser un autre fichier.
      Si ce fichier est disponible sur le serveur d'applications, vous pouvez le rechercher et le sélectionner. Si ce fichier n'est pas disponible sur le serveur d'applications, vous pouvez le rechercher et le charger.
    • Charger le fichier de données
      Recherchez le fichier de données sources que vous voulez importer. Ce fichier est chargé sur le serveur d'applications.
    • Date de la première exécution
      Spécifie la date de début du traitement de la première importation.
    • Type d'intervalle
      Spécifie le type d'intervalle de l'importation (par exemple, jour, mois, trimestre, semaine ou année).
    • Interval
      Spécifie la fréquence de traitement de l'importation. Cet intervalle est basé sur le type d'intervalle spécifié. Par exemple, si le type d'intervalle est Hebdomadaire et la fréquence est définie sur 2, l'importation aura lieu toutes les deux semaines.
    • Dernier jour de l'intervalle
      Spécifie que l'importation a lieu le dernier jour du type d'intervalle sélectionné. Si vous sélectionnez cette case à cocher, toutes les valeurs précédentes ajoutées au champ Jour d'intervalle seront supprimées et ce champ sera désactivé.
  3. Cliquez sur Soumettre.
    L'importation de données est planifiée pour les date et heure spécifiées.
Exemples : utilisation des paramètres de planification
Les exemples suivants illustrent l'utilisation des paramètres de planification.
  • Sélectionnez Jour comme type d'intervalle et définissez l'intervalle sur 2. L'importation a lieu tous les deux jours.
  • Sélectionnez Semaine comme type d'intervalle, définissez le jour d'intervalle sur 1 et l'intervalle sur 3. L'importation a lieu toutes les trois semaines, le premier jour de la semaine (dimanche).
  • Sélectionnez Mois comme type d'intervalle, définissez le jour d'intervalle sur 15 et l'intervalle sur 2. L'importation a lieu tous les deux mois, le 15e jour du mois.
  • Sélectionnez Trimestre comme type d'intervalle et sélectionnez Dernier jour de l'intervalle. L'importation aura lieu tous les trimestres (tous les trois mois), le dernier jour du dernier mois du trimestre.
  • Sélectionnez Année comme type d'intervalle, définissez le jour d'intervalle sur 1 et l'intervalle sur 1. L'importation a lieu le 1er janvier de chaque année.
Pour afficher les jobs pour l'importation actuellement sélectionnée, cliquez sur Jobs associés dans la partie gauche de la page. Pour afficher tous les jobs pour toutes les importations, cliquez sur Jobs d'importation dans la partie gauche de la page. Dans la liste des jobs d'importation qui s'affiche, cliquez sur Message de statut pour afficher le statut d'une importation.
Pour plus d'informations sur l'activité d'importation, vous pouvez également afficher le fichier journal. Dans la liste des jobs d'importation, cliquez sur Afficher les journaux pour l'importation sélectionnée.
Affichage des détails de la planification
Vous pouvez afficher les détails de la planification d'un job d'importation planifié que vous avez créé.
Ouvrez la liste des jobs d'importation.
  • Pour afficher les jobs planifiés pour l'importation actuellement sélectionnée, cliquez sur Jobs associés dans la partie gauche de la page, sélectionnez la case Planifié, puis cliquez sur OK.
  • Pour afficher tous les jobs pour toutes les importations, cliquez sur Jobs d'importation dans la partie gauche de la page, sélectionnez la case Planifié et cliquez sur OK.
Dans la liste des jobs d'importation qui s'affiche, cliquez sur Détails de la planification pour l'importation sélectionnée.
Affichage des fichiers journaux d'importation
Vous pouvez afficher les fichiers journaux de l'importateur de données pour afficher les détails de toutes les importations fournies par CA ou définies par l'utilisateur qui se sont terminées. L'importateur de données crée un fichier journal pour chaque importation que vous exécutez, y compris les importations qui ont été soumises immédiatement ou planifiées à une date ultérieure. Toutes les activités d'importation sont enregistrées dans les fichiers journaux.
Pour afficher les fichiers journaux, ouvrez la liste des jobs d'importation.
  • Pour afficher les jobs pour l'importation actuellement sélectionnée, cliquez sur Jobs associés dans la partie gauche de la page.
  • Pour afficher tous les jobs pour toutes les importations, cliquez sur Jobs d'importation.
Dans la liste des jobs d'importation, cliquez sur Afficher les journaux pour l'importation sélectionnée. Si plusieurs fichiers journaux sont indisponibles (par exemple, pour une importation planifiée effectuée plusieurs fois), tous les fichiers sont répertoriés avec leurs dates de création correspondantes.
Vous pouvez afficher tous les fichiers journaux de synchronisation d'importation LDAP disponibles. Si vous cliquez sur Démarrer l'importation et la synchronisation des données LDAP dans la page Importation et synchronisation des données LDAP (Administration, Gestion des utilisateurs et des rôles), un ID de job d'importation s'affiche. Utilisez cet ID de job pour localiser le job dans la liste des jobs d'importation de l'importateur de données. Cliquez ensuite sur Afficher les journaux pour ce job.
Vous pouvez également localiser et afficher les fichiers journaux d'importation dans l'emplacement suivant sur le serveur d'applications CA APM :
[ITAM Root Path]\Storage\Common Store\Import\Logs
Vérification du fichier journal d'importation - Meilleures pratiques
Le fichier journal de l'importateur de données contient des messages d'erreur et des informations concernant le traitement des jobs d'importation. Pour vous aider à comprendre les résultats de l'importation et corriger les erreurs, utilisez les informations de ce fichier journal. Cette section contient certaines recommandations sur l'utilisation du fichier journal de l'importateur de données.
Mise en correspondance du numéro de ligne dans le fichier de données avec le message d'erreur dans le fichier journal.
Un message d'erreur de fichier journal identifie le numéro de ligne correspondante dans le fichier de données. Vous trouverez également le numéro de ligne de fichier de données dans la ligne au-dessus ou en dessous du message d'erreur dans le fichier journal.
Parfois, le message d'erreur du fichier journal n'affiche pas le numéro de ligne du fichier de données. Dans ce cas, les valeurs de fichier de données sont affichées immédiatement après le message d'erreur dans le fichier journal.
Nombre de messages d'erreur dans le fichier journal
  1. Recherchez les expressions suivantes dans le fichier journal pour identifier les messages d'erreur dans le fichier. Ces expressions sont incluses dans les messages d'erreur.
    Web Service threw exception Error at record
  2. Après avoir déterminé le type de message d'erreur, recherchez l'erreur dans le fichier journal et comptez le nombre d'occurrences.
  3. Identifiez et recherchez les autres types d'erreur qui s'affichent dans le fichier journal et comptez le nombre d'occurrences.
  4. Comparez le nombre d'erreurs dans le fichier journal avec les statistiques que l'importateur de données a généré pour l'importation correspondante. Pour afficher ces statistiques, cliquez sur Message de statut dans la liste Jobs associés ou Jobs d'importation. Cette comparaison vous permet d'identifier toutes les erreurs pertinentes et les messages d'erreur qui ne sont pas valides et peuvent être ignorés.
Vérification des données importées
Vérifiez que l'importation de données s'est correctement effectuée en affichant les données dans CA APM et en examinant les statistiques de l'importateur de données.
  • Consultez les statistiques de l'importateur de données.
    Pour consulter les statistiques de l'importation actuellement sélectionnée, cliquez sur Jobs associés dans la partie gauche de la page. Dans la liste des jobs d'importation qui s'affiche, cliquez sur Message de statut pour afficher le statut d'une importation.
    Pour plus d'informations sur l'activité d'importation, vous pouvez également afficher le fichier journal. Dans la liste des jobs d'importation, cliquez sur Afficher les journaux pour l'importation sélectionnée.
  • Affichez les données importées dans CA APM.
    Pour afficher les données importées, accédez à l'onglet et au sous-onglet, si nécessaire, de l'objet importé (par exemple : un actif, une société ou un contact). Recherchez les objets importés et vérifiez qu'ils sont disponibles.
Exemple : vérification de l'importation des données sur les nouveaux employés
A l'issue de l'exécution de l'importation, Sam applique la procédure suivante pour vérifier l'importation des données sur les nouveaux employés :
  1. Elle vérifie les statistiques de l'importation.
    • Elle clique sur Jobs associés ou sur Jobs d'importation dans la partie gauche de la page Importateur de données.
    • Il clique sur Message de statut pour l'importation et consulte les statistiques.
  2. Elle affiche le fichier journal de l'importation et l'interface utilisateur.
    • Elle clique sur Afficher les journaux dans la liste des jobs d'importation et consulte le contenu du fichier journal.
    • Dans l'interface utilisateur de CA APM, il accède à Répertoire, Contact. Il recherche les nouveaux employés. Il vérifie que les employés qui ne travaillent pas au département informatique ni au siège de la société ne sont pas disponibles.