Compartir a través de

Elemento Mapping

  • Artículo

Última modificación: martes, 22 de junio de 2010

Hace referencia a: SharePoint Server 2010

Se aplica a: Microsoft FAST Search Server 2010 for SharePoint
Asigna una expresión XPath a una propiedad rastreada. Opcional.

<Mapping path='XPath' attr='propName' propset='GUID' type='varType' sep-str='separator' post-str='postString' ignore-whitespace='yes|no' strip-tags='yes|no' shallow='yes|no' mode='append|prepend|overwrite' />

Atributos y elementos

En las siguientes secciones se describen los atributos, elementos secundarios y elementos primarios.

Atributos

Atributo

Descripción

path

Obligatorio. Especifica una expresión XPath para el nodo XML desde el que se va a recuperar contenido.

attr

Especifica el nombre de propiedad de la propiedad rastreada creada. Obligatorio sólo cuando el elemento no forma parte de un elemento MappingGroup.

propset

Opcional. Especifica una cadena que representa un GUID propset hexadecimal. Invalida el conjunto de propiedades predeterminadas. Se aplica únicamente cuando el elemento no forma parte de un elemento MappingGroup.

type

Opcional. Determina una especificación de tipo variant que invalida el tipo variant predeterminado. Se aplica únicamente cuando el elemento no forma parte de un elemento MappingGroup.

sep-str

Opcional. Especifica la cadena de separación cuando la ruta de acceso coincide con más de un nodo XML.

Valor predeterminado: un carácter de espacio único.

post-str

Opcional. Especifica una cadena para anexar al contenido extraído.

Valor predeterminado: una cadena vacía.

ignore-white-space

Opcional. Un valor yes indica que los caracteres de espacio en blanco consecutivos se reemplazan con un espacio. Un valor no indica que no hay ninguna asignación de varios espacios en blanco.

Valor predeterminado: yes

strip-tags

Opcional. Un valor yes indica que las etiquetas de elementos secundarios se eliminan del contenido extraído. Por ejemplo, cuando la ruta de acceso coincide con un elemento que contiene elementos secundarios. Un valor no indica que las etiquetas del subelemento se mantienen en el contenido extraído. No debe usar no si la propiedad rastreada está asignada a una propiedad administrada que permite búsqueda.

Valor predeterminado: yes

shallow

Opcional. Un valor yes indica que solo se extrae texto de los elementos coincidentes. Un valor no indica que también se extrae texto de todos los elementos XML descendientes.

En el siguiente ejemplo se asume que el atributo path contiene una expresión XPath que coincide con el elemento body.

<body>
Some text
  <sub-body>  more text</sub-body>
End of body
</body>

Cuando shallow="yes", solo se extraen Some text y End of body. Cuando shallow="no", también se extrae more text (junto con Some text y End of body) porque se encuentra en un elemento descendiente de <body>.

Valor predeterminado: no

mode

Opcional. Define el comportamiento cuando otro elemento Mapping o elemento MappingGroup ha asignado contenido al mismo nombre de propiedad. Se aplica únicamente cuando el elemento no forma parte de un elemento MappingGroup.

Valor predeterminado: append

Atributos

Valor

Descripción

append

Agrega el nuevo contenido al final del contenido existente.

prepend

Agrega el nuevo contenido al inicio del contenido existente.

overwrite

Sobrescribe el contenido existente.

Elementos secundarios

Ninguno.

Elementos primarios

Nombre

Descripción

XMLMappings

Especifica un conjunto de asignaciones de expresiones XPath a propiedades rastreadas.

MappingGroup

Asigna el contenido de elementos Mapping secundarios a una propiedad rastreada.

SubTree

Define una ruta de acceso base común para los elementos contenidos Mapping, MappingGroup y SubTree.

Ejemplo

La primera sección del código proporciona entradas XML de muestra. La segunda sección del código proporciona una configuración de asignador XML asociada que asigna el título, el tamaño y las palabras clave a las propiedades rastreadas mytitle, mysize y mykeywords.

<Document>
  <title>My title</title>
  <size>128</size>
  <keywords>
    <keyword>math</keyword>
    <keyword>biology</keyword>
  </keywords>
</Document>

<XMLPropertiesCreator>
  <propset>d6ee4933-09c4-46e3-a5e4-b3787cb4a090</propset>
  <type>31</type>
  <XMLMappings>
    <Mapping attr="mytitle" path="//title"/>
    <Mapping attr="mysize" path="//size" propset="38c35ad5-69ee-4776-886f-95961a73d52d" type="3"/>
    <Mapping attr="mykeywords" path="//keyword" sep-str=","/>
  </XMLMappings>
</XMLPropertiesCreator>

Vea también

Conceptos

Procesamiento de elementos XML personalizados

Esquema de asignador XML