Command Reference > infacmd-Steuerdateien > Importsteuerdateien
  

Importsteuerdateien

Eine Importsteuerdatei ist eine XML-Datei, die Sie mit infacmd-Befehlen verwenden. Die Steuerdatei filtert die Objekte, die infacmd aus einer Exportdatei in eine Domäne oder ein Modellrepository importiert.
Sie können eine Importsteuerdatei mit den folgenden Befehlen verwenden:
infacmd isp ImportDomainObjects
Importiert native Benutzer, native Gruppen, Rollen, Verbindungen und Cluster-Konfigurationen aus einer Exportdatei in eine Domäne. Wenn Sie eine Importsteuerdatei für den Befehl angeben, können Sie die folgenden Aufgaben abschließen:
infacmd oie ImportObjects
Importiert Modellrepository-Objekte aus einer Exportdatei in ein Modellrepository. Wenn Sie eine Importsteuerdatei für den Befehl angeben, können Sie die folgenden Aufgaben abschließen:
Abhängige Modellrepository-Objekte können sich in verschiedenen Ordnern oder Projekten befinden. Sie müssen alle abhängigen Objekte mithilfe von folderMap-Elementen in die Importsteuerdatei einbeziehen. Andernfalls kann der Import mit einer Fehlermeldung fehlschlagen, da das Target-Repository kein abhängiges Objekt enthält.
Beim Importieren der Objekte können Sie eine Konfliktlösungsstrategie über die Befehlszeile oder Steuerdatei definieren. Die Steuerdatei hat Vorrang, wenn Sie eine Konfliktlösung in der Befehlszeile und der Steuerdatei definieren. Der Import schlägt fehl, wenn ein Konflikt auftritt und Sie keine Konfliktlösungsstrategie definiert haben.
Wenn Sie die Umbenennungs-Konfliktlösungsstrategie definieren, können Sie einen Namen in der Steuerdatei für ein bestimmtes Objekt angeben. Alternativ dazu kann infacmd durch Anhängen einer laufenden Nummer an das Ende des Namens einen Namen generieren.
Eine Importsteuerdatei verwendet andere Parameter basierend darauf, ob Sie die Datei zum Importieren von Domänenobjekten oder Modellrepository-Objekten konfigurieren.

Import-Steuerdatei-Parameter für Domänenobjekte

Verwenden Sie die Import-Steuerdatei-Parameter zum Konfigurieren der Objekte, die Sie aus einer XML-Datei in die Domäne importieren möchten.
Eine Import-Steuerdatei für Domänenobjekte kann die folgenden Elemente enthalten:
In der folgenden Tabelle werden die Import-Steuerdateielemente aufgelistet, die konfigurierbare Attribute enthalten:
Element
Attributname
Attributbeschreibung
objectList
type
Erforderlich. Typ des Domänenobjekts, das Sie importieren möchten. Geben Sie einen der folgenden Werte an:
  • - Benutzer
  • - Gruppe
  • - Role
  • - Cluster-Konfiguration
  • - Connection
Bei diesem Wert muss die Groß-/Kleinschreibung nicht beachtet werden.
objectList
select
Optional. Zeigt an, ob infacmd alle übrigen Objekte des angegebenen Typs importiert, wenn Sie ein object-Element für objectList definieren. Bei Auswahl von „all“ werden alle übrigen Objekte importiert. Zum Beispiel importieren die folgenden Zeilen Group1 mit einer Reuse-Lösungsstrategie. Die Zeilen importieren alle übrigen Gruppen mit einer Merge-Lösungsstrategie:
<objectList type="group" select="all" resolution="merge">
<object name="Group1" resolution="reuse" />
</objectList>
Wenn Sie ein Objektelement definieren und das select-Attribut nicht verwenden, importiert infacmd Objekte in Übereinstimmung mit den im object-Element definierten Attributen. Zum Beispiel importieren die folgenden Zeilen Group1 mit einer Merge-Lösungsstrategie.
<objectList type="group" resolution="merge">
<object name="Group1" />
</objectList>
Wenn Sie kein object-Element für objectList definieren, ist „all“ der Standardwert des ausgewählten Attributs. Zum Beispiel importieren die folgenden Zeilen alle Gruppen mit einer Merge-Lösungsstrategie.
<objectList type="group" resolution="merge" />
Gültiger Wert ist „all“.
objectList
resolution
Optional. Lösungsstrategie bei Auftreten eines Namenskonflikts. Gilt für alle Objekte des angegebenen Typs. Geben Sie einen der folgenden Werte an:
  • - Replace. Ersetzen Sie das Target-Objekt mit dem Quellobjekt.
  • - Rename. Benennen Sie das Quellobjekt mit einem generierten Namen um und importieren Sie es anschließend.
    • Sie können die Option Rename nicht mit dem Cluster-Konfigurationstyp verwenden.
  • - Reuse. Verwenden Sie das Objekt in der Target-Domäne wieder.
  • - Merge. Führen Sie die Objekte in einem Objekt zusammen. Diese Option kann für Gruppen verwendet werden.
