Datensatzattributschema
Datensätze können anwendungsspezifische Attribute aufweisen, bei denen es sich um eine Sequenz von Name- oder Wertpaaren handelt, die als XML-Zeichenfolge im pszAttributes-Element der PEER _ RECORD-Struktur dargestellt werden. Die Attribute werden verwendet, um eine Datensatzsuche zu filtern, die durch Aufrufe von PeerGroupSearchRecordsinitiiert wird. Dabei wird ein XML-Suchfilter verwendet, der im Abfrageformat für die Datensatzsuche als Parameter angegeben ist.
Ein Datensatzattribut kann einer der folgenden drei Typen sein:
- int ist ein ganzzahliger Wert.
- date ist ein datetime-Wert, der als eines der unter beschriebenen Standardformate dargestellt https://www.w3.org/TR/NOTE-datetime wird.
- string ist ein Unicode-Zeichenfolgenwert.
In der folgenden Liste sind die spezifischen Attributnamen aufgeführt, die von der Peerinfrastruktur reserviert werden:
- peerlastmodifiedby
- peercrekollegd
- peerlastmodificationtime
- peerrecordid
- peerrecordtype
- peercreationtime
- peerlastmodificationtime
Beispiel für das Definieren von Datensatzattributen
Im folgenden Schemabeispiel wird veranschaulicht, wie Datensatzattribute definiert werden:
<?xml version="1.0" encoding="utf-8" ?>
<xs:schema xmlns:xs="https://www.w3.org/2001/XMLSchema">
<xs:simpleType name="alphanum">
<xs:restriction base="xs:string">
<xs:pattern value="\c+" />
</xs:restriction>
</xs:simpleType>
<xs:complexType name="attributeType">
<xs:simpleContent>
<xs:extension base="xs:string">
<xs:attribute name="name" type="alphanum" />
<xs:attribute name="type">
<xs:simpleType>
<xs:restriction base="alphanum">
<xs:enumeration value="string"/>
<xs:enumeration value="date"/>
<xs:enumeration value="int"/>
</xs:restriction>
</xs:simpleType>
</xs:attribute>
</xs:extension>
</xs:simpleContent>
</xs:complexType>
<xs:element name="attributes">
<xs:complexType>
<xs:sequence>
<xs:element name="attribute" type="attributeType" minOccurs="0" maxOccurs="unbounded" />
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:schema>
Hinweis
Attributnamen müssen Sequenzen alphanumerischer Zeichen sein. Sonderzeichen wie Bindestriche ("-") und Unterstriche (" _ ") sind in einem Attributnamen nicht zulässig.
Das folgende Beispiel für eine XML-Attributsequenz enthält die benutzerdefinierten Attribute AuthenticationType und AuthExpires, die im pszAttributes-Element von PEER RECORD angezeigt _ werden.
<attributes>
<attribute name="AuthenticationType" type="string">Kerberos</attribute><attribute name="AuthExpires" type="date">2002-01-31</attribute>
<attributes>