Especificación del refinador en el servicio web de consulta y el modelo de objetos de consulta

Aprenda cómo especificar refinadores en el servicio web de consulta o el modelo de objetos de consulta.

Última modificación: jueves, 01 de septiembre de 2011

Hace referencia a: SharePoint Server 2010

Al consultar FAST Search Server 2010 for SharePoint, puede especificar qué refinadores y qué tipo de datos de refinamiento se devolverán en el resultado de la consulta.

Se aplica a: Microsoft FAST Search Server 2010 for SharePoint

Especificar refinadores mediante el servicio web de consulta o el modelo de objetos de consulta

Si usa el servicio web de consulta, especifique los refinadores de consulta solicitados mediante el Elemento Refiner en el esquema Microsoft.Search.Query. Para obtener más información, vea Uso de refinadores en el servicio web de consulta.

Si usa el modelo de objetos de consulta, especifique los refinadores de consulta solicitados mediante la propiedad Refiners de la clase KeywordQuery. Para especificar los refinadores de consulta solicitados, se usa la sintaxis siguiente:

<refiner>[,<refiner>]*

En ambos casos, la especificación de cada refinador individual tiene el siguiente formato:

<refiner-name>[(parameter=value[,parameter=value]*)]?

Donde:

• <nombre-refinador> es el nombre de la propiedad administrada asociada al refinador.

• La lista opcional de pares de parameter=value permite especificar valores de configuración no predeterminados para el refinador indicado. Si un parámetro de un refinador no se encuentra dentro de los paréntesis, la configuración del esquema de índices le muestra la configuración predeterminada. Para obtener más información, vea Esquema de índice (FAST Search Server for SharePoint).

En la Tabla 1 se enumeran los parámetros válidos para los refinadores.

Tabla 1. Parámetros válidos para refinadores (FAST Search Server 2010 for SharePoint)

