Aras Klassifizierung

Quelle: https://media.aras.com/wp-content/uploads/2024/05/Aras-Innovator-2024-Release-Extended-Classification.pdf

Übersetzt von https://translate.google.com

Diese Übersetzung dient ausschließlich mir persönlich zum Einrichten meiner offiziell eingerichteten ARAS Innovator Installation!

Übersicht

Mit der erweiterten Klassifizierungsfunktion von Aras Innovator können Benutzer ohne Administratorrechte Elementtypen klassifizieren,
ohne sie zu ändern. Benutzer können Elementen Eigenschaften basierend auf der erweiterten Klassifizierung des Elements zuweisen. Sie können auch klassenbasierte Suchvorgänge entweder programmgesteuert oder über die Benutzeroberfläche durchführen.
Dynamische Eigenschaften werden als erweiterte Eigenschaften (xProperty-Elementtyp) bezeichnet. Dynamische Klassen werden als erweiterte Klassen (xClass-Elementtyp) bezeichnet. Sie können xProperties mehreren xClasses zuweisen.
xProperties, die übergeordneten xClasses zugewiesen werden, werden von den untergeordneten xClasses übernommen. Sie können xProperties auch direkt mehreren Elementtypen als explizite xProperties zuweisen.
Benutzer mit den entsprechenden Berechtigungen können erweiterte Eigenschaftsdefinitionen und Klassifizierungsbäume entweder programmgesteuert oder über die Benutzeroberfläche erstellen und verwalten. Endbenutzer können einem Element mehrere xProperties
zuweisen. Sie können außerdem:

• Elemente klassifizieren
• Werte für die mit einem bestimmten Element verknüpften xProperties festlegen
• xProperty- und xClass-Werte verwenden, um nach Elementen zu suchen

1 Erstellen erweiterter Eigenschaften mithilfe der Benutzeroberfläche

Erweiterte Eigenschaften (xProperties) sind Eigenschaftsdefinitionen, die von jeder einzelnen ItemType-Definition isoliert sind. Mitglieder der Gruppenidentitäten „Administratoren“ oder „Klassifikationsadministratoren“ können diese erstellen. Mitglieder dieser Gruppen können auch eindeutige Berechtigungen für jede xProperty festlegen.

1.1 xProperty-Definition

Um xProperties zu definieren, wählen Sie im Inhaltsverzeichnis Erweiterte Klassifizierung → xProperties.

Klicken Sie auf „Neue xProperty erstellen“. Ein Bildschirm ähnlich dem folgenden wird angezeigt. Sie definieren eine xProperty auf die gleiche Weise wie eine ItemType-Eigenschaft. Definitionen umfassen Informationen wie Name, Bezeichnung und Datentyp.

1.2 Explizit definierte xProperties

Sie können xProperties direkt zu einem ItemType hinzufügen, getrennt von jeder xClassification-Definition. Um eine xProperty explizit mit einem ItemType zu verknüpfen, öffnen Sie die Definition des ItemType und fügen Sie die xProperty unter der Registerkarte xProperties hinzu. Sie können dann die Berechtigungen dieser xProperty entweder an die Standardberechtigungen des ItemType oder an ihre eigenen einzigartigen Berechtigungen binden. Es gibt zwei Einstellungen für einzigartige Berechtigungen, xProperty-Wertberechtigungen und explizite Berechtigungen. Wenn Sie die Berechtigungsverhalten auf „Keine Prüfung“ setzen, gelten die Standardberechtigungen für Elemente. Wenn Sie die Verhaltensweisen auf „Prüfung“ setzen, werden die konfigurierten Berechtigungen aktiviert. Berechtigungen werden in Abschnitt 3 ausführlicher beschrieben.

2 Erstellen erweiterter Klassifikationsbäume

xProperties sind in erster Linie über ihre erweiterten Klassifizierungen (xClassification/xClass) mit ItemTypes verknüpft. Diese sind im Inhaltsverzeichnis unter Erweiterte Klassifizierung –> xClassification Trees definiert. Der xClassification Tree ist eine hierarchische Struktur mit Unterklassen.

2.1 xKlassifikationsbäume

xClassification-Bäume werden in zwei Teilen definiert. Das Standardformular definiert Grundlagen wie den Namen und die Identifikationsnummer des Baums sowie zwei zusätzliche Konfigurationen: • Auswahl auf Blattklassen beschränken Wenn diese Option ausgewählt ist, können Sie im xClassification-Baum nur Blattklassen auswählen. Dies sind Klassen, die keine untergeordneten Klassen haben. • Auswahl auf eine einzelne Klasse beschränken Wenn diese Option ausgewählt ist, können Sie für jedes Element nur eine erweiterte Klassifizierung auswählen. Wenn Sie diese Option deaktivieren, können Sie einem einzelnen Element mehrere xClasses zuweisen, sodass alle diese xClasses-Eigenschaften verfügbar sind. Die Beziehungsregisterkarte „Elementtypen“ definiert die Elementtypen, für die dieser erweiterte Klassifizierungsbaum verfügbar ist.

Um den xClassification-Baum zu definieren, wählen Sie das Symbol Editor anzeigen in der grünen Seitenleiste. Dadurch wird ein Editor angezeigt, mit dem Sie die folgenden Funktionen ausführen können:

• Erstellen der Baumstruktur – Um eine neue xClass hinzuzufügen, klicken Sie mit der rechten Maustaste auf die oberste Ebene des Baums und wählen Sie Unterklasse einfügen. Die xClass der obersten Ebene hat denselben Namen wie der xClassification-Baum.
• Weisen Sie xProperties bestimmten xClasses zu – Wählen Sie die xClass aus dem Baum in der linken Spalte und wählen Sie Verwandte auswählen aus der Dropdown-Liste in der Symbolleiste rechts. Klicken Sie auf das Symbol Neue Beziehung. Das xProperty-Suchdialogfeld wird geöffnet und ermöglicht Ihnen, die gewünschte xProperty auszuwählen. Einer xClass können mehrere xProperties zugewiesen sein.

