Reguläre Ausdrücke in XML-Dateien definieren

Sie können reguläre Ausdrücke für die Eingabevalidierung in separaten XML-Dateien definieren.

Verweise auf diese regulären Ausdrücke können für verschiedene (in der Datei datatypes.xml definierte) Datentypen verwendet werden. Außerdem können Verweise auf reguläre Ausdrücke für verschiedene (in den verschiedenen XML-Dateien für Regeln definierte) Regeln verwendet werden. Durch diese Vorgehensweise wird es möglich, den regulären Ausdruck an einer einzigen Stelle zu ändern, wodurch die Änderungen sowohl in der Datei datatypes.xml als auch in verschiedenen XML-Dateien für Regeln wirksam werden. Jedem regulären Ausdruck ist eine eindeutige ID zugeordnet. Die Dateien mit regulären Ausdrücken können bei der Anwendung registriert werden, indem ein Kontextparameter in der Datei <runtime_sandbox>/repository/eardata/smcfs/extn/web.xml hinzugefügt wird.

Zum Definieren eines regulären Ausdrucks für die Eingabevalidierung erstellen Sie eine XML-Datei im folgenden Format.

<RegularExpressions>
     <RegularExpression id="" javaPattern="" jsPattern="" blacklistErrorMsg=""
       whitelistErrorMsg=""/>
     <RegularExpression id="" javaPattern="" jsPattern=""/> 
</RegularExpressions>

In der nachstehenden Tabelle werden verschiedene Elemente und Attribute der XML-Datei für reguläre Ausdrücke beschrieben.

Hinweis: Jedes leere Attribut wird als nicht angegeben betrachtet. Ein Element, das als

<RegularExpression
id="dates" javaPattern="" jsPattern="^[a-zA-Z0-9.,!\-/+=_ :]*$"/>

definiert ist, entspricht beispielsweise

<RegularExpression id="dates" jsPattern="^[a-zA-Z0-9.,!\-/+=_
:]*$"/>

Element/Attribut	Beschreibung
RegularExpressions	Erforderlich. Die XML-Datei für reguläre Ausdrücke muss "RegularExpressions" als Stammelement enthalten.
RegularExpression	Optional: Jeder reguläre Ausdruck muss als ein einziges RegularExpression-Element definiert werden. Dabei sind null oder mehr Vorkommen möglich.
ID	Erforderlich. Eindeutige ID für den regulären Ausdruck. Diese ID kann als Verweis für diesen regulären Ausdruck in verschiedenen Bereichen verwendet werden.
javaPattern	Optional: Muster für regulären Ausdruck zur Durchführung einer serverseitigen Validierung. Wird dieses Attribut nicht angegeben, erfolgt die Eingabevalidierung auf der Clientseite, basierend auf dem Wert des jsPattern-Attributs. Die serverseitige Validierung erfolgt in diesem Fall nicht.
jsPattern	Optional: Muster für regulären Ausdruck zur Durchführung einer clientseitigen Validierung. Wird dieses Attribut nicht angegeben, erfolgt die Eingabevalidierung auf der Serverseite, basierend auf dem Wert des javaPattern-Attributs. Die clientseitige Validierung erfolgt in diesem Fall nicht.
whitelistErrorMsg	Optional: Paketschlüssel für die Fehlernachricht, die angezeigt werden soll, wenn die Whitelist-Muster des regulären Ausdrucks fehlschlagen.
blacklistErrorMsg	Optional: Paketschlüssel für die Fehlernachricht, die angezeigt werden soll, wenn die Blacklist-Muster des regulären Ausdrucks fehlschlagen.

Wenn Sie beispielsweise einen regulären Ausdruck mit dem id-Wert "dates" definieren, hat die XML-Datei für reguläre Ausdrücke folgenden Inhalt:

<RegularExpressions>
    <RegularExpression id="dates" javaPattern="^[a-zA-Z0-9.,!\-/+=_ :]*$"
           jsPattern="^[a-zA-Z0-9.,!\-/+=_:]*$" blacklistErrorMsg=""
           whitelistErrorMsg=""/> 
</RegularExpressions>

Sie können sowohl in der XML-Datei für Regeln als auch in der XML-Datei für Datentypen auf den regulären Ausdruck "dates" verweisen.

Verweise auf reguläre Ausdrücke in der XML-Datei für Regeln verwenden

Sie können einen Verweis auf die ID des regulären Ausdrucks im RegularExpression-Element angeben, wenn Sie eine Regel in der XML-Datei für Regeln definieren. Beispiel:

<ValidationRules> 
    <Rule id="" ruleType="Regex" inputType="" inputName="" uri="" 
      maxLength="" minLength="" allowNull="" > 
     <Whitelist> 
        <RegularExpression ref="dates"/> 
     </Rule> 
</ValidationRules>

Verweise auf reguläre Ausdrücke in der XML-Datei für Datentypen verwenden

Sie können einen Verweis auf die ID des regulären Ausdrucks im Regex-Element angeben, wenn Sie einen regulären Ausdruck in der Datei datatypes.xml definieren. Beispiel:

<DataTypes>
    <DataType Name="Date" PpcSize="12" Size="7" Type="DATE">
        <Validation>
             <Regex Ref="dates" />        
        </Validation>
        <UIType Size="8" UITableSize="15"/>
   </DataType> 
</DataTypes>