Usar un archivo CSV para importar datos en Service ManagerUse a CSV file to import data into Service Manager

Se aplica a: System Center 2016 - Service ManagerApplies To: System Center 2016 - Service Manager

Este artículo proporciona información general y procedimientos para importar datos y elementos de configuración en Service Manager mediante el uso de archivos de valores separados por comas (CSV).This artilce provides an overview and procedures for importing data and configuration items into Service Manager by using comma-separated value (CSV) files.

Importar datos de archivos separados por comasImport data from comma-separated files

Elementos de configuración contenidos en un archivo de valores separados por comas (.csv) se pueden importar en la base de datos de Service Manager mediante el uso de la característica Importar desde archivo CSV.Configuration items contained in a comma-separated value (.csv) file can be imported into the Service Manager database by using the Import from CSV File feature. Esta característica permite importación masiva de instancias de cualquier tipo de clase o tipo de proyección que se define en la base de datos de Service Manager.This feature lets you to bulk-import instances of any class type or projection type that is defined in the Service Manager database. Esta característica se puede usar para:You can use this feature to:

  • Crear instancias de elementos de configuración o de elementos de trabajo a partir de datos almacenados en formato tabular.Create configuration item or work item instances from data stored in a tabular format.

  • Editar de forma masiva instancias existentes de la base de datos.Bulk-edit existing database instances.

  • Rellenar la base de datos de Service Manager mediante el uso de los datos exportados desde una base de datos externo.Populate the Service Manager database by using data exported from an external database.

  • Sortear entradas de datos a través de formularios cuando se deben crear numerosas instancias de clase al mismo tiempo.Circumvent data entry through forms when many class instances must be created at the same time.

Nota

Importar muchos elementos complejos-por ejemplo 5.000 proyecciones de equipos-puede tardar una hora o más.Importing many complex items-for example, 5,000 computer projections-could take an hour or more. Durante este tiempo, Service Manager sigue funcionando.During this time, Service Manager continues to function.

Para importar un conjunto de instancias mediante la característica Importar desde archivo CSV se requieren dos archivos:Two files are required to import a set of instances by using the Import from CSV File feature:

  1. Un archivo de datos que consta de una serie de instancias de objeto delimitadas por comas.A data file that consists of a series of comma-delimited object instances. El archivo de datos debe tener la extensión de nombre de archivo .csv.The data file must end with the .csv file name extension.

  2. Un archivo de formato que especifica el tipo de clase o el tipo de proyección de las instancias presentes en el archivo de datos.A format file that specifies the class type or projection type of the instances present in the data file. Se supone que todas las instancias del archivo de datos son de este tipo.Every instance in the data file is assumed to be of this kind. El archivo de formato también especifica (1) el subconjunto de propiedades y, en el caso de las proyecciones, especifica los componentes.The format file also specifies (1) the subset of properties and, for projections, specifies components. Se importan para el tipo indicado y (2) en el orden en que dichas propiedades aparecen en forma de columnas en el archivo de datos asociado.They are being imported for the indicated type, and (2) the order in which those properties appear as columns in the associated data file. El archivo de formato debe tener el mismo nombre que el archivo csv que describe y debe terminar con la extensión de nombre de archivo .xml.The format file must have the same file name as the csv file that it describes, and it must end with the .xml file name extension.

Crear el archivo de datosCreate the data file

Por ejemplo, recibe una hoja de cálculo que contiene información sobre los equipos que se van a importar en la base de datos de Service Manager.For example, you receive a spreadsheet that contains information about computers that you want to import into the Service Manager database. A continuación figura una muestra de los 10 primeros equipos contenidos en la hoja de cálculo.The following is a sample of the first 10 computers in the spreadsheet.

