Detectar elemento (detectElement)

<detectElement> Elemento

La regla detectElement se utiliza para buscar elementos en archivos XML.

Tabla 1. Atributos del elemento " <detectElement> "
Nombre de atributo	Tipo	Obligatorio	Descripción
etiquetas	Serie	Nee	Nombre del elemento Si proporciona varios, utilice una lista separada por comas. Si no se especifica, coincidirá con cualquier elemento que cumpla los demás criterios de la regla.
valor	Expresión regular	Nee	El valor del contenido de texto del elemento.
espacio de nombres	Expresión regular	Nee	Sólo se marcan los resultados si el URI del espacio de nombres al que pertenece el elemento coincide con este patrón. Si el patrón es "", marque los elementos de cualquier espacio de nombres, incluidos los elementos sin ningún espacio de nombres especificado. El valor predeterminado es "".
documentNamespace	Expresión regular	Nee	Sólo se marcan los resultados si el espacio de nombres de documento del archivo coincide con este patrón de espacio de nombres. Los resultados no se marcarán en ningún archivo que no tenga especificado un espacio de nombres de documento. Si se especifican tanto documentNamespace como validateDocumentNamespaceIfPresent, se utiliza documentNamespace.
validateDocumentNamespaceIfPresent	Expresión regular	Nee	Marque los resultados si el espacio de nombres de documento para el archivo no coincide con este patrón de espacio de nombres y en cualquier archivo que no tenga un espacio de nombres de documento especificado. Utilice este atributo para señalar los archivos XML que no se ajustan a un espacio de nombres de documento específico. Si se especifican tanto documentNamespace como validateDocumentNamespaceIfPresent, se utiliza documentNamespace.
missingChildElement	Serie	Nee	Marcar el elemento especificado por el atributo tags si no contiene un elemento hijo con este nombre.
missingChildElementValue	Expresión regular	Nee	Marcar el elemento especificado mediante el atributo tags si no contiene missingChildElement con un valor que coincida con esto.
missingChildElementAttribute	Serie	Nee	Marcar el elemento especificado mediante el atributo tags si no contiene missingChildElement con un atributo con este nombre.
missingChildElementAttributeValue	Expresión regular	Nee	Marcar el elemento especificado por el atributo tags si no contiene un missingChildElement con un missingChildElementAttribute con un valor coincidente con este.
parentTags	Serie	Nee	Marcar el elemento especificado si es un elemento hijo de esta etiqueta (tag). Si facilita varios, use una lista separada por comas. Se omite si se establece flagRootNode en "true".
flagNotEmpty	Booleano	Nee	Indica si el elemento especificado por el atributo tags debe marcarse sólo cuando no está vacío (contiene hijos). La especificación de elementos de distintivos "false" independientemente del recuento de hijos. El valor predeterminado es false.
flagDuplicate	Booleano	Nee	Indica que la regla solo tiene que marcar si dos o más instancias del elemento se encuentran en el mismo archivo XML. El valor predeterminado es false.
flagRootNode	Booleano	Nee	Indica si la regla solo tiene que marcar si el elemento es el nodo raíz del archivo XML. El valor predeterminado es false.
flagNoRootNode	Booleano	Nee	Si se establece en true, indica que la regla sólo debe marcar si el archivo XML no contiene ningún nodo raíz. No marca los archivos en los que se inicia un nodo raíz, pero nunca se termina, ni los archivos con varios nodos raíz. El valor predeterminado es false.
flagOnce	Booleano	Nee	Indica si se debe marcar una vez por archivo- El valor predeterminado es false.
flagOncePerFile	Booleano	Nee	Indica si se debe marcar una vez por archivo. El valor predeterminado es false.
hideResult	Booleano	Nee	Indica si los resultados marcados por esta regla deben ocultarse en el informe. Este atributo sólo oculta los resultados cuando se utiliza con reglas bajo las etiquetas < and> u < or>. El valor predeterminado es false.

Elementos hijo (uno o más)

Elemento &lt;xmlFile&gt; - necesario, puede ser múltiple

Tabla 2. Atributos del elemento " <xmlFile> "
Nombre de atributo	Tipo	Obligatorio	Descripción
patrón	Expresión regular	Sí	Nombre del archivo con o sin ruta.

Por ejemplo, para detectar un elemento security-constraint o auth-method en un archivo web.xml ubicado en un directorio WEB-INF de aplicación, especifique:


<detectElement tags="security-constraint, auth-method">
    <xmlFile pattern="WEB-INF/web.xml"/>
</detectElement>