Configuración de las búsquedas

ccppmop1561
HID_admin_lookups
Una búsqueda es una lista de valores que se desea que otros usuarios puedan ver mediante listas desplegables o de selección múltiple. Se pueden crear y configurar búsquedas en campos personalizados, informes, consultas y en filtros de portlet de gráficos o listas.
Por ejemplo, un campo personalizado denominado Estado del documento puede contener una lista desplegable con valores de búsqueda como
Borrador
,
Revisar
o
Aprobado
. La funcionalidad Sugerencias automáticas muestra una lista de posibles valores coincidentes cuando el usuario introduce los primeros caracteres de la palabra en una lista estática, consulta dinámica u origen de datos de una búsqueda parametrizada.
2
Particiones y búsquedas
Las particiones ayudan a crear vistas diferentes de una página para los distintos usuarios. Normalmente, las estructuras subyacentes del elemento son atributos de objeto y valores de búsqueda.
  • No se pueden hacer particiones en valores de búsqueda dinámica de consultas ni en listas dependientes estáticas.
  • Se pueden crear búsquedas de listas estáticas que contengan valores con particiones.
Para obtener más información, consulte
CA PPM Studio Development
en la sección
Reference
.
Tipos de búsqueda
Se pueden crear y utilizar los siguientes tipos de búsquedas:
  • Listas estáticas
    Utilice este tipo de búsqueda cuando se desea que un conjunto estándar de opciones aparezca como una lista desplegable de valores para un campo.
  • Listas dependientes estáticas
    Utilice este tipo de búsqueda para crear una jerarquía de búsquedas y valores. Los elementos que aparecen en la segunda lista y en las listas subsiguientes dependen de un valor previamente seleccionado en un campo inicial.
    Ejemplo:
    El usuario selecciona EE. UU. en una lista de países. Aparece una lista de estados en la cual el usuario puede seleccionar el estado apropiado. Otro usuario selecciona Canadá en la lista de países. Aparece una lista de provincias en la segunda lista de búsqueda.
  • Consultas dinámicas.
    Utilice este tipo de búsqueda para recuperar datos de la base de datos en tiempo real para rellenar la lista desplegable. Estas búsquedas proporcionan los valores más actuales posibles. Las búsquedas dinámicas limitan el resultado de la lista de consultas. Los valores se basan en los valores que se introducen en los otros atributos de la vista. Cree consultas NSQL dinámicas para proporcionar búsquedas parametrizadas.
Se puede anidar una búsqueda estática dentro de una búsqueda de consulta dinámica. No se puede anidar una búsqueda de lista dependiente estática dentro de una búsqueda de consulta dinámica. La funcionalidad de sugerencias automáticas no funciona con las listas dependientes estáticas.
La siguiente tabla describe cómo se puede editar o suprimir cada tipo de búsqueda, dependiendo de quién lo haya creado y de cómo se utilice:
Tipo de búsqueda
Modificar
Delete
Búsquedas restringidas por el sistema
Es posible cambiar solamente las etiquetas y el diseño. Todas las búsquedas de consulta dinámicas estándares están restringidas por el sistema. También pueden haber otros tipos de búsquedas restringidos por el sistema.
No
Búsquedas del sistema
Puede agregar y desactivar los valores. No puede desactivar los valores predeterminados que se proporcionan con la aplicación.
No
Búsquedas definidas por el usuario
Puede agregar y desactivar los valores. Utilice sus propias búsquedas para ampliar el conjunto de búsquedas proporcionadas con la aplicación.
Creación de búsquedas de lista estáticas
Siga estos pasos:
  1. Haga clic en
    Administración
    ,
    Administración de datos
    ,
    Búsquedas
    .
  2. Haga clic en
    Nuevo
    .
  3. Rellene los campos siguientes:
    • Nombre de búsqueda
      Define un nombre único para la búsqueda.
    • ID de búsqueda
      Define un ID único para la búsqueda. El valor está normalmente especificado en letras mayúsculas. El ID proporciona alguna información acerca de la función de la búsqueda.
      Ejemplo:
      LOOKUP_ACTION_STATUS.
    • Origen del contenido
      Especifica el origen de datos para la búsqueda.
      Valores:
      • Cliente: indica que es usted quien proporciona el origen de los datos.
      • Informes de stock de gestión financiera
      • Acelerador CPIC: indica que se está usando el complemento Acelerador CPIC como origen de datos.
      • Acelerador de PMO: indica que se está usando el complemento Acelerador de PMO como origen de datos.
      • Informes de stock de PPM.
      Póngase en contacto con un representante de
      Clarity PPM
      para obtener más detalles sobre la adquisición de complementos.
      Valor predeterminado:
      Cliente
  4. Complete los campos siguientes desde el campo Origen:
    • Lista estática
      Seleccione el tipo de búsqueda Lista estática cuando trabaje con un conjunto estándar de opciones. Especifique también un orden de clasificación, por ejemplo:
      • Alfanumérico. Muestra los elementos en orden alfanumérico. Las búsquedas de listas alfanuméricas no se pueden reordenar. Antes de comenzar a crear los valores, decida el orden que va a usar.
      • Manual: Permite determinar y cambiar el orden de clasificación.
      Valor predeterminado:
      Alfanumérico
    • Listas dependientes estáticas
      Seleccione el tipo de búsqueda Listas dependientes estáticas para crear una jerarquía de búsquedas y valores. Los elementos que aparecen en la segunda lista y en las posteriores dependen de la configuración. Especifique uno de los siguientes órdenes de clasificación:
      • Alfanumérico
        : Muestra los elementos en orden alfanumérico. Las búsquedas de listas alfanuméricas no se pueden reordenar. Antes de comenzar a crear los valores, decida el orden que va a usar.
      • Manual
        : Permite determinar y cambiar el orden de clasificación.
      Valor predeterminado:
      Alfanumérico
    • Consulta dinámica
      Seleccione el tipo de búsqueda Consulta dinámica para recuperar datos de la base de datos en tiempo real y que se muestren en la lista desplegable.
    • Descripción
      Especifica una descripción breve de la búsqueda en el campo Descripción.
  5. Guarde los cambios realizados.
    Aparece la ventana principal para la nueva búsqueda de lista. Use la página para definir la asociación de ventana principal. Por ejemplo, seleccione lookup_code para cadenas y seleccione lookup_enum para números.
