Info*Engine-Server
Der Info*Engine Server ermöglicht das Abrufen und Ändern von Daten, die Benutzer und benutzerdefinierte Anwendungen anzeigen oder empfangen möchten.
|
|
Der Info*Engine Servereintrag wird nicht mehr standardmäßig verwendet. Sie können jedoch einen Eintrag zur Integration mit der eigenständigen Legacy-Installation von Info*Engine erstellen.
|
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.
Anmeldeinformationszuordnungseigenschaften
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.
Weitere Informationen finden Sie unter
Zuordnung von Berechtigungen.
Anmeldeinformationszuordnung
credentialsMapper
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.
Anmeldeinformationsdateien
credentialsFiles
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 diese Eigenschaft nicht angegeben wird, sucht Info*Engine nicht nach einer Authentifizierungszuordnungsdatei.
◦ Wenn sie angegeben wird, versucht Info*Engine, eine Authentifizierungszuordnungsdatei zu öffnen und zu lesen, die dem angegebenen Benutzernamen entspricht.
Die Datei wird geöffnet, bevor Sie eine Geschäftsaufgabe und die Aufgabe in der Eigenschaft credentialsMapper ausführen.
Existenzdauer für Anmeldeinformationen
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.
Aufgabenkompilierereigenschaften
Sie können die Position kompilierter Aufgaben sowie weitere Dateien, die dem Klassenpfad hinzugefügt werden müssen, festlegen, indem Sie Compilereigenschaften angeben.
Weitere Informationen finden Sie unter
Info*Engine Aufgaben und Aufgabenregeln.
Codebasis
codebase
Gibt das Verzeichnis an, in dem kompilierte Aufgaben gespeichert sind.
Compiler-Klassenpfad
compiler.classpath
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.
Lib-Verzeichnis n
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.
Allgemeine Eigenschaften
Um allgemeine Eigenschaften anzugeben, verwenden Sie die folgenden Felder:
Basisverzeichnis
home
Das Info*Engine Stamminstallationsverzeichnis. Das Stamminstallationsverzeichnis für Info*Engine entspricht dem Stamminstallationsverzeichnis für Windchill (wt.home).
Startaufgabe n
startupTaskn
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):
com.infoengine.startupTask1=msg/subscribeQueue.xml
Der Wert für diese Eigenschaft ist der Pfad für die Aufgabe, die beim Starten von Info*Engine initiiert wird.
XML-Parser-Debug
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.
Anfrage-Debug
request.xmlStream.debug
Aktivieren Sie XML-Protokollierungsanfragen. Dies führt dazu, dass eingehender XML-Code für Debugging-Zwecke gedruckt wird.
JMS-Standarddienst
jms.defaultService
Der Name des JMS-Diensts, der für alle MSG- und WES-Webjects verwendet werden soll, die ohne SERVICE-Parameter aufgerufen werden.
JMS-Haupteigenschaften
Beim Konfigurieren von Info*Engine bei einem Java Messaging Service (JMS) werden die folgenden Eigenschaften im Allgemeinen festgelegt. Eigenschaftenbeschreibungen werden basierend auf der Position der Eigenschaften im Formular und ihrer Funktion gruppiert.
|
|
Beim Konfigurieren von Info*Engine mit einer JMS-MOM, ist es am besten, stattdessen einen neuen JMS-Diensteintrag zu erstellen. Sie können Kern- und zusätzliche Eigenschaften angeben, indem Sie den Eigenschaften-Editor für diesen JMS-Diensteintrag verwenden.
Sie können den Dienstnamen dieses JMS-Diensts dann als SERVICE-Parameter für MSG- und WES-Webjects eingeben. Sie können ihn auch als Wert der Eigenschaft JMS-Standarddienst für den Info*Engine Server oder Adapter eingeben.
|
Weitere Informationen finden Sie in den folgenden Themen:
JMS-Kontext-Provider-Factory
jms.CtxFactory
Der Klassenname der Factory, die den anfänglichen JNDI-Kontext für die verwaltete Objektsuche zurückgibt. Wenn nicht angegeben, wird davon ausgegangen, dass die verwalteten Objekte im LDAP gespeichert werden.
Der Standardwert ist com.sun.jndi.ldap.LdapCtxFactory.
JMS-Basis-URI
jms.baseUri
Der LDAP-URI, auf den sich JMS-bezogene URIs beziehen.
Er dient als Basisspeicherort für auf JMS bezogene verwaltete Objekte.
JMS-Basis-URI-Hauptbenutzer
jms.baseUri.principal
Der Benutzername, der bereitgestellt wurde, um den zur JMS-Basis-URI zugeordneten JNDI-Benutzer zu authentifizieren.
JMS-Basis-URI-Passwort
jms.baseUri.password
Das Passwort, das dem JMS-Basis-URI-Hauptbenutzer zugeordnet ist.
JMS-Benutzer
jms.username
Der Standardbenutzer, der dem JMS-Anbieter oder der MOM zugeordnet ist.
JMS-Passwort
jms.password
Das standardmäßige Passwort für die Verbindung mit dem JMS-Anbieter oder der MOM.
Warteschlangenverbindungs-Factory
msg.queueConnectionFactory
Der Speicherort einer verwalteten JMS-Warteschlangenverbindungs-Factory, die von der JMS-MOM verwendet wird.
Themenverbindungs-Factory
wes.topicConnectionFactory
Der Speicherort einer verwalteten JMS-Themenverbindungs-Factory. Dieser Wert kann ein vollständig qualifizierter URI oder ein zu einem konfigurierten Basis-URI relativer eindeutiger Name sein. Weitere Informationen finden Sie unter
Messaging und Web Event Service implementieren.
WES-Anmelde-ID
wes.subscriptionIdentifier
Eindeutige ID, die beim Erstellen von Themenabonnements verwendet wird. Legen Sie diese Eigenschaft fest, wenn mehrere Info*Engine Prozesse auf einem einzelnen Host ein Abonnement zum gleichen Thema erstellen möchten.
Jeder einzelne Info*Engine Dienst muss seine eigene eindeutige ID haben. Wenn diese Eigenschaft nicht angegeben ist, wird eine ID basierend auf dem Host- und Ereignisnamen generiert.
JMS-Bibliothekverzeichnis
jms.lib
Das Verzeichnis, in dem sich die JAR-Dateien von Drittanbietern befinden, die für die Kommunikation mit einem JMS-Dienst erforderlich sind. Wenn die JAR-Dateien bereits im Dienstklassenpfad enthalten sind, ist diese Eigenschaft optional.
Zusätzliche JMS-Eigenschaften
Beim Konfigurieren von Info*Engine mit einem JMS-Dienst können auch die folgenden Eigenschaften festgelegt werden. Eigenschaftenbeschreibungen werden basierend auf der Position der Eigenschaften im Formular und ihrer Funktion gruppiert.
JMS-Neuverbindungsversuchsintervall
jms.recoveryRetryInterval
Die Dauer in Sekunden, die zwischen Versuchen bis zur Wiederherstellung einer Verbindung bei Trennung der MOM gewartet wird.
Der Standardwert ist 30.
Warteschlange für fehlerhafte JMS-Meldungen
jms.badMessageQueue
Wenn eine Meldung vorliegt, die nicht in eine Info*Engine Anfrage übersetzt werden kann, definiert diese Eigenschaft die Warteschlange, in der die Meldung platziert wird. Wird diese Eigenschaft nicht definiert, wird die ungültige Nachricht gelöscht.
WES-Kontext-Provider-Factory
wes.CtxFactory
Der Klassenname der Factory, die den anfänglichen Windchill Kontext für die verwaltete Objektsuche zurückgibt.
Der Standardwert ist com.sun.jndi.ldap.LdapCtxFactory.
WES-Basis-URI
wes.baseUri
Der LDAP-URI (eine Unterebene in einem LDAP-Verzeichnis) mit WES-bezogenen verwalteten Objekten.
Wird diese Eigenschaft nicht angegeben, wird die Eigenschaft jms.baseUri verwendet.
WES-Benutzer
wes.username
Der WES-Benutzername, der beim Herstellen einer Verbindung mit einer JMS-MOM zur Verfügung gestellt werden sollte.
Wird diese Eigenschaft nicht angegeben, wird die Eigenschaft jms.username verwendet.
WES-Passwort
wes.password
Das dem WES-Benutzer zugeordnete Passwort.
Wird diese Eigenschaft nicht angegeben, wird die Eigenschaft jms.password verwendet.
Warteschlange für fehlerhafte WES-Meldungen
wes.badMessageQueue
Wenn eine Meldung vorliegt, die nicht in eine Info*Engine Anfrage übersetzt werden kann, definiert diese Eigenschaft die Warteschlange, in der die Meldung platziert wird. Wird diese Eigenschaft nicht definiert, wird die ungültige Nachricht gelöscht.
Wird diese Eigenschaft nicht angegeben, wird die Eigenschaft jms.badMessageQueue verwendet.
MSG-Kontext-Provider-Factory
msg.CtxFactory
Der Klassenname der Factory, die den anfänglichen JNDI-Kontext für die verwaltete Objektsuche zurückgibt.
Der Standardwert ist com.sun.jndi.ldap.LdapCtxFactory.
Warteschlangen-Basis-URI
msg.baseUri
Der LDAP-URI (eine Unterebene in einem LDAP-Verzeichnis) mit warteschlangenbezogenen verwalteten Objekten.
Wird diese Eigenschaft nicht angegeben, wird die Eigenschaft jms.baseUri verwendet.
Warteschlangen-Benutzer
msg.username
Der Benutzername, der beim Herstellen einer Verbindung mit einer JMS-MOM zur Verfügung gestellt werden sollte.
Wird diese Eigenschaft nicht angegeben, wird die Eigenschaft jms.username verwendet.
Warteschlangen-Passwort
msg.password
Das dem Warteschlangen-Benutzer zugeordnete Passwort.
Wird diese Eigenschaft nicht angegeben, wird die Eigenschaft jms.password verwendet.
Warteschlange für fehlerhafte MSG-Meldungen
msg.badMessageQueue
Wenn eine Meldung vorliegt, die nicht in eine Info*Engine Anfrage übersetzt werden kann, definiert diese Eigenschaft die Warteschlange, in der die Meldung platziert wird. Wird diese Eigenschaft nicht definiert, wird die ungültige Nachricht gelöscht.
Wird diese Eigenschaft nicht angegeben, wird die Eigenschaft jms.badMessageQueue verwendet.
Standard-Anmelde/Einreich-Warteschlange
msg.defaultExecutionQueue
Der eindeutige LDAP-Name einer verwalteten Warteschlange. Der Wert kann ein eindeutiger LDAP-Name hinsichtlich eines konfigurierten Grund-URI oder ein vollständig qualifizierter eindeutiger LDAP-Name sein. Wenn relativ, ist cn= (Attribut des üblichen Namens) implizit (wenn nicht explizit angegeben).
Dieser Warteschlangenspeicherort wird mit den folgenden Webjects verwendet:
◦ Queue-Task – Speicherort von Aufgaben in der Warteschlange. Wenn diese Eigenschaft nicht angegeben ist, muss der Webject-Parameter QUEUE angegeben werden.
◦ Subscribe-Queue – Die bei der Verwendung des Webject zu abonnierende Warteschlange. Wenn diese Eigenschaft nicht angegeben ist, muss der Webject-Parameter QUEUE angegeben werden.
Standard-Ergebnis-Warteschlange
msg.defaultResultsQueue
Der eindeutige LDAP-Name einer verwalteten Warteschlange. Der Wert kann ein eindeutiger LDAP-Name hinsichtlich eines konfigurierten Grund-URI oder ein vollständig qualifizierter eindeutiger LDAP-Name sein. Wenn relativ, ist cn= (Attribut des üblichen Namens) implizit (wenn nicht explizit angegeben).
Dieser Warteschlangenspeicherort wird mit den folgenden Webjects verwendet:
◦ Query-Results – Warteschlangenspeicherort für Ergebnisse. Wenn diese Eigenschaft nicht angegeben ist, muss der Webject-Parameter QUEUE angegeben werden.
◦ Delete-Results – Warteschlangenspeicherort für Ergebnisse. Wenn diese Eigenschaft nicht angegeben ist, muss der Webject-Parameter QUEUE angegeben werden.
◦ Queue-Task – Warteschlangenspeicherort von Ergebnissen. Wenn diese Eigenschaft nicht angegeben ist, muss der Webject-Parameter DESTINATION angegeben werden.
Eigenschaften des Send-Mail-Webject
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.
So legen Sie die folgenden Eigenschaften für die Konfiguration der Send-Mail-Standardeinstellungen fest:
Standard-Mail-Absender
mail.originator
Der Standardabsender (die E-Mail-Adresse, die die Nachricht sendet), der vom Send-Mail-Webject verwendet wird.
Entspricht dem FROM-Webject-Parameter.
Standard-SMTP-Server
mail.smtp.server
Der vom Send-Mail-Webject verwendete Standardserver.
Standard-SMTP-Benutzername
mail.smtp.username
Der beim Herstellen einer Verbindung mit dem SMTP-Server bereitgestellte Standardbenutzername.
Entspricht dem USERNAME-Parameter.
Standard-SMTP-Passwort
mail.smtp.password
Das dem Standard-SMTP-Benutzernamen zugeordnete Standardpasswort.
Entspricht dem PASSWORD-Parameter.
Konfiguration der dynamischen Eigenschaften
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 an, die, in Minuten, 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.
Zusätzliche Eigenschaften
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:
<Dienstname>.dbuser
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.
