Referencia de comando > Archivos de control de infacmd > Archivos de control de importación
  

Archivos de control de importación

Un archivo de control de importación es un archivo XML que se usa con los comandos infacmd. El archivo de control filtra los objetos que infacmd importa desde un archivo de exportación a un dominio o repositorio de modelos.
Puede usar un archivo de control de importación con los siguientes comandos:
infacmd isp ImportDomainObjects
Importa usuarios nativos, grupos nativos, funciones y conexiones desde un archivo de exportación a un dominio. Cuando especifica un archivo de control de importación para el comando, puede realizar las tareas siguientes:
infacmd oie ImportObjects
Importa objetos del repositorio de modelos desde un archivo de exportación a un repositorio de modelos. Cuando especifica un archivo de control de importación para el comando, puede realizar las tareas siguientes:
Los objetos del repositorio de modelos dependientes pueden existir en distintas carpetas o proyectos. Debe incluir todos los objetos dependientes mediante los elementos folderMap del archivo de control de importación. En caso contrario, la importación podría fallar con un mensaje de error porque un objeto dependiente no existe en el repositorio de destino.
Puede definir una estrategia de resolución de conflictos a través de la línea de comandos o del archivo de control cuando importa los objetos. El archivo de control tendrá preferencia si define una resolución de conflicto en la línea de comandos y el archivo de control. La importación falla si hay un conflicto y no ha definido ninguna estrategia de resolución de conflictos.
Si define la estrategia de resolución de conflictos de cambio de nombre, puede especificar un nombre en el archivo de control para un objeto específico. De forma alternativa, infacmd puede generar un nombre anexando un número secuencial al final del nombre.
Un archivo de control de importación usa distintos parámetros basados en si el archivo ha sido configurado para importar objetos de dominio u objetos del repositorio de modelos.

Parámetros del archivo de control de importación para objetos de dominio

Use los parámetros del archivo de control de importación para configurar los objetos que desea importar de un archivo XML al dominio.
Los archivos de control de importación para objetos de dominio pueden contener los elementos siguientes:
La tabla siguiente enumera los elementos del archivo de control de importación que tienen atributos configurables:
Elemento
Nombre de atributo
Descripción de atributo
objectList
type
Obligatorio. Tipo de objeto de dominio que desea importar. Especifique uno de los siguientes valores:
  • - Usuario
  • - Grupo
  • - Función
  • - Conexión
El valor no distingue mayúsculas de minúsculas.
objectList
select
Opcional. Indica si infacmd importa todos los objetos restantes del tipo especificado cuando se define un elemento de objeto para objectList. Especifique all para importar todos los objetos restantes. Por ejemplo, las siguientes líneas importan Group1 con la estrategia de resolución Reuse. Las líneas importan todos los grupos restantes con la estrategia de resolución Merge:
<objectList type="group" select="all" resolution="merge">
<object name="Group1" resolution="reuse" />
</objectList>
Si define un elemento de objeto y no emplea el atributo select, infacmd importará los objetos que concuerden con los atributos definidos en el elemento de objeto. Por ejemplo, las siguientes líneas importan Group1 con la estrategia de resolución Merge.
<objectList type="group" resolution="merge">
<object name="Group1" />
</objectList>
Si no se define un elemento de objeto para objectList, el valor predeterminado del atributo select será all. Por ejemplo, la siguiente línea importa todos los grupos con la estrategia de resolución Merge:
<objectList type="group" resolution="merge" />
El valor válido es all.
objectList
resolution
Opcional. Estrategia de resolución cuando se produce un conflicto de nombres. Se aplica a todos los objetos del tipo especificado. Especifique uno de los siguientes valores:
  • - Replace. Reemplazar el objeto de destino por el objeto de origen.
  • - Rename. Cambiar el nombre del objeto de origen utilizando un nombre generado y, a continuación, importarlo.
  • - Reuse. Reutilizar el objeto del dominio de destino.
  • - Merge. Fusionar todos los objetos en uno solo. Esta opción se puede aplicar a grupos.
