Préchargement de l’inventaire

Le réglage Préchargement de l'inventaire vous permet de téléverser les données d'inventaire des ordinateurs et des appareils mobiles avant l’enrôlement des appareils. Les données préchargées seront appliquées aux ordinateurs et aux appareils mobiles lorsque l'inventaire sera recueilli en fonction d'un numéro de série correspondant. Les données de l’utilisateur seront appliquées dès qu’un fichier de valeurs séparées par des virgules (CSV) sera téléversé.

Important :

Les valeurs du fichier CSV doivent être séparées par des virgules. Séparer les valeurs du fichier CSV en utilisant d’autres caractères, par exemple des points-virgules, entraînera des erreurs.

Les données du fichier CSV téléversé prévalent sur les données Jamf Pro existantes selon les priorités suivantes :

  • Les données remplacent tous les enregistrements de données actives existants si des numéros de série en double sont trouvés.

  • Les données prévalent sur les données de l’appareil LDAP si LDAP est configuré.

Les données préchargées sont utilisées en permanence pour mettre à jour les rapports d’inventaire des appareils dans Jamf Pro lorsque l'inventaire est collecté. Par exemple, les rapports d’inventaire des appareils sont mis à jour lors des événements suivants :

  • Lors de le téléversement d'un fichier CSV avec un appareil unique et un ensemble de données d'appareil. Lors de la prochaine collecte d’inventaire et de la prochaine mise à jour de l’appareil spécifié dans Jamf Pro, l’inventaire sera mis à jour avec les données Préchargement de l’inventaire.

  • Lors de l’upload d'un autre fichier CSV pour le même appareil unique mais avec un autre un ensemble de données d'appareil. Lors de la prochaine collecte d’inventaire et de la prochaine mise à jour de l’appareil spécifié dans Jamf Pro, l’inventaire sera mis à jour avec les données Préchargement de l’inventaire.

Le processus de collecte de l'inventaire s'exécute après l'enrôlement ou selon la fréquence définie dans les réglages Collecte d'inventaire. Pour plus d’informations, consultez les sections suivantes de ce guide :

Important :

Lorsque vous utilisez l’option Préchargement de l’inventaire, toutes les modifications manuelles ou mises à jour en masse des détails d'inventaire des ordinateurs et appareils mobiles dans Jamf Pro seront remplacées par les données Préchargement de l’inventaire lorsque la collecte d'inventaire est lancée.

Le tableau suivant indique les champs valides pour l’upload du fichier CSV de préchargement de l’inventaire :

Champ

Ordinateurs

Appareils mobiles

Numéro de série(obligatoire)

Type d'appareil (obligatoire)

Remarque :

Seules deux valeurs sont valides : « Ordinateur » ou « Appareil mobile »

Nom d’utilisateur

Nom complet

Adresse électronique

Numéro de téléphone

Poste

Département

Bâtiment

Salle

Numéro de bon de commande

Date du bon de commande

Expiration de la garantie

Identifiant AppleCare

Prix d’achat

Espérance de vie

Compte d’achat

Contact d’achat

Expiration de la location

Code-barre 1

 

Code-barre 2

 

Étiquette d’inventaire

Fournisseur

Attributs d'extension (pour plus d'informations, voir la section « Attributs d'extension » ci-dessous).

Le modèle CSV disponible au téléchargement sur la page Préchargement de l’inventaire contient tous les champs pris en charge.

Exemple de workflow

L'exemple suivant décrit comment téléverser les données d'un appareil mobile à l'aide de l’option Préchargement de l’inventaire, comment mettre à jour les rapports d'inventaire Jamf Pro, et comment mettre à jour les données d'inventaire en téléversant d’autres fichiers CSV.

  1. Un fichier CSV avec le contenu suivant est téléversé à l'aide de l’option Préchargement de l'inventaire :

    Numéro de série

    Type d’appareil

    Nom d’utilisateur

    Bâtiment

    Département

    C8PLK8CLFM

    Appareil mobile

    wcrandall

    Hopkins Hall

    Psychologie

  2. Lorsque le numéro de série de l'appareil mobile « C8PLK8CLFM » est enrôlé, les événements suivants se produisent :
    • L'appareil mobile est affecté à l'utilisateur « wcrandall ».

    • Le champ Bâtiment pour l'appareil mobile est mis à jour et affiche « Hopkins Hall ».

    • Le champ Département de l'appareil mobile est mis à jour et affiche « Psychologie ».

  3. Le fichier CSV est révisé pour spécifier le numéro de série de l'appareil mobile « C8PLK8CLFM » situé dans le bâtiment « Smith Hall ».
  4. Le fichier CSV révisé est téléversé vers Jamf Pro à l'aide de l'option Préchargement de l’inventaire.
  5. La prochaine fois que l'appareil mobile « C8PLK8CLFM » mettra à jour son inventaire, le champ Bâtiment sera remplacé par « Smith Hall ».

Validation

Le téléversement d'un fichier CSV contenant des données sur le bâtiment et le département nécessite que le bâtiment et le département existent dans Jamf Pro. Si le bâtiment et le département n'existent pas dans Jamf Pro, le téléversement échouera.

Utilisateurs

Lorsqu'un fichier CSV est téléversé, les données CSV sont comparées à la base de données d'inventaire Jamf Pro pour déterminer si de nouveaux utilisateurs doivent être créés ou si les informations des utilisateurs existants seront mises à jour.

Les champs suivants sont requis dans le fichier CSV pour que les utilisateurs puissent être créés ou mis à jour dans Jamf Pro :

Nouveau

Mettre à jour

Nom d’utilisateur

Adresse électronique

Si le fichier CSV contient un nouveau nom d'utilisateur et qu'une adresse électronique est fournie, le nouvel utilisateur est créé dans Jamf Pro.

Si le fichier CSV contient un nom d'utilisateur existant, les champs suivants sont mis à jour dans Jamf Pro :

  • Nom complet

  • Adresse électronique

  • Numéro de téléphone

  • Poste

Quand les données sont appliquées

Les données du fichier CSV téléversé sont appliquées dans Jamf Pro à différents moments selon le type de données.

Les données relatives à l'utilisateur, y compris les champs suivants, sont appliquées immédiatement lorsque le fichier CSV est téléversé :

  • Nom d’utilisateur

  • Nom complet

  • Adresse électronique

  • Numéro de téléphone

  • Poste

Les données sur l'ordinateur et l'appareil mobile, y compris l'emplacement de l'appareil, sont appliquées en continu chaque fois que l'inventaire est recueilli.

Attributs d’extension

Les attributs d'extension ne sont pas fournis dans le modèle CSV car ils varient selon chaque configuration, mais vous pouvez les ajouter si nécessaire. Les attributs d'extension sont mappés dynamiquement à l'aide du préfixe « EA » dans l'en-tête de colonne (notez l'espace après « EA »). Par exemple, si les données CSV contiennent une colonne nommée « EA Memo1 », le processus de mise à jour de préchargement de l'inventaire mettra en correspondance la valeur de cette colonne avec un attribut d'extension existant dans Jamf Pro appelé « Memo1 ».

Remarque :

Le champ d’attribut d’extension fonctionne différemment des autres champs lorsqu’un fichier CSV est téléversé vers Préchargement de l’inventaire. Par exemple :

  • Si le champ d’attribut d’extension est vide dans le fichier CSV téléversé, la valeur de l’attribut d’extension existante est supprimée du rapport d’inventaire.

  • Si un autre champ est vide dans le fichier CSV téléversé, la valeur actuelle du champ est conservée dans le rapport d’inventaire.

Téléversement d'un fichier CSV à l'aide de l’option Préchargement de l’inventaire

Exigences

Pour téléverser un fichier CSV, vous avez besoin des éléments suivants : 

  • Un compte utilisateur Jamf Pro avec tous les privilèges pour les rapports Préchargement de l'inventaire

  • Un compte utilisateur Jamf Pro avec les privilèges « Créer » et « Mettre à jour » pour les utilisateurs

Pour plus d’informations, consultez Groupes et comptes utilisateur Jamf Pro.

  1. Dans Jamf Pro, cliquez sur Réglages dans l’angle supérieur droit de la page.
  2. Dans la section Gestion globale, cliquez sur Préchargement de l’inventaire .
  3. Pour télécharger un modèle de fichier CSV et préparer les données, cliquez sur Modèle .
  4. Si votre navigateur vous invite à autoriser les téléchargements, cliquez sur Autoriser.
  5. Préparez le fichier CSV téléchargé à l’aide de l’éditeur de votre choix.
    Important :

    Si vous modifiez le fichier CSV avec Microsoft Excel sur Windows, vous devez l'enregistrer avec le type de fichier « CSV UTF-8 (délimité par des virgules)(*.csv) ». Si vous avez enregistré le fichier CSV en tant que fichier XLSX, vous pouvez le convertir au format « CSV UTF-8 (délimité par des virgules)(*.csv) » en sélectionnant la commande Enregistrer sous, puis en modifiant le type de fichier. Toutefois, des données peuvent être perdues selon la façon dont elles ont été formatées.

  6. Une fois le fichier CSV préparé, cliquez sur Téléversement de fichiers dans Jamf Pro.
  7. Faites glisser votre fichier CSV ou recherchez-le dans la boîte de dialogue Téléverser le fichier de ressources. Votre fichier s’affiche alors dans la boîte de dialogue.
    Important :

    Les nouvelles données écraseront les données existantes des lignes CSV dont les numéros de série correspondent.

  8. Cliquez sur Confirmer pour téléverser le fichier CSV.
    1. Si le fichier est valide, les données CSV s’affichent sous forme de tableau dans la fenêtre Jamf Pro.
    2. Si le fichier n’est pas valide, la liste des erreurs s’affiche. Notez les erreurs, puis cliquez sur Refuser. Corrigez les erreurs, puis tentez à nouveau de téléverser le fichier.

Affichage et exportation des données actives

Affichez les données actives dans Jamf Pro ou exportez-les sous forme de fichier CSV.

  1. Dans Jamf Pro, cliquez sur Réglages dans l’angle supérieur droit de la page.
  2. Dans la section Gestion globale, cliquez sur Préchargement de l’inventaire .
  3. Pour exporter les données actives, procédez comme suit :
    1. Cochez les cases de chaque ligne de données que vous voulez exporter, ou cliquez sur la case du haut pour sélectionner toutes les lignes.
    2. Cliquez sur Exporter les éléments sélectionnés dans le coin supérieur droit du volet.

      Le fichier exporté sera nommé inventory-preload.csv.

Suppression des données actives

Vous pouvez supprimer toutes les données actives précédemment téléversées vers Préchargement de l'inventaire. La suppression des données actives désactive effectivement le processus de mise à jour de préchargement de l’inventaire car aucune donnée préchargée n'existera lorsque l'inventaire sera collecté.

Tous les détails d'inventaire dans Jamf Pro mis à jour avec l’option Préchargement de l’inventaire resteront intacts.

  1. Dans Jamf Pro, cliquez sur Réglages dans l’angle supérieur droit de la page.
  2. Dans la section Gestion globale, cliquez sur Préchargement de l’inventaire .
  3. Cliquez sur Supprimer les données, puis sur Supprimer.
Avertissement :

Cette action supprime toutes les données actives, quelles que soient les lignes de données sélectionnées.

Affichage de l’historique de l’activité du préchargement de l’inventaire

Affichez l'historique de tous les fichiers de ressources téléversés, y compris le nom du fichier, le nom de l'utilisateur qui a téléversé le fichier, ainsi que la date à laquelle le fichier a été téléversé.

  1. Dans Jamf Pro, cliquez sur Réglages dans l’angle supérieur droit de la page.
  2. Dans la section Gestion globale, cliquez sur Préchargement de l’inventaire .
  3. Cliquez sur Historique .

    Une liste de toutes les activités de préchargement de l’inventaire s’affiche.

  4. Pour ajouter des commentaires sur les enregistrements de la liste d’historique, cliquez sur Ajouter une note, saisissez une note, puis cliquez à nouveau sur Ajouter une note pour enregistrer la note.