Informes › Tipos de informes › Descripción general de folletos › Creación de un folleto › Creación de folletos en formato RTF › Etiquetas de exportación de contratos y folletos › Folletos parametrizados › Sintaxis de parámetros de folletos
Sintaxis de parámetros de folletos
La sintaxis de la plantilla de folleto se parece a la sintaxis de envío de parámetros a informes de formato libre.
Notas relacionadas con la sintaxis:
- El nombre del parámetro procederá de una lista de nombres predeterminados en MAYÚSCULAS y no serán texto libre (excepto los parámetros de forma libre que *sean* de texto libre).
- El valor del parámetro será de texto libre (con la palabra clave VALUE) o un valor de contexto (con la palabra clave CONTEXT_VALUE). Cuando no haya ningún contexto de contrato, no se envían los valores de contexto.
- El valor distingue entre mayúsculas y minúsculas.
- Cuando se envía más de un valor para el mismo parámetro y el parámetro no está definido como multiselección, o cuándo se envía el mismo parámetro más de una vez, se enviará el último valor para aparezca en la plantilla.
- Si no se envía ningún valor (falta la palabra clave VALUE o <<VALUE=>>), el folleto enviará nulo como valor. Esto eliminará el valor de filtro original como si no estuviera en el informe favorito (similar a "Todo").
- El envío de un nombre del parámetro que no exista no tiene ningún efecto (esto es importante para la forma libre en un grupo).
- Los valores de parámetros se combinarán con el filtro de favoritos original donde los parámetros de folletos tienen prioridad sobre el filtro original. Por lo tanto, si se envía un parámetro a un filtro que ya existe en el informe, el filtro utilizará el parámetro del folleto.
- Defina la multiselección o el comodín. Debe declararse con la palabra clave SELECT_TYPE. Los valores pueden ser: MULTI, WILDCARD o SINGLE (el valor predeterminado si no se define es SINGLE).
- En caso de que se seleccionen varios recursos/grupos de recursos. Por ahora, el usuario solamente puede seleccionar un tipo. Recursos o grupos de recursos. El usuario tendrá que declarar qué ha utilizado en el parámetro con la palabra clave IS_GROUP. El valor puede ser YES o NO (el valor predeterminado si no se define es NO).
- Al definir la multiselección, el usuario debe definir la ruta completa de la entidad mediante con '/' (consulte el ejemplo de sintaxis de parámetro de folletos que aparece a continuación). Al seleccionar varias métricas, si el usuario ha definido un contexto de contrato, el usuario puede omitir la definición de la ruta completa y el contexto del contrato se utilizará para obtener información relevante.
- Compuesto y Favoritos de grupo tienen la misma sintaxis que Normal. Para los informes compuestos, se enviarán los valores de parámetros a cada una de la serie. Para los informes del grupos, se enviará un valor a cada miembro del grupo (también informes de formato libre). Si hay informes compuestos en el grupo, los valores de parámetros se enviarán a cada serie en todos los miembros.
Ejemplo de sintaxis de parámetros de folletos
<<BEGIN_FAVORITE=Normal favorite name>>
<<BEGIN_PARAMETER>>
<<NAME=AGGREGATION>><<VALUE=Sum>>
<<END_PARAMETER>>
<<BEGIN_PARAMETER>>
<<NAME=CONTRACT>><<CONTEXT_VALUE=SLA_NAME>>
<<END_PARAMETER>>
<<BEGIN_PARAMETER>>
<<NAME=SERVICE>><<VALUE=Service 1>>
<<END_PARAMETER>>
<<BEGIN_PARAMETER>>
<<NAME=RESOURCE>><<IS_GROUP=NO>><<VALUE=Resource 1>>
<<END_PARAMETER>>
<<BEGIN_PARAMETER>>
<<NAME=metric >>
<<SELECT_TYPE=MULTI>>
<<VALUE=Contract Party/Contract/metric 1>>
<<VALUE=Contract Party/Contract/metric 2>>
<<VALUE=Contract Party/Contract/metric 3>>
<<END_PARAMETER>>
<<NAME>>
<<CHART>>
<<DATA>>
<< END_FAVORITE>>