• In diesem xClassification Tree sind sieben xProperties verschiedenen xClasses zugeordnet. Wenn Sie einen Knoten auswählen, werden alle enthaltenen xProperties im rechten Raster angezeigt. Die mit grauem Hintergrund werden von xClasses höherer Ebene übernommen. Die für die ausgewählte xClass definierten xProperties werden mit weißem Hintergrund angezeigt.

• Innerhalb des Rasters können Sie Zeilen per Drag & Drop verschieben, indem Sie in einer bestimmten Zeile auf klicken, um die xProperties neu anzuordnen. Die angezeigte Reihenfolge entspricht der Reihenfolge, die auf dem Formular eines Elements angezeigt wird, wenn Sie die xClass auswählen, um das Element zu klassifizieren. Sie können auch die Schaltflächen „Nach oben verschieben“ und „Nach unten verschieben“ in der Editor-Symbolleiste verwenden, um Zeilen neu anzuordnen.

2.1.1 Überschreiben der Eigenschaften einer xProperty

Für eine bestimmte xProperty werden die Eigenschaften Label, Standardwert, Erforderlich und Nur Lesen auf globaler Ebene erstellt. Der Klassifizierungsadministrator kann den Wert dieser vier Eigenschaften überschreiben, wenn die xProperty einer xClass zugewiesen wird. Die neuen Werte (Überschrieben) sind die klassenspezifischen Eigenschaften der xProperty. Das Überschreiben der Eigenschaften einer xProperty kann im xClass-Baumeditor erfolgen.

Wenn Sie eine Zeile im Raster auswählen, werden in den Spalten „Beschriftung“, „Standardwert“, „Erforderlich“ oder „Schreibgeschützte Lösungen“ für diese xProperty Umschaltflächen angezeigt, wie im folgenden Screenshot gezeigt:

Die in diesen Zellen angezeigten Werte sind die globalen Werte. Wenn Sie auf eine Umschaltfläche klicken, wird der in der Zelle angezeigte Wert durch ein Leerzeichen ersetzt, wie hier gezeigt:

Klicken Sie auf die Zelle, um einen neuen Wert einzugeben. Dieser neue Wert ist der Override-Wert. Klicken Sie erneut auf den Umschaltknopf, um zum globalen Wert zurückzukehren. xProperties, die einer bestimmten xClass zugewiesen sind, werden im Raster mit einem weißen Hintergrund angezeigt. Geerbte xProperties werden mit einem grauen Hintergrund angezeigt. Es ist möglich, Eigenschaftswerte für xProperties zu überschreiben, die von einer höheren xClass geerbt wurden. Alle untergeordneten Klassen mit geerbten xProperties erben die Werte ihrer unmittelbaren übergeordneten Klasse – unabhängig davon, ob dieser Wert überschrieben oder von einer höheren Klasse geerbt wurde.

2.1.2 Eine xProperty inaktiv machen

Sie können eine mit einer xClass verknüpfte xProperty inaktiv machen, indem Sie das Flag „Inaktiv“ für diese Eigenschaft auswählen, wie hier gezeigt:

Wenn Sie eine xProperty inaktiv machen, können Endbenutzer sie nicht in der Benutzeroberfläche sehen. Dies gilt sowohl für vorhandene Elemente, denen die xProperty zugewiesen ist, als auch für neue Elemente, die Sie erstellt und
klassifiziert haben. Die xProperty und ihr zugehöriger Wert werden nicht gelöscht und Sie können sie erneut aktivieren, indem Sie das Kontrollkästchen Inaktiv deaktivieren.
Wenn Sie eine xProperty inaktiv machen, wird sie nicht mehr im Spaltenwähler, im Hauptraster oder im Beziehungsraster angezeigt. Sie wird auch nicht im Dialogfeld „Erweiterte Sucheigenschaft“ angezeigt. Wenn Sie die xProperty in einer gespeicherten Suche gespeichert haben, müssen Sie sie aktualisieren, damit sie nicht angezeigt wird, wenn Sie diese Suche
für ein Element auswählen.

3 Erweiterte Berechtigungen

Um einen xClassification Tree und xProperties verwenden zu können, müssen Sie für jeden ItemType erweiterte Berechtigungen im xClassification Tree-Formular festlegen. Im folgenden Fall werden zwei Berechtigungen für den Part-ItemType festgelegt, indem Sie mit der rechten Maustaste auf Part → Pick xProperty Value Permission und Pick Item Classification Permission klicken.

Legen Sie die folgenden Berechtigungen für explizite xProperties fest: Explizite Berechtigung und xProperty-Wertberechtigung. Diese Berechtigungen sollten für jede xProperty auf der Registerkarte „xProperties“ des ItemType festgelegt werden.

3.1 Berechtigungen für xProperty-Werte

Spezifische xProperty-Berechtigungen werden unter Erweiterte Klassifizierung → Berechtigungen für xProperty-Werte im Inhaltsverzeichnis definiert. Diese definieren den Zugriff auf die ausgewählten Identitäten zum Abrufen, Aktualisieren und Ändern:

Um die Berechtigung für den xClassification Tree zu definieren, klicken Sie mit der rechten Maustaste auf den ItemType unter der Registerkarte Item Types
in der Formularansicht und wählen Sie entweder Create xProperty Value Permission oder Pick xProperty Value Permission. Nach der Auswahl haben Sie die Möglichkeit, die ausgewählte Berechtigung anzuzeigen oder zu ersetzen.
Wenn das private Berechtigungsverhalten im xProperty-Formular auf „Beliebig“ eingestellt ist, können Sie ein x festlegen.

3.2 Berechtigungen zur Artikelklassifizierung

Wählen Sie im Inhaltsverzeichnis Erweiterte Klassifizierung → Berechtigungen zur Artikelklassifizierung, um bestimmte xClass-Berechtigungen zu definieren. Diese legen fest, ob Benutzer die aktuelle xClass sehen und ob sie die erweiterte Klassifizierung für einen Artikel festlegen oder löschen können.