Parámetro	Descripción
deephits	Invalida la cantidad predeterminada de aciertos que se usa como base para el cálculo del refinamiento profundo. Esto afectará al rendimiento de la búsqueda. Sintaxis deephits=<integer value> Ejemplo price(deephits=1000) Nota Este límite se aplica en cada partición de búsqueda dentro de las columnas o filas de la búsqueda. La cantidad real de aciertos que se evalúa será mayor que este valor debido a la agregación de resultados a través de las particiones de búsqueda.
discretize	Especifica intervalos personalizados (contenedores de refinamiento) para refinadores numéricos. Sintaxis discretize=manual/<threshold>/<threshold>[/<threshold>]* El atributo <umbral> especifica el umbral para cada contenedor de refinamiento. Hay un intervalo para todos los elementos que están por debajo del primer umbral especificado, un intervalo entre cada umbral consecutivo y un intervalo para todos los elementos que están por encima del último umbral. Para un refinador de tipo Datetime, especifique el umbral de acuerdo con los siguientes formatos compatibles con la norma ISO 8601: AAAA-MM-DD AAAA-MM-DDThh:mm:ss AAAA-MM-DDThh:mm:ssZ Los valores de formato especifican lo siguiente: AAAA  Año de cuatro dígitos. Se admiten sólo cuatro dígitos. MM  Mes de dos dígitos. 01 = enero. DD  Día de dos dígitos (01 a 31). T  La letra "T". hh  Hora de dos dígitos (00 a 23). No se permite la indicación de a. m. o p. m. mm  Minuto de dos dígitos (00 a 59). ss  Segundo de dos dígitos (00 a 59). Importante Todos los valores de fecha y hora deben especificarse según el formato UTC (hora universal coordinada), también conocido como zona horaria GMT (hora del meridiano de Greenwich). El identificador de zona horaria UTC (un carácter final "Z") es opcional.
sort	Define cómo se ordenan los contenedores dentro de un refinador de cadena. Sintaxis sort=<property>/<direction> Los atributos realizan lo siguiente: <propiedad>  Especifica el algoritmo de ordenación. Los valores válidos son los siguientes (los valores deben estar en minúscula): frequency  Ordena por repetición en los contenedores. name  Ordena por nombre de etiqueta. number  Trata las cadenas como numéricas y usa la ordenación numérica. Este valor puede ser útil para especificar valores discretos, por ejemplo, para realizar la ordenación numérica de un valor que se encuentra en una propiedad de cadena administrada. <dirección>  Especifica la dirección de ordenación. Los valores válidos son: descending ascending Ejemplo sort=frequency/descending Predeterminado: frecuencia/descendente.
filter	Define cómo se filtran los contenedores de un refinador de tipo String antes de que se devuelvan al cliente. Sintaxis filter=<bins>/<freq>/<prefix>[<levels>] Los atributos realizan lo siguiente: <contenedores>  Especifica la cantidad máxima de contenedores devueltos. Después de ordenar los contenedores dentro del refinador, use este atributo para cortar los contenedores finales. Por ejemplo, si bins=10, solo se devuelven los 10 primeros contenedores, según el algoritmo de ordenación especificado. <frec>  Limita la cantidad de contenedores devueltos. Use este atributo para quitar los contenedores que tienen recuentos de baja frecuencia. Por ejemplo, freq=2 indica que solo se devuelven los contenedores con dos o más miembros. <prefijo>  Especifica que solo se devuelven los contenedores con un nombre que comienza con este prefijo. El carácter del asterisco comodín "*" coincidirá con todos los nombres. Ejemplo filter=30/2/* <niveles>  Especifica los niveles de la taxonomía. Use este atributo para filtrar el resultado del refinador jerárquico según los niveles de taxonomía. El atributo debe ser un número entero positivo n. El valor predeterminado es n=0. Si n>0, solo se devolverán las entradas de refinador que tengan menos de n símbolos de separador para la ruta de acceso de taxonomía ("/"). Si n=0, no hay filtrado de nivel. El separador de nivel es el carácter de barra diagonal ("/"). Tenga en cuenta el costo de rendimiento del uso de un navegador de taxonomía muy grande. El filtrado se lleva a cabo como parte del procesamiento de resultados. Nota Este parámetro aplica el filtrado del resultado específico de la aplicación. Es diferente del parámetro cutoff, que aplica limitaciones en cada nodo coincidente de la consulta individual para optimizar el rendimiento.
cutoff	Limita la cantidad de datos que se deben transferir y procesar para los refinadores profundos de cadena. Puede configurar los refinadores para devolver solo los valores más relevantes (contenedores). Nota Este filtrado de límite se lleva a cabo dentro de cada servidor coincidente de la consulta. Es diferente del parámetro filter, que realiza el filtrado solo de los resultados. Puede combinar los dos parámetros. Sintaxis cutoff=<frequency>/<minbins>/<maxbins> Los atributos realizan lo siguiente: <máximoContenedores>  Limita la cantidad de contenedores. Este parámetro limita la cantidad de valores únicos (contenedores), que será devuelto para un refinador. Es la mejor manera de mejorar el rendimiento de la búsqueda cuando se devuelven refinadores de cadena con una gran cantidad de contenedores. "0" indica que se usa el valor predeterminado especificado en el esquema de índice. <frecuencia>  Limita la cantidad de contenedores según la frecuencia. Si la cantidad de repeticiones de un valor de un refinador en un conjunto de resultados es menor o igual que el valor de frecuencia, no se devuelve el valor del refinador. "0" indica que se usa el valor predeterminado de acuerdo con el esquema de índice. <mínimoContenedores>  Especifica el valor mínimo para el límite de la frecuencia. Si la cantidad de valores de refinador único para la consulta es menor que este valor, no se limitará la frecuencia y se devolverán todos los valores del refinador de dicha partición de búsqueda. Cuando se usa la limitación por frecuencia, este parámetro se puede usar para especificar un número mínimo de valores únicos de refinador que se devolverá independientemente de la cantidad de repeticiones. El valor predeterminado de este atributo es "0", lo que significa que esa limitación de frecuencia se lleva a cabo con independencia del número de valores únicos del navegador. "0" indica que se usa el valor predeterminado especificado en el esquema de índice. Nota Use <frecuencia> y <mínimoContenedores> con cuidado; se recomienda que solo use <máximoContenedores>.

El siguiente ejemplo especifica un refinador de consulta para la fecha de última modificación:

write(discretize=manual/2010-01-01/2010-08-22/2010-09-15/2010-09-21/2010-09-22)

El refinador write se asocia a la propiedad administrada que contiene la fecha de última modificación de los elementos. Este refinador especifica contenedores de fecha y hora de tamaño fijo, donde el último contenedor (2010-09-22) debe representar la fecha actual en la que se ha emitido la consulta. Los contenedores pueden usarse entonces como base para representar los contenedores de refinamiento para hoy, ayer, la semana pasada, el mes pasado, el año pasado y fechas anteriores.

Si desea adaptarse a la zona horaria del usuario, puede especificar los contenedores con representación de fecha y hora completa.

Nota

Los nombres de los refinadores deben escribirse en minúscula en la especificación.

Vea también

Conceptos

Uso de refinadores en el servicio web de consulta

Adición de un refinador al elemento web de panel de refinamiento

Refinamiento de consultas(FAST Search Server 2010 for SharePoint)