Análise de arquivos CSV em CDM

  • Versão de lançamento: Zurich
  • Atualizado 31 de jul. de 2025
  • 3 min. de leitura
  • . CDM O analisador CSV permite a análise de dados em arquivos CSV, portanto, quando você carrega dados de configuração de um arquivo de valores separados por vírgulas (CSV) no CDM, você pode identificar facilmente os atributos de formato de dados e os dados de configuração no CDM editor ou exibição de lista.

    Importante:
    Configuração de DevOps agora está descontinuado e não há mais suporte ou disponível para nova ativação.
    . CDM O analisador CSV segue o padrão CSV RFC 4180. Esta análise de dados de um arquivo CSV para um formato JSON em CDM ajuda você das seguintes maneiras:
    • Carregando dados de configuração existentes de um arquivo CSV com cabeçalho personalizado e atributos de delimitador para analisá-los como pares de chave-valor apropriados em JSON.
    • Diferenciando atributos de formato de dados (metadados) dos itens de dados de configuração (dados) no CDM editor.
    • Validando dados CSV importados em CDM para implantação.
    • Convertendo dados de configuração do formato JSON para o formato CSV com atributos no formato original.

    Análise de CSV para JSON durante a importação

    Quando você importa um arquivo CSV para CDM, O analisador converte os dados no formato CSV para o formato JSON da seguinte forma:
    • Adiciona cada registro do arquivo CSV como um CDI em nós indexados separados em dataNó no formato JSON.
    • Adiciona os atributos de formato de dados usados durante o carregamento de CSV em metadatanó.

      O parâmetro de consulta dataFormatAttributesinclui atributos para determinar o delimitador, cabeçalhos, primeira linha como cabeçalho e cabeçalhos protegidos.

      Tabela 1. Atributos do analisador CSV do CDM
      Nome de atributo Descrição
      delimitador Caractere para separar cada campo de cabeçalho como uma chave e o campo de registro como um valor de um CDI. Você pode especificar um caractere válido como delimitador.

      Padrão: "delimitador": "," .

      ContainsHeader Opção para determinar se a primeira linha no arquivo CSV é considerada como a linha do cabeçalho. Este atributo é opcional.
      • Verdadeiro: O arquivo CSV contém a primeira linha como cabeçalho.
      • Falso: O arquivo CSV não tem a primeira linha como cabeçalho. Nesse caso, você deve fornecer os cabeçalhos em headersatributo.

      Padrão: "ContainsHeader": "True" .

      cabeçalhos Lista de campos de cabeçalho para campos de registro no arquivo CSV. Esses cabeçalhos são convertidos para os nomes de chave dos CDIs no formato JSON.
      Nota:
      Este atributo será aplicável somente se containsHeadero atributo está definido como falso .

      Se o arquivo CSV não tiver a primeira linha com cabeçalhos, você poderá fornecer uma matriz de cabeçalhos. O número de cabeçalhos deve corresponder ao número de campos de registro. Exemplo: "Cabeçalhos": ["Nome","Sobrenome","Local","Salário"] .

      Matriz vazia: Uma matriz vazia: "cabeçalhos": [] .

      Cabeçalhos secured Lista de campos de cabeçalho para os quais o valor de todos os registros é exibido no formato criptografado no formato JSON. Este atributo é opcional.

      Você pode fornecer uma matriz de cabeçalhos que devem ser protegidos. O nome dos cabeçalhos protegidos deve corresponder ao nome dos cabeçalhos em cabeçalhos Atributo ou arquivo CSV. Exemplo: "SecuredHeaders": ["Salary"] .

      Matriz vazia: Uma matriz vazia: "SecuredHeaders": [] .

    Conversão do formato CSV para JSON

    Este exemplo mostra os atributos de formato de dados fornecidos e a conversão de conteúdo CSV para o formato JSON com base nesses atributos.
    Atributos de formato de dados
    Nota:
    Este parâmetro é opcional. Se você não fornecer valores, os valores padrão dos atributos serão usados.

    "Delimitador": ",", "containsHeader": "True", "headers": [], "securedHeaders": ["salary"]

    Formato 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
    Formato 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"
    	}
    }

    Análise de JSON para CSV durante a exportação

    Para manter os dados de configuração CSV em seu formato original ao exportar os dados de configuração para um formato de arquivo CSV, certifique-se de ter o. datae. metadatanós em seus dados.
    • Itens de dados de configuração em dataOs nós são convertidos em linhas de registro individuais no arquivo CSV.
    • Atributos de formato de dados em metadataOs nós são usados para definir o delimitador, o cabeçalho e as informações do cabeçalho secreto no arquivo CSV.