Freigeben über

Record-Attributschema

  • Artikel

Datensätze können anwendungsspezifische Attribute aufweisen, die eine Sequenz von Namen- oder Wertpaaren sind, die als XML-Zeichenfolge im pszAttributes Member der PEER_RECORD-Struktur dargestellt werden. Die Attribute werden verwendet, um eine Datensatzsuche zu filtern, die durch Aufrufe von PeerGroupSearchRecordsinitiiert wird, wodurch ein XML-Suchfilter verwendet wird, der in Datensatzsuchabfrageformat als Parameter angegeben ist.

Ein Datensatzattribute kann eines der folgenden drei Typen sein:

  • int ist ein ganzzahliger Wert.
  • Datum ist ein Datetime-Wert, der als eines der Standardformate dargestellt wird, die unter https://www.w3.org/TR/NOTE-datetimebeschrieben werden.
  • Zeichenfolge ist ein Unicode-Zeichenfolgenwert.

In der folgenden Liste werden die spezifischen Attributnamen identifiziert, die von der Peerinfrastruktur reserviert sind:

  • peerlastmodifiedby
  • peercreatorid
  • peerlastmodificationtime
  • peerrecordid-
  • peerrecordtype-
  • Peercreationtime-
  • peerlastmodificationtime

Beispiel für das Definieren von Datensatzattributen

Das folgende Schemabeispiel zeigt, 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>

Anmerkung

Attributnamen müssen Sequenzen alphanumerischer Zeichen sein. Sonderzeichen wie Bindestriche ("-") und Unterstriche ("_") sind in einem Attributnamen nicht zulässig.

 

Das folgende Beispiel einer XML-Attributsequenz enthält die benutzerdefinierten AuthenticationType- und AuthExpires Attribute, die im pszAttributes Member von PEER_RECORDangezeigt werden.

<attributes>
  <attribute name="AuthenticationType" type="string">Kerberos</attribute><attribute name="AuthExpires" type="date">2002-01-31</attribute>
<attributes>