CasewareDocumentación

Función CUSTPROP

La función CUSTPROP devuelve la propiedad personalizada especificada por «name». El parámetro «scope» es opcional y se utiliza para determinar el nivel de búsqueda. Por ejemplo, en el caso de un objeto de fila de tabla, el usuario puede especificar si desea obtener la propiedad personalizada de la fila de tabla o de la tabla.

Sintaxis

CUSTPROP("nombre", <"ámbito">)

Dónde

El nombre especifica la etiqueta de la propiedad personalizada que se va a devolver.

Nota: Este valor distingue entre mayúsculas y minúsculas, por lo que pueden existir tanto la propiedad personalizada «AAA» como «aaa».

El ámbito puede ser cualquiera de los siguientes valores:

  • C - Célula

  • P - Párrafo

  • T - Tabla

  • TR - Fila

  • TC - Columna

  • D - Configuración del documento

  • SSK: se trata de la sección más pequeña que incluye un enlace a la biblioteca de conocimientos y que abarca el objeto que contiene el cálculo (lo más sencillo es imaginarlo como un párrafo).

  • SSL: se trata de la sección más pequeña con una etiqueta que engloba el objeto que contiene el cálculo.

Notas

  • Si no se especifica un tipo de parámetro, la función CUSTPROP() buscará y utilizará las propiedades de los siguientes elementos en este orden:
    1. Célula
    2. Párrafo
    3. Columna de la tabla
    4. Fila de la tabla
    5. Tabla
    6. Documento

Ejemplo

CUSTPROP("Propiedad 1", <"ámbito">)

La siguiente lista muestra los casos (para «ámbito»)

Párrafo:

  1. Si falta o es «P» ==> obtener la propiedad personalizada con ese nombre del párrafo
  2. «TR» ==> obtiene la propiedad personalizada indicada de la fila de la tabla en la que se encuentra este párrafo, si este párrafo está dentro de una tabla
  3. «TC» ==> obtiene la propiedad personalizada con ese nombre de la columna de la tabla en la que se encuentra este párrafo, si este párrafo está dentro de una tabla
  4. «T» obtiene la propiedad personalizada con ese nombre de la tabla en la que se encuentra este párrafo, si este párrafo está dentro de una tabla
  5. «D» permite obtener la propiedad personalizada especificada en la configuración del documento.

Fila de la tabla:

  1. Si falta o es «TR» ==> obtener la propiedad personalizada indicada de la fila de la tabla
  2. «T» ==> obtener la propiedad personalizada con ese nombre de la tabla

Columna de la tabla:

  1. Falta o «TC» ==> obtener la propiedad personalizada con ese nombre de la columna de la tabla
  2. «T» ==> obtener la propiedad personalizada con ese nombre de la tabla

Notas

  • Si la función no encuentra ninguna coincidencia, se devuelve una cadena vacía.
  • El parámetro «name» puede ser un cálculo si la propiedad personalizada recuperada es una propiedad de texto. Si la propiedad personalizada de origen es una propiedad calculada, CUSTPROP solo puede calcular su valor correcto si el parámetro «name» es una cadena constante.

Temas relacionados