Integrity Lifecycle Manager
Mithilfe des Integrity Lifecycle Manager(ILM)-Konnektors können ThingWorx Flow Workflows auf Aktionen in Integrity Lifecycle Manager zugreifen und sie ausführen.
Voraussetzungen
Je nachdem, welche Version von Integrity Lifecycle Manager Sie verwenden, stellen Sie sicher, dass Sie die richtigen Voraussetzungen erfüllen:
Wenn Sie Integrity Lifecycle Manager 12.1 verwenden
1. Richten Sie Folgendes ein, und konfigurieren Sie es:
▪ Integrity Lifecycle Manager 12.1 Server
▪ Integrity Lifecycle Manager REST Services 12.1
▪ Integrity Lifecycle Manager Lösung für Anforderungen und Validierung
2. Führen Sie den folgenden Bootstrap-API-Endpunkt aus:
https://<HOSTNAME>:<PORT>/rws/odata/ptc/ilm/resources/jsongenerators
Sie müssen diesen Endpunkt jedes Mal ausführen, wenn der REST-Dienst oder Integrity Lifecycle Manager-Server neu gestartet wird.
Wenn Sie Integrity Lifecycle Manager 12.2 verwenden
1. Richten Sie Folgendes ein, und konfigurieren Sie es:
▪ Integrity Lifecycle Manager 12.2 Server
▪ Integrity Lifecycle Manager Lösung für Anforderungen und Validierung
2. Ändern Sie in der Datei ResourcesNameMapping.xml unter <Integrity Serververzeichnis>/data/rws für die folgenden Felder des Typs Ziel die Werte des Typs Quelle, wie nachfolgend gezeigt.
|
Ziel
|
Quelle
|
|---|---|
|
Live Item ID
|
LiveItemID
|
|
Major Version ID
|
MajorVersionID
|
|
Minor Version ID
|
MinorVersionID
|
|
Typ
|
Typ
|
Die Feldnamen der verschiedenen Aktionen des Integrity Lifecycle Manager-Konnektors entsprechen den Werten des Typs Quelle in der Datei ResourcesNameMapping.xml. Um die entsprechenden Feldnamen für die Aktionen anzuzeigen, können Sie die Werte des Typs Quelle für die anderen Felder des Typs Ziel ändern. Stellen Sie jedoch sicher, dass die Werte des Typs Quelle keine Leerzeichen enthalten.
3. Führen Sie den folgenden Endpunkt aus:
https://<HOSTNAME>:<PORT>/rws/odata/ptc/ilm/resources/jsongenerators?updateformapping=true
 |