Creación de valores de búsqueda de lista estática
Se pueden crear y editar los valores que aparecen en las búsquedas. Se puede crear cualquier número de valores para una búsqueda. Por ejemplo, cree una búsqueda llamada
Estado de la entrega
con los valores
Alto
,
Medio
y
Bajo
.
Siga estos pasos:
  1. Abra una búsqueda de lista estática y haga clic en
    Valores
    .
  2. Haga clic en
    Nuevo
    .
  3. Rellene los campos siguientes:
    • Nombre del valor de búsqueda
      Define el nombre del valor de búsqueda.
    • ID (LOOKUP_CODE)
      Define el ID del valor de búsqueda. El ID puede ser un número o cadena según la configuración de la Clave oculta en la página Ventana principal.
    • Partición
      Define la partición del valor de búsqueda. Si no se activa la creación de particiones, el valor predeterminado es Sistema.
    • Modo de asociación de la partición
      Define el nivel para que los usuarios vean la partición.
      Valores:
      • Partición, ancestros y descendientes. Asocia la búsqueda a la partición seleccionada en el paso anterior, así como a la partición principal y las secundarias.
      • Partición y antecesores. Asocia la búsqueda a la partición seleccionada en el paso anterior y a las particiones principales.
      • Partición y descendientes. Asocia la búsqueda a la partición seleccionada en el paso anterior y a las particiones secundarias.
      • Solo partición. Asocia la búsqueda solamente a la partición y no a sus descendientes ni a los antecesores.
      Valor predeterminado:
      Partición, predecesores y descendientes
      Para obtener más información, consulte el
      Desarrollo de CA PPM Studio
      .
    • Descripción
      Especifica información adicional sobre la finalidad del valor de búsqueda. Para evitar resultados inesperados del usuario, especifique una descripción para cada valor de la búsqueda.
    • Activo
      Especifica si el valor está visible en la página cuando ésta se muestra a los usuarios. Desactive la casilla de verificación para ocultar el valor.
      Valor predeterminado:
      Seleccionado
  4. Guarde los cambios.
Reordenación manual de los valores de búsqueda de lista estática
Utilice un orden de clasificación manual cuando cree por primera vez una búsqueda de lista estática. Podrá reordenar la forma en que se muestran los valores en la lista desplegable.
Siga estos pasos:
  1. Una vez abierta la búsqueda de lista estática, haga clic en Reordenar valores.
  2. Haga clic en el nombre del valor y use las flechas para desplazar el valor hacia arriba y abajo en la lista.
  3. Guarde los cambios realizados.
Búsquedas en listas dependientes estáticas
Una búsqueda de lista dependiente estática (SDL) consiste de una jerarquía de niveles y valores. Para crear la búsqueda, cree los niveles de la jerarquía y, a continuación, los valores que pueden estar disponibles para seleccionarlos en cada nivel. Normalmente, cada nivel ofrece varios valores. Por ejemplo, el campo Nación de nivel superior ofrece varios valores además de EE. UU. como, por ejemplo, Argentina, Gran Bretaña, Canadá, México o Singapur.
Planifique cuidadosamente la jerarquía. No se pueden mover los niveles ni los valores hacia arriba o hacia abajo en la estructura. Se pueden cambiar las propiedades para los niveles y los valores creados. Si es necesario, se pueden suprimir y, a continuación, volver a crear los valores.
Creación o edición de búsquedas de listas dependientes estáticas
Use la página Crear búsqueda para crear búsquedas de listas dependientes estáticas. La primera búsqueda que se crea aparecerá en la página de niveles de la búsqueda. La primera búsqueda sirve como la búsqueda de nivel superior en la jerarquía.
Siga estos pasos:
  1. Haga clic en
    Administración
    ,
    Administración de datos
    ,
    Búsquedas
    .
  2. Haga clic en
    Nuevo
    para crear una búsqueda nueva o haga clic en el nombre de una búsqueda para editarla.
  3. Para
    Origen
    , seleccione
    Listas dependientes estáticas
    y rellene los siguientes campos:
    • Nombre de búsqueda
      Define un nombre único para la búsqueda.
    • ID de búsqueda
      Define un ID único para la búsqueda. El valor está normalmente especificado en letras mayúsculas. El ID proporciona alguna información acerca de la función de la búsqueda.
      Ejemplo:
      LOOKUP_ACTION_STATUS.
    • Origen del contenido
      Especifica el origen de datos para la búsqueda.
      Valores:
      • Cliente: indica que es usted quien proporciona el origen de los datos.
      • Informes de stock de gestión financiera
      • Acelerador CPIC: indica que se está usando el complemento Acelerador CPIC como origen de datos.
      • Acelerador de PMO: indica que se está usando el complemento Acelerador de PMO como origen de datos.
      • Informes de stock de PPM.
      Póngase en contacto con un representante de
      Clarity PPM
      para obtener más detalles sobre la adquisición de complementos.
      Valor predeterminado:
      Cliente
    • Descripción
      Especifica una descripción breve de la búsqueda.
  4. Guarde los cambios realizados.
