Hinzufügen von Transformationszuordnungen für den Import

Verwenden Sie Transformationszuordnungen, um Daten zu ändern, bevor Sie sie Importieren. Teilen Sie z. B. einen vollständigen Namen, der in der Quelldatei enthalten ist, in einen Vornamen und einen Nachnamen auf, um die Zielspalten für eine Tabelle anzupassen.

Verwenden Sie zum Implementieren der Transformations-Zuordnung die Tabelle TransformationMapping und die Tabelle TransformationParameterMapping.

Die transformierten Daten müssen mit den Microsoft Dataverse-Spaltentypen kompatibel sein.

Der Transformationstyp wird von der TransformationMapping.TransformationTypeName-Eigenschaft beschrieben. Die gültigen Werte für diese Eigenschaft werden in der folgenden Tabelle aufgeführt:

Spalte	Wert
AddToCurrentDate	Microsoft.Crm.Transformations.AddToCurrentDate
AddToDate	Microsoft.Crm.Transformations.AddToDate
AdvancedAddToCurrentDate	Microsoft.Crm.Transformations.AdvancedAddToCurrentDate
AssignValue	Microsoft.Crm.Transformations.AssignValue
Concatenate	Microsoft.Crm.Transformations.Concatenate
Replace	Microsoft.Crm.Transformations.Replace
Split	Microsoft.Crm.Transformations.Split
Substring	Microsoft.Crm.Transformations.Substring

In den folgenden Abschnitten werden die verfügbaren Transformationen beschrieben.

Verkettung

Verkettet Zeichenfolgen und trennt sie mit einem Trennzeichen.

Eingabeparameter	Beschreibung
Präfix	Zeichenfolge, die als Präfix in der verketteten Zeichenfolge verwendet wird.
Suffix	Zeichenfolge, die als Suffix in der verketteten Zeichenfolge verwendet wird.
Trennzeichen	Ein Zeichen oder eine Kombination von Zeichen, die Teilzeichenfolgen innerhalb der verketteten Zeichenfolge trennen. Das Trennzeichen wird nicht zwischen dem Präfix und der Teilzeichenfolge oder Suffix und der Teilzeichenfolge verwendet. Verwenden Sie nicht die Zeichen für zurück (\b), neue Zeile (\n) und Zeilenumbruch (\r) als ein Trennzeichen.
<Variable>	Array variabler Länge, das Teilzeichenfolgen enthält.

Ausgabeparameter	Beschreibung
Zeichenfolge	Verkettete Zeichenfolge.

Teilen

Trennt eine Zeichenfolge, die ein Trennzeichen in Teilzeichenfolgen enthält. Es kann bis zu zehn Teilzeichenfolgen geben.

Eingabeparameter	Beschreibung
Eingabezeichenfolge	Zeichenfolge, die mindestens eine Teilzeichenfolge enthält, die mit Trennzeichen getrennt wird.
Trennzeichen	Ein Zeichen oder eine Kombination von Zeichen, die Teilzeichenfolgen innerhalb der Zeichenfolge trennen. Verwenden Sie nicht die Zeichen für zurück (\b), neue Zeile (\n) und Zeilenumbruch (\r) oder leere Zeichenfolgen als ein Trennzeichen.

Ausgabeparameter	Beschreibung
Variable	Teilzeichenfolgen 1 durch Maximum von 10.

Angenommen die Eingabezeichenfolge enthält elf , Teilzeichenfolgen, die Ausgabe enthält zehn Teilzeichenfolgen, wie im folgenden Beispiel gezeigt:

Eingabezeichenfolge: a;b;c;d;e;f;g;h;i;j;k

Ausgabe:

 a  
 b  
 c  
 d  
 e  
 f 
 g
 h  
 i  
 j;k  

Substring

Gibt eine Teilzeichenfolge einer bestimmten Länge zurück, beginnend an einem bestimmten Punkt der Zeichenfolge.

Eingabeparameter	Beschreibung
Eingabezeichenfolge	Zeichenfolge, die eine Teilzeichenfolge enthält.
Startindex	Anfangsposition der Teilzeichenfolge.
Länge	Länge der Teilzeichenfolge. Wenn die Länge NULL ist, wird vom Startindex eine vollständige Zeichenfolge zurückgegeben.

Ausgabeparameter	Beschreibung
Teilzeichenfolge	Zurückgegebene Teilzeichenfolge.

