Uso de un archivo CSV para importar datos en Service Manager
Importante
Esta versión de Service Manager ha llegado al final del soporte técnico. Se recomienda actualizar a Service Manager 2022.
En este artículo se proporciona información general y procedimientos para importar datos y elementos de configuración en Service Manager mediante archivos de valores separados por comas (CSV).
Importación de datos de archivos separados por comas
Los elementos de configuración contenidos en un archivo de valores separados por comas (.csv) se pueden importar en la base de datos Service Manager mediante la característica Importar desde archivo CSV. Esta característica permite importar de forma masiva instancias de cualquier tipo de clase o tipo de proyección que se defina en la base de datos de Service Manager. Esta característica se puede usar para:
Crear instancias de elementos de configuración o de elementos de trabajo a partir de datos almacenados en formato tabular.
Editar de forma masiva instancias existentes de la base de datos.
Rellene la base de datos Service Manager mediante los datos exportados desde una base de datos externa.
Sortear entradas de datos a través de formularios cuando se deben crear numerosas instancias de clase al mismo tiempo.
Nota
La importación de muchos elementos complejos,por ejemplo, 5000 proyecciones de equipo podría tardar una hora o más. Durante este tiempo, Service Manager continúa funcionando.
Para importar un conjunto de instancias mediante la característica Importar desde archivo CSV se requieren dos archivos:
Un archivo de datos que consta de una serie de instancias de objeto delimitadas por comas. El archivo de datos debe tener la extensión de nombre de archivo .csv.
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. Se supone que todas las instancias del archivo de datos son de este tipo. El archivo de formato también especifica (1) el subconjunto de propiedades y, en el caso de las proyecciones, especifica los componentes. Se importan para el tipo indicado y (2) el orden en el que esas propiedades aparecen como columnas en el archivo de datos asociado. 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.
Creación del archivo de datos
Por ejemplo, recibirá una hoja de cálculo que contiene información sobre los equipos que desea importar en la base de datos de Service Manager. A continuación figura una muestra de los 10 primeros equipos contenidos en la hoja de cálculo.
| Nombre del equipo | Dirección IP | Nombre de dominio |
|---|---|---|
| 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 |
El primer paso consiste en convertir los datos de la tabla al formato de archivo .csv. En el archivo .csv, supone que la primera línea corresponde a datos, no a un encabezado. 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.
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
Creación del archivo de formato
Ahora se crea un archivo de formato adecuado para importar las líneas contenidas en el archivo newcomputers.csv . 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. 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.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. Comience por declarar la clase del objeto a importar:
<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.
| columna | propiedad |
|---|---|
| Columna 1 | Nombre de la entidad |
| Columna 2 | IPAddress |
| Columna 3 | DomainDnsName |
Utilizando estas propiedades, se construye el siguiente archivo de formato. Las propiedades se enumeran en el orden en que aparecen en el archivo .csv. Debe guardar este archivo, que tiene el mismo nombre que el archivo .csv, pero con la extensión de nombre de archivo .xml.
<CSVImportFormat>
<Class Type="Microsoft.Windows.Computer">
<Property ID="PrincipalName"/>
<Property ID="IPAddress"/>
<Property ID="DomainDnsName"/>
</Class>
</CSVImportFormat>
Guarde este archivo como newcomputers.xml.
Importar elementos de configuración desde un archivo CSV
Para poder importar datos de un archivo de valores separados por comas (CSV), debe crear dos archivos: un archivo de datos y un archivo de formato. Puede usar el procedimiento siguiente para importar el archivo Newcomputers.csv usando el archivo de formato Newcomputers.xml.
Para importar elementos de configuración desde un archivo CSV
En la consola de Service Manager, seleccione Administración.
En el panel Administración , expanda Administración y seleccione Conectores.
En el panel Tareas , seleccione Importar desde un archivo CSV.
En el cuadro de diálogo Importar instancias de archivo CSV , haga lo siguiente:
Junto al cuadro Archivo de formato XML , seleccione Examinar y, a continuación, seleccione el archivo de formato. Por ejemplo, seleccione Newcomputers.xmly seleccione Abrir.
Junto al cuadro Archivo de datos , seleccione Examinar y, a continuación, seleccione el archivo de datos. Por ejemplo, seleccione Newcomputers.csvy seleccione Abrir.
En el cuadro de diálogo Importar instancias desde archivo CSV , seleccione Importar.
En el cuadro de diálogo Importar instancias del archivo CSV , compruebe que los números junto a Elementos guardados, Instancias creadas en memoria e Instancias confirmadas en la base de datos son iguales al número de filas del archivo de datos y seleccione Cerrar.
Puede usar un comando Windows PowerShell para completar esta tarea. Para obtener información acerca de cómo usar Windows PowerShell para importar elementos de configuración desde un archivo CSV, consulte Import-SCSMInstance.
Para validar la importación de elementos de configuración desde un archivo CSV
En la consola de Service Manager, seleccione Elementos de configuración.
En el panel Elementos de configuración, expanda Elementos de configuración, equipos y seleccione Todos los equipos Windows.
En el panel Todos los equipos Windows, compruebe que aparecen los equipos del archivo CSV.
Pasos siguientes
Comentarios
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea: https://aka.ms/ContentUserFeedback.
Enviar y ver comentarios de