Los valores no distinguen mayúsculas de minúsculas.
object
name
Obligatorio. Nombre del objeto concreto que se va a importar del tipo de objeto especificado. El valor no distingue mayúsculas de minúsculas.
object
resolution
Opcional. Estrategia de resolución cuando se produce un conflicto de nombres en este objeto. Especifique uno de los siguientes valores:
  • - Replace. Reemplazar el objeto de destino por el objeto de origen.
  • - Rename. Cambiar el nombre del objeto de origen y, a continuación, importarlo.
  • - Reuse. Reutilizar el objeto del dominio de destino.
  • - Merge. Fusionar todos los objetos en uno solo. Esta opción se puede aplicar a grupos.
Los valores no distinguen mayúsculas de minúsculas.
object
renameTo
Opcional. El nombre que se usa cuando la estrategia de resolución de conflictos es Rename. Si no se especifica un nombre, infacmd lo genera añadiendo un número al final del nombre. Infacmd omite el valor si no hay conflictos o si la estrategia de resolución de conflictos no es Rename.
object
renameIdTo
Opcional. La cadena de ID que se usa cuando se importa un objeto de conexión y la estrategia de resolución de conflictos es Rename. Si no se especifica un ID de conexión, infacmd lo generará añadiendo un número al final del ID de conexión. Infacmd omite el valor si no hay conflictos o si la estrategia de resolución de conflictos no es Rename.

Muestra del archivo de control de importación para objetos de dominio

El código siguiente muestra un archivo de control de importación de ejemplo para los objetos de dominio:
<?xml version="1.0" encoding="UTF-16LE" standalone="yes" ?>
<importParams xmlns="http://www.informatica.com/oie/importControl/9">

<! -- Import all connections, roles, and users. -->
<objectList type="connection" resolution="replace" />
<objectList type="role" resolution="reuse" />
<objectList type="user" resolution="rename" />

<! -- Import specific groups. -->
<objectList type="group">
<object name="g1" resolution="replace" />
<object name="g2" resolution="merge" />
</objectList>
</importParams>

Parámetros del archivo de control de importación para objetos del repositorio de modelos