Creación de niveles de dependencia para búsquedas de listas dependientes estáticas
Una búsqueda de lista dependiente estática consiste de una jerarquía de niveles y valores. Para crear este tipo de búsqueda, cree los niveles de la jerarquía. A continuación, cree los valores que deban estar disponibles para seleccionarlos en cada nivel. Normalmente, cada nivel ofrece varios valores. Por ejemplo, el campo Nación de nivel superior ofrece varios valores además de EE. UU. como, por ejemplo, Argentina, Gran Bretaña, Canadá, México o Singapur.
Siga estos pasos:
  1. Abra la búsqueda de lista dependiente estática.
  2. Haga clic en
    Niveles
    .
  3. Haga clic en
    Nuevo
    .
  4. Rellene los campos siguientes:
    • Nombre de búsqueda
      Define el nombre del nivel de búsqueda.
    • ID de búsqueda
      Define un ID único para el nivel de búsqueda.
    • Descripción
      Define una breve descripción del nivel de búsqueda.
  5. Guarde los cambios realizados.
Creación de valores para búsqueda para listas dependientes estáticas
Utilice este procedimiento para crear los valores que desee que seleccionen los recursos en cada nivel. Haga este procedimiento después de haber creado los niveles de dependencia para la búsqueda de lista dependiente estática. Si los valores de primer nivel tienen un signo más (+) delante, significa que hay más niveles. Haga clic en el signo más (+) situado delante de un elemento para expandir la jerarquía.
Siga estos pasos:
  1. Abra una búsqueda de lista dependiente estática y haga clic en
    Valores
    .
  2. Haga clic en
    Nuevo
    .
  3. Rellene los siguientes campos:
    • Nombre del valor de búsqueda
      Define el nombre del valor de búsqueda.
    • ID del valor de búsqueda
      Define un ID único para el valor de búsqueda.
    • Descripción
      Define una breve descripción del valor de búsqueda.
    • Activo
      Especifica si el valor está visible en la página cuando ésta se muestra a los usuarios. Desactive la casilla de verificación para ocultar el valor.
      Valor predeterminado:
      Seleccionado
  4. Guarde los cambios realizados.
Búsquedas de consultas dinámicas
Una búsqueda de consulta dinámica contiene una lista de elementos que se muestran en una lista desplegable. Use la versión de
Clarity PPM
de SQL, llamada NSQL, para crear consultas para búsquedas dinámicas. En una búsqueda de consulta dinámica, la lista desplegable, el diseño y el comportamiento dependen del contenido de la consulta de NSQL creada.
Nota
: No se puede modificar la consulta de NSQL para una búsqueda de consulta dinámica si la búsqueda se asocia con un atributo de objeto.
Vídeo: Cómo crear una búsqueda dinámica
El siguiente vídeo de productos de terceros lo proporciona Rego Consulting. Este vídeo lo proporciona CA Technologies "tal cual" y sin ninguna garantía.

Para reproducir este vídeo en pantalla completa, haga clic en el logotipo de YouTube situado a la derecha del icono de configuración, en la parte inferior de la ventana.
Creación o edición de búsquedas de consultas dinámicas
Siga estos pasos:
  1. Haga clic en
    Administración
    ,
    Administración de datos
    ,
    Búsquedas
    .
  2. Haga clic en
    Nuevo
    para crear una búsqueda o haga clic en el nombre de una búsqueda para editarla.
  3. Rellene los campos siguientes:
    • Nombre de búsqueda
      Define un nombre único para la búsqueda.
    • ID de búsqueda
      Define un ID único para la búsqueda. El valor está normalmente especificado en letras mayúsculas. El ID proporciona alguna información acerca de la función de la búsqueda.
      Ejemplo:
      LOOKUP_ACTION_STATUS.
    • Origen del contenido
      Especifica el origen de datos para la búsqueda.
      Valores:
      • Cliente: indica que es usted quien proporciona el origen de los datos.
      • Informes de stock de gestión financiera
      • Acelerador CPIC: indica que se está usando el complemento Acelerador CPIC como origen de datos.
      • Acelerador de PMO: indica que se está usando el complemento Acelerador de PMO como origen de datos.
      • Informes de stock de PPM
      Póngase en contacto con un representante de
      Clarity PPM
      para obtener más detalles sobre la adquisición de complementos.
      Valor predeterminado:
      Cliente
  4. En
    Origen
    , seleccione
    Consulta dinámica
    y complete los campos siguientes:
    • Objeto
      Si desea que el valor de la clave oculta devuelva el valor de la clave primaria de un objeto, seleccione el objeto.
    • Descripción
      Introduzca una breve descripción de la búsqueda.
  5. Guarde los cambios realizados.
Creación de búsquedas dinámicas y configuración de la exportación
Si el objetivo de una búsqueda dinámica es vincular un objeto a una instancia única de otro objeto o registro, se recomienda lo siguiente:
  • Utilice el ID interno que genera el entorno de
    Clarity PPM
    como clave oculta.
  • Agregue el código único o el ID definido por el usuario como la columna UNIQUE_CODE en la cláusula select de la consulta
Incluya la columna de la consulta NSQL UNIQUE_CODE en una consulta para impedir que XOG exporte el atributo de búsqueda mediante el valor de clave oculta literal. En lugar del valor de clave oculto, XOG utiliza el valor de UNIQUE_CODE. Con este valor se evita la exportación de valores de ID de clave principal en el archivo XML que son difíciles de importar en otro entorno de
Clarity PPM
.
Por ejemplo, la siguiente consulta de búsqueda selecciona SRM_RESOURCES.ID como su clave oculta.
SELECT @SELECT:r.id:[email protected] ,@SELECT:r.full_name:[email protected] ,@SELECT:r.unique_name:[email protected] ,@SELECT:r.last_name:[email protected] ,@SELECT:r.first_name:[email protected] FROM srm_resources r WHERE 1=1 AND @[email protected]
Cuando se utiliza la búsqueda anterior, la clave oculta está seleccionada y se almacena como el valor de búsqueda. Cuando esta consulta de búsqueda se exporta mediante XOG, el atributo que se asocia con la búsqueda contiene el id interno del recurso. Cuando se importan estos datos a un entorno diferente de
Clarity PPM
, el esfuerzo puede producir un error. El registro exportado puede incluso llegar a ser asociado con el registro de destino incorrecto debido a que el id interno del sistema de destino es diferente del sistema de origen.
Al incluir la columna UNIQUE_CODE en la cláusula select, la exportación XOG sustituye el id definido por el usuario único (SRM_RESOURCES.unique_name) en el atributo en la salida XOG.
SELECT @SELECT:r.id:[email protected] ,@SELECT:r.full_name:[email protected] ,@SELECT:r.unique_name:[email protected] ,@SELECT:r.unique_name:[email protected] ,@SELECT:r.last_name:[email protected] ,@SELECT:r.first_name:[email protected] FROM srm_resources r WHERE 1=1 AND @[email protected]
Cuando se importan los datos, la arquitectura de
Clarity PPM
utiliza el valor UNIQUE_CODE para consultar el sistema y almacenar SRM_RESOURCES.ID para el valor de búsqueda.
Cómo incluir los atributos de búsqueda de la consulta dinámica en el almacén de datos
Para incluir un atributo que utiliza una búsqueda de consulta dinámica en el almacén de datos, complete los siguientes pasos:
  1. Cree la definición de la búsqueda de consulta dinámica con las reglas específicas de codificación que se describen más adelante.
  2. Cree un atributo del tipo de datos de "búsqueda" y actívelo en el almacén de datos. Consulte
    Configuración del almacén de datos
    para obtener más información.
  3. Ejecute el trabajo de carga del almacén de datos con la opción Full Load (Carga completa) seleccionada.
Reglas para la creación de búsquedas de consultas dinámicas para el almacén de datos
Utilice las reglas siguientes para definir la búsqueda de consulta dinámica con precisión y evitar los mensajes de error cuando se activa el atributo para el almacén de datos:
  • Siempre se incluye una columna de selección llamada LAST_UPDATED_DATE
  • Establezca el nombre de campo de columna o el alias en LAST_UPDATED_DATE
  • Compruebe que LAST_UPDATED_DATE es un campo de fecha que se rellena con una fecha válida desde cualquier tabla incluida en la consulta dinámica
Ejemplo
: Utilice la siguiente declaración select para consultar la tabla PRTIMEPERIOD si el campo LAST_UPDATED_DATE tiene un nombre de columna de tabla PRMODTIME:
@SELECT:tp.PRMODTIME:[email protected]
Reglas para incluir traducciones en el almacén de datos
No todas las tablas de la consulta tienen traducciones asociadas con sus datos. Por lo tanto, la adición de traducciones es opcional para utilizar una búsqueda de consulta con el almacén de datos. Utilice las siguientes reglas para incluir traducciones para las búsquedas de consultas en el almacén de datos:
  • Siempre se incluye una columna de selección llamada LANGUAGE_CODE
  • Siempre se incluye una columna de selección llamada LANGUAGE_ID
  • Siempre se incluye la siguiente declaración en la cláusula WHERE del almacén de datos para reconocer las traducciones disponibles en la búsqueda de consulta:
@WHERE:PARAM:[email protected]
Ejemplo
: La búsqueda de consulta dinámica siguiente aplica las reglas correctas para definir la fecha de última actualización y las traducciones:
SELECT @SELECT:a.name:[email protected], @SELECT:c.currency_code:[email protected], @SELECT:c.currency_code || ' (' || c.currency_symbol || ')':[email protected], @SELECT:c.LAST_UPDATED_DATE:[email protected], @SELECT:LANG.LANGUAGE_CODE:[email protected], @SELECT:LANG.ID:[email protected] FROM cmn_countries b, cmn_captions_nls a, cmn_currencies c, CMN_LANGUAGES LANG WHERE a.table_name = 'CMN_COUNTRIES' AND @[email protected] AND a.pk_id = b.id AND a.language_code = @WHERE:PARAM:[email protected] AND b.currency_id = c.id AND LANG.LANGUAGE_CODE=a.LANGUAGE_CODE
Definición de consultas
Utilice la ficha Consulta de una búsqueda para definir consultas de búsqueda.
Clarity PPM
solamente es compatible con una versión especial de las declaraciones SQL llamada NSQL.
Se recomienda incluir siempre la frase "@[email protected]" en la cláusula WHERE de la consulta, tal como se muestra en el ejemplo siguiente.
Ejemplo de declaración NSQL
SELECT @SELECT:c.currency_code:[email protected], @SELECT:c.currency_code:[email protected] FROM cmn_currencies c WHERE c.is_active = 1 AND @[email protected]
Para obtener más información, consulte el
Desarrollo de CA PPM Studio
.
Creación de declaraciones de consulta
Utilice el procedimiento siguiente para componer una consulta que extraiga valores de la búsqueda.
Siga estos pasos:
  1. Si no se muestra la página Consulta para una búsqueda, seleccione la búsqueda de consulta dinámica deseada y haga clic en Consulta.
  2. En el campo Consulta Niku, introduzca declaraciones NSQL.
  3. Guarde los cambios realizados.
Construcción BROWSE-ONLY para las búsquedas de consulta dinámicas
Para las búsquedas de consultas dinámicas, la exploración funciona de un modo específico. Cuando se muestra un registro de
Clarity PPM
, el valor no aparece en el campo de búsqueda. En este caso, no existe ninguna coincidencia entre el valor que se almacena en el registro y el valor de lista en la búsqueda. Los valores previos se mantienen en la tabla de la base de datos para el registro de la instancia. Si se recupera un registro con el valor previo y no se muestra en el producto, haga clic en Guardar para eliminar el valor anterior del registro.
Para conservar los valores no activados en el registro y verlos en la aplicación, cambie la definición de la consulta de búsqueda. Para este caso, incluya la construcción NSQL específica @BROWSE-ONLY con la definición. Cuando un usuario utiliza la búsqueda en los nuevos registros, se mostrarán los valores activos. Además, cuando aparezca un registro existente con valores inactivos, el valor inactivo permanecerá en el registro.
Esta construcción tiene la siguiente sintaxis:
@BROWSE-ONLY: /* include SQL statement here to look at active results only */ :[email protected]
En el ejemplo siguiente se muestra la construcción BROWSE-ONLY con un valor incluido que define los siguientes resultados:
SELECT... FROM... WHERE @[email protected] @BROWSE-ONLY: AND IS_ACTIVE = 1 :[email protected]
Definición de las características de la ventana de exploración para búsquedas de consultas dinámicas
Los campos de la página de la ventana de exploración de una búsqueda muestran, en función de la consulta, las selecciones en la página de la ventana principal. La mayor parte de estos campos se pueden cambiar mediante una búsqueda de consulta dinámica creada por el usuario.
No se debe incluir una cláusula ORDER BY en una consulta dinámica utilizada en una búsqueda. La ficha Explorar ventana para la consulta dinámica ya incluye un campo Columna de orden predeterminado. La consulta añade automáticamente el campo de ordenación seleccionado como una cláusula ORDER BY.
Siga estos pasos:
  1. Abra una búsqueda de consulta dinámica y haga clic en
    Explorar ventana
    .
  2. En la sección
    Diseño del filtro
    , seleccione los campos que se deben mostrar en la lista
    Campos de filtro disponibles
    .
  3. Haga clic en la flecha hacia la derecha para desplazarlos a la lista
    Campos de filtro seleccionados
    .
  4. En la lista
    Campos de filtro seleccionados
    , seleccione los campos y use las flechas hacia arriba y hacia abajo para establecer el orden de los campos.
  5. En la sección de Diseño de la lista, use las teclas de flecha para seleccionar y arreglar las columnas de la lista para mostrarlas en la búsqueda. Desplace las columnas desde la lista de Columnas disponibles hasta la lista de Columnas seleccionadas.
  6. Haga clic en Aplicar para actualizar y preparar los dos campos siguientes.
  7. Si utiliza más de una columna, seleccione una columna de clasificación predeterminada en el campo Columna de orden predeterminado.
  8. Seleccione Ascendente (valor predeterminado) o Descendente en el campo Orden predeterminado.
  9. Haga clic en
    Vista preliminar
    para mostrar una vista previa de la ventana de exploración.
  10. Realice uno de los siguientes subpasos:
    • Si la búsqueda no contiene valores desplegables, haga clic en
      Guardar y cierre
      el procedimiento.
    • Si la búsqueda contiene valores desplegables, haga clic en
      Guardar
      . Haga clic en
      Filtros de búsqueda
      en el menú superior y asocie el filtro a la búsqueda apropiada.
Definición de filtros de búsqueda para búsquedas de consultas dinámicas
Si ha especificado una lista desplegable para el campo Tipo de elemento de campo, utilice el procedimiento siguiente para asociarlo a una búsqueda.
Siga estos pasos:
  1. Con la consulta dinámica abierta, haga clic en
    Filtros de búsqueda
    .
  2. Para cada campo, haga clic el icono Explorar de la columna Búsqueda para seleccionar y asociar la búsqueda con ese filtro.
  3. Haga clic en
    Salir
    .
Definición de opciones de filtro para explorar búsquedas
Se pueden establecer opciones de filtro para una búsqueda de consulta dinámica. Se pueden mostrar todos los resultados automáticamente bien cuando seleccione la búsqueda, bien cuando active la opción para permitir el filtrado antes de mostrar los resultados. Si activa la opción para filtrar antes de mostrar los resultados, haga clic en Filtro para que la búsqueda muestre algunos registros. La tarea ayuda a reducir el número de registros que se muestran y mejora el rendimiento.
Siga estos pasos:
  1. Con la búsqueda abierta, seleccione
    Explorar ventana
    .
  2. En la sección de Opciones de filtro, seleccione uno de los siguientes:
    • Mostrar resultados automáticamente
      Muestra todos los resultados para la búsqueda inmediatamente.
    • Mostrar los resultados tras aplicar el filtro
      Solamente se muestran resultados para la búsqueda después de que el usuario especifique las opciones de filtro.
  3. Guarde los cambios realizados.
Creación de búsquedas parametrizadas
Las búsquedas parametrizadas están basadas en búsquedas de consultas dinámicas. Las búsquedas parametrizadas proporcionan la capacidad de controlar los resultados que se muestran en una consulta dinámica con base en otros valores introducidos en una vista. Por ejemplo, suponga que una sección de filtro tiene dos atributos denominados "País" y "Estado". Se pueden filtrar los resultados de la consulta de modo que muestren solamente los Estados, cuando el valor de búsqueda sea País.
Para una búsqueda parametrizada, no se puede utilizar una búsqueda con varios valores como el origen que determina lo que se muestra en la búsqueda de destino secundaria. Utilice una búsqueda de un solo valor para el origen.
Para obtener más información, consulte el
Desarrollo de CA PPM Studio
.
Para crear búsquedas parametrizadas, utilice el proceso siguiente:
  1. Cree una búsqueda de consulta dinámica.
  2. Cree una consulta NSQL con parámetros de búsqueda en la que la cláusula Where haga referencia a los atributos del objeto.
  3. Cree un atributo de búsqueda parametrizada en el objeto y asigne los parámetros de la búsqueda de la consulta NSQL a los atributos del objeto apropiados.
Definición de las características de la ventana principal para las búsquedas
Use la página Ventana principal de una búsqueda de consulta dinámica o de lista estática para definir las características de la ventana principal para las búsquedas de consulta dinámica.
Siga estos pasos:
  1. Con una búsqueda de consulta dinámica abierta, haga clic en
    Ventana principal
    .
  2. Cumplimente la información solicitada:
    • Nombre interno
      Muestra el valor del nombre interno.
    • Clave oculta
      Muestra el valor de clave oculta.
    • Visualizar atributo
      Especifica un valor de atributo de visualización.
  3. Guarde los cambios realizados.
Definición de los valores de configuración de la funcionalidad de sugerencias automáticas para las búsquedas
Las sugerencias automáticas muestran una lista de valores que coinciden con los caracteres que el usuario introduce en los campos de texto de búsqueda. De forma predeterminada, la funcionalidad de sugerencias automáticas está activada para todas las búsquedas de sistema y las búsquedas nuevas que se creen.
Los siguientes orígenes de búsqueda funcionan con las sugerencias automáticas:
  • Lista estática
  • Consulta dinámica
  • Parametrizado
Las sugerencias automáticas no funcionan con los orígenes de búsqueda de listas dependientes estáticas.
Se pueden realizar los siguientes pasos para configurar las sugerencias automáticas:
  • Activar o desactivar las sugerencias automáticas
  • Especificar los valores de búsqueda para una búsqueda
  • Especificar los valores que se muestran en la lista de sugerencia para la búsqueda
  • Indicar el número de elementos que se muestran en la lista de sugerencias
Siga estos pasos:
  1. Con la búsqueda abierta, seleccione
    Sugerencias automáticas
    .
  2. Rellene los siguientes campos y guárdelos:
    • Sugerencias automáticas activadas
      Indica si deben activarse las sugerencias automáticas.
      Valor predeterminado:
      Seleccionado
    • Número de sugerencias mostradas en pantalla
      Define el número de resultados de sugerencias automáticas que se debe mostrar.
      Valor predeterminado:
      20
    • Claves de búsqueda de atributos
      Especifica las claves de búsqueda que están basadas en atributos (como, por ejemplo, Nombre) que se deben utilizar cuando el usuario introduzca texto para buscar un valor de búsqueda.
      Ejemplo:
      Especifique Nombre como clave de búsqueda. Si se introduce Ma, solamente se mostrarán en la lista de sugerencias los valores cuyo apellido comience por Ma.
      Seleccione el atributo en la lista Claves de búsqueda disponibles y agréguelo a la lista Claves de búsqueda seleccionadas. Si agrega varias claves a la lista, las sugerencias automáticas utilizan una expresión OR para filtrar los resultados.
      Ejemplo:
      Si se agregan el Nombre y la Descripción como claves de búsqueda, las sugerencias automáticas mostrarán resultados que coincidan con el nombre O con la descripción. El orden desde arriba hacia abajo en la lista Claves de búsqueda seleccionadas determina la prioridad de sugerencias automáticas para las claves de búsqueda de una búsqueda.
      Valor predeterminado:
      Nombre
      Los únicos valores de lista de sugerencias o de claves de búsqueda disponibles para listas estáticas son Nombre y Descripción. Para las consultas dinámicas, se pueden incluir valores adicionales agregando los valores a la consulta. Una vez que los valores se agregan a la consulta, aparecen en la lista disponible para la clave de búsqueda o la lista de sugerencias.
    • Mostrar lista de sugerencias de atributos
      Especifica las claves que se basan en los atributos que se muestran en la lista de sugerencias.
      Ejemplo:
      Especifique un nombre como la clave de búsqueda de atributos para una búsqueda de recursos. Pero se puede mostrar el nombre y la descripción en la lista de sugerencias.
      Valor predeterminado:
      Nombre
  3. Seleccione el atributo en la lista Atributos disponibles. Agréguelo a la lista Atributos seleccionados. Si se especifican varios valores en el campo, los valores de búsqueda se mostrarán en la lista de sugerencias separados por una barra (|) (por ejemplo, Manuel García | Empleado).
Creación de búsquedas dinámicas directamente en el almacén de datos
Se pueden crear consultas de búsqueda en el almacén de datos, en lugar de en la base de datos de la aplicación.
Clarity PPM
incluye un origen de datos predeterminado para la creación de búsquedas en el almacén de datos.
Origen de datos del almacén de datos.
Se aplican las condiciones siguientes:
  • Como práctica recomendada, utilice estas búsquedas solo para la creación de parámetros del informe. Las búsquedas en el almacén de datos no están disponibles para la creación de atributos mediante portlets u objetos de Studio. Esta opción no es compatible con las consultas de portlet.
  • Esta opción únicamente está disponible para la creación de consultas de búsqueda dinámica para los informes de Jaspersoft. No se admiten las búsquedas estáticas.
  • El vínculo de la base de datos de PPM no se admite para la creación de consultas de búsqueda dinámica utilizando el
    almacén de datos
    como origen.
  • Las búsquedas creadas mediante el origen
    Almacén de datos
    no están disponibles para su selección durante la creación de un atributo del tipo
    búsqueda
    .
La cláusula de seguridad predeterminada () no es compatible con el origen de datos del almacén de datos predeterminado. Para implementar su propia seguridad, cree la consulta con todas las cláusulas
WHERE
necesarias.
Ejemplos de consulta de NSQL de búsqueda:
4
4
Parámetro Código de idioma (PARAM:LANGUAGE):
SELECT DISTINCT @SELECT:lkp.investment_status_key:[email protected], @SELECT:lkp.investment_status:[email protected], @SELECT:lkp.sort_order:[email protected] FROM dwh_lkp_investment_status lkp INNER JOIN dwh_inv_investment i ON i.investment_status_key = lkp.investment_status_key WHERE lkp.is_active = 1 AND i.investment_type_key = 'project' AND lkp.language_code = @WHERE:PARAM:[email protected] AND @[email protected]
Parámetro ID de usuario (PARAM:USER_ID):
SELECT DISTINCT @SELECT:r.resource_key:[email protected],
@SELECT:r.resource_id:[email protected],
@SELECT:r.resource_name:[email protected]
FROM dwh_res_resource r
INNER JOIN dwh_res_resource rm ON r.resource_key = rm.resource_manager_key
WHERE r.is_role = 0
AND r.is_active = 1
AND EXISTS (SELECT 1
FROM dwh_res_security_v
WHERE user_key = @WHERE:PARAM:[email protected]
AND resource_key = r.resource_key)
AND @[email protected]
Parámetro USER_DEF (PARAM:USER_DEF):
SELECT @SELECT:PHASE.TASK_ID:[email protected], @SELECT:PHASE.TASK_NAME:[email protected], @SELECT:PHASE.WBS_SEQUENCE:[email protected] FROM DWH_INV_TASK PHASE WHERE PHASE.WBS_LEVEL = 1 AND (@WHERE:PARAM:USER_DEF:INTEGER:[email protected] IS NULL OR @WHERE:PARAM:USER_DEF:INTEGER:[email protected] = PHASE.INVESTMENT_KEY) AND @[email protected]
Función NVL (ISNULL/NVL):
La consulta de ejemplo siguiente puede utilizarse para comprobar un valor nulo:
SELECT @SELECT:'T'+ team.TEAM_KEY:[email protected], @SELECT:@[email protected](team.REQUIREMENT_NAME,1):[email protected], @SELECT:team.DW_UPDATED_DATE:[email protected] FROM dwh_inv_team team WHERE 1=1 AND @[email protected]
Reglas para cambiar las búsquedas
En la siguiente tabla se resumen las reglas que se aplican al cambiar búsquedas:
Tipo de búsqueda
Regla
Restringida por el sistema
Se pueden cambiar solamente las etiquetas.
Definido por el usuario
Se puede cambiar cualquier campo.
Búsqueda del sistema
Se pueden agregar valores.
Las búsquedas del sistema no se pueden desactivar.
Se pueden activar y desactivar los valores que se agregan a la búsqueda.
Búsquedas de listas estáticas
En la siguiente tabla se resumen las reglas que se aplican al cambiar las búsquedas de listas estáticas:
Función
Restringida por el sistema
Sistema
Definido por el usuario
Cambiar la descripción y el nombre de la búsqueda
Cambiar el orden de clasificación
No
Cambiar el origen del contenido
No
No
Desactivar o activar la búsqueda
No
No
Suprimir la búsqueda
No
No
Cambiar la descripción y el nombre del valor de la búsqueda
Cambiar el atributo de visualización de la ventana principal
No
No
Cambiar la partición y sus asociaciones
No
No
Desactivar y activar valores de búsqueda
No
No
Reordenar manualmente los valores de búsqueda
Cambiar la configuración de las sugerencias automáticas
Búsquedas en listas dependientes estáticas
En la siguiente tabla se resumen las reglas que se aplican al cambiar las búsquedas en listas dependientes estáticas:
Función
Restringida por el sistema
Sistema
Definido por el usuario
Cambiar la descripción y el nombre de la búsqueda
Cambiar el orden de clasificación
No
Cambiar el origen del contenido
No
No
Desactivar o activar la búsqueda
No
No
Suprimir la búsqueda
No
No
Cambiar la descripción y el nombre del valor de la búsqueda
Cambiar el atributo de visualización de la ventana principal
No aplicable
No aplicable
No aplicable
Desactivar y activar valores de búsqueda
No
Reordenar manualmente los valores de búsqueda
Búsquedas de consultas dinámicas de Niku
En la siguiente tabla se resumen las reglas que se aplican al cambiar las búsquedas de consultas dinámicas de Niku:
Función
Restringida por el sistema
Sistema
Definido por el usuario
Cambiar la descripción y el nombre de la búsqueda
No aplicable
Editar la consulta
No
No aplicable
Cambiar el atributo de visualización de la ventana principal
No
No aplicable
Cambiar los campos Etiqueta y Explorar nombre de ventana
No aplicable
Cambiar el tipo de elemento de los campos de Explorar ventana
No
No aplicable
Cambiar los campos Lista y Filtro seleccionado de Explorar ventana
No
No aplicable
Cambiar el orden de la columna de lista y del campo filtro en Explorar ventana
No aplicable
Cambiar el orden/la columna de orden predeterminado de Explorar ventana
No aplicable
Cambiar la configuración de las sugerencias automáticas
Búsquedas de recurso de elementos de acción
Clarity PPM
proporciona las siguientes búsquedas de stock para utilizarlas con la funcionalidad Asignatarios de la acción.
  • Exploración de recursos (SCH_BROWSE_RESOURCE)
  • Exploración de todos los recursos (LOOKUP_RESOURCES_ALL)
Las definiciones de búsqueda contienen las propiedades generales siguientes:
  • Objeto = recurso y la ventana principal
  • Ocultar la clave = valor de ID de la tabla SRM_RESOURCES
La funcionalidad de asignatarios de la acción de los procesos de
Clarity PPM
espera el ID interno de un registro de recurso, que se almacena en la tabla SRM_RESOURCES. La funcionalidad no espera un ID de registro de usuario. Puede crear un atributo personalizado que utiliza un tipo de
exploración de recursos
de búsqueda de stock, o puede crear su propia definición de la búsqueda de consulta dinámica.
La búsqueda proporcionada por el sistema utilizada con más frecuencia que cumple estos criterios es Lookup ID = SCH_BROWSE_RESOURCE. Mediante esta búsqueda, puede crear su propia búsqueda dinámica que devuelve el valor SRM_RESOURCE.ID como el valor de clave oculta en la búsqueda.
No confunda las búsquedas de exploración de recursos con recursos o búsquedas de usuario de nombre similar.
Activar y desactivar búsquedas
Las búsquedas se activan de forma predeterminada al crearlas. Hay que activar las búsquedas para poder utilizarlas en informes u otros objetos. Se pueden desactivar las búsquedas que se han creado, pero no se pueden desactivar las búsquedas de sistema ni las búsquedas restringidas por el sistema.
Siga estos pasos:
  1. Abra la búsqueda.
  2. Rellene el siguiente campo y guárdelo:
    • Activo
      Especifica si el valor está visible en la página cuando ésta se muestra a los usuarios. Desactive la casilla de verificación para ocultar el valor.
      Valor predeterminado:
      Seleccionado