Bei diesen Werten muss die Groß-/Kleinschreibung nicht beachtet werden.
object
name
Erforderlich. Name eines bestimmten zu importierenden Objekts des angegebenen Objekttyps. Bei diesem Wert muss die Groß-/Kleinschreibung nicht beachtet werden.
object
resolution
Optional. Lösungsstrategie bei Auftreten eines Namenskonflikts für dieses Objekt. Geben Sie einen der folgenden Werte an:
  • - Replace. Ersetzen Sie das Target-Objekt mit dem Quellobjekt.
  • - Rename. Benennen Sie das Quellobjekt um und importieren Sie es anschließend.
    • Sie können die Option Rename nicht mit dem Cluster-Konfigurationstyp verwenden.
  • - Reuse. Verwenden Sie das Objekt in der Target-Domäne wieder.
  • - Merge. Führen Sie die Objekte in einem Objekt zusammen. Diese Option kann für Gruppen verwendet werden.
Bei diesen Werten muss die Groß-/Kleinschreibung nicht beachtet werden.
object
renameTo
Optional. Zu verwendender Name, wenn Rename als Konfliktlösungsstrategie dient. Wenn Sie keinen Namen festlegen, generiert infacmd einen Namen durch Anhängen einer Nummer an das Ende des Namens. Infacmd ignoriert den Wert, wenn keine Konflikte auftreten oder wenn es sich bei der Konfliktlösungsstrategie nicht um Rename handelt.
object
renameIdTo
Optional. Zu verwendende ID-Zeichenfolge, wenn Sie ein Verbindungsobjekt importieren und Rename als Konfliktlösungsstrategie dient. Wenn Sie keine Verbindungs-ID angeben, generiert infacmd eine ID durch Anhängen einer Nummer an das Ende der Verbindungs-ID. Infacmd ignoriert den Wert, wenn keine Konflikte auftreten oder wenn es sich bei der Konfliktlösungsstrategie nicht um Rename handelt.

Import-Steuerdatei-Beispiel für Domänenobjekte

Der folgende Code zeigt ein Beispiel einer Import-Steuerdatei für Domänenobjekte:
<?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>

Importsteuerdateiparameter für Modellrepository-Objekte