Use los parámetros del archivo de control de importación para configurar los objetos que desea importar desde un archivo XML al repositorio de modelos.
Un archivo de control de importación para objetos del repositorio de modelos puede contener los elementos siguientes:
La siguiente tabla describe los atributos configurables del elemento folderMap en el archivo de control de importación:
Nombre de atributo
Descripción de atributo
sourceProject
Obligatorio. Nombre del proyecto de origen en el archivo de exportación que contiene los objetos que desea importar. El valor no distingue mayúsculas de minúsculas.
sourceFolderPath
Opcional. Ruta de la carpeta de origen en el archivo de exportación que contiene los objetos que desea importar. Use el siguiente formato:
"/<nombre_de_carpeta>/<nombre_de_carpeta>"
Por ejemplo, si un proyecto contiene una carpeta llamada F1, su ruta de acceso de carpeta es "/F1". Para considerar la importación de todos los objetos del proyecto, especifique "/". El valor no distingue mayúsculas de minúsculas. El valor predeterminado es "/."
targetProject
Obligatorio. Nombre del proyecto del repositorio de destino en el que desea importar los objetos. El proyecto debe existir en el repositorio antes de que importe los objetos. El valor no distingue mayúsculas de minúsculas.
targetFolderPath
Opcional. Ruta de la carpeta del repositorio de destino a la que desea importar los objetos. Use el siguiente formato:
"/<nombre_de_carpeta>/<nombre_de_carpeta>"
Por ejemplo, si un proyecto contiene una carpeta llamada F1, su ruta de acceso de carpeta es "/F1". Para importar todos los objetos del proyecto de destino, especifique "/". La carpeta debe existir en el repositorio antes de que importe los objetos. El valor no distingue mayúsculas de minúsculas. El valor predeterminado es "/."
recursive
Opcional. Indica si se importan los objetos de las subcarpetas de la carpeta especificada. Especifique true para importar desde las subcarpetas. Los valores válidos son true o false. El valor distingue mayúsculas de minúsculas. El valor predeterminado es true.
select
Opcional. Indica si infacmd importa todos los objetos restantes del proyecto especificado cuando se define un elemento objectList para folderMap. Especifique all para importar todos los objetos restantes. Por ejemplo, las siguientes líneas importan asignaciones con una estrategia de resolución Reuse: Las líneas importan todos los objetos restantes con la estrategia de resolución Replace:
<folderMap sourceProject="p1" targetProject="p2" select="all" resolution="replace">
<objectList type="Mapping" resolution="reuse" />
</folderMap>
Si define un elemento objectList y no usa el atributo select, infacmd importará objetos que concuerden con los atributos definidos en objectList. Por ejemplo, las siguientes líneas importan asignaciones con una estrategia de resolución Replace:
<folderMap sourceProject="p1" targetProject="p2" resolution="replace">
<objectList type="Mapping" />
</folderMap>
Si no define ningún elemento objectList para folderMap, el valor predeterminado es all. Por ejemplo, la siguiente línea importa todos los objetos con la estrategia de resolución Replace:
<folderMap sourceProject="p1" targetProject="p2" resolution="replace" />
El valor válido es all.
resolution
Opcional. Estrategia de resolución cuando se produce un conflicto de nombres. Se aplica a todos los objetos de esta carpeta. Especifique uno de los siguientes valores:
  • - Rename. Cambiar el nombre del objeto de origen utilizando un nombre generado y, a continuación, importarlo.
  • - Replace. Reemplazar el objeto de destino por el objeto de origen.
  • - Reuse. Reutilizar el objeto del repositorio de modelos de destino.
  • - None.
Los valores no distinguen mayúsculas de minúsculas. El valor predeterminado es None.
La siguiente tabla describe los atributos configurables del elemento objectList en el archivo de control de importación:
Nombre de atributo
Descripción de atributo
type
Obligatorio. El tipo de objeto del repositorio de modelos que se importará a la ruta de carpeta especificada. Los valores válidos incluyen todos los tipos de objeto presentes en el repositorio de modelos. Puede ver el tipo de objeto en la vista Propiedades de la herramienta del desarrollador. Por ejemplo, puede especificar "Objeto de datos relacionales" o "Perfil". El valor no distingue mayúsculas de minúsculas.
select
Opcional. Indica si infacmd importa todos los objetos restantes del tipo especificado cuando se define un elemento de objeto para objectList. Especifique all para importar todos los objetos restantes. Por ejemplo, las siguientes líneas importan MyMapping con una estrategia de resolución Reuse. Las líneas importan todas las asignaciones restantes con la estrategia de resolución Replace:
<folderMap sourceProject="p1" targetProject="p2">
<objectList type="Mapping" select="all" resolution="replace">
<object name="MyMapping" resolution="reuse" />
</objectList>
</folderMap>
Si define un elemento de objeto y no emplea el atributo select, infacmd importará los objetos que concuerden con los atributos definidos en el elemento de objeto. Por ejemplo, las siguientes líneas importan la asignación llamada MyMapping con una estrategia de resolución Replace.
<folderMap sourceProject="p1" targetProject="p2">
<objectList type="Mapping" resolution="replace">
<object name="MyMapping"/>
</objectList>
</folderMap>
Si no define ningún elemento de objeto para objectList, el valor predeterminado es all. Por ejemplo, las siguientes líneas importan todas las asignaciones con una estrategia de resolución Replace.
<folderMap sourceProject="p1" targetProject="p2">
<objectList type="Mapping" resolution="replace" />
</folderMap>
El valor válido es all.
resolution
Opcional. Estrategia de resolución cuando se produce un conflicto de nombres. Se aplica a todos los objetos del tipo especificado. Especifique uno de los siguientes valores:
  • - Rename. Cambiar el nombre del objeto de origen utilizando un nombre generado y, a continuación, importarlo.
  • - Replace. Reemplazar el objeto de destino por el objeto de origen.
  • - Reuse. Reutilizar el objeto del repositorio de modelos de destino.
  • - None.