Ersetzen

Ersetzt alle Vorkommen einer angegebenen Zeichenfolge durch eine andere angegebene Zeichenfolge.

Eingabeparameter	Beschreibung
Eingabezeichenfolge	Zeichenfolge, die eine Suchzeichenfolge enthält.
Suchzeichenfolge	Suchzeichenfolge Verwenden Sie nicht die Zeichen für zurück (\b), neue Zeile (\n) und Zeilenumbruch (\r) als eine Suchzeichenfolge.
Zeichenfolge ersetzen	Die Ersetzungszeichenfolge. Verwenden Sie eine leere Zeichenfolge, um eine Suchzeichenfolge zu entfernen. Verwenden Sie nicht die Zeichen für zurück (\b), neue Zeile (\n) und Zeilenumbruch (\r) als eine Ersatzzeichenfolge.

Ausgabeparameter	Beschreibung
Wert	Ersatzwert (gleich dem zugewiesenen Wert)

Wert zuweisen

Ersetzt alle Werte durch einen angegebenen Wert.

Eingabeparameter	Beschreibung
Wert	Wert, den Sie zuweisen möchten.

Ausgabeparameter	Beschreibung
Wert	Ersatzwert (gleich dem zugewiesenen Wert)

Hinweis

Datumstransformationen können nur für ordnungsgemäß formatierte Datumswerte verwendet werden. Informationen zum Formatieren von Daten finden Sie in der Hilfe in Dataverse.

Hinzufügen zum Datum

Fügt einem Datum eine bestimmte Anzahl von Tagen, Monaten und Jahren hinzu.

Eingabeparameter	Beschreibung
Datum	Datumszeichenfolge, die geändert werden soll.
Offset für das Jahr	Positiver oder negativer Wert, der einer Jahreskomponente eines Eingabedatums hinzugefügt wird.
Offset für den Monat	Positiver oder negativer Wert, der einer Monatskomponente eines Eingabedatums hinzugefügt wird.
Offset für den Tag.	Positiver oder negativer Wert, der einer Tagkomponente eines Eingabedatums hinzugefügt wird.

Ausgabeparameter	Beschreibung
Neues Datum	Neue Datenzeichenfolge, die Tag, Monat, und Jahr in dieser Reihenfolge hinzugefügt enthält.

Anpassen des aktuellen Datums und Festlegen der Zeit

Fügt dem aktuellen Datum eine angegebene Anzahl von Tagen, Monaten und Jahren hinzu und legt die angegebene Uhrzeit fest. Die Offsets können nur ganze Zahlen sein.

Eingabeparameter	Beschreibung
Offset für das Jahr.	Positiver oder negativer Wert, der einer Jahreskomponente eines aktuellen Datums hinzugefügt wird.
Offset für den Monat	Positiver oder negativer Wert, der einer Monatskomponente eines aktuellen Datums hinzugefügt wird.
Offset für den Tag	Positiver oder negativer Wert, der einer Tageskomponente eines aktuellen Datums hinzugefügt wird.
Stunden	Wert, der verwendet wird, um die Stundenkomponente des aktuellen Datums festzulegen.
Minuten	Wert, der verwendet wird, um die Minutenkomponente des aktuellen Datums festzulegen.
Sekunden	Wert, der verwendet wird, um die Sekundenkomponente des aktuellen Datums festzulegen.
Wochentag	Wochentag, der Montag, Dienstag, Mittwoch, Donnerstag, Freitag, Samstag oder Sonntag sein kann. Die Wochentage werden von ganzen Zahlen, beginnend mit der Dezimalstellen 1 für Montag, dargestellt. Die Werte für Wochentage sind in der DayOfWeek-Enumeration enthalten. Weitere Informationen über diese Enumeration finden Sie im MSDN-Thema DayOfWeekEnumeration. Wenn das berechnete aktuelle Datum nicht dem angegebene Wochentag entspricht, wird es auf das nächst frühere Datum angepasst, das auf den angegebenen Wochentag fällt. Das aktuelle Datum wird stets auf ein Datum in der Vergangenheit angepasst. Wenn Sie z. B. Mittwoch als ein Wochentag angeben, und das neu berechnete Datum fällt auf Dienstag, den 9. März, wird das Datum auf Mittwoch, den 3. März angepasst.

Ausgabeparameter	Beschreibung
Neues Datum	Neue Datenzeichenfolge, die Tag, Monat, und Jahr in dieser Reihenfolge hinzugefügt enthält.

Erweitertes Hinzufügen zum aktuellen Datum

Fügt dem aktuellen Datum eine angegebene Anzahl von Tagen, Monaten und Jahren hinzu. Sie können angeben, ob Offsets relativ zum aktuellen Datum oder zu absoluten Werten sind. Die Offsets können nur ganze Zahlen sein.

Wenn Sie beispielsweise den absoluten Wert 3 für einen Monatsoffset verwenden, ist neu berechnete Monat März Wenn Sie ein relatives zu aktuellem Datumsmonatsoffset auf 3 festlegen und der aktuelle Monat April ist, ist der neu berechnete Monat Juli.

Eingabeparameter	Beschreibung
Offset für das Jahr	Positiver oder negativer Wert, der einer Jahreskomponente eines aktuellen Datums oder absoluten Jahres hinzugefügt wird.
Offsetmodus für das Jahr.	Geben Sie mit der Spalte TransformationParameterMapping.Data an, ob der Offset relativ zum aktuellen Datum oder absolut ist. Bei Nutzung von Typen mit früher Bindung, können Sie die TransformationOffsetMode-Enumeration verwenden, um relativen oder absoluten Offset anzugeben. Eine Liste der DataTypeCode-Werte finden Sie bei den Auswahlwerten für diese Tabelle. Um die Metadaten für Ihre Organisation anzuzeigen, installieren Sie die Lösung „Metadata Browser”, die in Tabellendefinitionen in Ihrer Umgebung durchsuchen beschrieben wird. Sie können auch die Referenzdokumentation für Tabellen in der Dataverse-Tabellen/-Entitäten-Referenz durchsuchen.
Offset für den Monat	Positiver oder negativer Wert, der einer Monatskomponente eines aktuellen Datums oder absoluten Monats hinzugefügt wird.
Offsetmodus für den Monat.	Geben Sie mit der Spalte TransformationParameterMapping.Data an, ob der Offset relativ zum aktuellen Datum oder absolut ist. Bei Nutzung von Typen mit früher Bindung, können Sie die TransformationOffsetMode-Enumeration verwenden, um relativen oder absoluten Offset anzugeben. Eine Liste der DataTypeCode-Werte finden Sie bei den Auswahlwerten für diese Tabelle.
Offset für den Tag.	Positiver oder negativer Wert, der einer Tageskomponente eines aktuellen Datums oder absoluten Tages hinzugefügt wird.
Offsetmodus für den Tag.	Geben Sie mit der Spalte TransformationParameterMapping.Data an, ob der Offset relativ zum aktuellen Datum oder absolut ist. Bei Nutzung von Typen mit früher Bindung, können Sie die TransformationOffsetMode-Enumeration verwenden, um relativen oder absoluten Offset anzugeben. Eine Liste der DataTypeCode-Werte finden Sie bei den Auswahlwerten für diese Tabelle.
Stunden	Wert, der die Stundenkomponente des aktuellen Datums festlegt.
Minuten	Wert, der die Minutenkomponente des aktuellen Datums festlegt.
Sekunden	Wert, der die Sekundenkomponente des aktuellen Datums festlegt.

Ausgabeparameter	Beschreibung
Neues Datum	Neue Datenzeichenfolge, die Tag, Monat, und Jahr in dieser Reihenfolge hinzugefügt enthält. Zunächst werden die relativen Komponenten hinzugefügt, und anschließend werden die absoluten Werte verwendet, um ein Datum zu bilden.

Siehe auch

Importieren von Daten
Vorbereiten einer Quelldatei für den Import
Erstellen von Datenzuordnungen für den Import
Konfiguration des Datenimports
Ausführen des Datenimports
Datenimportentitäten
Beispiel: Exportieren und Importieren einer Datenzuordnung
Beispiel: Importieren von Daten mithilfe der komplexen Datenzuordnung

Hinweis

Können Sie uns Ihre Präferenzen für die Dokumentationssprache mitteilen? Nehmen Sie an einer kurzen Umfrage teil. (Beachten Sie, dass diese Umfrage auf Englisch ist.)

Die Umfrage dauert etwa sieben Minuten. Es werden keine personenbezogenen Daten erhoben. (Datenschutzbestimmungen).