Nombre del equipoComputer Name Dirección IPIP Address Nombre de dominioDomain Name
WG-Det-1WG-Det-1 172.30.14.21172.30.14.21 DETROITDETROIT
WG-Det-2WG-Det-2 172.30.14.22172.30.14.22 DETROITDETROIT
WG-Det-3WG-Det-3 172.30.14.23172.30.14.23 DETROITDETROIT
WG-Dal-1WG-Dal-1 172.30.14.24172.30.14.24 DALLASDALLAS
WG-Dal-2WG-Dal-2 172.30.14.25172.30.14.25 DALLASDALLAS
WG-Chi-1WG-Chi-1 172.30.14.26172.30.14.26 CHICAGOCHICAGO
WG-Chi-2WG-Chi-2 172.30.14.27172.30.14.27 CHICAGOCHICAGO
WG-Chi-3WG-Chi-3 172.30.14.28172.30.14.28 CHICAGOCHICAGO
WG-Chi-4WG-Chi-4 172.30.14.29172.30.14.29 CHICAGOCHICAGO
WG-Chi-5WG-Chi-5 172.30.14.30172.30.14.30 CHICAGOCHICAGO

El primer paso consiste en convertir los datos de la tabla al formato de archivo .csv.The first step is to convert the data in the table into a .csv file format. En el archivo .csv, supone que la primera línea corresponde a datos, no a un encabezado.In the .csv file, you make the assumption that the first row is data, and not a header. Por ello, elimina la línea del encabezado de la hoja de cálculo y guarda los resultados como newcomputers.csv tal como se muestra en el ejemplo siguiente.Therefore, you remove the header line from the spreadsheet and save the results as newcomputers.csv as in the following example.

WG-Det-1, 172.30.14.21, DETROIT
WG-Det-2, 172.30.14.22, DETROIT
WG-Det-3, 172.30.14.23, DETROIT
WG-Dal-1, 172.30.14.24, DALLAS
WG-Dal-2, 172.30.14.25, DALLAS
WG-Chi-1, 172.30.14.26, CHICAGO
WG-Chi-2, 172.30.14.27, CHICAGO
WG-Chi-3, 172.30.14.28, CHICAGO
WG-Chi-4, 172.30.14.29, CHICAGO
WG-Chi-5, 172.30.14.30, CHICAGO

Crear el archivo de formatoCreate the format file

Ahora se crea un archivo de formato adecuado para importar las líneas contenidas en el archivo newcomputers.csv .A format file is now created that is suited to import the rows that are contained in the newcomputers.csv file. El primer paso para escribir el archivo de formato consiste en identificar el tipo de clase o el tipo de proyección que se debe utilizar para las instancias del archivo .csv.The first step in writing the format file is identifying the class type or projection type that must be used for the instances in the .csv file. Para obtener más información acerca del tipo de clase o de los tipos de proyección, consulte la entrada de blog Using the CSV import feature (Uso de la característica de importación de CSV) y descargue el archivo CSVImport.docxFor more information about class type or projection types, see the blog post Using the CSV import feature and download the file CSVImport.docx.

En cuanto al tipo de datos a importar, descubre que la clase Microsoft.Windows.Computer es la más adecuada para el tipo de objeto y el conjunto de propiedades.For the type of data being imported, you find that the Microsoft.Windows.Computer class is the best suited for the object type and property set. Comience por declarar la clase del objeto a importar:Start by declaring the class of the object that is being imported:

<CSVImportFormat>
   <Class Type="Microsoft.Windows.Computer">
      ...
   </Class>
</CSVImportFormat>

Después de examinar la lista de propiedades disponibles de la clase Microsoft.Windows.Computer , seleccione las siguientes propiedades para cada columna del archivo .csv.After scanning the list of available properties of the Microsoft.Windows.Computer class, select the following properties for each column in the .csv file.

Columnacolumn Propiedadproperty
Columna 1Column 1 Nombre principalPrincipal Name
Columna 2Column 2 Dirección IPIPAddress
Columna 3Column 3 Nombre DNS de dominioDomainDnsName

