Diferencias

Muestra las diferencias entre dos versiones de la página.

--- funcionesreportes [2020/07/30 19:13] – [Extracción de campos personalizados (CF)] aolano
+++ funcionesreportes [2025/11/17 14:53] (actual) – [Extracción de campos personalizados (CF)] aolano
@@ Línea 1: / Línea 1: @@
 ====== Funciones especiales para reportes ======
-//En construcción//
 En esta sección se podrá encontrar información sobre funciones especiales para creación de reportes
@@ Línea 22: / Línea 20: @@
        caso.FECHACREACION
 FROM caso
-WHERE caso.FECHACREACION BETWEEN {{FECHADESDE}} AND {{FECHAHASTA}}
+WHERE caso.FECHACREACION BETWEEN '{{FECHADESDE}}' AND '{{FECHAHASTA}}'
 </code>
@@ Línea 35: / Línea 33: @@
 === Función CONVERT_TZ ===
-La función **Convert_TZ** es propia de mysql y permite convertir una fecha desde una zona horaria a otra diferente. Un ejemplo de uso es el siguiente, donde la fecha actual se convierte de la zona horaria UTC a la zona horaria 'América/Bogota'
+La función **Convert_TZ** es propia de mysql y permite convertir una fecha desde una zona horaria a otra diferente. Un ejemplo de uso es el siguiente, donde la fecha actual se convierte de la zona horaria UTC a 'América/Bogota'
 <code mysql>
@@ Línea 45: / Línea 43: @@
 === Función GET_VALUE ===
-La función **GET_VALUE** permite obtener el valor correspondiente a la zona horaria especificada en el sistema, el cual obtendremos mediante el parámetro 'TIME_ZONE'. Su uso es el siguiente:
+La función **GET_VALUE** permite obtener el valor correspondiente a la zona horaria especificada en el sistema, el cual requiere el parámetro 'TIME_ZONE'. Su uso es el siguiente:
 <code mysql>
@@ Línea 84: / Línea 82: @@
 ===== Extracción de campos personalizados (CF) =====
-Los campos personalizados pueden ser creados y asociados casos, cuentas, cuentas y usuarios, de tal forma que se pueden añadir datos adicionales a los que el formulario estándar permite, como por ejemplo agregar la edad del contacto, el número de hijos de un usuario, la placa\matrícula\patente de un vehículo para un caso, entre otros. Todos estos datos, conocidos como Custom Fields (CF) se encuentran en la tabla del objeto (caso, contacto, cuenta, usuario) y se almacenan en formato JSON. Por ejemplo al obtener la información del caso 200501-000001
+Los campos personalizados pueden ser creados y asociados casos, cuentas, contactos y usuarios, de tal forma que se pueden añadir datos adicionales a los que el formulario estándar permite, como por ejemplo agregar la edad del contacto, el número de hijos de un usuario, la placa\matrícula\patente de un vehículo para un caso, entre otros. Todos estos datos, conocidos como Custom Fields (CF) se encuentran en la tabla del objeto (caso, contacto, cuenta, usuario) y se almacenan en formato JSON. Por ejemplo al obtener la información del caso 200501-000001
 (un caso de prueba) podemos ver que la columna CF contiene los datos personalizados que se ingresaron al ticket.
@@ Línea 120: / Línea 118: @@
 | 200501-000001 | "00000000" | "Andres" | "Baloncesto" |
-=== Función DATE_FORMAT ===
+=== Función CONVERT ===
 Los datos guardados en campos personalizados que contengan acentos pueden visualizarse de forma incorrecta al momento de llevarlos a un reporte. La siguiente sentencia SQL obtiene los datos de un caso cuyos CF contienen datos con acentos:
@@ Línea 156: / Línea 154: @@
 ^ REF_NUM ^ Guia ^ Nombre ^ Hobbie Principal ^
 | 200724-000001 | Estación | Andrés | Nadar |
+=== EXTRACCIÓN DE VALORES EN LISTAS DE SELECCIÓN ===
+Los custom fields de tipo lista seleccionable se componen de opciones, y cada opción se compone a su vez de un key que corresponde al ID y un valor que corresponde al nombre de la opción. Por ejemplo:
+^ REF_NUM ^ CF ^
+| 200501-000001 | {"guia": "00000000", "nombre": "Andres", "hobbie_principal": {"01":"Baloncesto"} |
+Para obtener los nombres de la opción (Valor 2) se recomienda una query similar a la siguiente (este es un ejemplo de varias partes para mostrar las opciones disponibles, pero se puede simplificar):
+<code mysql>
+ select c.ID, @objetoCompleto := JSON_EXTRACT(c.CF, "$.hobbie_principal") as obj,
+@key := JSON_UNQUOTE(JSON_EXTRACT(JSON_KEYS(JSON_EXTRACT(c.CF, "$.hobbie_principal")),'$[0]')) as 'key',
+@value := JSON_UNQUOTE(JSON_EXTRACT(@objetoCompleto, CONCAT('$.', @key))) as 'value',
+concat(@key,'-',@value) as 'resultado'
+from caso c
+where c.ID = 53615
+order by c.ID DESC;
+</code>
+Lo cual entrega un resultado como:
+^ ID^ OBJ ^ KEY ^ VALUE ^ RESULTADO
+| 53615 | {"01": "BALONCESTO", "01"} | 01 | BALONCESTO | 01 - BALONCESTO |