Um die xClass-Berechtigungen zu definieren, klicken Sie mit der rechten Maustaste auf den ItemType auf der Registerkarte „Item Types“ in der Formularansicht und wählen Sie entweder „Item Classification Permission erstellen“ oder „Item Classification Permission auswählen“ aus. Nach der
Auswahl können Sie die ausgewählte Berechtigung entweder anzeigen oder ersetzen.

3.3 Explizite Berechtigungen

Explizite xProperty-Berechtigungen werden unter Erweiterte Klassifizierung → Explizite Berechtigungen im Inhaltsverzeichnis definiert. Diese legen den Zugriff einer Identität fest, um eine xProperty explizit zu definieren oder aufzuheben, sowie den Zugriff auf explizit definierte Abfrage-xProperties.

4 Erweiterte UI-Konfiguration

4.1 Anzeigen von xClasses und xProperties auf einem Item-Formular

Um xClasses und xProperties im Formular des Elements anzuzeigen, müssen Sie zuerst das Formular bearbeiten und ein neues xClass-Steuerelement einfügen, indem Sie auf die Auslassungspunkte im xClass-Feld klicken.

Hinweis: Hierzu müssen Sie über Administratorrechte verfügen.

Sobald Sie das Feld hinzugefügt haben, können Sie die xClass mithilfe des Auslassungssymbols oben rechts im xClass-Feld auswählen.
Das Dialogfeld „Klassifizierung“ wird angezeigt:

Eigenschaften für die ausgewählten xClasses werden im Feld unter einem Dropdown-Menü für jede xClass angezeigt. Sie können xClasses einzeln oder alle auf einmal erweitern, indem Sie das blaue Pfeilzeichen oben links im Feld auswählen:

5 Sucheigenschaften, xClasses und xProperties

Sie können mit der einfachen, erweiterten und AML-Suche nach Eigenschaften, xClasses und xProperties suchen, die mit Elementen verknüpft sind. Die xClass- und xProperty-Kriterien können auch in einer gespeicherten Suche gespeichert werden.

5.1.1 Verwenden des Spaltenselektors in Hauptrastern und Beziehungsrastern

Die Haupt- und Beziehungsraster-Symbolleisten enthalten das Symbol „Suche verfeinern“

. Wenn Sie auf das Symbol klicken, wird ein Dialogfeld ähnlich dem folgenden angezeigt. Das Dialogfeld enthält zwei Spalten – Eigenschaften und Klassifizierungen.

Hinweis: Bei den im folgenden Dialog angezeigten Daten handelt es sich um Beispieldaten.

Im Hauptraster zeigt die Spalte „Eigenschaften“ eine Liste der mit dem Element verknüpften Eigenschaften an. Wählen Sie eine der folgenden Optionen aus der Dropdown-Liste aus:

• Alle (Standard) zeigt alle Eigenschaften an.
• Standard zeigt alle Eigenschaften an, bei denen hidden2 = false und explizit definierte xProperties auf dem Verwandten ItemType
• Beziehung zeigt Eigenschaften an, bei denen hidden2 = false sowie explizit definierte xProperties und xProperties, die durch xClass-Bäume für den Beziehungs-ItemType zugewiesen wurden
• Erweitert zeigt alle xProperties an, die durch xClassification-Bäume für den Verwandten ItemType zugewiesen wurden

Die von Ihnen ausgewählten Standardeigenschaften werden als Spaltenüberschriften in den Haupt- und Beziehungsrastern angezeigt.
Wenn Sie die Auswahl von Eigenschaften aufheben, werden diese aus dem Raster entfernt.

In der Spalte „Klassifikationen“ wird der einem Element zugeordnete xClassification-Baum angezeigt.

Um nach mehreren xProperties oder xClasses zu suchen, klicken Sie auf das UND-Symbol . Klicken Sie auf das ODER-Symbol, um nach einer bestimmten xProperty oder xClass zu suchen.

• Wenn der Benutzer beispielsweise nach xClass X ODER xClass Y sucht, sollte die Suche nur Elemente zurückgeben, die als X oder als Y klassifiziert sind, oder Elemente, die sowohl als X als auch als Y klassifiziert sind. Und Elemente, die nach X und Z klassifiziert sind. Und Elemente, die nach Y und Z klassifiziert sind. Und Elemente, die nach X, Y und Z klassifiziert sind. usw. Solange ein Element nach X oder Y klassifiziert ist, sollte es zurückgegeben werden, unabhängig davon, wie es sonst noch klassifiziert ist.
• Wenn der Benutzer nach xClass X UND xClass Y sucht, sollte die Suche Elemente zurückgeben, die sowohl als X als auch als Y klassifiziert sind, und Elemente, die nach X, Y und Z klassifiziert sind.

5.1.1.1 Filtern der Eigenschaftenspaltenliste nach xClasses

Sie können nach xProperties suchen, die nur mit einer bestimmten xClass verknüpft sind, indem Sie xProperty-Spalten filtern, indem Sie xClasses auswählen. Wenn Sie eine xClass in der Klassifizierungsspalte auswählen, werden die mit dieser xClass verknüpften xProperties in der Eigenschaftenspalte angezeigt. Wenn Sie mehrere xClasses auswählen, werden die xProperties für alle xClass-Auswahlen in der Eigenschaftenspalte angezeigt. Wenn Sie das Steuerelement „xClass-Filter“ für xClasses deaktivieren, werden die zugewiesenen xProperties für diese xClasses nicht in der Eigenschaftenspalte angezeigt.

Wie im folgenden Screenshot gezeigt, führt die Auswahl des Filters für die xClass „Festkondensator“ dazu, dass die mit der xClass „Festkondensator“ verknüpften xProperties in der Spalte „Eigenschaften“ angezeigt werden. Das Filtersymbol für jede xClass befindet sich rechts neben dem Namen der xClass. Der Standardstatus des Symbols ist grau (nicht ausgewählt). Wenn Sie den Filter für eine bestimmte xClass auswählen, wird das Filtersymbol orange angezeigt.

5.1.1.2 xClass-Suchoptionen

In der Klassifizierungsspalte des Spaltenselektors stehen die folgenden Zustände (1-7, im Diagramm unten dargestellt) zur Auswahl der xClass zur Verfügung, die in die Suchkriterien einbezogen werden soll.

Mit den Kontrollkästchen rechts neben dem xClass-Namen können Sie die xClass auswählen, die in die Suchkriterien einbezogen werden soll. Die xClass, die Sie für die Suche auswählen, wird in der xClass-Leiste angezeigt. Weitere Informationen finden Sie in Abschnitt 5.1.1.3.

Abbildung 18 zeigt die verschiedenen Zustände der Kontrollkästchen. Jeder dieser Zustände wird hier beschrieben:

• Nicht ausgewählt + Unbestimmt – Dies ist der Standardsuchstatus für alle xClasses. Das Unbestimmt-Symbol zeigt an, dass es inaktiv ist. Die Rasterergebnisse können nach dieser xClass klassifiziert sein oder nicht.
• Aktiviert – Wenn Sie auf das Kästchen klicken, zeigt das angezeigte Häkchen an, dass die xClass als einzelnes Suchkriterium aufgenommen wurde.
• Hart aktiviert (Unterklassen einschließen) – Wenn Sie ein xClass-Kontrollkästchen zweimal anklicken, zeigen die invertierten Farben des Häkchensymbols an, dass sowohl diese xClass als auch alle zugehörigen Unterklassen als Suchkriterien aufgenommen wurden. (Nur verfügbar bei Verwendung der UND-Logik).
• Leicht aktiviert – Das normale Häkchensymbol ist ausgegraut, um anzuzeigen, dass die xClass als einzelnes Suchkriterium aufgenommen wurde. Sie können diesen Status nicht anklicken. Er wird nur angezeigt, wenn eine übergeordnete xClass auf „Hart aktiviert“ gesetzt wurde.
• Nicht aktiviert – Das leere Kästchen zeigt an, dass die Suchergebnisse diese xClass NICHT enthalten dürfen.
• Hart deaktiviert (Unterklassen ausschließen) – Der blaue Rand um das leere Kästchen zeigt an, dass die Suchergebnisse diese xClass oder eine ihrer Unterklassen NICHT enthalten dürfen. (Nur verfügbar, wenn die UND-Logik verwendet wird).
• Weich deaktiviert – Das leere Kästchen zeigt an, dass die Suchergebnisse die xClass NICHT enthalten dürfen. Sie können diesen Status nicht auswählen. Er wird nur angezeigt, wenn eine übergeordnete xClass auf „Hart deaktiviert“ gesetzt wurde.

Der Klickzyklus für xClasses mit Unterklassen, in denen die „UND“-Logik aktiv ist, beginnt mit der Standardeinstellung „Nicht ausgewählt + unbestimmt“. Er geht dann weiter über Aktiviert, Hart aktiviert, Nicht aktiviert, Hart deaktiviert und dann zurück zu Nicht ausgewählt + unbestimmt.

• Der Klickzyklus für alle anderen Bedingungen beginnt mit der Standardeinstellung Nicht ausgewählt + unbestimmt und ist
  Aktiviert, Nicht aktiviert und dann zurück zu Nicht ausgewählt + unbestimmt.
• Wenn Sie irgendwo außerhalb des Menüs klicken, wird das Menü geschlossen.
• Wenn Sie in der Suchsymbolleiste auf „Suche ausführen“ klicken, werden die xClass-Suchkriterien ausgeführt und die Ergebnisse zurückgegeben.
• Wenn Sie in der Suchsymbolleiste auf „Suchkriterien löschen“ klicken, werden alle xClass-Suchkriterien gelöscht.
• Beliebige Klassifizierung – Benutzer können auch nach Elementen mit beliebiger oder keiner Klassifizierung suchen, wie im folgenden
  Diagramm gezeigt.

1. Setzen Sie „Beliebige Klassifizierungen“ auf „Hart geprüft“, um nach Elementen zu suchen, die durch mindestens eine
   xClass aus den xClassification-Bäumen klassifiziert sind.
2. Wenn Sie „Beliebige Klassifizierungen“ auswählen, sollten alle xClasses in den Bäumen „weich geprüft“ sein.
3. Setzen Sie „Beliebige Klassifizierungen“ auf „Hart ungeprüft“, um nach Elementen zu suchen, die in keiner
   Klassifikation enthalten sind.
4. Nachdem Sie „Beliebige Klassifizierungen“ auf „Hart ungeprüft“ gesetzt haben, sollten alle xClasses „weich ungeprüft“ anzeigen.

Die verwendete Logik hat keine Auswirkung auf die Suche nach „Beliebiger Klassifizierung“ – wenn sie auf „UND“ oder „ODER“ eingestellt ist, funktioniert die Operation gleich.

5.1.1.3 Verwenden der xClass-Leiste

Wenn Sie xClasses auswählen und auf das Symbol

klicken, werden sie in der xClass-Leiste angezeigt, die im Hauptraster angezeigt wird, wie in Abbildung 22 dargestellt.

Das Beziehungsraster zeigt xClasses und xProperties folgendermaßen an:

Wenn Sie eine erweiterte Suche durchführen, zeigt das Raster xClasses wie folgt an:

Bei einer AML-Suche werden xClasses folgendermaßen angezeigt:

5.1.2 Suchen nach xProperties über mehrere ItemTypes hinweg

Sie können Elementen unabhängig vom Typ xProperties zuweisen. Mit dem folgenden Verfahren können Sie nach Elementen suchen, denen xProperties
zugeordnet sind:

1. Wählen Sie im Inhaltsverzeichnis Mein Innovator → Erweiterte Eigenschaftensuche. Das folgende Menü wird angezeigt:

2. Wählen Sie Suche Erweiterte Immobiliensuche. Das Suchraster erscheint

3. Um nach Elementen zu suchen, die mit einem bestimmten Elementtyp verknüpft sind, können Sie entweder den Elementtypnamen eingeben
   oder ihn aus der Dropdown-Liste in der Spalte „Elementtyp“ auswählen. Um eine Liste aller Elemente anzuzeigen, denen xProperties zugeordnet sind, lassen Sie die Spalte „Elementtyp“ leer und klicken Sie auf das Suchsymbol.

4. Wählen Sie ein Element im Raster aus und klicken Sie auf das Symbol „Spalten auswählen“, um eine Liste der Eigenschaften, xProperties und xClasses anzuzeigen, die dem ausgewählten Element zugeordnet sind.

5. Wählen Sie „Erweitert“ aus der Dropdown-Liste „Eigenschaften“, um die Liste der erweiterten Eigenschaften anzuzeigen, die mit dem Element verknüpft sind.

5.1.3 Durchführen einer erweiterten Suche

Mit der Option „Erweiterte Suche“ können Sie nach Werten suchen, die mit Folgendem verknüpft sind:

• xEigenschaften
• xKlassen
• Artikelklassifizierungen
• Explizite Berechtigungen

Das folgende Verfahren verwendet xClassification Tree als Beispiel:

1. Wählen Sie im Inhaltsverzeichnis Erweiterte Klassifizierung > xClassification Trees. Durch Klicken auf das Suchsymbol gelangen Sie direkt zum Suchraster. Durch Klicken auf xClassification Trees gelangen Sie zum folgenden Menü:

2. Klicken Sie auf „xClassification Trees durchsuchen“. Das Suchraster wird angezeigt.

3. Wählen Sie „Erweitert“ aus der Dropdown-Liste „Suchen“. Die Zeile „xProperty Selector“ wird angezeigt und ermöglicht Ihnen die Suche nach xProperties, die mit bestimmten ItemTypes verknüpft sind.

4. Klicken Sie auf das Symbol „Kriterien hinzufügen“, um Ihre Suchkriterien hinzuzufügen.

5. Wählen Sie den Artikeltyp aus der Dropdown-Liste aus:

6. Wählen Sie die Zelle „Eigenschaft“ aus und klicken Sie auf die Auslassungspunkte. Das Dialogfeld „Eigenschaft“ wird angezeigt.

7. Wählen Sie xClassification Tree/Relationships/xClassificationTree_ItemType aus der Eigenschaftenliste. Eine Liste der mit dem ItemType verknüpften Eigenschaften wird angezeigt.

8. Wählen Sie Verhalten aus und klicken Sie auf Übernehmen.
9. Klicken Sie auf die Dropdown-Schaltfläche in der Zelle „Operationen“ und wählen Sie =.
10. Wählen Sie die Dropdown-Schaltfläche in der Zelle „Kriterien“ und wählen Sie Float.
11. Klicken Sie auf Suchen. Eine Liste von xClassification-Bäumen, die den angegebenen Kriterien zugeordnet sind, wird im Raster angezeigt.

6 xEigenschaften in AML

In diesem Abschnitt wird beschrieben, wie Attribute und xProperties programmgesteuert in AML definiert werden.

6.1 Verwenden des @set-Attributs

Sie können die folgenden Vorgänge an einer xProperty ausführen, wenn Sie ein Element aktualisieren oder hinzufügen:

• Einen Wert festlegen.
• Ihn explizit definieren
• Die privaten Berechtigungen ändern

Sie müssen das Attribut @set zu einem xProperty-Knoten hinzufügen, um den auszuführenden Vorgang anzugeben.
Die folgende Liste enthält gültige Werte, die mit dem Attribut @set verknüpft sind:

• „Wert“
• „explizit“
• „Berechtigungs-ID“
• Jede beliebige Kombination der hier aufgeführten Werte, wobei „|“ als Trennzeichen verwendet wird (zum Beispiel bedeutet „explizit|Wert“
  „beide Vorgänge ausführen“).

Wenn Sie das Attribut @set nicht einschließen, werden keine Aktualisierungsvorgänge ausgeführt.

6.2 Explizites Definieren einer xProperty für ein Element

Der Unterschied zwischen xProperties und Standardeigenschaften besteht darin, dass Sie eine xProperty für ein Element definieren müssen, bevor Sie eine Operation (z. B. Wert abrufen/festlegen) damit durchführen können.

Sie können die xProperty entweder explizit oder implizit definieren. Um eine xProperty explizit zu definieren, müssen Sie die Attribute @explicit und @set zum Property-Knoten hinzufügen. Wenn Sie das Attribut @set nicht angeben oder es nicht den Wert „explicit“ enthält, wird das Attribut „@explicit“ ignoriert.

Das folgende Beispiel zeigt, wie Sie ein Element hinzufügen und eine xProperty programmgesteuert definieren. Der Standardwert wird für die Eigenschaft „xp-cost“ festgelegt, da das Attribut „set“ keine Zeichenfolge „value“ enthält:

Das folgende Beispiel aktualisiert ein Element und definiert die xProperty:

Dieses Beispiel aktualisiert das Element, definiert eine xProperty und legt ihren Wert fest:

Dieses Beispiel aktualisiert das Element und legt den Wert für eine bereits definierte xProperty fest:

Dies ist ein Beispiel dafür, wie eine explizit definierte xProperty undefiniert gemacht wird:

6.3 Auflösen mehrdeutiger Eigenschaftsnamen

Verwenden Sie das Präfix „xp-“, um eine xProperty von einer Standardeigenschaft in AML zu unterscheiden. Beispielsweise wäre der
xProperty-Name für die Kosteneigenschaft xp-cost. Diese Technik garantiert, dass Namen eindeutig sind, da Standardeigenschaften keinen Bindestrich als Teil eines Namens verwenden können.

Hinweis: Sie können Namespaces nicht verwenden, um mehrdeutige Eigenschaftsnamen aufzulösen, da diese in AML verwendet werden, um mehrsprachige Zeichenfolgen zurückzugeben. Dies funktioniert nicht für eine xProperty mit einem mehrsprachigen String-Datentyp. Siehe das folgende Beispiel. Das folgende AML ist ungültig.

6.4 Einem ItemType eine xPropertyDefinition zuweisen

Wenn Sie einem ItemType eine xProperty zuweisen, wird sie in AML als Eigenschaft des ItemType referenziert. Wenn Sie für ein Element keine xProperty definieren, wird sie ignoriert. Das folgende Beispiel ruft alle Elemente aus der Datenbank ab, deren Gewicht 15 und deren xProperty-Kosten 10 betragen:

Beispiel für das Abrufen von Elementen, wenn der Benutzer keine Berechtigungen für die xProperty hat:

Holen Sie alle Teilelemente aus der Datenbank, deren Gewicht 15 und deren xProperty-Kosten 10 betragen. Geben Sie für jedes gefundene Element die Artikelnummer, die Kosten und die xProperty-Kosten (explizit definiert) zurück.
Der Benutzer hat KEINE „Kann abrufen“-Berechtigung für die xProperty-Kosten.

Elemente mit „select=*“ abrufen – Beispiel:

Alle Teilelemente aus der Datenbank abrufen, deren Gewicht 15 und deren xProperty-Kosten (explizit definiert) 10 betragen. Das @select-Attribut ist nicht angegeben. Die xProperty-Länge ist für das resultierende Element definiert und hat einen NULL-Wert. Für jedes gefundene Element werden alle Standardeigenschaften und alle definierten xProperties zurückgegeben. Alle Eigenschaften mit dem Wert NULL werden nicht zurückgegeben.

Beispiel für die Aktualisierung eines Elements:

Aktualisieren Sie den Wert der Standardeigenschaft „Kosten“ auf 128 und den Wert der xProperty „Kosten“ (explizit oder implizit definiert) auf 100:

6.5 Verwenden von @defined_as zum Filtern von xProperties

Die folgenden Bedingungen ermöglichen Ihnen, Elemente nach ihrem definierten Status zu filtern:

• „ist definiert“
• „ist nicht definiert“
  Verwenden Sie das Attribut @defined_as, um Elemente nach ihrer Definition zu filtern. Sie können die folgenden Werte mit dem Attribut verwenden:
• „Klasse“ gibt an, dass die xProperty durch Klassifizierung definiert ist. Es spielt keine Rolle, ob die xProperty explizit definiert ist oder nicht.
• „explizit“ gibt an, dass die xProperty explizit definiert ist. Es spielt keine Rolle, ob die xProperty explizit definiert/nicht definiert ist).
• „Klasse|explizit“ gibt an, dass die xProperty sowohl durch Klassifizierung als auch explizit definiert ist.
  Das folgende Beispiel ruft alle Teile mit einer definierten xProperty aus der Datenbank ab. Es spielt keine Rolle, wie die xProperty definiert ist:

Das folgende Beispiel ruft alle Teile aus der Datenbank ab, die über eine explizit definierte xProperty verfügen:

Das folgende Beispiel ruft alle Teile aus der Datenbank ab, die eine xProperty haben, die NICHT mithilfe einer Klassifizierung definiert ist:

6.6 Zusätzliche xProperty-Informationen abrufen

Jede xProperty hat eine komplexe Struktur, die die folgenden Informationen enthält:

• Ein Wert
• Eine Definition
• Private Berechtigung
• Flags

Hinweis: Aus Leistungsgründen gibt der Standardserver in der AML-Antwort nur den xProperty-Wert zurück.

Sie können die Syntax des @select-Attributs erweitern, um zusätzliche Informationen zu den für ein Element definierten xProperties zu erhalten, indem Sie die folgenden Attribute verwenden:

• $value
• @permission_id
• @explicit
• @defined_as
  Das folgende Beispiel ruft alle in der Datenbank enthaltenen Teile ab. Es enthält die Artikelnummer und alle definierten xProperties für jedes zurückgegebene Element in der Antwort:

Das folgende Beispiel ruft zusätzliche Informationen über die definierte xProperty (permission_id, explizit) ab:

Das folgende Beispiel ruft zusätzliche Informationen über die definierte xProperty (is_defined) ab:

6.7 Private Berechtigungen ändern

Sie müssen die Attribute @permission_id und @set zu einem Eigenschaftsknoten hinzufügen, um private Berechtigungen für eine xProperty festlegen zu können. Das Attribut @set muss den Wert permission_id enthalten.
Das folgende Beispiel legt private Berechtigungen fest, ohne den xProperty-Wert zu ändern:

Das folgende Beispiel legt private Berechtigungen fest und ändert den xProperty-Wert:

Das folgende Beispiel setzt private Berechtigungen auf den NULL-Wert:

Das folgende Beispiel gibt an, dass die Berechtigung nicht ohne Verwendung des @set-Attributs geändert werden soll:

Diese AML ändert KEINE privaten Berechtigungen (da das @set-Attribut nicht hinzugefügt wird) und setzt den Wert NICHT auf NULL (da das Fehlen des @set-Attributs dem Äquivalent von „set=’’“ entspricht).

Sie können die Benutzeroberfläche verwenden, um eine private Berechtigung zu ändern. Klicken Sie im Elementformular für die angegebene xProperty auf die Schaltfläche neben dem xProperty-Feld, um die Änderung vorzunehmen:

6.8 Abfragen von xProperties über Elementtypen hinweg

Verwenden Sie den Polyitemtyp xPropertyContainerItem, um Werte für mehrere Elementtypen abzurufen. Aras Innovator fügt automatisch die Polyquelle xPropertyContainerItem zu jedem Elementtyp hinzu, der mindestens eine zulässige xProperty enthält. Die Liste der zulässigen xProperties für xPropertyContainerItem ist die Vereinigung aller zulässigen
xProperties aus den Polyquellen xPropertyContainerItem, wie im folgenden Beispiel gezeigt:

Sie können auch in allen ItemTypes nach xProperties suchen, indem Sie im Inhaltsverzeichnis „Mein Innovator“ → „Erweiterte Eigenschaftensuche“ auswählen. Eine Liste der mit xProperties verknüpften ItemTypes wird im Hauptraster angezeigt.

6.8.1 Filtern von Elementen nach Elementtypname

Sie können die xPropertyContainerItem ItemType-Eigenschaft verwenden, um Elemente nach Elementtyp zu filtern. Die Attribute @condition und @id ermöglichen Ihnen, Elemente nach ihren Typnamen zu filtern, wie im folgenden Beispiel gezeigt:

Die vorherige AML-Anweisung generiert das folgende SQL:

In diesem Fall:

• Das Attribut condition=“in“ teilt dem Server mit, dass mithilfe einer Unterabfrage gefiltert werden muss.
• Das Attribut by=“id“ gibt an, welche Eigenschaft aus der Unterabfrage zum Filtern verwendet werden muss.
• In der Unterabfrage muss eine gesicherte Funktion verwendet werden.

6.8.1.1 Verwenden der Attribute „condition“ und „by“, um Elemente nach JEDER Eigenschaft JEDEM Typ zu filtern

Sie können die Attribute condition=“in“ by=“…“ nicht nur für die Eigenschaft „itemtype“ eines Poly-Artikels verwenden, sondern für JEDE Eigenschaft eines JEDEM Artikeltyp.

Beispielsweise hat Artikeltyp A eine „schwache“ Referenz auf Artikeltyp B, nicht über B.id, sondern über B.name. Artikeltyp A hat eine Eigenschaft reference_to_b, die ein Wert des (eindeutigen) Namens eines Artikels vom Typ B ist. Jetzt möchte ich AML verwenden, um alle Artikel vom Typ A zu finden, die auf Artikel vom Typ B verweisen, deren Kosten > 10 betragen. Dann
kann ich das folgende AML ausgeben:

6.9 xEigenschaft des Datentyps Item

6.9.1 Verwenden von $value, @keyed_name, @type in einem Auswahlattribut

Das folgende Beispiel verwendet die Eigenschaft xp-document vom Typ item, wobei die Datenquelle Document ist. Der Dokument-ItemType hat die Eigenschaften name und description. Um name und description zur Ausgabe einer AML-Anfrage hinzuzufügen, müssen Sie $value verwenden, um Zugriff auf die Eigenschaften name und description von xp-document zu erhalten.
Abfrage:

Ausgabe:

Wenn die Namen der Eigenschaften des XP-Dokuments ohne Verwendung von $value angegeben werden, wird ein Nullwert zurückgegeben, wie hier gezeigt:

Abfrage:

Ausgabe:

Weitere Beispiele:
Abfrage:

Ausgabe:

Abfrage:

Ausgabe:

Abfrage:

Ausgabe:

7 Arbeiten mit dem Klassifizierungsdatenmodell
in AML

Dieser Abschnitt enthält Beispiele für die Arbeit mit dem Klassifizierungsdatenmodell.

7.1 Arbeiten mit Klassifizierungsdaten im Kontext von ItemType

Das folgende Beispiel fordert alle Teile an, die durch die xClass „Schraube“ klassifiziert sind.
Die Antwort auf diese Anfrage muss KEINE Teile enthalten, die durch untergeordnete xClasses von „Schraube“ klassifiziert sind.

Das folgende Beispiel muss Teile enthalten, die nach untergeordneten xClasses von „Bolt“ klassifiziert sind.

Das folgende Beispiel fordert alle Teile an, die durch die xClass mit dem Namen „Schraube“ klassifiziert sind, wobei das Gewicht 15 beträgt und die xProperty-Kosten 10 betragen. Die Antwort MUSS Teile enthalten, die durch untergeordnete xClasses von „Schraube“ klassifiziert sind.

Das folgende Beispiel fordert alle Teile an, die nach xClass mit der ID „ABCD…“ klassifiziert sind. Die Antwort MUSS Teile enthalten, die nach untergeordneten xClasses der xClass mit der ID „ABCD…“ klassifiziert sind.

8 11.0 SP12 Erweiterte AML-Verbesserungen

Dieser Abschnitt enthält Beispiele für AML-Erweiterungen, die als Teil von SP12 veröffentlicht wurden. Sie können AML verwenden, um xProperty-Werte und -Attribute wie deren Permission_ID und explizites Flag festzulegen. Beispiel:

Verfügbare Optionen für das Attribut „set“ sind „value“, „permission_id“ und „explicit“. Es spielt keine Rolle, ob die xProperty definiert ist oder nicht. Wenn Sie die xProperty explizit definieren möchten, müssen Sie „explicit“ verwenden. Verwenden Sie das „|“-Trennzeichen, um mehrere Operationen gleichzeitig festzulegen:

Die für ein Element festgelegten xClasses werden in AML als Beziehungen nach dem Muster %itemtype_name%_xClass konfiguriert. Der Typname wird automatisch basierend auf dem Namen des im xClassification Tree angegebenen ItemType definiert. Dies bedeutet, dass der xClass-Name für den Elementtyp „Teil“ „Part_xClass“ wäre. Für den Elementtyp „CAD“ wäre der xClass-Name „CAD_xClass“.
Beispiel:

8.1 Verwenden der Flags „Ist definiert/Ist nicht definiert“

Verwenden Sie die Flags „Ist definiert“/„Ist nicht definiert“, um Elemente nach ihren definierten xProperties zu filtern. Mit dem Attribut @defined_as
können Sie genau angeben, wie eine xProperty definiert ist. Das Attribut verwendet die folgenden zulässigen Werte:

• Mit Class können Sie eine xProperty entsprechend ihrer Klassifizierung definieren. Dabei spielt es keine Rolle, ob die xProperty explizit definiert ist oder nicht.
• Explicit ermöglicht Ihnen, eine xProperty explizit zu definieren. Dabei spielt es keine Rolle, ob die xProperty definiert ist oder mithilfe einer Klassifizierung definiert wird.
• Class|explicit ermöglicht Ihnen, eine xProperty sowohl explizit als auch mit Hilfe einer Klassifizierung zu definieren.

Das folgende Beispiel ruft alle Teile aus der Datenbank ab, in denen die xProperty definiert ist:

Dieses Beispiel ruft alle Teile aus der Datenbank ab, bei denen die xProperty explizit definiert ist:

Dieses Beispiel ruft alle Teile aus der Datenbank ab, bei denen die xProperty NICHT mithilfe der Klassifizierung definiert ist:

8.2 Anfordern von xProperty-Informationen

Sie können die erweiterte Syntax des ausgewählten Attributs verwenden, um weitere Informationen zu definierten xProperties zu erhalten. Verwenden Sie „xp-*“, um alle für ein Element definierten xProperties abzurufen. Sie können auch zusätzliche Informationen zu xProperties anfordern, indem Sie die folgenden speziellen Werte in Ihre Anfrage aufnehmen.

• Select=”xp-cost” gibt einen Wert zurück
• Select=”xp-cost($value)” gibt den Geldwert zurück, der einem Artikel zugeordnet ist.
• Select=”xp-cost(permission_id)” gibt das Berechtigungs-ID-Attribut zurück, gibt aber keinen Wert zurück.
• Select=”xp-*(@defined_as)” gibt alle definierten xProperties zurück, gibt aber keinen Wert zurück.

Das folgende Beispiel ruft alle Teile aus der Datenbank ab. Die Antwort enthält auch die Artikelnummer und alle definierten xProperties:
Abfrage:

Antwort:

Das folgende Beispiel zeigt die Informationsabfrage für die definierten xProperties eines Artikels:
Abfrage:

Antwort:

Das folgende Beispiel zeigt die Abfrage von Informationen zu einer definierten xProperty eines Artikels:
Abfrage:

8.3 Filtern von Artikeln nach Artikeltypname

Das folgende Beispiel ruft alle Elemente in der Datenbank ab, die kein Teil sind und deren xProperty-Kosten 100 betragen:

8.4 Filtern von Elementen mit den Attributen „Condition= In“ und „By“

Sie können die Attribute condition=“in“ by=“…“ verwenden, um eine beliebige Eigenschaft für einen beliebigen Artikeltyp zurückzugeben. Das folgende Beispiel findet alle Artikel vom Typ A, die auf Artikel vom Typ B verweisen, deren Kosten größer als 10 sind:

Im folgenden Beispiel möchte der Benutzer alle CADs mit demselben Namen wie die PART-Artikel abrufen, bei denen die Kosten der PART-Artikel 100 betragen.

8.4.1 Abwärtskompatibilität für Artikeldatentypen

Sie müssen für Eigenschaften mit dem Datentyp „Item“ keine Attribute „condition=“in“ by=“…“ angeben.
Die folgenden Codebeispiele sind gleichwertig:

8.4.2 xProperties zu jedem PolyItem-Typ hinzufügen

Aras Innovator prüft nicht, ob einem Polyitem eine xProperty zugeordnet ist. Wenn eine xProperty auf einem polymorphen Element vorhanden ist, aber nicht auf der Poly-Quelle, gibt eine Get-Abfrage einen Nullwert zurück, wenn Sie eine xProperty als Teil einer AML-Abfrage anfordern, wie im folgenden Beispiel gezeigt:

8.4.3 Filtern von Elementen nach xClass und Nachkommen

Das folgende Beispiel ist eine Abfrage, die die xClass Bolt und alle ihre Nachkommen zurückgibt:

8.4.4 Verwenden von [<filter_expression>]

[<filter_expression>] wurde hinzugefügt, um die @select-Attributsyntax zu erweitern. Es gibt einen Booleschen Wert zurück, der bestimmt, ob dem Ergebnis eine Eigenschaft hinzugefügt werden soll oder nicht. Verwenden Sie eckige Klammern, um nach einem expliziten Eigenschaftsnamen oder „“ zu definieren.

is_not_null() ist der einzige gültige Filterausdruck, der in AML verwendet wird. select=”[is_not_null()]” bedeutet: alle Eigenschaften zur Antwort hinzufügen, wenn der Eigenschaftswert NICHT NULL ist.

ist gleichbedeutend mit

9 xClass Such-API

In diesem Abschnitt wird beschrieben, wie die xClass-Suche programmgesteuert erweitert wird.

9.1 Erweiterung der SearchMode-Basisklasse

SearchMode has been extended by the following properties:

• supportXClassSearch ermöglicht Ihnen die Verwendung von XClass Search mit einer bestimmten SearchMode-Implementierung. Der Standardwert für diese Eigenschaft ist „false“.
• xClassSearchCriteriaXPath enthält den XPath, der dabei hilft, xClass-Suchkriterien in der Suchanfrage zu finden.

9.2 xClass Search für den benutzerdefinierten Suchmodus aktivieren

Es ist notwendig, das Flag „supportXClassSearch“ im Konstruktor eines benutzerdefinierten Suchmodus zu setzen.

Suchmodus:
JavaScript

Hinweis: Wenn die xClass-Suchkriterien nicht mit dem benutzerdefinierten Suchmodus kompatibel sind, wird jedes Mal, wenn Sie versuchen, eine Abfrage mit xClass-Kriterien zu erstellen, eine Validierungsmeldung angezeigt.

9.3 Erweiterung des benutzerdefinierten Suchmodus für die Arbeit mit xClass Suche

Um xClass-Kriterien mit einem benutzerdefinierten Suchmodus ohne Validierungsfehler zu verwenden, ist es notwendig, die Funktionen testAmlForCompatibility, getAml und setAml des benutzerdefinierten Suchmodus zu erweitern:
SearchMode:
JavaScript