Tema anterior: Objeto wsptblTema siguiente: Referencias cruzadas entre tablas y objetos


Archivo de configuración XML de la superficie del rastreador

El archivo crawler_surface_config.xml tiene las secciones siguientes.

<objects>

Especifica la información acerca de los objetos y atributos que muestra la superficie del rastreador para un objeto. La sección de objetos describe el diseño de una página de detalles para cada tipo de objeto que se muestra a un rastreador. Esta sección no controla la selección de registros individuales. La sección <objects> es una recolección de secciones usuario de información de inicio de sesión.

Cada objeto se define en una sección usuario de información de inicio de sesión. Se proporcionan las especificaciones predeterminadas para estos objetos del siguiente modo:

KD

Indica Documentos del conocimiento.

chg

Indica Órdenes de cambio.

iss

Indica Incidencias.

en

Indica Incidentes.

pr

Indica Problemas.

cr

Indica Solicitudes.

Nota: Para obtener más información sobre las definiciones de objetos, consulte la Guía de referencia técnica.

El archivo XML contiene las secciones siguientes que crean la sección <head> de una página de detalles en CA SDM:

<name>

Indica el nombre de objeto Majic del objeto expuesto.

<note>

Indica un lugar para una descripción breve del objeto. Este elemento únicamente tiene fines de documentación y la superficie del rastreador lo ignora.

<last_mod_dt>

Indica el nombre del atributo que almacena la hora y la fecha de la última modificación. Esta marca de tiempo se muestra en el rastreador del motor de búsqueda para permitir que este determine si se ha actualizado el registro. Muchos rastreadores utilizan esta marca de hora durante un rastreo incremental. Una marca de tiempo actualizada indica que el registro ha cambiado tras el último rastreo. El rastreador del motor de búsqueda omite el rastreo cuando el registro no se actualiza desde el último rastreo.

<title>

Indica el atributo que se utiliza para el título de la página de detalles. Los motores de búsqueda utilizan este elemento como el título del documento que se devuelve en los resultados de la búsqueda. Esta entrada de elemento genera una etiqueta <title> HTML en la sección <head> de la página de detalles. En el caso de Documento de conocimiento, el título predeterminado es el del documento de conocimiento. El resumen se utiliza para el título de Incidentes, Problemas, Solicitudes, Órdenes de cambio e Incidencias.

<meta_data>

Indica una o varias propiedades que se muestran como metadatos. Los metadatos permiten a un motor de búsqueda almacenar características adicionales del documento en su índice. Los metadatos no se buscan directamente, pero suelen filtrar resultados de la búsqueda. Esta sección genera etiquetas <meta> HTML en la sección <head> de la página de detalles.

Cada entrada de la sección <meta_data> contiene una o varias entradas <property>. Cada elemento <property> está formado por un elemento <name> y otro <content>.

<name>

Indica el nombre de la propiedad de metadatos.

<content>

Indica el atributo del objeto que se utilizará como el valor para los metadatos.

Juntos, cada par de elementos <name> y <content> de <property> generan una etiqueta <meta> HTML. Los rastreadores del motor de búsqueda utilizan las dos propiedades de metadatos siguientes de forma predeterminada:

Description

Indica la propiedad de metadatos de un motor de búsqueda que almacena un breve resumen del documento.

Autor

Indica el autor del documento.

La propiedad de metadatos CASDMTENANT también se configura de forma predeterminada para cada objeto. Esta propiedad es una propiedad de metadatos específica de CA SDM. Cuando se configura CA SDM para la opción multicliente, la superficie del rastreador utiliza esta propiedad para mostrar el nombre del cliente del objeto al rastreador del motor de búsqueda. Posteriormente, durante una búsqueda federada, los resultados devueltos del motor de búsqueda se filtran según esta propiedad de metadatos. Únicamente se devuelven al usuario los resultados que no tienen la propiedad de metadatos CASDMTENANT o los resultados cuya propiedad de metadatos CASDMTENANT coincide con el campo Cliente del registro Contacto del usuario. Si se configura CA SDM para la opción multicliente, la superficie del rastreador muestra la propiedad de metadatos CASDMTENANT.

El archivo XML contiene las siguientes secciones que crean la sección <body> de una página de detalles en CA SDM:

<additional_attributes_to_index>

Indica una lista de atributos del objeto que muestra la superficie del rastreador. Las diversas entradas se separan mediante una coma y un espacio. Por ejemplo, PROBLEM, RESOLUTION, SD_ASSET_ID.name.

<activity_logs>

Indica información que muestra la superficie del rastreador de registros de actividades para objetos que tienen estos registros. La sección <activity_logs> contiene los elementos usuario de información de inicio de sesión, <select_criteria>, <rel_attr> y <attributes>.

usuario de información de inicio de sesión

Especifica el nombre del objeto que contiene las entradas del registro de actividades para el objeto. Por ejemplo, el objeto de Registro de actividades para lo siguiente:

  • Los incidentes, problemas y solicitudes son alg.
  • Las órdenes de cambio son chgalg.
  • Las incidencias son issalg.
  • Los documentos del conocimiento son O_COMMENTS.
<select_criteria>

Permite filtrar los objetos que se muestran del registro de actividades. Este elemento es importante para aumentar la relevancia de los resultados de la búsqueda disminuyendo las palabras que se producen con frecuencia. Por ejemplo, <select_criteria> para chgalg contiene la siguiente cláusula Where de Majic:

"type IN ('ST', 'UPD_RISK', 'CB', 'RS', 'LOG', 'TR', 'ESC' ,'NF', 'UPD_SCHED')"

Estos criterios solamente incluyen entradas de Registro de actividades que permiten al usuario introducir comentarios y eliminar entradas de dicho registro con texto fijo como Inicial o Adjuntar documento.

<rel_attr>

Especifica cómo se relaciona una entrada del registro de actividades con su objeto padre. La subsección <rel_attr> contiene los elementos <parent_obj_attr> y <join_attr>.

<parent_obj_attr>

Indica un atributo de un registro de actividades que contiene SREL (o un puntero de clave externa) para el objeto padre. Por ejemplo, change_id es el atributo de chgalg.

<join_attr>

Indica el atributo relacional (Rel Attr) del objeto padre que se almacena en <parent_obj_attr>. Por ejemplo, <join_attr> para chgalg es id. Se pueden verificar estos valores mediante este comando:

bop_sinfo -df chgalg

Se pueden verificar estos valores con el comando bop_sinfo -df chgalg. El resultado debe mostrar que el valor de change_id es SREL -> chg.id, e ISS, SREL -> iss.persistent_id.

<attachments>

Esta subsección permite mostrar archivos adjuntos al rastreador del motor de búsqueda para que su contenido se pueda indexar junto con el objeto padre. La sección <attachments> únicamente se permite para objetos que tienen archivos adjuntos.

Los archivos adjuntos se gestionan de forma especial mediante la superficie del rastreador. En lugar de enviar el contenido de cada archivo adjunto al rastreador de la superficie del rastreador, esta última muestra un hipervínculo que el rastreador puede seguir para descargar el archivo adjunto de CA SDM. Posteriormente, durante una búsqueda federada, si se incluye un archivo adjunto en los resultados de la búsqueda, al hacer clic en el hipervínculo, el usuario accederá al objeto padre en lugar de directamente al archivo adjunto.

La sección <attachments> contiene los elementos usuario de información de inicio de sesión, <rel_attr>, <attmnt_id> y <is_parent_updated>.

usuario de información de inicio de sesión

Este elemento especifica el objeto Majic que vincula el archivo adjunto con su objeto padre.

<rel_attr>

Esta subsección funciona igual que Registros de actividades. Especifica cómo se relaciona el objeto padre con este objeto que vincula el objeto padre al archivo adjunto.

<attmnt_id>

Este elemento especifica el atributo de este objeto de vínculo que indica el archivo adjunto.

<is_parent_updated>

Este es un indicador especial que indica a la superficie del rastreador cómo mostrar la fecha de última modificación para el objeto. Para algunos objetos como Documentos del conocimiento, cuando se carga un archivo adjunto, la fecha de última modificación de este no se actualiza. La fecha de última modificación resulta importante cuando el motor de búsqueda realiza un rastreo incremental. Normalmente, si el rastreador ve que un objeto no se haya actualizado desde que se encontró por última vez, lo omite y no actualiza su índice mediante la reindexación del objeto. Cuando se especifica No para <is_parent_updated>, la superficie del rastreador comprueba la fecha de última modificación de todos los archivos adjuntos. Si detecta cualquier fecha posterior al objeto padre, utilizará esta fecha posterior al mostrar dicho objeto. Normalmente, esto provoca que el motor de búsqueda reindexe el objeto e incluya los archivos adjuntos nuevos durante la indexación.

<configuration_items>

Esta sección se utiliza para objetos que contienen una lista de elementos de configuración. Esta sección incluye los elementos usuario de información de inicio de sesión, <rel_attr> y <attributes>.

usuario de información de inicio de sesión

Funciona del mismo modo que Registros de actividades y Archivos adjuntos.

<rel_attr>

Funciona del mismo modo que Registros de actividades y Archivos adjuntos.

<attributes>

Este elemento funciona del mismo modo que Archivos adjuntos.

<multi-farm_datasets>

Después de la sección <objects> se encuentra <multi-farm_datasets>. Mientras que la sección <objects> define los objetos de CA SDM y los atributos que se pueden mostrar mediante la superficie del rastreador, <multi-farm_datasets> especifica qué objetos se muestran y cómo se seleccionan sus registros. La sección <multi-farm_datasets> es una recolección de secciones de <farm>.

<farm>

Cada sección <farm> controla la información de CA SDM que se muestra a un rastreador. Cuando se configura un rastreador, la sección <farm> se especifica en la dirección URL. Únicamente se muestra al rastreador la información especificada en la sección <farm>. Cada sección <farm> contiene los elementos <name>, <data_sets> y <sdm_user>. <name>

Este elemento especifica el nombre de la sección <farm>. Este nombre se especifica en la dirección URL que se utiliza para configurar el rastreador. Este campo distingue entre mayúsculas y minúsculas.

<data_sets>

Esta subsección especifica los objetos que se mostrarán y cómo se seleccionan sus registros. Esta subsección incluye uno o varios elementos usuario de información de inicio de sesión. Cada elemento de objeto contiene un elemento <name> y otro <select_criteria>.

<name>

Este elemento hace referencia a usuario de información de inicio de sesión que se ha definido en la sección <objects>.

<select_criteria>

Este elemento especifica una cláusula Where de Majic que se utiliza para seleccionar los registros del objeto.

<sdm_user>

Este elemento especifica el ID del usuario de CA SDM que se deberá utilizar al acceder a esta granja. Este ID de uso debe tener al rastreador como el tipo de acceso y el rol.