41:null 42:["$","title",null,{"children":"Toolkit para API SOCRATA | David Zamora | Observable"}] 48:Tebb,async function cardSocrata(datasetId) { // 1. Manejo del estado vacío (antes de que el usuario defina el ID) if (!datasetId || typeof datasetId !== "string") { return html`

⏳ Esperando un ID de dataset válido (ej. "3jdh-nmwu")...

`; } try { // 2. Consultas en paralelo a la API de Socrata / datos.gov.co const [metaRes, countRes] = await Promise.all([ fetch(`https://www.datos.gov.co/api/views/${datasetId}.json`), fetch(`https://www.datos.gov.co/resource/${datasetId}.json?$select=count(*)`) ]); if (!metaRes.ok) throw new Error("Dataset no encontrado o acceso denegado."); const metadata = await metaRes.json(); const countData = await countRes.json(); const totalFilas = Object.values(countData[0])[0]; // 3. Extracción segura de datos (evita errores si falta algún campo) const titulo = metadata.name || "Dataset sin título"; const actualizacionPortal = new Date(metadata.viewLastModified * 1000).toLocaleDateString("es-CO", { year: 'numeric', month: 'long', day: 'numeric' }); const actualizacionDatos = metadata.rowsUpdatedAt ? new Date(metadata.rowsUpdatedAt * 1000).toLocaleDateString("es-CO", { year: 'numeric', month: 'long', day: 'numeric' }) : "No disponible"; const proveedor = metadata.attribution || "Entidad no especificada"; const columnas = metadata.columns ? metadata.columns.length : 0; const cadaFilaEs = metadata.metadata?.rowLabel || "Un registro"; // 4. Renderizado exitoso de la tarjeta return html`

${titulo}

Cada fila es un(a): ${cadaFilaEs}

Total de Filas: ${Number(totalFilas).toLocaleString("es-CO")}

Columnas: ${columnas}

Modificación en Portal ${actualizacionPortal}

Datos suministrados por ${proveedor}

Última consolidación de filas: ${actualizacionDatos}

`; } catch (error) { // 5. Renderizado de error amigable (si la API falla) return html`

🚨 Error al cargar metadatos: ${error.message}

`; } }49:T726,html`

${infoTarjeta.titulo}

Cada fila es un(a): ${ infoTarjeta.cadaFilaEs }

Total de Filas: ${Number(conteoFilas).toLocaleString( "es-CO" )}

Columnas: ${infoTarjeta.columnas}

Modificación en Portal ${ infoTarjeta.actualizacionPortal }

Datos suministrados por ${ infoTarjeta.proveedor }

Última consolidación de filas (DIJIN): ${ infoTarjeta.actualizacionDatos }

`4a:T43f,async function* cargarSocrata(datasetId, soqlQuery = "") { if (!datasetId) { yield []; return; } const baseUrl = `https://www.datos.gov.co/resource/${datasetId}.json`; let data = []; let offset = 0; const limit = 10000; // Bloques manejables let hayMasDatos = true; while (hayMasDatos) { // Construimos la URL con el query SoQL y la paginación const url = new URL(baseUrl); url.searchParams.set("$limit", limit); url.searchParams.set("$offset", offset); // Si pasamos un filtro SoQL (ej. $where), lo adjuntamos if (soqlQuery) { const params = new URLSearchParams(soqlQuery); for (const [key, value] of params) { url.searchParams.set(key, value); } } const res = await fetch(url.href); if (!res.ok) throw new Error("Error en la descarga de Socrata"); const chunk = await res.json(); if (chunk.length === 0) { hayMasDatos = false; break; } data = data.concat(chunk); offset += limit; // Entregamos los datos progresivamente a Observable yield data; } }4b:T682,async function diccionarioDatos(datasetId) { if (!datasetId || typeof datasetId !== "string") { return html`

Esperando ID para cargar el diccionario...

`; } try { const res = await fetch(`https://www.datos.gov.co/api/views/${datasetId}.json`); if (!res.ok) throw new Error("No se pudo cargar la estructura del dataset."); const metadata = await res.json(); const estructuraLimpiada = metadata.columns .filter(col => !col.fieldName.startsWith(":@computed")) .map(col => { // Intentamos extraer los valores más comunes si están cacheados let valoresComunes = "No disponible"; if (col.cachedContents && col.cachedContents.top && col.cachedContents.top.length > 0) { // Tomamos los top 3 valores y los unimos en un string valoresComunes = col.cachedContents.top.slice(0, 3).map(t => `${t.item} (${t.count})`).join(", "); } return { "Orden": col.position, "Nombre Legible": col.name, "Campo API (fieldName)": col.fieldName, "Tipo (Socrata)": col.dataTypeName, "Nulos / Vacíos": col.cachedContents ? col.cachedContents.null : "N/A", "Top Valores (Ejemplo)": valoresComunes, "Descripción": col.description || "Sin descripción" }; }); return Inputs.table(estructuraLimpiada, { rows: 15, maxWidth: 1000, // Lo hacemos un poco más ancho layout: "auto" }); } catch (error) { return html`

Error cargando diccionario: ${error.message}

`; } }4c:T5c1,function generarQuerySoQL(filtrosObj) { // Validamos que se pase un objeto válido if (!filtrosObj || typeof filtrosObj !== "object") return ""; const condiciones = Object.entries(filtrosObj) // Descartamos llaves vacías, nulas o arreglos sin elementos .filter( ([_, valor]) => valor !== "" && valor !== null && valor !== undefined && (!Array.isArray(valor) || valor.length > 0) ) .map(([columna, valor]) => { // 1. Manejo de múltiples opciones (IN) -> ej. ["CALI", "BOGOTA"] if (Array.isArray(valor)) { const lista = valor.map((v) => `'${v}'`).join(", "); return `${columna} IN (${lista})`; } const esString = typeof valor === "string"; // 2. Manejo de operadores lógicos relacionales (>, <, >=, <=, !=) if (esString && /^(>|<|!=|>=|<=)/.test(valor.trim())) { const operador = valor.trim().match(/^(>|<|!=|>=|<=)/)[0]; const valorReal = valor.trim().substring(operador.length).trim(); return `${columna} ${operador} '${valorReal}'`; } // 3. Manejo de búsquedas aproximadas (LIKE) usando el comodín % if (esString && valor.includes("%")) { return `${columna} LIKE '${valor}'`; } // 4. Igualdad estricta (Por defecto) return `${columna} = '${valor}'`; }); // Unimos todas las condiciones con "AND" return condiciones.length > 0 ? `$where=${condiciones.join(" AND ")}` : ""; }4d:T6f9,function normalizarFrecuencias(datos, opciones = {}) { // Configuración por defecto ampliada const { mayusculas = true, quitarTildes = false, limpiarEspeciales = true // Nueva opción activada por defecto } = opciones; if (!Array.isArray(datos)) return []; // 1. Agrupamos y sumamos usando reduce (JavaScript puro) const mapaAgrupado = datos.reduce((acumulador, d) => { // Si la categoría viene nula, le asignamos un nombre estándar let cat = d.categoria ? String(d.categoria) : "SIN INFORMACIÓN"; // A. Limpieza Quirúrgica de Caracteres Especiales if (limpiarEspeciales) { // \p{L} = Cualquier letra (incluye con tildes/eñes) // \p{N} = Cualquier número // \s = Espacios // ():\- = Paréntesis, dos puntos y guiones (protegidos) // El modificador 'gu' permite leer Unicode cat = cat.replace(/[^\p{L}\p{N}\s():\-]/gu, ""); } // B. Limpieza de espacios (quita inicio/fin y colapsa los dobles espacios del medio) cat = cat.trim().replace(/\s+/g, " "); // C. Homologación de capitalización (une "lunes" con "Lunes") if (mayusculas) { cat = cat.toUpperCase(); } // D. Homologación de tildes (une "SÁBADO" con "SABADO") if (quitarTildes) { cat = cat.normalize("NFD").replace(/[\u0300-\u036f]/g, ""); } // 2. Acumulamos el total. Si la categoría ya existe, sumamos el nuevo valor. acumulador[cat] = (acumulador[cat] || 0) + Number(d.total); return acumulador; }, {}); // 3. Convertimos el objeto resultante de vuelta al formato de Observable Plot y ordenamos return Object.entries(mapaAgrupado) .map(([categoria, total]) => ({ categoria, total })) .sort((a, b) => b.total - a.total); // Orden estricto de mayor a menor }4e:T46c,parsearFecha = function parsearFecha(valorStr) { if (!valorStr || typeof valorStr !== "string") return null; const v = valorStr.trim(); // Formato ISO con timestamp: "2023-03-15T00:00:00" o "2023-03-15T14:32:00.000" // El constructor nativo de Date lo maneja bien directamente if (/^\d{4}-\d{2}-\d{2}T/.test(v)) { const d = new Date(v); return isNaN(d) ? null : d; } // Separamos el string en tres partes numéricas usando / o - const partes = v.split(/[\/\-]/); if (partes.length !== 3) return null; const [p1, p2, p3] = partes.map(Number); // Formato ISO puro: "aaaa-mm-dd" o "aaaa/mm/dd" (p1 > 31, es un año inequívocamente) if (p1 > 31) { const d = new Date(p1, p2 - 1, p3); return isNaN(d) ? null : d; } // Formato latino: "dd/mm/aaaa" o "dd-mm-aaaa" (p3 > 31, el año está al final) // Este es el prioritario para datos.gov.co if (p3 > 31) { const d = new Date(p3, p2 - 1, p1); return isNaN(d) ? null : d; } // Si no se pudo determinar el formato con certeza, retornamos null // en lugar de asumir y silenciar un error de interpretación return null; }4f:T528,### 🗓️ `derivarCamposFecha(arreglo, columna, opciones)` **Enriquecedor de Datasets con Componentes Temporales** Recorre el arreglo descargado por `cargarSocrata` y añade campos de fecha derivados a cada objeto. Está diseñada para encadenarse con `obtenerColumnasMenu` e `Inputs.select`, de modo que el `fieldName` de la columna sea siempre una elección explícita del analista y nunca una inferencia automática. * **Parámetros:** * `arreglo` *(Array)*: El dataset completo, tal como lo entrega `cargarSocrata`. * `columna` *(String)*: El `fieldName` técnico de la columna a procesar (ej. `"fecha_hecho"`). Debe provenir de `obtenerColumnasMenu`. * `opciones` *(Object)*: Declaración de los campos a derivar. Todos son `false` por defecto. * `dia` *(Boolean)*: Día del mes (1–31). * `mes` *(Boolean)*: Número de mes (1–12). * `anio` *(Boolean)*: Año con cuatro dígitos. * `diaSemana` *(Boolean)*: Nombre del día en español (ej. `"lunes"`). * `trimestre` *(Boolean)*: Trimestre del año (1–4). * **Retorno:** Un nuevo arreglo con los campos solicitados añadidos a cada objeto. Las filas donde `parsearFecha` retorne `null` conservan esos campos como `null`. Si la columna no existe en el dataset, retorna el arreglo original intacto y emite una advertencia en consola.50:T790,derivarCamposFecha = function derivarCamposFecha( arreglo, columna, opciones = {} ) { // Validaciones de entrada if (!Array.isArray(arreglo) || arreglo.length === 0) return []; if (!columna || typeof columna !== "string") { console.warn( "derivarCamposFecha: debes pasar el fieldName de la columna explícitamente." ); return arreglo; } // Verificamos que la columna exista en el dataset antes de procesar if (!(columna in arreglo[0])) { console.warn( `derivarCamposFecha: la columna "${columna}" no existe en el dataset. Verifica el fieldName con obtenerColumnasMenu().` ); return arreglo; } const { dia = false, mes = false, anio = false, diaSemana = false, trimestre = false } = opciones; const DIAS_SEMANA = [ "domingo", "lunes", "martes", "miércoles", "jueves", "viernes", "sábado" ]; return arreglo.map((fila) => { const fecha = parsearFecha(fila[columna]); const nueva = { ...fila }; // Si parsearFecha no pudo interpretar el valor, todos los campos derivados quedan null nueva[`${columna}_dia`] = dia && fecha ? fecha.getDate() : dia ? null : undefined; nueva[`${columna}_mes`] = mes && fecha ? fecha.getMonth() + 1 : mes ? null : undefined; nueva[`${columna}_anio`] = anio && fecha ? fecha.getFullYear() : anio ? null : undefined; nueva[`${columna}_diaSemana`] = diaSemana && fecha ? DIAS_SEMANA[fecha.getDay()] : diaSemana ? null : undefined; nueva[`${columna}_trimestre`] = trimestre && fecha ? Math.ceil((fecha.getMonth() + 1) / 3) : trimestre ? null : undefined; // Limpiamos las claves que el usuario no pidió (undefined) para no ensuciar el objeto Object.keys(nueva).forEach( (k) => nueva[k] === undefined && delete nueva[k] ); return nueva; }); }51:[] 46:{"id":"344cc9c924b63f48","slug":"socrata-api-toolkit","title":"Toolkit para API SOCRATA","thumbnail":"77bef58c00690e2ffa4123d095c16d0d0fcaea96455cdabb981b3782338a1ad9","access_level":"public","create_time":"$D2026-03-18T04:33:35.648Z","update_time":"$D2026-04-02T05:13:23.650Z","view_time":null,"first_public_time":"$D2026-03-18T04:53:13.116Z","has_unpublished_edits":null,"fork":false,"stars":0,"starred":false,"owner":{"type":"team","id":"872bea5f18aed5fe","login":"davzrx","name":"David Zamora","avatar_url":"https://avatars-next.observableusercontent.com/4c82c56df5ebe314bd43d89bb3e5fd175ff8d9d69a411a48ba64b3754cfa03a6","tier":"starter_2024","bio":"Sociólogo | Sociologist - Analista de Datos | Data Analyst - Datos en Español - Colombia","following":false},"version":133,"publish_version":null,"role":null,"authored":false,"authors":[{"type":"individual","id":"4a902bd04f67962c","login":"davzrx","name":"David Zamora Ramírez","avatar_url":"https://avatars-next.observableusercontent.com/4c82c56df5ebe314bd43d89bb3e5fd175ff8d9d69a411a48ba64b3754cfa03a6","tier":null,"bio":"Data Analyst | GeoData | Cali | Colombia","following":false}],"members":[{"type":"individual","id":"4a902bd04f67962c","login":"davzrx","name":"David Zamora Ramírez","avatar_url":"https://avatars-next.observableusercontent.com/4c82c56df5ebe314bd43d89bb3e5fd175ff8d9d69a411a48ba64b3754cfa03a6","tier":null,"role":"editor"},{"type":"team","id":"872bea5f18aed5fe","login":"davzrx","name":"David Zamora","avatar_url":"https://avatars-next.observableusercontent.com/4c82c56df5ebe314bd43d89bb3e5fd175ff8d9d69a411a48ba64b3754cfa03a6","tier":"starter_2024","role":"viewer"}],"comments":[],"custom_thumbnail":false,"trashed":false,"lapsed":null,"subscribed":null,"forks":0,"collection":null,"type":"notebook","body":{"titling":"auto","title":"Toolkit para API SOCRATA","cells":[{"id":0,"value":"# Toolkit para API SOCRATA","pinned":false,"hidden":false,"mode":"md","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"","database":"$undefined"},{"id":72,"value":"### 📊 `cardSocrata(datasetId)`\n**Generador Reactivo de Metadatos y Volumetría**\n\nEsta función asíncrona consulta el endpoint de vistas (`/api/views`) de Socrata para construir un panel de control HTML nativo. Está diseñada para ofrecer un contexto inmediato sobre la vitalidad y dimensión del conjunto de datos antes de iniciar cualquier procesamiento analítico pesado.\n\n* **Parámetros:** * `datasetId` *(String)*: El identificador alfanumérico único del dataset de Socrata (ej. `\"3jdh-nmwu\"`).\n* **Comportamiento:** Ejecuta promesas en paralelo para extraer los metadatos descriptivos y realizar un conteo en vivo (`$select=count(*)`) de los registros en el servidor.\n* **Retorno:** Un nodo DOM (literal de plantilla `html`) con el título, proveedor, fechas reales de actualización de filas y volumetría exacta, listo para ser renderizado en el notebook importador.","pinned":false,"hidden":false,"mode":"md","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"","database":"$undefined"},{"id":47,"value":"$48","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":23,"value":"$49","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":13,"value":"infoTarjeta = ({\n titulo: metadata.name,\n actualizacionPortal: new Date(metadata.viewLastModified * 1000).toLocaleDateString(\"es-CO\", {\n year: 'numeric', month: 'long', day: 'numeric'\n }),\n actualizacionDatos: new Date(metadata.rowsUpdatedAt * 1000).toLocaleDateString(\"es-CO\", {\n year: 'numeric', month: 'long', day: 'numeric'\n }),\n proveedor: metadata.attribution || \"Policía Nacional\",\n columnas: metadata.columns.length,\n cadaFilaEs: metadata.metadata.rowLabel || \"Un registro\"\n})","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":77,"value":"### 🔄 `cargarSocrata(datasetId, soqlQuery)`\n**Motor de Extracción Progresiva con Soporte SoQL**\n\nFunción generadora asíncrona (`async function*`) diseñada para eludir las limitaciones de memoria del navegador y el *throttling* de la API al descargar conjuntos de datos gubernamentales masivos. Permite delegar la carga computacional de filtrado directamente a los servidores de Socrata.\n\n* **Parámetros:**\n * `datasetId` *(String)*: El identificador único del dataset.\n * `soqlQuery` *(String, opcional)*: Cadena de consulta estructurada en Socrata Query Language (ej. `\"$where=municipio='CALI'\"`).\n* **Comportamiento:** Implementa un bucle de paginación controlada usando los parámetros `$limit` y `$offset`. Mediante la instrucción `yield`, inyecta bloques de datos de forma progresiva y reactiva a las celdas dependientes en Observable.\n* **Retorno:** Un flujo asíncrono (Generator) que evalúa un arreglo de objetos JavaScript, creciendo dinámicamente hasta completar la extracción de la consulta.","pinned":false,"hidden":false,"mode":"md","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"","database":"$undefined"},{"id":52,"value":"$4a","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":79,"value":"### 📖 `diccionarioDatos(datasetId)`\n**Auditor de Estructura y Caché de Datos**\n\nHerramienta de inspección previa a la formulación de consultas. Analiza la estructura interna del dataset para exponer los nombres técnicos requeridos por la API y evaluar rápidamente la calidad del dato sin necesidad de descargar registros individuales.\n\n* **Parámetros:**\n * `datasetId` *(String)*: El identificador único del dataset.\n* **Comportamiento:** Filtra las columnas computadas por el sistema y extrae propiedades avanzadas de la caché de Socrata (`cachedContents`), revelando estadísticas vitales como el volumen de valores nulos y las categorías más frecuentes.\n* **Retorno:** Un componente interactivo `Inputs.table` de ObservableHQ, optimizado para búsqueda y ordenamiento de esquemas de bases de datos.","pinned":false,"hidden":false,"mode":"md","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"","database":"$undefined"},{"id":64,"value":"$4b","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":89,"value":"### 🔎 `generarQuerySoQL(filtros)`\n**Transpilador de Objetos JS a Sintaxis Socrata (SoQL)**\n\nToma un objeto estándar de JavaScript y lo convierte en una cadena de consulta `$where` válida para la API de Socrata. Ignora automáticamente los valores vacíos, lo que lo hace perfecto para conectarse reactivamente con formularios (`Inputs.form`) de ObservableHQ.\n\n* **Parámetros:**\n * `filtros` *(Object)*: Un objeto donde las llaves son los `fieldName` de las columnas, y los valores son el criterio de filtro (ej. `{ municipio: \"CALI\", edad: \">=18\" }`).\n* **Soporte Avanzado:**\n * **Igualdad:** `{ sexo: \"MASCULINO\" }`\n * **Listas (IN):** `{ departamento: [\"VALLE\", \"CAUCA\"] }`\n * **Operadores (>, <, >=, <=, !=):** `{ fecha: \">=2024-01-01\" }`\n * **Búsquedas Parciales (LIKE):** `{ barrio: \"SAN %\" }` (El `%` es el comodín).\n* **Retorno:** Cadena de texto formateada (ej. `\"$where=municipio='CALI' AND sexo='MASCULINO'\"`). Retorna un string vacío si el objeto no tiene filtros válidos.","pinned":false,"hidden":false,"mode":"md","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"","database":"$undefined"},{"id":90,"value":"$4c","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":94,"value":"### 📊 `obtenerFrecuencias(datasetId, columna, limite)`\n**Motor Agregador de Categorías (Group By)**\n\nConsulta directamente al servidor de Socrata para realizar un conteo de frecuencia sobre una columna específica. Ideal para poblar gráficos de barras, *pie charts* o entender la distribución categórica de una variable antes de cruzar datos.\n\n* **Parámetros:**\n * `datasetId` *(String)*: El ID del dataset.\n * `columna` *(String)*: El nombre técnico (`fieldName`) de la columna a agrupar.\n * `limite` *(Number, opcional)*: Cuántos resultados top traer (por defecto 10).\n* **Retorno:** Un arreglo de objetos ordenado de mayor a menor frecuencia (ej. `[{municipio: \"CALI\", total: 1500}, ...]`).","pinned":false,"hidden":false,"mode":"md","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"","database":"$undefined"},{"id":96,"value":"async function obtenerFrecuencias(datasetId, columna, limite = 10) {\n if (!datasetId || !columna) return [];\n\n // Construimos un query SoQL puramente agregacional\n const soql = `$select=${columna}, count(*) AS total&$group=${columna}&$order=total DESC&$limit=${limite}`;\n const url = `https://www.datos.gov.co/resource/${datasetId}.json?${soql}`;\n\n try {\n const res = await fetch(url);\n if (!res.ok) throw new Error(\"Fallo en la agrupación\");\n\n const data = await res.json();\n\n // Convertimos el \"total\" de string a número para que Observable Plot lo entienda\n return data.map((d) => ({\n categoria: d[columna] || \"SIN DATO\",\n total: +d.total\n }));\n } catch (error) {\n console.error(\"Error en obtenerFrecuencias:\", error);\n return [];\n }\n}","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":99,"value":"### 📋 `obtenerColumnasMenu(datasetId)`\n**Extractor de Columnas para Interfaces de Usuario (UI)**\n\nConsulta los metadatos del dataset y devuelve un objeto `Map` diseñado específicamente para alimentar componentes `Inputs.select` de ObservableHQ. Oculta las columnas del sistema y mapea los nombres legibles a sus respectivos `fieldName` técnicos.\n\n* **Parámetros:**\n * `datasetId` *(String)*: El ID del dataset.\n* **Retorno:** Un objeto `Map` de JavaScript.","pinned":false,"hidden":false,"mode":"md","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"","database":"$undefined"},{"id":104,"value":"async function obtenerColumnasMenu(datasetId) {\n if (!datasetId) return new Map();\n\n try {\n const res = await fetch(\n `https://www.datos.gov.co/api/views/${datasetId}.json`\n );\n if (!res.ok) throw new Error(\"No se pudieron cargar las columnas\");\n\n const metadata = await res.json();\n\n // Filtramos las columnas del sistema y creamos un arreglo de pares [Nombre Legible, fieldName]\n const paresColumnas = metadata.columns\n .filter((col) => !col.fieldName.startsWith(\":@computed\"))\n .map((col) => [col.name, col.fieldName]); // [Lo que ve el usuario, Lo que lee el código]\n\n // Retornamos un Map nativo de JS\n return new Map(paresColumnas);\n } catch (error) {\n console.error(\"Error extrayendo columnas:\", error);\n return new Map([[\"Error cargando columnas\", \"\"]]);\n }\n}","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":107,"value":"### 🧹 `normalizarFrecuencias(datosFrecuencia, opciones)`\n**Motor Avanzado de Normalización y Deduplicación Categórica**\n\nLimpia, estandariza y reagrupa arreglos de frecuencias eliminando anomalías de digitación (espacios dobles, mayúsculas, tildes y puntuación basura). Protege la estructura de rangos horarios y etiquetas complejas.\n\n* **Parámetros:**\n * `datosFrecuencia` *(Array)*: El arreglo devuelto por `obtenerFrecuencias`.\n * `opciones` *(Object)*: Configuración de limpieza. \n * `mayusculas` (Default `true`): Estandariza a mayúsculas.\n * `quitarTildes` (Default `false`): Remueve marcas diacríticas.\n * `limpiarEspeciales` (Default `true`): Borra puntos, comas y símbolos, conservando solo letras, números, `()`, `:` y `-`.\n* **Retorno:** Arreglo de objetos ordenado de mayor a menor frecuencia, listo para graficar.","pinned":false,"hidden":false,"mode":"md","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"","database":"$undefined"},{"id":109,"value":"$4d","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":117,"value":"### 📅 `parsearFecha(valorStr)`\n**Detector y Parseador Universal de Formatos de Fecha**\n\nFunción utilitaria de bajo nivel que recibe un valor crudo de la API y lo convierte en un objeto `Date` nativo de JavaScript. Está diseñada para ser robusta ante la heterogeneidad de formatos presentes en datasets gubernamentales colombianos.\n\n* **Parámetros:**\n * `valorStr` *(String)*: El valor crudo de la celda de fecha (ej. `\"15/03/2023\"`, `\"2023-03-15\"`, `\"03-15-2023\"`).\n* **Formatos soportados:**\n * ISO 8601: `aaaa-mm-dd` y `aaaa/mm/dd`\n * Latino invertido: `dd/mm/aaaa` y `dd-mm-aaaa` *(el más común en datos.gov.co)*\n * Americano: `mm/dd/aaaa` y `mm-dd-aaaa`\n * Con hora: `aaaa-mm-ddTHH:MM:SS` (ISO con timestamp)\n* **Retorno:** Un objeto `Date` válido, o `null` si el valor no pudo ser interpretado.","pinned":false,"hidden":false,"mode":"md","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"","database":"$undefined"},{"id":123,"value":"$4e","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":126,"value":"$4f","pinned":false,"hidden":false,"mode":"md","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"","database":"$undefined"},{"id":129,"value":"$50","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":9,"value":"metadata = fetch(`https://www.datos.gov.co/api/views/${datasetId}.json`).then(res => res.json())","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":37,"value":"conteoFilas = fetch(`https://www.datos.gov.co/resource/${datasetId}.json?$select=count(*)`)\n .then(res => res.json())\n .then(data => Object.values(data[0])[0]) // Extraemos el número exacto","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":3,"value":"datasetId = \"3jdh-nmwu\"","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"}],"files":"$W51","stdlib":"1"}} 47:"$46:body"