Entitäten nach ID abrufen
Verwenden Sie die Aktion Entitäten nach ID abrufen, um Details zu Entitäten basierend auf einer Liste von Objekt-IDs abzurufen. Sie können Windchill Objekt-IDs aus dem Windchill-Trigger oder einer anderen Windchill Aktion abrufen, die die Objekt-ID im Ausgabeschema bereitstellt.
Führen Sie die folgenden Schritte aus, um die Aktion Entitäten nach ID abrufen in Ihrem Workflow zu verwenden:
1. Ziehen Sie die Aktion Entitäten nach ID abrufen unter Windchill in den Zeichenbereich, zeigen Sie mit der Maus auf die Aktion, und klicken Sie dann auf 
. Oder: Doppelklicken Sie auf die Aktion. Das Fenster "Entitäten nach ID abrufen" wird geöffnet.
. Oder: Doppelklicken Sie auf die Aktion. Das Fenster "Entitäten nach ID abrufen" wird geöffnet.2. Bearbeiten Sie bei Bedarf die Beschriftung. Standardmäßig ist der Beschriftungsname mit dem Aktionsnamen identisch.
3. Informationen zum Hinzufügen eines Windchill Konnektortyps finden Sie unter Unterstützte Windchill Konnektortypen.
Wenn Sie zuvor einen Konnektortyp hinzugefügt haben, wählen Sie den entsprechenden Konnektortyp aus, und wählen Sie unter Konnektor-Name den Konnektor aus.
4. Klicken Sie auf TESTEN, um den Konnektor zu validieren.
5. Klicken Sie auf KONNEKTOR ZUORDNEN, um die Aktion mit einem anderen Konnektor auszuführen als dem, den Sie zum Füllen der Eingabefelder verwenden. Geben Sie im Feld Laufzeit-Konnektor einen gültigen Windchill Konnektornamen an. Weitere Informationen zu KONNEKTOR ZUORDNEN finden Sie unter Using Map Connector.
6. Wählen Sie in der Liste Entitätstyp den entsprechenden Entitätstyp aus.
7. Geben Sie im Feld ID-Liste eine kommagetrennte Liste von Objekt-IDs im Windchill OID-Format an, z.B. OR:Typ:ID, wobei Typ der interne Name des Windchill Entitätstyps ist.
Beispiel: OR:wt.part.WTPart:646192, OR:wt.part.WTPart:601234
Sie können die ID-Liste aus der vorherigen Aktion zuordnen.
8. Verwenden Sie die Optionen in der Liste Abfragetyp, um die Ausgabe basierend auf den Objekteigenschaften zu filtern, die in der Ausgabe enthalten sein sollen.
Abhängig vom Rückgabetyp der Entität hat eine Abfrage die folgenden Parameter:
◦ Einzelnes Objekt – Eigenschaften auswählen, Zugehörige Elemente hinzufügen
◦ Sammlung von Objekten – Filter, Eigenschaften auswählen, Zugehörige Elemente hinzufügen, Grenzwert, Überspringen
Wählen Sie in der Liste Abfragetyp den Typ Formularbasierte Abfrage, Diskrete Abfrage oder Leere Abfrage aus, um Abfrageparameter anzugeben.
Formularbasierte Abfrage a. (Nur für Sammlung von Objekten verfügbar) Gehen Sie unter der Gruppe Filter wie folgt vor: a. Wählen Sie in der Liste Vereinen durch einen logischen Operator aus, um die Filterklauseln zu verknüpfen. Der Standardwert ist and. b. Klicken Sie unter Filterklauseln auf Hinzufügen, um einen Filter hinzuzufügen: ▪ Eigenschaft – Wählen Sie eine Eigenschaft aus. ▪ Übereinstimmende Bedingung – Wählen Sie eine Bedingung aus. Die Bedingung hängt davon ab, welchen Eigenschaftstyp Sie ausgewählt haben (Zeichenfolge, boolescher Wert usw.). ▪ Wert – Geben Sie einen Eigenschaftswert ein. Um mehrere Filter hinzuzufügen, klicken Sie auf Hinzufügen. Klicken Sie auf  , um hinzugefügte Filter zu löschen.Wenn Sie dieselben Eigenschaften hinzufügen und UND in der Liste Vereinen durch auswählen, werden die Attribute durch den ODER-Operator verknüpft. b. Klicken Sie unter Eigenschaften auswählen auf Hinzufügen, und wählen Sie in der Liste Eigenschaft die Eigenschaft aus, für die Sie Werte abrufen möchten. Klicken Sie auf Hinzufügen, um mehrere Eigenschaften hinzuzufügen. Klicken Sie auf , um hinzugefügte Eigenschaften zu löschen.Standardmäßig werden Werte für "wichtige" Eigenschaften in der Ausgabe abgerufen. c. Klicken Sie unter Zugehörige Elemente hinzufügen auf Hinzufügen, und wählen Sie in der Liste Zugehöriges Element das zugehörige Element aus, für das Sie Werte abrufen möchten. Klicken Sie auf Hinzufügen, um mehrere zugehörige Elemente hinzuzufügen. Klicken Sie auf , um hinzugefügte zugehörige Elemente zu löschen.Alle als NavigationProperty markierten Eigenschaften sind als Zugehöriges Element kategorisiert. d. (Nur für Sammlung von Objekten verfügbar) Geben Sie im Feld Grenzwert einen Wert ein, um die Ausgabe auf eine angegebene Anzahl von Entitäten zu begrenzen. e. (Nur für Sammlung von Objekten verfügbar) Geben Sie im Feld Überspringen die Anzahl der Ressourcen ein, die Sie überspringen möchten. |
Diskrete Abfrage a. (Nur für Sammlung von Objekten verfügbar) Geben Sie im Feld Filter die OData-Filterkriterien im Format propertyName operator 'value' [and | or | not]... an. Beispiel: number eq '0000222341' oder name eq 'PTC' oder startswith(name, 'PTC') b. Geben Sie im Feld Eigenschaften auswählen einen OData-select-Ausdruck an, um eine durch Trennzeichen getrennte Liste der Eigenschaftsnamen bereitzustellen. Standardmäßig werden Werte für "wichtige" Eigenschaften in der Ausgabe abgerufen. c. Geben Sie im Feld Zugehörige Elemente hinzufügen einen OData-select-Ausdruck an, um eine durch Trennzeichen getrennte Liste zugehöriger Elemente bereitzustellen. Alle als NavigationProperty markierten Eigenschaften sind als Zugehöriges Element kategorisiert. d. (Nur für Sammlung von Objekten verfügbar) Geben Sie im Feld Grenzwert die Anzahl der Suchergebnisse ein, die Sie abrufen möchten. e. (Nur für Sammlung von Objekten verfügbar) Geben Sie im Feld Überspringen die Anzahl der Top-Suchergebnisse ein, die Sie im Ergebnis überspringen möchten. |
Leere Abfrage Geben Sie im Feld Abfrage einen OData-Abfrageausdruck an. Beispiel: $select=name,number&$expand=context&$top=2&$skip=1&$orderby=name asc&$filter=name eq 'PTC' Standardmäßig werden Werte für "wichtige" Eigenschaften in der Ausgabe abgerufen. Alle als NavigationProperty markierten Eigenschaften sind als Zugehöriges Element kategorisiert. Je nach Rückgabetyp der Entität können Sie die Parameter "Filter", "Grenzwert" und "Überspringen" im Abfrageausdruck angeben. |
9. Klicken Sie auf Weitere Felder anzeigen, um zusätzliche Felder anzuzeigen.
◦ Wählen Sie unter OData-Anmerkungen abrufen die Option wahr aus, um OData-Anmerkungen in die Ausgabe einzuschließen. Der Standardwert ist falsch.
10. Klicken Sie auf Fertig.
Ausgabeschema
Das Ausgabeschema für die Aktion Entitäten nach ID abrufen ist ein dynamisches Schema. Es gibt ein Array mit Objekten mit Eigenschaften des ausgewählten Entitätstyps und eine ID-Liste aller abgefragten Entitätstypen zurück.
Wenn Sie Formularbasierte Abfrage ausgewählt haben, um Abfrageparameter anzugeben, bietet das Ausgabeschema nur Details der ausgewählten Eigenschaften.
Für Diskrete Abfrage oder Leere Abfrage enthält das Ausgabeschema alle Eigenschaften des zurückgegebenen Objekts, aber es stellt nur Werte der ausgewählten Eigenschaften bereit.
Die folgende Abbildung zeigt das Standard-Ausgabeschema:
Wenn Sie CADDocuments als Entitätstyp auswählen, ist das Ausgabeschema wie in der folgenden Abbildung dargestellt:
Wenn Sie CADDocuments als Entitätstyp auswählen und AuthoringApplication als Eigenschaft festlegen, ist das Ausgabeschema wie in der folgenden Abbildung dargestellt:
Wenn Sie CADDocuments als Entitätstyp auswählen und AuthoringApplication als Eigenschaft und Versionen als Zugehörige Elemente festlegen, wird das Ausgabeschema wie in der folgenden Abbildung dargestellt:
