Info*Engine Servlets

Ein Info*Engine Servlet enthält eine Schnittstelle zwischen Info*Engine und einem Web-Server. Sie können Info*Engine Aufgaben über HTTP oder HTTPS mithilfe des Servlets direkt aufrufen. Wenn Aufgaben durch ein Info*Engine Servlet aufgerufen werden, wird die virtuelle Info*Engine Datenbank (VDB) in der Antwort als XML gerendert.

Dieses Formular stellt auch die Standardkonfiguration für das SOAP-RPC-Servlet bereit. SOAP (Simple Object Access-Protokoll) ist ein einfaches, XML-basiertes Protokoll, das von Anwendungen von Drittanbietern verwendet werden kann. Die Info*Engine SOAP-Servlets fangen und verarbeiten Info*Engine SOAP-Anforderungen, die über das Web gestellt werden. Dadurch können Sie Informationen austauschen und benutzerdefinierte Info*Engine Geschäftsaufgaben remote ausführen. Weitere Informationen finden Sie unter SOAP Services (SOAP-Dienste).

Informationen zu Eigenschaften, die nicht hier aufgeführt sind, sowie Anweisungen zum Verwenden von verfügbaren Formularschaltflächen und Eingeben von Attributwerten finden Sie unter Allgemeine Eigenschaften und Aktionen.

Sie können die Authentifizierungszuordnung durch den Server einrichten, indem Sie die zu verwendenden Anmeldeinformationsdateien angeben. Anmeldeinformationsdateien ermöglichen einem Benutzer, sich bei einem Server mit den Berechtigungen für einen oder mehrere Adapter anzumelden.

Anmeldeinformationszuordnungseigenschaften werden in der Regel in der Datei wt.properties konfiguriert, anstatt im Dienstprogramm "Eigenschaften-Verwaltung". Sie können jedoch das Dienstprogramm zur Eigenschaftenverwaltung verwenden, um einige Anmeldeinformationszuordnungseigenschaften festzulegen, wenn Sie einen neuen Adapter konfigurieren.

Der relative Pfad zur Authentifizierungsaufgabe, die an Ihrem Standort für die Authentifizierung von Benutzern über Info*Engine erstellt wurde. Dieser Pfad ist relativ zum konfigurierten Stammverzeichnis für Aufgaben. Diese Eigenschaft ist optional.

Wenn der Geschäftsaufgabenprozessor aufgerufen wird, um eine Geschäftsaufgabe auszuführen, wird von diesem die Eigenschaft credentialsMapper überprüft. Wenn die Eigenschaft festgelegt wurde, führt der Aufgabenprozessor die Authentifizierungszuordnungsaufgabe aus, bevor er seine zugewiesene Aufgabe ausführt. Die Authentifizierungszuordnungsaufgabe kann den Benutzernamen als Schlüssel verwenden, um benutzerspezifische Authentifizierungsinformationen von einem oder mehreren Informationssystemen zu erhalten, auf die über Adapter zugegriffen werden kann. Die Aufgabe kann dann eine Ausgabegruppe aus diesen Authentifizierungsinformationen erstellen.

Wenn Sie die Eigenschaft credentialsMapper nicht angeben, führt der Info*Engine Server vor dem Ausführen der angegebenen Aufgabe keine serverbasierte Authentifizierungszuordnungsaufgabe aus.

Der relative Pfad zum Verzeichnis, das an Ihrem Standort für das Speichern einer Authentifizierungszuordnungsdatei für jeden Benutzer erstellt wurde. Der Name jeder Zuordnungsdatei muss dem authentifizierten Benutzernamen entsprechen, der an den Info*Engine Server übergeben wurde. Der Verzeichnispfad ist relativ zum konfigurierten Stammverzeichnis für Aufgaben. Diese Eigenschaft ist optional.

◦ Wenn sie angegeben wird, versucht Info*Engine, eine Authentifizierungszuordnungsdatei zu öffnen und zu lesen, die dem angegebenen Benutzernamen entspricht.

credentialsTimeToLive

Diese Eigenschaft verbessert die Leistung, indem der Aufgabenprozessor Authentifizierungsinformationen aus einem Cache lesen kann. Andernfalls sendet der Aufgabenprozessor jedes Mal Authentifizierungsinformationen, wenn Authentifizierungsdateien gelesen oder Authentifizierungszuordnungsaufgaben ausgeführt werden.

Der Wert dieser Eigenschaft entspricht der Anzahl der Millisekunden, die Authentifizierungsinformationen vor der Aktualisierung zwischengespeichert werden. Der Wert muss eine positive Ganzzahl sein, sonst wird er ignoriert. Wenn diese Eigenschaft nicht definiert wird, werden keine Authentifizierungsgruppen-Informationen zwischengespeichert und die Leistung bleibt dieselbe.

Sie können die Position kompilierter Aufgaben sowie weitere Dateien, die dem Klassenpfad hinzugefügt werden müssen, festlegen, indem Sie Compilereigenschaften angeben.

Gibt den Stammpfad für XML-Geschäftsaufgaben an.

Das Stammdateisystemverzeichnis, in dem das Servlet alle XML-Geschäftsaufgaben findet. Dies ermöglicht dem Servlet, die Aufgaben lokal zu kompilieren und auszuführen.

Diese Eigenschaft ist nützlich, wenn das Servlet ohne einen Aufgabenprozessor ausgeführt wird.

Gibt das Verzeichnis an, in dem kompilierte Aufgaben gespeichert sind.

Gibt weitere JAR- und Klassendateien an, die dem Klassenpfad beim Kompilieren von Aufgaben hinzugefügt werden. Geben Sie einen Standard-Java-Klassenpfad ein. Verwenden Sie für ein Windows-System ; als Pfadtrennzeichen. Verwenden Sie für ein Unix-System : als Pfadtrennzeichen.

compiler.libDirectoryn

Wenn dem Klassenpfad zusätzliche JAR- und Klassendateien hinzugefügt werden, verwenden Sie dieses Feld, um das Verzeichnis anzugeben, wo sich jene Dateien befinden.

Der erste Wert von n muss 1 sein und der Wert muss sequentiell ansteigen.

Das Info*Engine Stamminstallationsverzeichnis. Das Stamminstallationsverzeichnis für Info*Engine entspricht dem Stamminstallationsverzeichnis für Windchill (wt.home).

Der Name des Info*Engine Servers oder Aufgabenprozessors, der vom Servlet verwendet wird. Dieser Wert wird standardmäßig angegeben.

Das Präfix, das in URLs verwendet wurde, die XML-Geschäftsaufgaben referenzieren. Dieses Präfix unterstützt das Servlet dabei festzulegen, ob Anforderungen an den Aufgaben- oder an den Vorlagenprozessor gesendet werden. Der Standardwert ist /infoengine/servlet/IE/tasks/.

Das Info*Engine Servlet bietet URLs mit diesem Präfix zum Aufgabenprozessor. Wenn beispielsweise das Standardpräfix verwendet wird, hat der Web-Server den Namen "myServer", und ein Benutzer gibt die folgende URL ein:

Das Info*Engine Servlet übergibt die URL an den Aufgabenprozessor, der "myTask.xml" lokalisiert und ausführt.

Der erste Eintrag im Präfix muss den gleichen Wert aufweisen, den Sie für die Anwendungs-URL eingegeben haben. Dies wird festgelegt, wenn Sie die Servlet-Engine für das Info*Engine Servlet konfigurieren. Den Präfix-Wert und die entsprechenden Servlet-Engine-Einstellungen für die JRun und Tomcat Servlet-Engines legt Windchill für Sie fest.

PTC empfiehlt, dass Sie den Teil /servlet/IE/tasks/ des Präfixes nicht ändern. Wenn Sie diesen Teil des Präfixes ändern, müssen Sie ebenfalls manuelle Änderungen in der Servlet-Engine vornehmen. Sie können in Ihrem Web-Server eine URL-Weiterleitung einrichten, um andere Präfixe für URL-Referenzierungen zu erlauben.

Sie können Info*Engine konfigurieren, um bestimmte Aufgaben beim Start auszuführen. Sie können beispielsweise automatisch Warteschlangen- oder Ereignisabonnements generieren. Der erste Wert von n muss 1 sein, und der Wert muss sequentiell ansteigen (wie in folgendem Beispiel):

Der Wert für diese Eigenschaft ist der Pfad für die Aufgabe, die beim Starten von Info*Engine initiiert wird.

Weitere Informationen finden Sie unter Info*Engine Tasks (Info*Engine Aufgaben).

request.xmlParser.debug

Aktivieren Sie XML-Parser-Debugging. Dies führt dazu, dass Informationen beim Parsen von eingehendem XML-Code für Debugging-Zwecke gedruckt werden.

request.xmlStream.debug

Aktivieren Sie XML-Protokollierungsanfragen. Dies führt dazu, dass eingehender XML-Code für Debugging-Zwecke gedruckt wird.

Das Send-Mail-Webject erstellt und sendet E-Mails. Die Konfiguration der Eigenschaften des Send-Mail-Webject ermöglicht es Ihnen, beim Ausführen des Webjects bestimmte Standardwerte festzulegen.

Der Standardabsender (die E-Mail-Adresse, die die Nachricht sendet), der vom Send-Mail-Webject verwendet wird.

Entspricht dem FROM-Webject-Parameter.

Der vom Send-Mail-Webject verwendete Standardserver.

Der beim Herstellen einer Verbindung mit dem SMTP-Server bereitgestellte Standardbenutzername.

Entspricht dem USERNAME-Parameter.

Das dem Standard-SMTP-Benutzernamen zugeordnete Standardpasswort.

Entspricht dem PASSWORD-Parameter.

Wenn Sie sich zum ersten Mal beim Dienstprogramm zur Eigenschaftenverwaltung anmelden, wird der Basis-URI-Wert automatisch generiert. Diese Informationen können später in den Servlet-Einstellungen konfiguriert werden.

Der Standard-Basis-URI für die Benutzeroberfläche des Dienstprogramms zur Eigenschaftenverwaltung. Dieser Wert bestimmt, welche Dienste, Adapter und Eigenschaftensätze auf der Hauptseite des Dienstprogramms zur Eigenschaftenverwaltung aufgeführt sind.

Geben Sie eine vollqualifizierte LDAP-URL an, die auf den Speicherort der Eigenschaften verweist, die konfiguriert werden können.

Die Konfigurationsinformationen für einen Dienst oder Adapter können aktualisiert werden, während der Dienst oder der Adapter ausgeführt wird. Dies ermöglicht es Ihnen, Eigenschaften zu aktualisieren, ohne einen Neustart durchzuführen.

Die Eigenschaft Existenzdauer gibt die Zeit in Minuten an, die verstreicht, bevor die Eigenschaften für einen Dienst oder Adapter automatisch neu geladen werden. Die Eigenschaften werden nur dann automatisch neu geladen, wenn auf sie zugegriffen wird. Standardmäßig laufen die Eigenschaften nicht ab.

Wenn eine Eigenschaft im Formular nicht definiert ist, können Sie sie im Feld Zusätzliche Eigenschaften hinzufügen. Beim Hinzufügen zusätzlicher Eigenschaften umfasst der Eigenschaftsname den Namen des Adaptereintrags (den Dienstnamen) gefolgt vom Eigenschaftsnamen. Beispiel:

Geben Sie in den entsprechenden Feldern die vom Dienst oder dem Adapter und dem Wert dieser Eigenschaft verwendete Eigenschaft an. Klicken Sie neben dem neuen Eigenschaftsnamen auf Hinzufügen, um ein Textfeld zu öffnen, in dem Sie den Eigenschaftswert ändern können.

Wenn der Wert zu lang wird, um in seiner Gesamtheit angezeigt zu werden, wird die Aktion Bearbeiten angezeigt. Klicken Sie auf Bearbeiten, um ein neues Browserfenster mit einem größeren Textfeld zu öffnen.