Analyse des fichiers CSV dans CDM

  • Rversion finale: Yokohama
  • Mis à jour 30 janv. 2025
  • 4 minutes de lecture
  • L’analyseur CDM CSV permet d’analyser les données dans des fichiers CSV, de sorte que lorsque vous chargez les données de configuration d’un fichier CSV (valeurs séparées par des virgules) dans CDM, vous pouvez facilement identifier les attributs de format des données et les données de configuration dans l’éditeur ou la CDM vue de liste.

    Important :
    À partir de la version Washington DC, DevOps Config ne sera plus disponible. L'application sera masquée et ne sera plus installée sur les nouvelles instances, mais continuera d'être prise en charge. Pour en savoir plus, consultez l'article Processus de retrait [KB0867184] dans la base de connaissances Now Support.
    L’analyseur CDM CSV suit la norme CSV RFC 4180. Cette analyse des données d’un fichier CSV au format CDM JSON vous aide de la manière suivante :
    • Chargement des données de configuration existantes à partir d’un fichier CSV avec des attributs d’en-tête et de délimiteur personnalisés pour les analyser en tant que paires clé-valeur appropriées dans JSON.
    • Différenciation des attributs de format de données (métadonnées) des éléments de données de configuration (données) dans l’éditeur CDM .
    • Validation des données CDM CSV importées pour le déploiement.
    • Conversion des données de configuration du format JSON au format CSV avec des attributs au format d’origine.

    Analyse de CSV en JSON pendant l’importation

    Lorsque vous importez un fichier CSV dans CDM, l’analyseur convertit les données au format CSV au format JSON, comme suit :
    • Ajoute chaque enregistrement du fichier CSV en tant que CDI dans des nœuds indexés distincts sous le data nœud au format JSON.
    • Ajoute les attributs de format de données utilisés lors du chargement CSV sous le metadata nœud.

      Le paramètre dataFormatAttributes de requête comprend des attributs pour déterminer le délimiteur, les en-têtes, la première ligne en tant qu’en-tête et les en-têtes sécurisés.

      Tableau 1. Attributs pour l’analyseur CSV CDM
      Nom d'attribut Description
      délimiteur Caractère permettant de séparer chaque champ d’en-tête en tant que clé et le champ d’enregistrement en tant que valeur d’un CDI. Vous pouvez spécifier un caractère valide comme délimiteur.

      Par défaut : « délimiteur » : « , ».

      containsheader Option permettant de déterminer si la première ligne du fichier CSV est considérée comme la ligne d’en-tête. Cet attribut est facultatif.
      • true : le fichier CSV contient la première ligne comme en-tête.
      • false : le fichier CSV n’a pas la première ligne comme en-tête. Dans ce cas, vous devez fournir les en-têtes dans l’attribut headers .

      Par défaut : « containsHeader » : « vrai ».

      en-têtes Liste des champs d’en-tête des champs d’enregistrement dans le fichier CSV. Ces en-têtes sont convertis en noms de clés des CDI au format JSON.
      Remarque :
      Cet attribut ne s’applique que si l’attribut containsHeader est défini sur faux.

      Si votre fichier CSV n’a pas la première ligne avec des en-têtes, vous pouvez fournir un tableau d’en-têtes. Le nombre d’en-têtes doit correspondre au nombre de champs d’enregistrement. Exemple : « headers » : [« FirstName », « LastName », « Location », « Salary »].

      Par défaut : un tableau vide : « headers » : [].

      securedHeaders Liste des champs d’en-tête pour lesquels la valeur de tous les enregistrements est affichée au format chiffré au format JSON. Cet attribut est facultatif.

      Vous pouvez fournir un tableau d’en-têtes qui doivent être sécurisés. Le nom des en-têtes sécurisés doit correspondre au nom des en-têtes dans l’attribut en-têtes ou le fichier CSV. Exemple : « securedHeaders » : [« Salaire »].

      Par défaut : un tableau vide : « securedHeaders » : [].

    Conversion de CSV en format JSON

    Cet exemple montre les attributs de format de données donnés et la conversion du contenu CSV au format JSON en fonction de ces attributs.
    Attributs de format de données
    Remarque :
    Ce paramètre est facultatif. Si vous ne fournissez pas de valeurs, les valeurs par défaut des attributs sont utilisées.

    { « delimiter » : « , », « containsHeader » : « true », « headers » : [], « securedHeaders » : ["salary"] }

    Format CSV
    //Sample CSV file content: no header in the first row; each line represents a record 
      FirstName,LastName,Location,Salary
      David,Ben,NYC,1000
      Jakes D,Ron,IRE,1220
      "George, R",Martin,US,12120
      "Antony, ""Ron",Mak,US,1210
    Format JSON
    
    //data node for the records from CSV - each record row converted to individual nodes with fields separated by delimiter character converted to individual items of the node{
    	"data": {   
    		"0": {
    			"FirstName": "David",
    			"LastName": "Ben",
    			"Location": "NYC",
    			"Salary": "*****"
    		},
    		"1": {
    			"FirstName": "Jakes D",
    			"LastName": "Ron",
    			"Location": "IRE",
    			"Salary": "*****"
    		},
    		"2": {
    			"FirstName": "George, R",  //the name has a delimiter char so the full name is enclosed within " "
    			"LastName": "Martin",
    			"Location": "US",
    			"Salary": "******"
    		},
    		"3": {
    			"FirstName": "Antony, \"Ron", //the last name has "" so a \ is added to include " in the last name
    			"LastName": "Mak",
    			"Location": "US",
    			"Salary": "*****"
    		}
    	},
    //metadata added for the data format attributes
    	"metadata": {   
    		"containsHeader": "true",
    		"delimiter": ",",
    		"headers": "FirstName�LastName�Location�salary",
    		"securedHeaders": "Salary"
    	}
    }

    Analyse de JSON en CSV pendant l’exportation

    Pour conserver les données de configuration CSV dans leur format d’origine lors de l’exportation des données de configuration vers un format de fichier CSV, assurez-vous que vous disposez des data nœuds et metadata dans vos données.
    • Les éléments de données de configuration au sein data du nœud sont convertis en lignes d’enregistrement individuelles dans le fichier CSV.
    • Les attributs de format de données dans le metadata nœud sont utilisés pour définir les informations du délimiteur, de l’en-tête et de l’en-tête secret dans le fichier CSV.