Verwenden Sie die Importsteuerdateiparameter zum Konfigurieren der Objekte, die Sie aus einer XML-Datei in das Modellrepository importieren möchten.
Eine Importsteuerdatei für Modellrepository-Objekte können die folgenden Elemente enthalten:
In der folgenden Tabelle werden die konfigurierbaren Attribute für das folderMap-Element in der Importsteuerdatei beschrieben:
Attributname
Attributbeschreibung
sourceProject
Erforderlich. Name des Quellprojekts in der Exportdatei, das die zu importierenden Objekte enthält. Bei diesem Wert muss die Groß-/Kleinschreibung nicht beachtet werden.
sourceFolderPath
Optional. Pfad des Quellordners in der Exportdatei, der die zu importierenden Objekte enthält. Verwenden Sie das folgende Format:
"/<folder_name>/<folder_name>"
Wenn beispielsweise ein Projekt einen Ordner mit dem Namen „F1“ enthält, ist „/F1“ der Ordnerpfad von F1. Um alle Objekte im Projekt zu importieren, geben Sie „/“ an. Bei diesem Wert muss die Groß-/Kleinschreibung nicht beachtet werden. Standardwert ist „/“.
targetProject
Erforderlich. Name des Projekts im Target-Repository, in das Objekte importiert werden sollen. Das Projekt muss im Repository vorhanden sein, bevor Sie diese Objekte importieren. Bei diesem Wert muss die Groß-/Kleinschreibung nicht beachtet werden.
targetFolderPath
Optional. Pfad des Ordners im Target-Repository, in das Sie Objekte importieren möchten. Verwenden Sie das folgende Format:
"/<folder_name>/<folder_name>"
Wenn beispielsweise ein Projekt einen Ordner mit dem Namen „F1“ enthält, ist „/F1“ der Ordnerpfad von F1. Um alle Objekte in das Target-Projekt zu importieren, geben Sie „/“ an. Der Ordner muss im Repository vorhanden sein, bevor Sie diese Objekte importieren. Bei diesem Wert muss die Groß-/Kleinschreibung nicht beachtet werden. Standardwert ist „/“.
recursive
Optional. Zeigt an, ob Objekte aus Unterordnern des angegebenen Ordners importiert werden sollen. Mit der Einstellung „true“ findet ein Import aus Unterordnern statt. Gültige Werte sind „true“ und „false“. Bei diesem Wert muss die Groß-/Kleinschreibung beachtet werden. Standardwert ist „true“.
auswählen
Optional. Zeigt an, ob infacmd alle übrigen Objekte im angegebenen Projekt importiert, wenn Sie ein objectList-Element für folderMap definieren. Bei Auswahl von „all“ werden alle übrigen Objekte importiert. Zum Beispiel importieren die folgenden Zeilen Zuordnungen mit einer Reuse-Lösungsstrategie. Die Zeilen importieren alle übrigen Objekte mit einer Replace-Lösungsstrategie:
<folderMap sourceProject="p1" targetProject="p2" select="all" resolution="replace">
<objectList type="Mapping" resolution="reuse" />
</folderMap>
Wenn Sie ein objectList-Element definieren und das select-Attribut nicht verwenden, importiert infacmd Objekte in Übereinstimmung mit den in objectList definierten Attribute. Zum Beispiel importieren die folgenden Zeilen Zuordnungen mit einer Replace-Lösungsstrategie:
<folderMap sourceProject="p1" targetProject="p2" resolution="replace">
<objectList type="Mapping" />
</folderMap>
Wenn Sie kein objectList-Element für folderMap definieren, wird der Standardwert „all“ verwendet. Zum Beispiel importiert die folgende Zeile alle Objekte mit einer Replace-Lösungsstrategie:
<folderMap sourceProject="p1" targetProject="p2" resolution="replace" />
Gültiger Wert ist „all“.
resolution
Optional. Lösungsstrategie bei Auftreten eines Namenskonflikts. Gilt für alle Objekte in diesem Ordner. Geben Sie einen der folgenden Werte an:
  • - Rename. Benennen Sie das Quellobjekt mit einem generierten Namen um und importieren Sie es anschließend.
  • - Replace. Ersetzen Sie das Target-Objekt mit dem Quellobjekt.
  • - Reuse. Verwenden Sie das Objekt im Modellrepository wieder.
  • - Keine.
Bei diesen Wert muss die Groß-/Kleinschreibung nicht beachtet werden. Der Standardwert ist „Keine“.
In der folgenden Tabelle werden die konfigurierbaren Attribute für das objectList-Element in der Importsteuerdatei beschrieben:
Attributname
Attributbeschreibung
Typ
Erforderlich. Typ des Modellrepository-Objekts, das in den angegebenen Ordnerpfad importiert werden soll. Gültige Werte beinhalten alle Objekttypen im Modellrepository. Sie können den Objekttyp in der Ansicht „Eigenschaften“ im Developer-Tool anzeigen. Beispielsweise können Sie „Relationales Datenobjekt“ oder „Profil“ eingeben. Bei diesem Wert muss die Groß-/Kleinschreibung nicht beachtet werden.
auswählen
Optional. Zeigt an, ob infacmd alle übrigen Objekte des angegebenen Typs importiert, wenn Sie ein object-Element für objectList definieren. Bei Auswahl von „all“ werden alle übrigen Objekte importiert. Zum Beispiel importieren die folgenden Zeilen MyMapping mit einer Reuse-Lösungsstrategie. Die Zeilen importieren alle übrigen Zuordnungen mit einer Replace-Lösungsstrategie:
<folderMap sourceProject="p1" targetProject="p2">
<objectList type="Mapping" select="all" resolution="replace">
<object name="MyMapping" resolution="reuse" />
</objectList>
</folderMap>
Wenn Sie ein Objektelement definieren und das select-Attribut nicht verwenden, importiert infacmd Objekte in Übereinstimmung mit den im Objektelement definierten Attributen. Zum Beispiel importieren die folgenden Zeilen die Zuordnung namens MyMapping mit einer Replace-Lösungsstrategie:
<folderMap sourceProject="p1" targetProject="p2">
<objectList type="Mapping" resolution="replace">
<object name="MyMapping"/>
</objectList>
</folderMap>
Wenn Sie kein object-Element für objectList definieren, wird der Standardwert „all“ verwendet. Zum Beispiel importieren die folgenden Zeilen alle Zuordnungen mit einer Replace-Lösungsstrategie:
<folderMap sourceProject="p1" targetProject="p2">
<objectList type="Mapping" resolution="replace" />
</folderMap>
Gültiger Wert ist „all“.
resolution
Optional. Lösungsstrategie bei Auftreten eines Namenskonflikts. Gilt für alle Objekte des angegebenen Typs. Geben Sie einen der folgenden Werte an:
  • - Rename. Benennen Sie das Quellobjekt mit einem generierten Namen um und importieren Sie es anschließend.
  • - Replace. Ersetzen Sie das Target-Objekt mit dem Quellobjekt.
  • - Reuse. Verwenden Sie das Objekt im Modellrepository wieder.
  • - Keine.
Bei diesen Wert muss die Groß-/Kleinschreibung nicht beachtet werden. Der Standardwert ist „Keine“.
In der folgenden Tabelle werden die konfigurierbaren Attribute für das Objektelement in der Importsteuerdatei beschrieben:
Attributname
Attributbeschreibung
name
Erforderlich. Name eines bestimmten zu importierenden Objekts des angegebenen Objekttyps. Bei diesem Wert muss die Groß-/Kleinschreibung nicht beachtet werden.
resolution
Optional. Lösungsstrategie bei Auftreten eines Namenskonflikts für dieses Objekt. Geben Sie einen der folgenden Werte an:
  • - Rename. Benennen Sie das Quellobjekt um und importieren Sie es anschließend.
  • - Replace. Ersetzen Sie das Target-Objekt mit dem Quellobjekt.
  • - Reuse. Verwenden Sie das Objekt im Modellrepository wieder.
  • - Keine.
Bei diesen Wert muss die Groß-/Kleinschreibung nicht beachtet werden. Der Standardwert ist „Keine“.
renameTo
Optional. Zu verwendender Name, wenn Rename als Konfliktlösungsstrategie dient. Wenn Sie keinen Namen festlegen, generiert infacmd einen Namen durch Anhängen einer Zahl an das Ende des Namens. Infacmd ignoriert den Wert, wenn keine Konflikte auftreten oder wenn es sich bei der Konfliktlösungsstrategie nicht um Rename handelt.
renameIdTo
Optional. Zu verwendender ID-String beim Importieren eines Verbindungsobjekts und wenn die Konfliktlösungsstrategie „Umbenennen“ lautet. Wenn Sie keine Verbindungs-ID angeben, generiert infacmd eine ID, indem eine Nummer an das Ende der Verbindungs-ID angehängt wird. Infacmd ignoriert den Wert, wenn keine Konflikte auftreten oder wenn es sich bei der Konfliktlösungsstrategie nicht um Rename handelt.
In der folgenden Tabelle werden die konfigurierbaren Attribute für das rebind-Element in der Importsteuerdatei beschrieben:
Attributname
Attributbeschreibung
source
Erforderlich. Name einer Quellverbindung in der Datei, die Sie importieren. Bei diesem Wert muss die Groß-/Kleinschreibung nicht beachtet werden.
target
Erforderlich. Name einer Verbindung im Target-Modellrepository, die der Quellverbindung zugeordnet werden soll. Standardmäßig muss die Verbindung im Zielrepository vorhanden sein, bevor Sie diese Objekte importieren. Wenn die Verbindung nicht vorhanden ist, schlägt der Import fehl. Wenn Sie infacmd ausführen, können Sie die Validierung der Zielverbindung während des Imports überspringen. Wenn Sie die Validierung der Zielverbindung überspringen, wird der Import auch dann erfolgreich ausgeführt, wenn keine Verbindung im Zielrepository vorhanden ist. Bei diesem Wert muss die Groß-/Kleinschreibung nicht beachtet werden.

Importsteuerdateibeispiel für Modellrepository-Objekte

Der folgende Code zeigt ein Beispiel einer Importsteuerdatei für Modellrepository-Objekte:
<?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>