Utilizando estas propiedades, se construye el siguiente archivo de formato.By using these properties, you construct the following format file. Las propiedades se enumeran en el orden en que aparecen en el archivo .csv.The properties are listed in the order in which they appear in the .csv file. Debe guardar este archivo, que tiene el mismo nombre que el archivo .csv, pero con la extensión de nombre de archivo .xml.You must save this file that has the same file name for the .csv file, but with an .xml file name extension.

<CSVImportFormat>
   <Class Type="Microsoft.Windows.Computer">
      <Property ID="PrincipalName"/>
      <Property ID="IPAddress"/>
      <Property ID="DomainDnsName"/>
   </Class>
</CSVImportFormat>

Guarde este archivo como newcomputers.xml.Save this file as newcomputers.xml.

Importar elementos de configuración desde un archivo CSVImport configuration items from a CSV file

Para poder importar datos desde un archivo de valores separados por comas (CSV), deberá crear dos archivos: un archivo de datos y un archivo de formato.Before you can import data from a comma-separated value (CSV) file, you have to create two files: a data file and a format file. Puede usar el procedimiento siguiente para importar el archivo Newcomputers.csv usando el archivo de formato Newcomputers.xml.You can use the following procedure to import the Newcomputers.csv file by using the Newcomputers.xml format file.

Para importar elementos de configuración desde un archivo CSVTo import configuration items from a CSV file

  1. En la consola de Service Manager, haga clic en administración.In the Service Manager console, click Administration.

  2. En el panel Administración , expanda Administracióny haga clic en Conectores.In the Administration pane, expand Administration, and then click Connectors.

  3. En el panel Tareas , haga clic en Importar desde archivo CSV.In the Tasks pane, click Import from CSV file.

  4. En el cuadro de diálogo Importar instancias desde archivo CSV , realice la acción siguiente:In the Import Instances from CSV File dialog box, do the following:

    1. Junto al cuadro Archivo de formato XML , haga clic en Examinary seleccione el archivo de formato.Next to the XML format file box, click Browse, and then select the format file. Por ejemplo, seleccione Newcomputers.xmly haga clic en Abrir.For example, select Newcomputers.xml, and then click Open.

    2. Junto al cuadro Archivo de datos , haga clic en Examinary seleccione el archivo de datos.Next to the Data file box, click Browse, and then select the data file. Por ejemplo, seleccione Newcomputers.csvy haga clic en Abrir.For example, select Newcomputers.csv, and then click Open.

  5. En el cuadro de diálogo Importar instancias desde archivo CSV , haga clic en Importar.In the Import Instances from CSV File dialog box, click Import.

  6. En el cuadro de diálogo Importar instancias desde archivo CSV , compruebe que los números que hay junto a Elementos guardados, Instancias creadas en memoriae Instancias confirmadas en la base de datos coinciden con el número de filas del archivo de datos y, a continuación, haga clic en Cerrar.In the Import Instances from CSV File dialog box, verify that the numbers next to Items saved, Instances created in memory, and Instances committed to database are equal to the number of rows in the data file, and then click Close.

Símbolo de PowerShell puede utilizar un comando de Windows PowerShell para completar esta tarea.PowerShell symbol You can use a Windows PowerShell command to complete this task. Para obtener información acerca de cómo usar Windows PowerShell para importar elementos de configuración desde un archivo CSV, consulte Import-SCSMInstance.For information about how to use Windows PowerShell to import configuration items from a CSV file, see Import-SCSMInstance.

Para validar la importación de elementos de configuración desde un archivo CSVTo validate the import of configuration items from a CSV file

  1. En la consola de Service Manager, haga clic en elementos de configuración.In the Service Manager console, click Configuration Items.

  2. En el panel Elementos de configuración , expanda Elementos de configuración, expanda Equiposy, a continuación, haga clic en Todos los equipos Windows.In the Configuration Items pane, expand Configuration Items, expand Computers, and then click All Windows Computers.

  3. En el panel Todos los equipos Windows , compruebe que aparecen los equipos del archivo CSV.In the All Windows Computers pane, verify that the computers in the CSV file are listed.

Pasos siguientesNext steps