buscar

Métodos de servicios Web › Gestión del conocimiento › Métodos generales de Gestión del conocimiento › buscar

buscar

Los siguientes parámetros se aplican al método search:

Parámetro	Tipo	Descripción
SID	Entero	Identifica la sesión recuperada del inicio de sesión.
problema	Cadena	Identifica la descripción del problema para el que desea buscar soluciones.
resultSize	Entero	Identifica el número de documentos de los que desea recuperar información detallada. Para el resto de los documentos, sólo se devuelven los ID. Se puede acceder posteriormente a la información detallada de estos documentos mediante el método getDocumentsByIDs(). El valor predeterminado es 10.
propertyList	Cadena	Identifica la lista separada por comas de los campos de base de datos de los que desea recuperar información. Siempre se devuelven los campos siguientes, independientemente del parámetro propertyList: ID DOC_TYPE_ID
sortBy	Cadena	Identifica el campo de base de datos que desea utilizar para ordenar los resultados. No se admiten varios campos de ordenación. El valor predeterminado es RELEVANCE. Cuando se utiliza ID como ordenación secundaria, siempre se ordenan los resultados. Para ver las propiedades de ordenación válidas, consulte el método faq.
descending	Boolean	Identifica un indicador disponible para ordenar los resultados en orden descendente.
relatedCategories	Boolean	Devuelve una lista de categorías relacionadas para los documentos encontrados.
searchType	Entero	Tipo de búsqueda que desea realizar: 1 = búsqueda por conceptos (NLS) 2 = búsqueda Gestión del conocimiento
matchType	Entero	Representa el tipo de coincidencia: 0 = coincidencia de tipo OR 1 = coincidencia de tipo AND 2 = coincidencia exacta Nota: Si se selecciona NLS para el parámetro searchType, sólo serán válidos los parámetros matchType OR y AND.
searchField	Entero	Representa la combinación binaria de los campos en los que desea realizar la búsqueda: Título = 1 Resumen = 2 Problema = 4 Resolución = 8 Por ejemplo, para buscar en todos los campos especifique 15 (1+2+4+8). Para buscar sólo en los campos Resumen y Problema, especifique 6 (2+4). Nota: El valor predeterminado es buscar en Problema. Si define el parámetro searchType en NLS, se omitirá el parámetro searchFields, ya que las búsquedas NLS sólo realizan búsquedas en el campo Problema.
categoryPath	Cadena	Limita los resultados de una búsqueda a una o más categorías determinadas. Debe especificar la ruta de ID completa de la categoría y separar las distintas categorías con comas. Por ejemplo, 1-3-5, 1-4-8 para limitar la búsqueda a las categorías 5 y 8 (y a sus subcategorías correspondientes).
whereClause	Cadena	Utilícelo para agregar su propia "cláusula Where SQL" para filtrar los resultados de la búsqueda.
maxDocIds	Entero	Representa la cantidad máxima de ID de documentos que se puede devolver. Por ejemplo, si el parámetro resultSize es 10, el parámetro maxDocIds es 50 y hay 100 documentos coincidentes en la base de datos, recuperará información detallada de 10 y sólo el ID de 40. No se devuelven los 50 restantes. El valor predeterminado es 100.

Descripción

Busca soluciones para un problema. Los documentos se recuperan en función del problema introducido. Se devuelven todos los documentos que coinciden con la descripción del problema o con una descripción similar. Para mejorar el rendimiento, estos métodos sólo recuperan información detallada de un conjunto de documentos definido por el usuario, que se controla mediante el parámetro resultSize. El resto de los documentos sólo devuelven sus ID. Con este método, por ejemplo, puede configurar un mecanismo de paginación en el que el usuario pueda hacer clic en los vínculos "Inicio", "Anterior", "Siguiente" y "Fin". Si necesita recuperar el siguiente lote de información, puede utilizar el método getDocumentsByIDs().

Resultado

Un nodo <UDSObjectList> con las siguientes secciones:

Nodo <UDSObject> de la sección Descripción del nodo <UDSObject> de este capítulo. Habrá un nodo <UDSObject> con todas las propiedades correspondientes a los primeros n documentos que el método encuentre, donde n equivale al parámetro resultSize. Por ejemplo, si el parámetro resultSize es 10, el parámetro maxDocIDs es 50 y el método encuentra 100 documentos, habrá 10 nodos <UDSObject> con todas las propiedades solicitadas en la sección <Attributes> y 40 nodos <UDSObject> con sólo la propiedad ID en la sección <Attributes>. Si desea recuperar información detallada de <UDSObject> para los documentos numerados del 11 al 20, debe realizar una llamada al método getDocumentsByIDs() e introducir los ID.

Si el parámetro getRelatedCategories es verdadero, el nodo <UDSObjectList> se incluye en la sección <Attributes> para las categorías relacionadas. Cada nodo <INDEX_DOC_LINKS> contiene el ID relacional de la categoría, como se muestra en el siguiente ejemplo:

1-70