XmlEventConfguration

Die Datei XmlEventConfguration definiert die Event Konfiguration einer Sourde Id für verschiedene Sprachen. Die XmlEventConfguration Source id und der Standortpfad müssen zur TcEventSourceLocation als ein Location node (Knoten) eingetragen werden.

Schema

Der folgende Screenshot zeigt das XML Schema, das die Struktur des XmlEventConfguration xml file beschreibt.

XmlEventConfguration 1:

Die folgende Tabelle beschreibt die Nodes des XML Dokuments

Schnittstelle

Beschreibung

TcEventSource

Das einzige Rootelement. Es enthält eine Liste der Source Knoten von 0 bis unendlich. 

Source

Unterelement des TcEventSource Knoten. Der Knoten stellt die Konfiguration eines Event Source dar.. Die Unterelemente sind die ids des Sources.1 bis unendlich für die Source Name der verschiedenen Sprachen und jeweils 0 bis unendlich für die Events und Properties.

id

Unterelement des Source Knoten. Ein Integer, der die Event Source darstellt.

Name

Unterelement des Source Knoten. Der Event Source Name für die verschiedenen Sprachen. Die Sprache wird durch das Attribut *LcId definiert. Wenn kein *LcId Attribut existiert, wird die *LcId 1033 (US-Englisch) verwendet.

Event

Unterelement des Source Knoten. Stellt die Event Konfiguration für ein Event dar. Die Unterelemente sind Event id, ein Message String für die verschiedenen Sprachen von 1 bis unendlich, ParaFormat der Formatstring für die Eventdaten, das MustConfirm Flag, die UserFlags, Dokumentverknüpfungen von 0 bis unendlich und Property von 0 bis unendlich.

Property

Unterelement des Source Knoten. Die Property wird durch Name, Value and Comment dargestellt.

id

Unterelement des Event Knoten. Ein Integer, der die Event Id darstellt.

Message

Unterelement des Event Knoten. Die Event Meldung für die verschiedenen Sprachen. Die Sprache wird durch das Attribut *LcId definiert. Wenn kein *LcId Attribut 

existiert, wird die *LcId 1033 (US-Englisch) verwendet. Das eventData wurde zugeordnet, als das Event vom SPS Funktionsblock ADSLOGEVENT durch Setzen des Flags von FALSE auf TRUE ( oder eines anderen ADS Geräts) ausgegeben wurde, oder vom Aufruf einer Report Event Funktion wie  ITcEventLogC::ReportEvent, ITcEventC3 ::ReportEventEx oder  ITcEventLog:: ReportEvent. Es kann der Meldung durch %1, %2, %,3 ... hinzugefügt werden, wobei die Ziffer den Index des eventData Parameter darstellt.

ParaFormat

Unterelement des Event Knoten. Definiert eine printf Formatbeschreibung, die für einen Eintrag im eventData verwendet wird. Das Attribut ParaNo repräsentiert den Index des eventData für den der Formatstring verwendet wird.

UserFlags

Unterelement des Event Knoten. Ein Integer, der die benutzerdefinierten Flags definiert.

Link

Unterelement des Event Knoten. Eine Dokumentverknüpfung, die den Link auf ein Dokument darstellt, das weitere Informationen über ein Event für die verschiedenen Sprachen bereitstellt. Der Zugriff auf die DocLink Eigenschaft erfolgt über das TcEvent Objekt ITcEvent:: EnumDocLink und ist im Kontextmenü des TcEventViewers verfügbar. Die mit dem Dokument verknüpfte Sprache wird durch das Attribut *LcId definiert. Die Dokumentverknüpfung hat ein Unterelement Text, das den angezeigten Text für die ausgewählte *LcId  und den URL Knoten darstellt. Der URL Knoten enthält die Url zum Dokument für die ausgewählte *LcId, die angezeigt werden soll.

Property

Unterelement des Event Knoten. Die Property wird durch Name, Value and Comment dargestellt.

Beispiel

Der Ausschnitt zeigt eine Beispielkonfiguration einer XmlEventConfguration Datei.

<?xml version="1.0"
encoding="UTF-8"?>
<TcEventSources>
  <Source>
    <Id>1</Id>
    <Name LcId="1033">Axis Controller</Name>
    <Name LcId="1031">Achsen Controller</Name>
  
    <Event>
      <Id>1</Id>
     
      <Message LcId="1033">The Axis:%1 stop at the position %2 mm</Message>
      <Message LcId="1031">Die Achse:%1 hielt an der Position %2 mm</Message>
     
      <!-- format for the seconf parameter -->
      <ParaFormat ParaNo="2">%.3f</ParaFormat>
     
      <!--the event class and prio is defined here -->
     
      <!-- the event class is a WARNING-->
      <Class>6</Class>
     
      <!-- the event priority is implicit -->
     <Priority>0</Priority>
     
     <MustConfirm>true</MustConfirm>

      <Link LcId="1033">
       <Text>Help</Text>
      <URL>file:///C:/1033/AxisError.html</URL>
      </Link>
      <Link LcId="1031">
       <Text>Help</Text>
       <URL>file:///C:/1031/AxisError.html</URL>
      </Link>
      <Property>
       <Name>Log</Name>
       <Value>true</Value>
      </Property>
    </Event>

    <Event>
      <Id>2</Id>
     
      <Message LcId="1033">Emergency Stop!</Message>
      <Message LcId="1031">Not Stopp!</Message>
    </Event>
  </Source>
</TcEventSources>

Das Beispiel zeigt die Eventkonfiguration für zwei Events für die unterstützten Sprachen Deutsch und Englisch.

 

* Die folgende Tabelle zeigt einige häufig verwendete *LCIDs:

LCID

Beschreibung

1031

Deutsch

1033

US English

1034

Spanisch 

1036

Französisch

 

*LCID: weitere Informationen finden Sie in der MSDN Library.