Freigeben über


Hinzufügen von Transformationszuordnungen für den Import

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

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

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:

Kolumne 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.

Eingabe-Parameter Description
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 Description
String Verkettete Zeichenfolge.

Split

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

Eingabe-Parameter Description
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 Description
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.

Eingabe-Parameter Description
Eingabezeichenfolge Zeichenfolge, die eine Teilzeichenfolge enthält.
Startindex Anfangsposition der Teilzeichenfolge.
Length Länge der Teilzeichenfolge. Wenn die Länge NULL ist, wird vom Startindex eine vollständige Zeichenfolge zurückgegeben.
Ausgabeparameter Description
Substring Zurückgegebene Teilzeichenfolge.

Replace

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

Eingabe-Parameter Description
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 Description
Wert Ersatzwert (gleich dem zugewiesenen Wert)

Wert zuweisen

Ersetzt alle Werte durch einen angegebenen Wert.

Eingabe-Parameter Description
Wert Wert, den Sie zuweisen möchten.
Ausgabeparameter Description
Wert Ersatzwert (gleich dem zugewiesenen Wert)

Hinweis

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

Hinzufügen zum Datum

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

Eingabe-Parameter Description
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 Description
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.

Eingabe-Parameter Description
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 Description
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.

Eingabe-Parameter Description
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 an, ob der Offset relativ zum aktuellen Datum oder absoluten Wert ist, indem Sie die TransformationParameterMapping.Data Spalte verwenden. 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 in den Auswahlwerten für diese Tabelle. Um die Metadaten für Ihre Organisation anzuzeigen, installieren Sie die Metadatenbrowserlösung, die unter "Tabellendefinitionen durchsuchen" in Ihrer Umgebung beschrieben ist. Sie können auch die Referenzdokumentation für Tabellen in der Dataverse-Tabelle/Entitätsreferenz 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 an, ob der Offset relativ zum aktuellen Datum oder absoluten Wert ist, indem Sie die TransformationParameterMapping.Data Spalte verwenden. 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 in 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 an, ob der Offset relativ zum aktuellen Datum oder absoluten Wert ist, indem Sie die TransformationParameterMapping.Data Spalte verwenden. 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 in 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 Description
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
Datenzuordnungen für Import erstellen
Konfigurieren des Datenimports
Ausführen des Datenimports
Datenimportentitäten
Beispiel: Exportieren und Importieren einer Datenzuordnung
Beispiel: Importieren von Daten mithilfe einer komplexen Datenzuordnung