Analyse de fichiers CSV dans CDM

  • Rversion finale: Australia
  • Mis à jour 12 mars 2026
  • 4 minutes de lecture

    • L'analyseur CSV CDM permet l'analyse des données dans les fichiers CSV, de sorte que lorsque vous chargez des données de configuration à partir d'un fichier CSV (valeurs séparées par des virgules) dans CDM, vous pouvez facilement identifier les attributs de format de données et les données de configuration dans l'éditeur CDM ou la vue de liste.

    Important :
    DevOps Config est désormais obsolète et n’est plus pris en charge ni disponible pour une nouvelle activation.
    L'analyseur CSV CDM suit la norme CSV RFC 4180. Cette analyse des données à partir d'un fichier CSV vers un format JSON dans CDM 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 au format 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 CSV importées dans CDM pour le déploiement.
    • Conversion des données de configuration du format JSON au format CSV avec les 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 du format CSV au format JSON comme suit :
    • Ajoute chaque enregistrement présent dans le fichier CSV en tant que CDI dans des nœuds indexés séparés sous le nœud data au format JSON.
    • Ajoute les attributs de format de données utilisés lors du chargement CSV sous le nœud metadata.

      Le paramètre de requête dataFormatAttributes comprend des attributs permettant de 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 de 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.

      Valeur 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 : la première ligne du fichier CSV contient l'en-tête.
      • false : la première ligne du fichier CSV ne contient pas d'en-tête. Dans ce cas, vous devez fournir les en-têtes dans l'attribut headers.

      Par défaut : « containsHeader » : « true ».
      en-têtes Liste des champs d'en-tête pour les champs d'enregistrement dans le fichier CSV. Ces en-têtes sont convertis en noms clés des CDI au format JSON.
      Remarque :
      Cet attribut ne s'applique que si l'attribut containsHeader est défini sur false.

      Si la première ligne de votre fichier CSV ne contient pas d'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 » : [« Prénom »,« Nom »,« Emplacement »,« Salaire »].

      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é dans le 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 au format JSON

    Cet exemple montre les attributs de format de données qui ont été fournis 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.

    { « délimiteur » : « , », « containsHeader » : « true », « en-têtes » : [], « securedHeaders » : [« salaire »] }

    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 au format CSV, assurez-vous que les nœuds data et metadata sont inclus dans vos données.
    • Les éléments de données de configuration dans le nœud data sont convertis en lignes d'enregistrement individuelles dans le fichier CSV.
    • Les attributs de format de données du nœud metadata sont utilisés pour définir les informations de délimiteur, d'en-tête et d'en-tête secret dans le fichier CSV.