Der Befehl Declare wird verwendet, um Felddefinitionen zu erstellen, in denen Sie Beziehungen zwischen Feldern und Funktionen festlegen können. Mithilfe mehrerer Felddefinitionen lassen sich automatisch abgeleitete Felder erstellen, die als Dimensionen verwendet werden können. Sie können beispielsweise eine Kalenderdefinition erstellen und diese zur Generierung von damit in Bezug stehenden Dimensionen, wie Jahr, Monat, Woche und Tag, aus einem Datumsfeld verwenden.
Sie können Declare verwenden, um entweder eine neue Felddefinition festzulegen oder eine Felddefinition auf der Grundlage einer bereits vorhandenen Definition erstellen.
Festlegen einer neuen Felddefinition
Syntax:
definition_name:
Declare [Field[s]] Definition [Tagged tag_list ]
[Parameters parameter_list ]
Fields field_list
Argumente:
| Argument | Beschreibung |
|---|---|
| definition_name | Name der Felddefinition, beendet mit einem Doppelpunkt. WarnhinweisVerwenden Sie autoCalendar nicht als Namen für Felddefinitionen, da dieser Name für automatisch generierte Kalendervorlagen reserviert ist. Beispiel: Calendar: |
| tag_list | Eine durch Kommas getrennte Liste mit Tags, die auf über die Felddefinition abgeleitete Felder anzuwenden sind. Das Anwenden von Tags ist optional, aber wenn Sie keine Tags wie $date, $numeric oder $text zum Festlegen einer Sortierreihenfolge anwenden, wird das abgeleitete Feld standardmäßig nach Lade-Reihenfolge sortiert. Beispiel: '$date'Thank you for bringing this to our attention, and apologies for the inconvenience. |
| parameter_list | Eine durch Kommas getrennte Liste der Parameter. Ein Parameter wird in der Form name=value definiert. Ihm wird ein Startwert zugewiesen, der bei der Wiederverwendung der Felddefinition überschrieben werden kann. Optional. Beispiel: first_month_of_year = 1 |
| field_list | Eine durch Kommas getrennte Liste der zu generierenden Felder, wenn die Felddefinition verwendet wird. Ein Feld wird in der Form <expression> As field_name tagged tag definiert. Verwenden Sie $1 zur Bezugnahme auf das Datenfeld, aus dem die abgeleiteten Felder generiert werden sollen. Beispiel: Year($1) As Year tagged ('$numeric') |
Beispiel:
Der Kalender ist jetzt definiert und Sie können ihn auf die Datumsfelder anwenden, die Sie geladen haben, in diesem Fall OrderDate und ShippingDate. Dazu dient eine Derive-Bedingung.
Abgeleitete Felder (vollständiges Beispiel)
Wiederverwenden einer vorhandenen Felddefinition
Syntax:
<definition name>:
Declare [Field][s] Definition
Using <existing_definition>
[With <parameter_assignment> ]
Argumente:
| Argument | Beschreibung |
|---|---|
| definition_name | Name der Felddefinition, beendet mit einem Doppelpunkt. Beispiel: MyCalendar: |
| existing_definition | Die Felddefinition, die beim Erstellen einer neuen Felddefinition wiederverwendet werden soll. Die neue Felddefinition funktioniert wie die Definition, die ihr zugrunde liegt, mit der Ausnahme, wenn parameter_assignment zum Ändern eines Werts in den Feldformeln verwendet wird. Beispiel: Using Calendar |
| parameter_assignment | Eine durch Kommas getrennte Liste der Parameterzuweisungen. Eine Parameterzuweisung wird in der Form name=value festgelegt und überschreibt den Parameterwert, der in der Basisfelddefinition festgelegt ist. Optional. Beispiel: first_month_of_year = 4 |
Beispiel:
In diesem Beispiel verwenden wir die Kalenderdefinition, die im vorhergehenden Beispiel erstellt wurde, erneut. In diesem Fall soll das Geschäftsjahr im April beginnen. Dies wird erreicht, indem dem Parameter first_month_of_year der Wert 4 zugewiesen wird, was sich auf das definierte Feld DayNumberOfYear auswirkt.
Im Beispiel wird angenommen, dass Sie die Beispieldaten und die Felddefinition des vorherigen Beispiels verwenden.
Wenn Sie das Datenskript neu geladen haben, sind die generierten Felder im Arbeitsblatteditor verfügbar und tragen die Namen OrderDate.MyCalendar.* und ShippingDate.MyCalendar.*.