Los valores no distinguen mayúsculas de minúsculas. El valor predeterminado es None.
La siguiente tabla describe los atributos configurables del elemento de objeto en el archivo de control de importación:
Nombre de atributo
Descripción de atributo
name
Obligatorio. Nombre del objeto concreto que se va a importar del tipo de objeto especificado. El valor no distingue mayúsculas de minúsculas.
resolution
Opcional. Estrategia de resolución cuando se produce un conflicto de nombres en este objeto. Especifique uno de los siguientes valores:
  • - Rename. Cambiar el nombre del objeto de origen y, a continuación, importarlo.
  • - Replace. Reemplazar el objeto de destino por el objeto de origen.
  • - Reuse. Reutilizar el objeto del repositorio de modelos de destino.
  • - None.
Los valores no distinguen mayúsculas de minúsculas. El valor predeterminado es None.
renameTo
Opcional. El nombre que se usa cuando la estrategia de resolución de conflictos es Rename. Si no se especifica un nombre, infacmd lo genera añadiendo un número al final del nombre. Infacmd omite el valor si no hay conflictos o si la estrategia de resolución de conflictos no es Rename.
renameIdTo
Opcional. La cadena de ID que se usa cuando se importa un objeto de conexión y la estrategia de resolución de conflictos es Rename. Si no se especifica un ID de conexión, infacmd lo generará añadiendo un número al final del ID de conexión. Infacmd omite el valor si no hay conflictos o si la estrategia de resolución de conflictos no es Rename.
La siguiente tabla describe los atributos configurables del elemento rebind en el archivo de control de importación:
Nombre de atributo
Descripción de atributo
origen
Obligatorio. Nombre de una conexión de origen del archivo que va a importar. El valor no distingue mayúsculas de minúsculas.
destino
Obligatorio. Nombre de una conexión del repositorio de modelos de destino que se va a asignar a la conexión de origen. De manera predeterminada, la conexión debe existir en el repositorio de destino antes de importar los objetos. Si la conexión no existe, se produce un error en la exportación. Al ejecutar infacmd, puede elegir omitir la validación de la conexión de destino durante la importación. Cuando se omite la validación de la conexión de destino, la importación se realiza correctamente si no existe una conexión en el repositorio de destino. El valor no distingue mayúsculas de minúsculas.

Muestra del archivo de control de importación para objetos del repositorio de modelos

El código siguiente muestra un archivo de control de importación de ejemplo para los objetos del repositorio de modelos:
<?xml version="1.0" encoding="UTF-16LE" standalone="yes" ?>
<importParams xmlns="http://www.informatica.com/oie/importControl/9">
<folderMaps>
<folderMap sourceProject="project1" sourceFolderPath="/f1" targetProject="project2" targetFolderPath="/f1" recursive="true">

<! -- Import mapping1 with the Rename resolution strategy. -->
<objectList type="Mapping" select="all" resolution="replace">
<object name="mapping1" resolution="rename" renameTo="mapping1_new"/>

<! -- Import all remaining mappings with the Replace resolution strategy. -->
</objectList>

<! -- Import all Aggregator transformations with the Replace resolution strategy. -->
<objectList type="Aggregator" resolution="replace"/>

<! -- Import all Filter transformations with no resolution strategy. -->
<objectList type="Filter" resolution="none"/>
</folderMap>
</folderMaps>

<! -- Map connections in the source repository to connections in the target repository. -->
<connectionInfo>
<rebindMap>
<rebind source="src_Conn1" target="tgt_Conn1"/>
<rebind source="src_Conn2" target="tgt_Conn2"/>
</rebindMap>
</connectionInfo>
</importParams>