Definición de expresiones regulares en archivos XML
Puede definir expresiones regulares para la validación de entrada en archivos XML aparte.
La referencia a estas expresiones regulares puede utilizarse en varios tipos de datos que se han definido en el archivo datatypes.xml. Además, la referencia a expresiones regulares puede utilizarse en varias reglas que se definen en los distintos archivos XML de reglas. Este enfoque facilita la modificación de la expresión regular en un solo lugar y los cambios entrarán en vigor tanto en el archivo datatypes.xml como en distintos archivos XML de reglas. Cada expresión regular tiene un ID exclusivo asociado a ella. Los archivos de expresión regular se pueden registrar con la aplicación añadiendo un parámetro de contexto en el archivo <runtime_sandbox>/repository/eardata/smcfs/extn/web.xml .
Para definir una expresión regular para la validación de entrada, cree un archivo XML en el siguiente formato.
<RegularExpressions>
<RegularExpression id="" javaPattern="" jsPattern="" blacklistErrorMsg=""
whitelistErrorMsg=""/>
<RegularExpression id="" javaPattern="" jsPattern=""/>
</RegularExpressions>En la tabla siguiente se describen distintos elementos y atributos del archivo XML de expresiones regulares.
<RegularExpression
id="dates" javaPattern="" jsPattern="^[a-zA-Z0-9.,!\-/+=_ :]*$"/> es equivalente a <RegularExpression id="dates" jsPattern="^[a-zA-Z0-9.,!\-/+=_
:]*$"/>.Elemento/Atributo |
Descripción |
|---|---|
RegularExpressions |
Necesario. El archivo XML de expresiones regulares debe tener RegularExpressions como elemento raíz. |
RegularExpression |
Opcional. Cada expresión regular debe definirse como un elemento RegularExpression. Puede tener cero o más apariciones. |
ID |
Necesario. Identificador exclusivo para la expresión regular. Este ID puede ser utilizado como referencia para esta expresión regular en varios lugares. |
javaPattern |
Opcional. Patrón de expresión regular para realizar la validación del lado del servidor. Si no se especifica, la validación de entrada ocurre en el lado del cliente que se basa en el valor de atributo jsPattern y la validación del lado del servidor no se realiza. |
jsPattern |
Opcional. Patrón de expresión regular para realizar la validación del lado del cliente. Si no se especifica, la validación de entrada ocurre en el lado del servidor que se basa en el valor del atributo javaPattern y la validación del lado de cliente no se realiza. |
whitelistErrorMsg |
Opcional. Clave de paquete para visualizar el mensaje de error, si fallan los patrones de lista blanca de la expresión regular. |
blacklistErrorMsg |
Opcional. Clave de paquete para mostrar el mensaje de error, si fallan los patrones de lista negra de la expresión regular. |
Por ejemplo, si define una expresión regular con la fecha id,
el archivo XML de expresiones regulares será como se indica a continuación:
<RegularExpressions>
<RegularExpression id="dates" javaPattern="^[a-zA-Z0-9.,!\-/+=_ :]*$"
jsPattern="^[a-zA-Z0-9.,!\-/+=_:]*$" blacklistErrorMsg=""
whitelistErrorMsg=""/>
</RegularExpressions>Puede hacer referencia a la expresión regular de fecha en ambos códigos XML de reglas y tipos de datos.
Utilización de una referencia de expresiones regulares en el XML de reglas
Puede proporcionar una referencia del ID de expresión regular en el elemento RegularExpression cuando se define una regla en el XML de regla. Por ejemplo:
<ValidationRules>
<Rule id="" ruleType="Regex" inputType="" inputName="" uri=""
maxLength="" minLength="" allowNull="" >
<Whitelist>
<RegularExpression ref="dates"/>
</Rule>
</ValidationRules>Utilización de una referencia de expresiones regulares en el XML de tipos de datos
Puede proporcionar una referencia del ID de expresión regular en el elemento Regex al definir una expresión regular en el archivo datatypes.xml. Por ejemplo:
<DataTypes>
<DataType Name="Date" PpcSize="12" Size="7" Type="DATE">
<Validation>
<Regex Ref="dates" />
</Validation>
<UIType Size="8" UITableSize="15"/>
</DataType>
</DataTypes>