Versionsparameter als Dimensionsparameter in Pentaho importieren
Wenn ein Skript-Loader oder eine Skript-Datenquelle Parameter enthält, werden diese Parameter normalerweise als Umgebungsvariablen an Pentaho übergeben. Versionsparameter können nicht als Umgebungsvariablen an Pentaho übergeben werden. Sie müssen Versionsparameter als Dimensionsparameter an den Agenten übergeben. Sobald ein Dimensionsparameter für eine Version erstellt wurde, können Sie ihn zur Laufzeit überschreiben, sodass er in einer Liste von Versionen ausgewählt werden kann.
- Erstellen Sie einen neuen Dimensionsparameter in der Skript-Datenquelle.

- Geben Sie dem Parameter einen Anzeigenamen wie z. B. „Planning Version to Load“.
- Wählen Sie das Element aus, das in der ausgewählten Dimension liegen soll. Die Auswahl des obersten Knotens der Versionsdimension entspricht der Auswahl des Dimensionswerts der Standardplanversion.

- Der Datendesigner kann den Dimensionsparameter bestimmten Skript-Loadern und Skript-Datenquellen zuordnen, indem Sie den Parameter in den Bereich „Parameter“ ziehen.

- Wenn einer Skript-Datenquelle ein Dimensionsparameter zugeordnet ist und ein Benutzer im Bildschirm „Datendesigner“ aufDaten importierenklickt, wird das in Schritt 3 ausgewählte Element angezeigt. Der Standardwert kann überschrieben werden, indem Sie eine andere Version auswählen. Der Integrationsoperator-Bildschirm zum Starten einer Aufgabe in Integration weist dasselbe Verhalten auf.

- Wenn es sich bei der ausgewählten Dimension um die Planversion handelt, wird als Sonderwert „[Standardversion]“ eingeschlossen. Dies bedeutet, dass die aktuell ausgewählte Standardversion der Planning-Anwendung verwendet wird. Die Ordnerstilelemente im Dimensionsbaum können nicht ausgewählt werden, wenn die Planversion ausgewählt ist.
- Wenn das Pentaho Kettle-Skript ausgeführt wird, stehen in der Kettle-Umgebung für jeden der Dimensionsparameter drei Variablen zur Verfügung: <Anzeigename>.DimensionIsSelected, <Anzeigename>.DimensionName, <Anzeigename>.MemberName. Das Pentaho Kettle-Skript kann diese auf jede für das Skript zutreffende Weise verwenden.
Beispiel für Dimensionsversionsparameter in einer Skript-Datenquelle
Im folgenden Beispiel ist „Planning Version to Load“ der Anzeigename des Parameters, der im Datendesigner in Schritt 2 konfiguriert wurde.
- Planning Version to Load.MemberName: Der Anzeigename des ausgewählten Elements.
- Wenn das Element auf Root-Ebene (die Dimension selbst) ausgewählt wird, ist dieser Wert leer.
- Planning Version to Load.DimensionName: Der Anzeigename der dem Parameter zugeordneten Dimension.
- Planning Version to Load.DimensionIsSelected: Hat den Wert „true“ oder „false“ und gibt an, ob das ausgewählte Element das Element auf Root-Ebene ist, also die Dimension selbst.

Eine häufige Verwendung des Versionsdimensionswerts ist eine
Adaptive Planning
Ausgabeschritt in Spoon, wie unten gezeigt.