1. Dispatcher Error Mailbenachrichtigung einrichten

1.1 Service.properties editieren

Die Datei Service.properties befindet sich unter folgendem Pfad auf dem Server

C:\plm\dispatcher\DispatcherClient\conf\Service.properties

• Service.properties im Editor öffnen und nach folgendem Abschnitt suchen (ca. ab Zeile 236):

##############################################################################
#
#     E - M A I L
#
#  The following are the recognized Dispatcher Client e-mail properties:

#
# Name          : Service.Email.AdminEmailId
# Description   : Adminstrator e-mail addresses to receive notification.
#                 specified e-mail inbox
# Value         : One or more valid, comma delimited, e-mail addresses. If a
#                 different address delimiter must be used, it must be specified
#                 as the Service.Email.AdminEmailIdDelimiter property value.
#
Service.Email.AdminEmailId=
 
#
# Name          : Service.Email.AdminEmailIdDelimiter
# Description   : The delimiter used for AdminEmailId property value.
# Value         : A valid delimiter character
# Default value : ,
#
Service.Email.AdminEmailIdDelimiter=,
 
#
# Name          : Service.Email.SMTPServerName
# Description   : Server used for basic text messaging
# Value         : A valid IP address of the SMTP Server
#
Service.Email.SMTPServerName=LOCALHOST
 
#
# Name          : Service.Email.SendUserEmailOnError
# Description   : 0 = off
#                 1 = Turn on e-mail based notification for Teamcenter users
#                     that create translation requests. When a translation
#                     error occurs, e-mail will be sent to the e-mail address
#                     specified for the user that owns the translation
#                     request.
# Value         : 0 or 1
#
Service.Email.SendUserEmailOnError=0
 
#
# Name          : Service.Email.SenderId
# Description   : All adminstrator and user error notifications sent via e-mail
#                 will use this value as the e-mail sender address.
# Value         : A single valid e-mail address.
# Default value : The Dispatcher Client name.
#
Service.Email.SenderId=CHANGE_ME@LOCALHOST
 
#
# Name          : Service.Email.EmailSubjectPrefix
# Description   : This set of characters is prepended to the subject
#                 of the e-mail
# Value         : String
#
Service.Email.EmailSubjectPrefix=[TS_ERROR]
 
###############################################################################

Folgende Einträge müssen editiert werden:

Service.Email.AdminEmailId=your_admin_mail_adress@domain.com
Service.Email.AdminEmailIdDelimiter=,
Service.Email.SMTPServerName=mail.domain.com
Service.Email.SendUserEmailOnError=1
Service.Email.SenderId=noreply@domain.com
Service.Email.EmailSubjectPrefix=[DISPATCHER-ERROR]

• Dispatcher Client Dienst stoppen/starten
  
  Damit die Änderungen aktiviert werden muss der Dispatcher Client Dienst gestoppt und wieder gestartet werden.
  
  
• Dienst über das Icon „STOP DC“ auf dem Desktop stoppen
  
  
  
  
• Dienst über „Dienste“ wieder starten
  
  
  
  
• Kontrolle im Log: „C:\plm\dispatcher\Logs\Dispatcher\process\DispatcherClient_192.168.0.226_2099.log“ ob dienst korrekt läuft
  
  Beispiel:
  
  

  2020-10-27 14:11:17,870 INFO  - Aktualisierte Aufgaben-ID: Ua612219285f981aeb1946 DELETE
  2020-10-27 14:32:16,714 INFO  - Connecting to DispatcherClient on Port: 2099
  2020-10-27 14:32:16,800 INFO  - Connected to DispatcherClient on Port: 2099
  2020-10-27 14:32:16,801 INFO  - Dienst wird angehalten...
  2020-10-27 14:32:17,145 INFO  - Stopped DispatcherClient.
  2020-10-27 14:35:00,301 INFO  - Dienst wird gestartet...
  2020-10-27 14:35:00,308 INFO  - In 4tier mode. Url is http://etc-dev:7070/tc
  2020-10-27 14:35:00,314 WARN  - TC_USE_KEYMANAGER environment variable is configured to not use KeyManager.
  2020-10-27 14:35:02,477 INFO  - Anmeldung an TC-Server abgeschlossen.
  2020-10-27 14:35:02,552 INFO  - 
  2020-10-27 14:35:02,552 INFO  - Connected to Scheduler on Url rmi://localhost:2001
  2020-10-27 14:35:03,571 INFO  - Anforderungsstatus-Verwaltungsaufgabe wird geplant. Intervall in Minuten: 30
  2020-10-27 14:35:03,573 INFO  - Verarbeitung der Datenbankanforderungen wird gestartet.

1.2 Test durch provozieren eines Fehlers

Beispiel:

• Neues Item erstellen „Dispatcher Test“
  
  
• Neues Word.docx Dataset erstellen
  
  
  
  
• Vorbereitung korrupte Word Datei:
  PNG Bilddatei aus Internet laden, auf dem Desktop abspeichern und in Test.docx umbenennen
  
  
• Check Out des Word Data Sets
  
  
  
  
• Rechtsclick und „Named References…“ wählen
  
  
• Auf „Upload“ klicken und die Datei Test.docx vom Desktop wählen
  
  
  
  
• Named References mit close schliessen
  
  
• Check In des Word Data Sets
  
  
• Dataset ausgewählt lassen und die Translation über das Menü „Translation → Translate“ starten und bei Service pdf wählen
  
  
  
  
• Über die Administrations Console den Vorgang überwachen, der nun auf einen Fehler läuft und unter State „TERMINAL“ zurück gibt

⇒ Nun wird eine Email mit der Fehlermeldung versendet

Inhalt der Mail:

[DISPATCHER-ERROR]DispatcherClient_192.168.0.226_2099:Ua612236e05f983276180a

Fehlerbericht aus "DispatcherService"
Konvertierungsanforderungsdetails --
Aufgaben-ID:Ua612236e05f983276180a
Anbieter:SIEMENS
Konvertierer:avamsofficetopdfvbs
Datum:27-Oct-2020 15:45
 
Primäre und sekundäre Objektliste --
Primäres Objekt:000153/A
Sekundäres Objekt:000153/A-Dispatcher Test
 
Benutzername:infodba
Benutzer-E-Mail-ID:Unbekannt
Hostname:eTC-Dev
 
Kommentar:Error returned by the translator...
 
Fehlerbericht:Konvertierung auf Grund nicht erzeugter Dateien fehlgeschlagen.