Berücksichtigen Sie die folgenden Punkte:
• Stellen Sie sicher, dass Sie diesen Endpunkt jedes Mal ausführen, wenn Sie die Datei ResourcesNameMapping.xml aktualisieren.
• Beim Neustart des Servers wird die Datei ResourcesNameMapping.xml auf das Original zurückgesetzt, und die geänderte Datei wird Sicherung als ResourcesNameMapping.xml.bak gespeichert.
Löschen Sie die Datei ResourcesNameMapping.xml, benennen Sie ResourcesNameMapping.xml.bak in ResourcesNameMapping.xmlum, und führen Sie den Endpunkt erneut aus.
|
In ThingWorx Flow können Sie die Aktion HTTP-Anforderung des HTTP-Dienstprogramms verwenden, um den Endpunkt auszuführen. Um die Aktion HTTP-Anforderung zu verwenden, legen Sie den URL-Wert auf die URL des Bootstrap API-Endpunkts fest, und geben Sie in zusätzlichen Feldern für Basisauthentifizierung den Benutzernamen und das Passwort eines Administrators an. Wenn Integrity Lifecycle Manager nicht für die Verwendung von SSL/TLS konfiguriert ist, legen Sie "SSL-Zertifikatüberprüfung" auf "falsch" fest, andernfalls auf "wahr". Weitere Informationen finden Sie unter
HTTP-Anforderung.
Version der Konnektorveröffentlichung
Der Integrity Lifecycle Manager Konnektor wurde in Version 8.4.1 bereitgestellt.
Unterstützte Aktionen
Unterstützte Trigger
None
Unterstützte Autorisierungen
Der Integrity Lifecycle Manager Konnektor erfordert die folgende Autorisierung:
• Einfach
• OAuth
|
|
Stellen Sie vor dem Hinzufügen einer OAuth-Verbindung sicher, dass Sie die Schritte unter
Konnektor-OAuth-Einstellungen konfigurieren ausführen.
|
Integrity Lifecycle Manager autorisieren
Sie müssen Integrity Lifecycle Manager für jede Aktion des Integrity Lifecycle Manager Konnektors autorisieren. Um den Integrity Lifecycle Manager Konnektor zu autorisieren, wählen Sie eines der folgenden Authentifizierungsschemas aus:
• Einfach – Wählen Sie in der Liste Authentifizierungsschema auswählen die Option Einfach aus, und führen Sie die folgenden Schritte aus:
1. Klicken Sie auf Neu hinzufügen, und geben Sie dann die folgenden Details ein:
▪ Verbindungsbeschriftung – Automatisch gefüllt. Sie können eine Verbindungsbeschriftung Ihrer Wahl angeben.
▪ Integrity Lifecycle Manager - REST-URL – Geben Sie die REST-URL im Format https://<Hostname des REST-Servers>:<Portnummer des REST-Servers> ein.
▪ Geben Sie den Benutzernamen und das Passwort ein.
2. Klicken Sie auf HINZUFÜGEN.
|
|
Klicken Sie auf TESTEN, um die Verbindung zu validieren.
|
• OAuth – Wählen Sie in der Liste Authentifizierungsschema auswählen die Option OAuth aus, und führen Sie die folgenden Schritte aus:
1. Klicken Sie auf Neu hinzufügen, und geben Sie dann die folgenden Details ein:
▪ Benutzername: Geben Sie den Benutzernamen ein.
▪ Passwort: Geben Sie das Passwort ein.
▪ Klicken Sie auf ZULASSEN, und schließen Sie dann den Autorisierungsprozess ab.
▪ Benennen Sie im Fenster "Autorisierung hinzufügen" die Autorisierungsbeschriftung sofern erforderlich um, und fügen Sie dann die Ressourcen-URL wie z.B. https://<Hostname des REST-Servers>:<Portnummer des REST-Servers> hinzu.
2. Klicken Sie auf HINZUFÜGEN.
|
|
Klicken Sie auf TESTEN, um die Verbindung zu validieren.
|
OData-Konnektor-Aktion verwenden
Sie können die Aktion "Eigenschaften abrufen" für den OData-Konnektor verwenden, um den Inhalt oder die Eigenschaften eines oder mehrerer Integrity Lifecycle Manager Elemente abzurufen. Um die Aktion "Eigenschaften abrufen" in einem Fluss zu verwenden, geben Sie die Basis-URL im folgenden Format an: https://<Hostname>:<Port>/rws/odata/ptc/ilm/items/$metadata
Weitere Informationen finden Sie unter
OData-Konnektor.
Beispiele
Sehen wir uns nun an, wie Sie die Aktionen von Excel Online und Integrity Lifecycle Manager mit ThingWorx Flow integrieren können.
Integrity Lifecycle Manager Abfrageergebnisse in ein Excel-Tabellenblatt ziehen
Voraussetzung:
1. Sie müssen mit demselben Unternehmenskonto auf Excel Online und Integrity Lifecycle Manager zugreifen können.
2. Einige Abfragen wurden bereits in Integrity Lifecycle Manager erstellt. Beispielsweise die Abfrage "Probleme", die alle Probleme zurückgibt. Informationen zum Erstellen benutzerdefinierter Abfragen finden Sie in der Dokumentation zu Integrity Lifecycle Manager auf der PTC Support Website.
Schritte:
Aktion "Abfrage ausführen" von Integrity Lifecycle Manager konfigurieren
1. Ziehen Sie die Aktion Abfrage ausführen unter dem Integrity Lifecycle Manager Konnektor in den Zeichenbereich, zeigen Sie mit der Maus auf die Aktion, und klicken Sie dann auf 
. Oder: Doppelklicken Sie auf die Aktion. Das Fenster für die Aktion "Abfrage ausführen" wird geöffnet.
. Oder: Doppelklicken Sie auf die Aktion. Das Fenster für die Aktion "Abfrage ausführen" wird geöffnet.
2. Erstellen Sie eine Verbindung in der Aktion Abfrage ausführen. Informationen zum Erstellen einer Verbindung finden Sie unter dem Thema zum Konnektor
Integrity Lifecycle Manager.
3. Geben Sie die folgenden Informationen ein:
a. Wählen Sie im Feld Abfragen die Option Probleme aus.
b. Wählen Sie im Abschnitt Sortieren nach die Option Attribut aus, um das Ergebnis zu sortieren.
c. Wählen Sie die Reihenfolge des Ergebnisses aus: aufsteigend oder absteigend.
d. Wählen Sie Attribute aus, die in der Ausgabe der Abfrage angezeigt werden sollen. In diesem Beispiel werden sieben Attribute hinzugefügt – ID, Summary, Project, Priority, Severity, State und Description –, indem im Abschnitt "Attribute auswählen" auf Hinzufügen geklickt wird.
4. Verbinden Sie die Aktion Abfrage ausführen mit dem Startsymbol 
im Zeichenbereich.
im Zeichenbereich.Schleifen zur Verarbeitung der Abfrageausgabe konfigurieren
In diesem Beispiel wird "Schleife" verwendet, um jeweils eine Datenzeile in eine Excel-Tabelle zu schreiben. Weitere Informationen zum Dienstprogramm "Schleife" finden Sie im Thema zur Aktion
Schleife.
Die Aktion "Schleife" finden Sie auf der Registerkarte "Dienstprogramm" oder indem Sie einfach im Suchfeld nach "Schleife" suchen. Sie müssen die Aktionen in die Aktion "Schleife" ziehen.
1. Klicken Sie auf 
, und ziehen Sie die Aktion Schleife unter dem Dienstprogramm Schleife in den Zeichenbereich.
, und ziehen Sie die Aktion Schleife unter dem Dienstprogramm Schleife in den Zeichenbereich.2. Verbinden Sie die Aktion Abfrage ausführen mit dem Schleifen-Tool.
3. Verbinden Sie "Schleife" mit dem Stopp-Symbol 
im Zeichenbereich.
im Zeichenbereich.4. Wählen Sie in der Liste Schleifentyp auswählen die Option "Jedes Element" aus. Die Aktion "Schleife" wird so oft ausgeführt, wie Elemente im Ergebnis der Aktion Abfrage ausführen vorhanden sind.
5. Wählen Sie im Feld Quell-Array oder Objekt das Ergebniselement aus den Trigger-Daten für die Aktion Abfrage ausführen aus, indem Sie neben "Ergebniselement" auf 
klicken.
klicken.
Wir erstellen nun eine Tabelle im Excel Online-Konnektor.
1. Wechseln Sie zur Website von Microsoft
Excel Online, und melden Sie sich mit den Anmeldeinformationen Ihres Unternehmenskontos an. Erstellen Sie eine Arbeitsmappe. In diesem Beispiel erstellen wir eine Arbeitsmappe namens DemoTask.
Die Arbeitsmappe enthält ein Standardtabellenblatt – Sheet 1.
2. Fügen Sie weitere Tabellenblätter hinzu, indem Sie auf das Pluszeichen (+) neben der Registerkarte "Tabelle" in der linken unteren Ecke klicken.
3. Erstellen Sie eine Tabelle mit einem beliebigen Namen. Nehmen wir an, Sie erstellen Table 1. Die Tabelle sollte eine ähnliche Anzahl von Spalten enthalten, wie Felder von der Integrity Lifecycle Manager Abfrage zurückgegeben werden. In diesem Beispiel werden sieben Spalten erstellt: ID, Summary, Project, Priority, Severity, State und Description.
4. Verbinden Sie die Aktion Zeilen zu Tabelle hinzufügen auf der linken und rechten Seite mit der Schleife.
Aktion "Zeilen zu Tabelle hinzufügen" des Excel Online-Konnektors von ThingWorx Flow konfigurieren
1. Ziehen Sie die Aktion Zeilen zu Tabelle hinzufügen unter dem Konnektor Excel Online in den Zeichenbereich, zeigen Sie mit der Maus auf die Aktion, und klicken Sie dann auf . Oder: Doppelklicken Sie auf die Aktion. Das Fenster für die Aktion "Zeilen zu Tabelle hinzufügen" wird geöffnet.
. Oder: Doppelklicken Sie auf die Aktion. Das Fenster für die Aktion "Zeilen zu Tabelle hinzufügen" wird geöffnet.2. Bearbeiten Sie bei Bedarf den Namen der Beschriftung. Standardmäßig ist der Beschriftungsname mit dem Aktionsnamen identisch.
3. Informationen zum Hinzufügen einer Autorisierung finden Sie im Abschnitt
Excel Online autorisieren des Themas "Excel Online-Konnektor".
| | Wenn Sie bereits zuvor eine Autorisierung für Excel Online hinzugefügt haben, können Sie eine Autorisierung in der Liste auswählen. |
4. Geben Sie die folgenden Details ein:
a. Ordnername – Wählen Sie "Documents" in der Liste aus.
b. Arbeitsmappen-ID – Wählen Sie den Namen der erstellten Arbeitsmappe aus. In diesem Fall ist dies "DemoTask".
c. Blatt-ID – Wählen Sie den Namen des Tabellenblatts mit der Tabelle aus. In diesem Fall ist die Tabelle in "Sheet 1" enthalten.
d. ID/Name der Tabelle – Name der Tabelle, in die das Ergebnis der Abfrage geschrieben werden soll. Wählen Sie den Tabellennamen in der Liste aus.
e. Eintragstyp auswählen – Wählen Sie einen einzelnen Zeileneintrag oder mehrere Zeileneinträge aus. In diesem Tutorial verwenden wir einen einzelnen Zeileneintrag mit dem Schleifen-Tool; die Anzahl der Schleifenausführungen entspricht somit der Anzahl der Elemente, die von der Integrity Lifecycle Manager Abfrage zurückgegeben und einzeln nacheinander in die Tabelle geschrieben werden.
Zeilenwerte – Ordnen Sie die Zeilenwerte zu, mit denen die Tabelle gefüllt wird. Im Feld "Zeilenwerte" werden sieben Spalten hinzugefügt, da sieben Felder gefüllt werden müssen. ID, Summary, Project, Priority, Severity, State und Description werden in Spalte 1, 2, 3, 4, 5, 6 bzw. 7 hinzugefügt, wie in der folgenden Abbildung dargestellt. Die Reihenfolge der Spalten ist die gleiche wie in der Tabelle, die wir im Excel-Tabellenblatt in Schritt 1 erstellt haben.
Diese Ergebniselemente befinden sich in einem Array, und bei jeder Ausführung der Schleife muss der aktuelle Wert des Schleifenindex eingefügt werden. Im Index wird daher der aktuelle Index der Schleife hinzugefügt, wie in der folgenden Abbildung dargestellt:
Starten Sie den Fluss, indem Sie oben rechts auf die Schaltfläche "Ausführen" klicken.
Ergebnis
Wenn der Fluss abgeschlossen ist, wird die Excel-Tabelle mit den Abfrageergebnissen gefüllt. Die Abbildung zeigt, dass der Tabelle zwei Probleme mit allen sieben Feldern hinzugefügt wurden.
Integrity Lifecycle Manager Element mit Excel-Daten bearbeiten
Voraussetzungen
1. Sie müssen mit demselben Unternehmenskonto auf Excel Online und Integrity Lifecycle Manager zugreifen können.
2. Integrity Lifecycle Manager 12.1 Server
a. REST-Webdienste
b. Integrity Lifecycle Manager Lösung für Anforderungen und Validierung
3. ThingWorx Flow
Schritte:
Bearbeiten Sie die Feldwerte im Excel-Tabellenblatt.
"Priority" und "Severity" werden für beide Elemente in "Low" bzw. "Minor" geändert.
Aktion "Tabellenzeilen abrufen" des Excel Online-Konnektors konfigurieren:
1. Ziehen Sie die Aktion Zeilen zu Tabelle hinzufügen unter dem Konnektor Excel Online in den Zeichenbereich, zeigen Sie mit der Maus auf die Aktion, und klicken Sie dann auf . Oder: Doppelklicken Sie auf die Aktion. Das Fenster für die Aktion "Zeilen zu Tabelle hinzufügen" wird geöffnet.
. Oder: Doppelklicken Sie auf die Aktion. Das Fenster für die Aktion "Zeilen zu Tabelle hinzufügen" wird geöffnet.2. Geben Sie die Informationen in die folgenden Felder ein:
a. Ordnername – Wählen Sie "Documents" in der Liste aus.
b. Arbeitsmappen-ID – Wählen Sie den Namen der erstellten Arbeitsmappe in der Liste aus. In diesem Fall ist dies "DemoTask".
c. Blatt-ID – Wählen Sie den Namen des Tabellenblatts mit Ihrer Tabelle in der Liste aus. Unsere Tabelle befindet sich in "Sheet 2".
d. Tabellen-ID – Name der Tabelle, die Sie erstellt haben und in die das Ergebnis der Abfrage geschrieben werden soll. Wählen Sie einen Tabellennamen in der Liste aus.
e. Abzurufende Zeilen – Geben Sie die Anzahl der Zeilen ein, die der Benutzer aus der Tabelle lesen und in Integrity Lifecycle Manager bearbeiten möchte.
f. Zu überspringende Zeilen – Sie können einige Zeilen vom Anfang der Tabelle überspringen. Geben Sie den Wert für die zu überspringenden Zeilen ein.
3. Verbinden Sie die Aktion Tabellenzeilen abrufen mit dem Startsymbol im Zeichenbereich.
im Zeichenbereich.Die Konfiguration ist abgeschlossen.
Aktion "Schleife" zur Verarbeitung der Abfrageausgabe konfigurieren
Die Aktion "Schleife" finden Sie auf der Registerkarte Dienstprogramm oder indem Sie einfach in der Suche nach "Schleife" suchen. Ein Konnektor muss in die Schleife gezogen werden, um ihn mit dem Tool zu verwenden. In diesem Tutorial erfahren Sie, wie Elemente einzeln nacheinander in Integrity Lifecycle Manager bearbeitet werden. In der Aktion Quell-Array oder Objekt ist "Ergebniselement" ausgewählt, die Ausgabe der Aktion Tabellenzeilen abrufen.
1. Klicken Sie auf , und ziehen Sie die Aktion Schleife unter dem Dienstprogramm Schleife in den Zeichenbereich.
, und ziehen Sie die Aktion Schleife unter dem Dienstprogramm Schleife in den Zeichenbereich.2. Wählen Sie im Feld Schleifentyp auswählen die Option Jedes Element in der Liste aus. Führen Sie die Schleife so oft aus, wie Elemente im Ergebnis der Aktion Tabellenzeilen abrufen vorahnden sind.
3. Ordnen Sie im Feld Quell-Array oder Objekt den Tabellenwert aus dem Abschnitt mit Trigger-Daten zu, indem Sie auf klicken.
klicken.
4. Verbinden Sie die Aktion Tabellenzeilen abrufen mit der Aktion "Schleife".
5. Verbinden Sie die Aktion "Schleife" mit dem Symbol im Zeichenbereich.
im Zeichenbereich.Die Aktion "Schleife" ist konfiguriert.
Aktion "Element bearbeiten" von Integrity Lifecycle Manager konfigurieren
1. Ziehen Sie die Aktion Element bearbeiten unter dem Integrity Lifecycle Manager-Konnektor in den Zeichenbereich, zeigen Sie mit der Maus auf die Aktion, und klicken Sie dann auf . Oder: Doppelklicken Sie auf die Aktion. Das Fenster für die Aktion "Element bearbeiten" wird geöffnet.
. Oder: Doppelklicken Sie auf die Aktion. Das Fenster für die Aktion "Element bearbeiten" wird geöffnet.2. Geben Sie im Feld Entitätstyp den Typ der Elemente ein, die bearbeitet werden sollen. In unserem Fall "Probleme". Die zum ausgewählten Elementtyp gehörigen Felder werden nach der Auswahl angezeigt.
3. Ordnen Sie die Werte aus Tabellenwerten zu, und ändern Sie den Index entsprechend dem aktuellen Index.
4. Alle anderen Felder werden aus den Tabellenwerten unter der Aktion Tabellenzeilen abrufen zugeordnet.
5. Verbinden Sie die Aktion Element bearbeiten mit der rechten Seite der Aktion "Schleife".
6. Führen Sie den Fluss aus, indem Sie oben rechts auf die Schaltfläche Ausführen klicken. Nachdem der Fluss abgeschlossen ist, kann der Benutzer die bearbeiteten Felder in Integrity Lifecycle Manager sehen. Der fertige Fluss ist in der folgenden Abbildung dargestellt:
