DM_setItemConstr

Intelligent Miner ® unterstützt Einschränkungen, die auf Taxonomien basieren. Taxonomien sind Klassen oder Kategorien von Elementen. Beispiel: Wenn 'Getränk' ein übergeordnetes Taxonomieelement der Elemente 'Saft' und 'Milch' ist und das Element 'Saft' ein übergeordnetes Taxonomieelement des Elements 'Orangensaft', können Sie eine Elementvorgaben für das übergeordnete Taxonomieelement 'Getränk' angeben. Diese Elementvorgabe hat die folgenden Auswirkungen:
  • Wenn die Vorgabe positiv ist (Vorgabetyp 1, 2 oder 3), durchlaufen nur die Regeln oder die Sequenzen den Filter, die im Rumpf (1), im Kopf (2) oder in der gesamten Sequenz bzw. Regel (3) 'Getränk' enthalten.
  • Wenn die Vorgabe negativ ist (Vorgabetyp -1, -2 oder -3) durchlaufen nur die Regeln oder die Sequenzen den Filter, die weder 'Getränk' noch zugehörige direkte oder indirekte gleichgeordnete Elemente der Taxonomie ('Saft', 'Milch', 'Orangensaft') im Rumpf (1), im Kopf (2) oder in der gesamten Sequenz bzw. Regel (3) enthalten.

Syntax

Methodensyntax

Read syntax diagramSkip visual syntax diagramruleFltr..DM_setItemConstr(item ,constraintType,disjunctiveGroup )

Funktionssyntax

Read syntax diagramSkip visual syntax diagramDM_setItemConstr(ruleFltr ,item,constraintType, disjunctiveGroup)

Parameter

Regelfltr
Ein Wert des Typs DM_RuleFilter
Element
Ein Wert des Typs VARCHAR(1024). Der Name eines Elements oder eines übergeordneten Taxonomieelements, wie zum Beispiel eine Elementkategorie.
Vorgabetyp
Ein Wert des Typs INTEGER. Die folgende Liste zeigt gültige ganze Zahlen an, die die Art der Vorgabe angeben.
1
Das Element muss im Regelrumpf vorhanden sein.
2
Das Element muss im Regelkopf vorhanden sein.
3
Das Element muss in der Regel vorhanden sein.
11
Mindestens ein Element dieser Kategorie oder der Kategoriename muss im Regelrumpf vorhanden sein.
12
Mindestens ein Element dieser Kategorie oder der Kategoriename muss im Regelkopf vorhanden sein.
13
Mindestens ein Element dieser Kategorie oder der Kategoriename muss in der Regel vorhanden sein.
-1
Das Element darf nicht im Regelrumpf vorhanden sein.
-2
Das Element darf nicht im Regelkopf vorhanden sein.
-3
Das Element darf an keiner Stelle in der Regel enthalten sein.
-11
Ein Element dieser Kategorie darf nicht im Regelrumpf vorhanden sein.
-12
Ein Element dieser Kategorie darf nicht im Regelkopf vorhanden sein.
-13
Ein Element dieser Kategorie darf nicht in der Regel vorhanden sein.
disjunctiveGroup
Ein Wert des Typs INTEGER. Die eindeutige ID einer disjunktiven Gruppe von Elementvorgaben. Elementvorgaben werden standardmäßig durch den logischen Operator AND verknüpft. Dies bedeutet, wenn zwei Elementvorgaben mit unterschiedlichen Werten für die disjunktive Gruppe (oder mindestens eine disjunktive Gruppe mit dem Wert NULL) vorhanden sind, werden in das zu erstellende Modell nur die Regeln eingeschlossen, die beide Vorgaben erfüllen. Von Elementvorgaben, deren IDs der disjunktiven Gruppe gleich sowie ungleich NULL sind, wird erwartet, dass sie von dem logischen Operator OR verknüpft werden. Dies bedeutet, dass eine Regel nur mindestens eine der Elementvorgaben in dieser Gruppe erfüllen muss.

Rückgabewert

Der Rückgabewert hat den Typ DM_RuleFilter.

  • Wenn Element NULL und Vorgabetyp nicht NULL ist, tritt der folgende Fehler auf:

    IDM1236E: Für die Funktion "Variable3" ist die Variable Element außerhalb des gültigen Bereichs NULL setItemConstr

  • Wenn Element und Vorgabetyp NULL sind, wird der Wert Regelfilter zurückgegeben. Die jeweilige disjunktive Gruppe der Elementvorgaben wird entfernt oder es werden alle Gruppen entfernt, wenn die disjunktive Gruppe NULL ist.
  • Wenn Vorgabetyp NULL ist, wird der Wert Regelfilter zurückgegeben. Das jeweilige Element wird aus der disjunktiven Gruppe entfernt oder es wird aus der Standardgruppe entfernt, wenn die disjunktive Gruppe NULL ist.
  • Wenn Vorgabetyp ungültig ist, tritt der folgende Fehler auf:

    IDM1236E: Für die Funktion "Variable3" liegt die Variable Vorgabetyp außerhalb des gültigen Bereichs { 1, -1, 2, -2, 3, -3, 11, -11, 12, -12, 13, -13 } setItemConstr

  • Trifft keine der oben genannten Bedingungen zu, wird der Wert Regelfilter zurückgegeben. Er enthält eine Elementvorgabe für das angegebene Element und den angegebenen Vorgabetyp in der angegebenen disjunktiven Gruppe (oder in einer neuen disjunktiven Gruppe ATOMIC, wenn der Wert der angegebenen disjunktiven Gruppe NULL ist).