Activación y desactivación de los valores de búsqueda
Los valores de las búsquedas se activan de forma predeterminada al crearlos. Un valor de búsqueda debe estar activo para que aparezca en una búsqueda. Se pueden activar o desactivar los valores de las listas dependientes estáticas y de las listas estáticas definidas por el usuario. Pero no se pueden desactivar los valores de consulta dinámica.
Siga estos pasos:
  1. Abra la búsqueda que contiene los valores para activarlos o desactivarlos.
  2. Haga clic en
    Valores
    .
  3. Seleccione la casilla de verificación situada junto a los valores para activarlos o desactivarlos.
  4. Haga clic en
    Activar
    o
    Desactivar
    .
    Aparece una marca de comprobación en la columna Activa de la página de búsquedas de los valores activos.
Aplicación de filtros para encontrar búsquedas
Utilice el filtro de búsqueda para encontrar una búsqueda específica o una familia de búsquedas.
Siga estos pasos:
  1. Haga clic en
    Administración
    ,
    Administración de datos
    ,
    Búsquedas
    .
  2. Utilice cualquiera de los siguientes parámetros para definir los criterios de búsqueda para las búsquedas:
    • Nombre de búsqueda
      Especifica total o parcialmente el nombre de la búsqueda. Por ejemplo, puede especificar
      Recursos activos
      o
      Recursos*
      .
    • ID de búsqueda
      Especifica total o parcialmente el ID de búsqueda.
    • Descripción
      Especifica total o parcialmente la descripción de la búsqueda.
    • Origen
      Especifica el origen de la búsqueda.
      Valores:
      Lista estática, Lista dependiente estática, Consulta dinámica o Todos.
    • Tipo de sistema
      Especifica el tipo de búsqueda.
      Valores:
      Sistema, Sistema restringido, Definido por el usuario o Todos.
    • Estado
      Indica si desea realizar búsquedas activas o inactivas.
    • Objeto
      Indica si la búsqueda es por objeto (para las consultas dinámicas solamente) si ha seleccionado un objeto durante la creación de la búsqueda.
  3. Haga clic en
    Filtrar
    .
Los filtros admiten el uso de caracteres comodín.
Limitación de los tipos de OBS que aparecen en las listas de exploración de OBS
Use la opción Ocultar estructura de desglose de la organización financiera para filtrar y limitar el número de tipos de OBS que aparecen en las listas de exploración de OBS. La opción es útil para negocios con muchas entradas de OBS en las listas de búsqueda de exploración, debido a las numerosas entidades. Al aplicar la opción, se eliminan los listados de OBS que son financieros (Departamento o Ubicación) de las listas de exploración de OBS.
Además de cualquier personalización existente para una exploración, también se aplica la opción. Se pueden ver resultados diferentes de lo esperado para algunas exploraciones personalizadas. Una vista de Filtro de lista de un objeto personalizado contiene de forma predeterminada el atributo Unidad OBS. La mejora afecta a una exploración en este atributo.
Opción Ocultar estructura de desglose de la organización financiera
La opción para filtrar las listas de exploración de OBS afecta a los siguientes ID de las búsquedas:
  • OBS_BROWSE_FLT_ALL
  • OBS_BROWSE_FLT_BPM_DEF_PROCESSES
  • OBS_BROWSE_FLT_CMP
  • OBS_BROWSE_FLT_CMN_PAGES
  • OBS_BROWSE_FLT_CMN_PORTLETS
  • OBS_BROWSE_FLT_CMN_SCH_JOB_DEFINITIONS
  • OBS_BROWSE_DMART_FLT_RES
  • OBS_BROWSE_DMART_FLT_PRJ
  • OBS_BROWSE_FLT_INV_APPLICATION
  • OBS_BROWSE_FLT_INV_ASSET
  • OBS_BROWSE_FLT_INV_OTHER
  • OBS_BROWSE_FLT_INV_PRODUCT
  • OBS_BROWSE_FLT_PRJ
  • OBS_BROWSE_FLT_RES
La opción afecta al filtrado de las siguientes áreas:
  • Informes
    Los informes que usan una unidad OBS como filtro no proporcionan información en profundidad sobre la OBS financiera en la lista desplegable Mostrar estructura de desglose de la organización. Para ejecutar un informe en una inversión que esté asignada a una OBS financiera, utilice opciones de filtro distintas. Por ejemplo, Gestor de proyectos, o bien deje vacía la opción del filtro OBS.
  • Lista de recursos
    El filtro de recursos, dentro de la lista de recursos o dentro de Equipo del proyecto, no proporciona información en profundidad sobre la estructura organizativa financiera en la lista desplegable Mostrar estructura de desglose de la organización. Para buscar recursos para asignarlos a una OBS financiera y que no se puedan mostrar, use opciones de filtro diferentes. Por ejemplo, parte del nombre del recurso. En la mayoría de los casos, los recursos se asignan a una OBS empresarial y el impacto es mínimo.
  • Filtro de inversiones
    Las inversiones que están asociadas a una OBS financiera no se pueden filtrar mediante la lista desplegable Mostrar estructura de desglose de la organización. Utilice otras opciones de filtro para reducir la lista.
  • Derechos de acceso de OBS
    Asocie derechos de acceso a través de la Unidad OBS para tipos de OBS no financieras. Los derechos de acceso para los tipos de OBS financieras en objetos, portlets, procesos u otros elementos deben tratarse a través de una OBS de seguridad independiente. Temporalmente también se puede desactivar la opción ocultar OBS financiera.
Opción Ocultar estructura de desglose de la organización financiera
Siga estos pasos:
  1. Haga clic en
    Administración
    ,
    Finanzas
    ,
    Procesamiento
    .
  2. Seleccione la casilla de verificación
    Ocultar estructura de desglose de la organización financiera
    en la sección
    Filtro de estructura de desglose de la organización
    .
  3. Haga clic en
    Save
    .