Manual para los usuarios
Acerca Este manual tiene como objetivo aclarar conceptos sobre el manejo básico de la plataforma de historias de Ciudatos de la Red Colombiana de Ciudades Cómo Vamos. Además es una guía para que el usuario pueda registrar nuevas historias y modificar elementos básicos no estructurales de la apariencia del portal.
Acerca Url's y Accesos Cuidados Url General: http://ciudatos.com Url de acceso al administrador WordPress: http://ciudatos.com/wp-admin Data Set para Ciudatos Url General: http://datos.ciudatos.com/dataset
Acesso Administrador El administrador de Wordpress Le permite al usuario (con nivel de acceso de administrador del sitio) realizar fácilmente los cambios que su sitio web requiera. Este manual se focará en brindar el paso a paso para crear la historia contextual para el catálogo de datos disponibles en la plataforma de CKAN. Es posible agregar fotos para enriquecer la experiencia de los lectores, así como etiquetas HTML de inserción en el texto y de esta forma permitir la creación de estilos de texto de encargo; insertar imágenes y cambiar el contenido de los textos de cada página de la ciudad. Acesso Para gestionar la plataforma es necesario tener acceso a las credenciales de un perfil de administrador y acceder a la siguiente URL: http:// wpcomovamos.eokoe.com/wplogin.php
Crear cuentas para los administradores Para crear nuevos usuarios tenga en cuenta los siguientes pasos: 1. Inicie sesión 2. Diríjase a la opción "Usuarios" en el menú y acceder al botón "Añadir nuevo. 3. Digite la información del nuevo usuario, elija el nivel de acceso que el nuevo miembro tendrá en el sistema o las acciones que se le permitirá correr. Recuerde que las acciones pueden ser de diferentes tipos como se detalla a continuación.
Crear cuentas para los administradores Perfiles Super Admin Esta regla permite al usuario tener un control total sobre el sistema y puede agregar y eliminar los nuevos usuarios y hacer cualquier tipo de modificaciones posibles a través de la interfaz gráfica. Administrator Es capaz de realizar todas las tareas administrativas desde un sitio web, pero puede ser asignado a solamente un número limitado de redes. Editor Con este perfil, es posible editar y publicar contenido en la plataforma, incluyendo los creados por otros usuarios. Author Este perfil permite la creación de contenidos y edición de su propio contenido. Contributor Puede crear y editar su propio contenido, pero no está autorizado a publicarlo. Subscriber Este perfil sólo supervisa lo que se produce permite gestionar su propio perfil personal.
Acerca del portal Ciudatos tiene como objetivo permitir a los administradores de cada ciudad crear contenido relevante sobre los datos recogidos a través de años de investigación y publicados en el plataforma de datos abierto CKAN. Para ello, hemos desarrollado un tema atractivo y adaptado un 100% a la identidad visual del programa y que fué pensado para ser simple, funcional, y que permita la navegación directa por datos y el seguimiento de las historias creadas, divididas por las etiquetas de interés, como por ejemplo la educación.
Integración con CKAN Fué realizada una integración a traves de la API CKAN, como parte integrante de la plataforma, lo que permite hacer búsqueda por palabras llave directamente en las bases de datos disponibles en el catálogo de datos, es decir, si se busca un término con "Encuestas", por ejemplo, se es dirigido a una lista de archivos y bases de datos que contienen este término,agilizando así el acceso a los datos. En la elección de la ciudad, el usuario puede acceder a la lista completa de bases de datos y archivos a su alcance, como se muestra en la imagen.
Gestión de páginas de movimiento Cada ciudad tiene su propia página explicativa que se puede actualizar la información requerida. Siga los pasos que se presentan a continuación: 1. Acceda a la lista de páginas:
Gestión de páginas de movimiento A continuación, seleccione la ciudad que desea editar y poner en su nombre: En estos campos, de forma consecutiva, usted puede poner el nombre de la página a crear, su contenido, con o sin etiquetas de marcado HTML. Después de editar la dirección que se asociará con esa página, ingrese al menú de la derecha, en donde podrá asociar una imagen y ajustar la visibilidad de la página como los tipos descritos a continuación: Público La página está disponible para el acceso público. Protegido por contraseña La página está disponible sólo para quienes estén registrados como usuarios y hayan iniciado sesión en el momento de cambio de la visibilidad. Privado sólo quien está registrado como administrador de Wordpress y haya iniciado sesión puede ver la página.
Gestión de páginas de movimiento Colocar el Link de los datos de la ciudad en la página 1. Digite el texto del vínculo (link) a ser visualizado abajo del texto del de la página (todavia en el editor de texto, habiendo tecleado 1 o 2 veces la tecla enter' para que quede en otro párrafo). 2. Accese el sitio web de los datos generados por CKAN en la url http://datos.ciudatos.com, luego haga click en el link Organizaciones" del menú principal.
Gestión de páginas de movimiento Colocar el Link de los datos de la ciudad en la página 3. Luego haga click en la organización que corresponde a la ciudad de la página 4. Después cópie la url de la organización usando la barra de direcciones web en la parte de arriba de su navegador.
Gestión de páginas de movimiento Colocar el Link de los datos de la ciudad en la página 5. Vuelva a la edición de la página, seleccione el texto del link que dígito en el paso 1 y haga click en el botón de link del editor de texto de campo para texto. 6. Cuando se abra la ventana de edición/creación de link, pegue en el campo Url" el link que copió en el paso 4 y después haga click en el botón Actualizar'.
Gestión de páginas de movimiento Vincular una imagen destacada a la página 1. Haga click en el texto Asingar imagen destacada en el cuadro Imagen Destacada del panel de edición de la página, que se encuentra en la pate de abajo - a la derecha en el panel. 2. Cuando se abra la ventana de la biblioteca multimedia, escoja una imagen ya existente en la biblioteca, o haga click en la aba Subir Archivos, para subir una imagen nueva desde su máquina/ dispositivo.
Gestión de páginas de movimiento Vincular una imagen destacada a la página 3. Estando seleccionada la imagen a vincular, haga click en el botón Asignar imagen destacada de la Biblioteca multimedia, que está situado en la parte de abajo - a la derecha de la ventana. Por último haga click en el botón Publicar/ Actualizar para guardar las adiciones o cambios hechos en la página.
La inclusión de una nueva historia Las historias son entradas (posts) con categorías especiales que se establecen para que dichas entradas puedan aparecer en lugares específicos, como la página de inicio del sitio y la página historias. Para crear una nueva historia, los siguientes pasos se deben seguir: 1. Acceda a la lista de Entradas (posts) y haga clic en "Agregar nuevo"
La inclusión de una nueva historia En la página para añadir nueva historia, el título debe ser colocado, tomando en cuenta que el titulo funciona como base para que el sistema cree automáticamente la dirección de la página específica de la entrada (post). En el cuadro de texto, todo el contenido de la historia se va a insertar, siendo posible usar etiquetas HTML para personalizar la visualización. En esta página, también es posible agregar la categoría a la que pertenece la historia. Estos datos son útiles para la clasificación y una mejor distinción de los contenidos.
Gestión de páginas de movimiento Vincular una imagen destacada al la Historia 1. Haga click en el texto Asingar imagen destacada en el cuadro Imagen Destacada del panel de edición de la historia/entrada, que se encuentra en la pate de abajo - a la derecha en el panel. 2. Cuando se abra la ventana de la biblioteca multimedia, escoja una imagen ya existente en la biblioteca, o haga click en la aba Subir Archivos, para subir una imagen nueva desde su máquina/ dispositivo.
Gestión de páginas de movimiento Subir y dimensionar una Imagen para destaque de la historia (En caso de tener que subir la imagen) 3. Con la ventana de la biblioteca multimedia abierta, haciendo click en la ama Subir Archivos, y escoja la imagen deseada. Es importante que la imagen tenga las dimensiones correctas para que no se deforme en el template de wordpress. Las dimensiones exactas son 670 pixeles de ancho por 400 pixeles de altura. La imagen debe ser superior a esas dimensiones para poder ser adecuada. El corte de la imagen puede hacerse de dos formas: - previo a la subida del archivo de imagen (Por ejemplo: usando photoshop) - o usando la herramienta de dimensionamiento de imágenes del sistema wordpress.
Gestión de páginas de movimiento Dimensionar una Imagen para destaque de la historia (En caso de tener que subir la imagen) 4. Con la ventana de la biblioteca multimedia abierta, haciendo click en la ama Subir Archivos o Cargar Ficheros', y escoja la imagen deseada. Es importante que la imagen tenga las dimensiones correctas para que no se deforme en el template de wordpress. Las dimensiones exactas son 670 pixeles de ancho por 400 pixeles de altura. La imagen debe ser superior a esas dimensiones para poder ser adecuada. El corte de la imagen puede hacerse de dos formas: - previo a la subida del archivo de imagen (Por ejemplo: usando photoshop) - o usando la herramienta de dimensionamiento de imágenes del sistema wordpress.
Gestión de páginas de movimiento Dimensionar una Imagen para destaque de la historia (En caso de tener que subir la imagen) 5. Habiendo seleccionado y subido la imagen dentro de su máquina (computador), la imagen queda seleccionada en la ventana de la biblioteca multimedia. 6. En ese estado, haga click en el link Editar Imagen. 7. Habiendo entrado en el panel de dimensionamiesto de imagen, haga click y arrastre el mouse hacia un lado y hacia abajo, manteniendo el click. 8. Luego vaya a los espacios enfrente del marcador selección', al lado derecho de la p a n t a l l a y d i g i t e 6 7 0 y 4 0 0 respectivamente, y haga lo mismo en los campos de 'Relación de aspecto.
Gestión de páginas de movimiento 9. Coloque el mouse sobre la selección hecha en la imagen (va a ver una cruz de traslación en la posición de mouse), y arrastre la selección hasta la posición deseada para redimensionarla a un tamaño mayor, pero manteniendo la relación de aspecto. Dimensionar una Imagen para destaque de la historia (En caso de tener que subir la imagen) 10.Redimensione haciendo click en una esquina de la selección manteniendo la tecla shift" presionada al mismo tiempo que el botón de click izquierdo del mouse, para mantener las proporciones correctas de la selección. Haga esto hasta alcanzar el mayor tamaño posible sin perder objetos importantes de la images.
Gestión de páginas de movimiento Dimensionar una Imagen para destaque de la historia (En caso de tener que subir la imagen) 11.Haga click en el botón de corte, situado encima de la ventana. es el primer botón de izquierda a derecha. 12.Haga click en el botón Guardar' para guardar la imagen que usted acaba de cortar
Gestión de páginas de movimiento Vincular una imagen destacada a la página 12.Estando seleccionada la imagen a vincular, haga click en el botón Asignar imagen destacada de la Biblioteca multimedia, que está situado en la parte de abajo - a la derecha de la ventana. Por último haga click en el botón Publicar/ Actualizar para guardar las adiciones o cambios hechos en la historia/entrada.
Categorías Las categorías permiten mejorar la organización en el portal porque hace posible separar el contenido publicado por área de interés, Ejemplo: una entrada (post) puede estar asociada con una o más categorías. Para agregar una nueva categoría, los pasos son los siguientes: Ingrese a 'Mensajes -> Categorías, elija el nombre de la categoría en el campo Nombre' y seleccione la url que direcciona a la categoría en el campo de 'Slug'. Luego elija la categoría a la cual pertenece (quedando como una subcategoria) y creando un sistema jerárquico categorías en niveles. Por último, digite una descripción (opcional).
La inclusión de una nueva historia Después de crear la(s) categoria(s) se puede vincular la historia creada con dicha categoría, entrando de nuevo al panel de edición especifico de la historia haciendo click en el cuadro que aparece al lado derecho del panel con el título de Categorias' como se muestra en la imagen de encima.
La inclusión de una nueva historia Cómo vincular un Data Set a la historia En la parte de abajo, del lado izquierdo del panel de edición de la historia y justo debajo del cuadro para digitar el Extracto, se encuentra el cuadro con el título de Campos Personalizados. Allí digite en el campo 'Nombre' estrictamente el siguiente texto: linked_data y al lado derecho de dicho campo, en el campo Valor' digite o pegue la URL/vículo a los datos relacionados a la historia en cuestión.
Ajustes Generales del Sitio Web Es posible alterar los ajustes generales del sitio web accesando el menú Settings -> General. Allí se tiene acceso a las configuraciones de título del sitio, descripción corta, zona horária, formato de hora, formato de fecha, Idioma y otros. Para hacer alteraciones en dichos ajustes, simplemente haga clicik, elija una opción o digite el contenido en el campo correspondientes a cada item, y luego guarde todos los cambios hechos haciendo click en el botón Save Changes ( Guardar cambios ) situado en la parte de abajo del panel para ese menú de la administración.
API Cómo Vamos Colombia Cómo conectarse a nuestra nueva API?
Acerca Ciudatos utiliza el repositorio de datos Ckan, que permite subir archivos y la creación automática de APIs para su consumo. Para entender cómo funciona, es importante conocer primero la estructura usada para la subida de archivos en este proyecto, la forma en la que Ckan maneja los datos en sus dos capas de APIs, y mostrar algunos ejemplos para el consumo de la información dinámica. API Cómo Vamos Colombia
Estructura de los Datos e Identificadores Los archivos están divididos por organizaciones, las cuales son exibidas como se muestra en pantalla al la derecha > API Cómo Vamos Colombia
Estructura de los Datos e Identificadores Cada conjunto de datos tiene un indicador específico que permite su acceso. La estructura de los datos subidos en la plataforma por ciudad, está formulada de la siguiente manera (las negrillas representan el id del objeto): Ciudad Resultados Anuales Encuesta(Datos Subjetivos) [clave organizacion]-subjetivos-anual Indicadores Anuales (Datos Objetivos) [clave organizacion]-objetivos-anual Recopilación de Indicadores(Datos Objetivos) [clave organizacion]-objetivos-lote Recopilación de Resultados(Datos Subjetivos) [clave organizacion]-subjetivos-lote Archivo de todos los resultados [clave organizacion]-archivo El ID es primordial para el acceso a la API, cuyo proceso será mencionado a continuación. API Cómo Vamos Colombia
Las dos capas de la API de Ckan (Ckan-api y Datastore) El repositorio de datos Ckan permite el acceso a sus datos en dos niveles: Ckan API: Permite la consulta de datos sobre la estructura de archivos, hacer búsquedas y crear datasets. Sin embargo, no cuenta con la capacidad de consultar el interior de un archivo y los datos que contiene. Datastore: Permite la consulta de los datos dentro de los archivos subidos (recurso). Al subir datos a Ckan, automáticamente se suben los archivos a un sistema interno donde también pueden ser consultados. Para ver este proceso para un recurso, solo hace falta ir a la pantalla 'datastore' dentro de la opción 'manage' del recurso. A continuación un ejemplo: API Cómo Vamos Colombia
Accesando el Catálogo con Ckan-API Ckan-api permite la exploración y manipulación de los catálogos de datos desde una interfaz programática. Su documentación puede ser consultada en: http://docs.ckan.org/en/latest/api/, solo hace falta cambiar la dirección mostrada en los tutoriales, por ejemplo: http://demo.ckan.org/api/3/action/package_list Por la dirección de nuestro sitio: http://comovamos.eokoe.com/api/3/action/package_list Es importante resaltar algunas funciones importantes para el consumo de la Ckan-API: http://comovamos.eokoe.com/api/3/action/organization_list: Permite ver las organizaciones dadas de alta en la plataforma. Para la plataforma como vamos, usamos el nombre de la organización como base para los códigos de ciudades (Bogota para Bogotá, para formar bogota-objetivos-lotes) http://comovamos.eokoe.com/api/3/action/package_show?id=cartagena-anual : Donde el último ID es el del dataset de interés, en este caso los datos anuales subjetivos de Cartagena. Lista los recursos disponibles http://comovamos.eokoe.com/api/3/action/package_create : Permite la creación de archivos desde la API. Necesita una API key, que puede ser consultada en: http://comovamos.eokoe.com/user/ admin API Cómo Vamos Colombia
Accediendo al recurso por datastore Datastore permite la consulta de los contenidos de los archivos que han sido subidos a esta extensión(todos los archivos de la red deberán ser incluidos). Se puede consultar la documentación de esta API en la dirección: http://docs.ckan.org/en/ckan-1.8/datastore-api.html Algunos ejemplos de consultas con esta API pueden visualizarse en: http://comovamos.eokoe.com/api/action/datastore_search?resource_id=17fd5202-baba-444ab046-3ea9cfa5b03b&limit=5 Al igual que el Ckan-API, datastore tiene un par de funciones de especial atención: datastore_search: Permite la búsqueda de datos por criterios de palabras clave datastore_search_sql: Permite la búsqueda mediante solicitudes de formato SQL. API Cómo Vamos Colombia
Plataforma de Datos Cómo Vamos Colombia Qué datos tenemos en la plataforma?
Qué datos tenemos en la plataforma? La información de la Red Cómo Vamos Colombia está organizada en Ciudatos, la plataforma de datos abiertos en tres niveles. Mapa de Dados
Qué datos tenemos en la plataforma? 1. Ciudades: Cada Cómo Vamos de la red de Colombia, cuenta con un espacio donde se guardan los conjuntos de datos que les corresponden. Dentro de la plataforma, se le conocen como Organizaciones. Mapa de Dados
Qué datos tenemos en la plataforma? 2. Conjuntos de Datos: Dentro del espacio de cada Ciudad, están localizados los conjuntos de datos generados por cada ciudad; Se considera que se tiene un solo conjunto de datos cuando varios archivos cuentan con similares características de dimensiones. Un conjunto de datos se diferencia de otro cuando tratan de distintos temas o cubren diferentes periodos de tiempo. Se puede entender un conjunto de datos como una carpeta donde se guardan diferentes archivos que tienen varias cosas en común. Mapa de Dados
Qué datos tenemos en la plataforma? 3. Recursos: Un recurso es la forma en la que se conoce un archivo o dirección de internet que contiene información. La Plataforma cuenta con dos tipos de recursos muy importantes: Las tablas de datos, donde se guardan las respuestas y los indicadores de manera estructurada y los diccionarios de datos, lugar donde guardamos datos importantes sobre las variables de las tablas. Hay un diccionario de datos por cada tabla de datos localizada en la plataforma. Mapa de Dados
Qué información tiene cada ciudad? Cada ciudad genera la información producto de las encuestas, datos que conocemos dentro de la plataforma como subjetivos ; Y genera datos de indicadores importantes de la ciudad, datos que se conocen como objetivos. Es importante que conozcas además los anillos en los que la información que recopila nuestra organización: - Optimismo y bienestar - Activos de las Personas - Hábitat Urbano - Buen Gobierno - Extra Planteemos dos escenarios: Queremos conocer el índice de desempleo en Medellín en el último año. Queremos conocer la opinión sobre el trabajo en Medellín, para compararlo con el índice de empleo. Recuerda que ambas comparaciones las puedes hacer desde la aplicación (: Mapa de Dados
Plataforma de Datos Como Vamos Colombia Cómo subir información a nuestra plataforma?
Acerca La plataforma de datos abiertos fue pensada para atender 2 frentes: El frente del consumo de la información y el frente de la subida de la misma. Este documento pretende compartir las características de los datos que tenemos en la plataforma, el formato en que se encuentran y el proceso que se debe seguir para la subida de datos de este año. Cómo subir información a nuestra plataforma?
Estructura de los datos Los archivos están divididos por organizaciones, y son exibidos como se muestra en la pantalla a la derecha > Cómo subir información a nuestra plataforma?
Estructura de los datos Cada organización corresponde a una de las ciudades de la red. Cada una de ellas podrá tener un usuario con poderes administrativos. Para las saber más sobre operaciones que se realizan como administrador del sistema, favor de consultar esta guía. Dentro de una ciudad, se pueden encontrar datos de las encuestas (referidas como datos subjetivos), los datos de los indicadores de los ciudades (referidos como datos objetivos) y la lista de datasets: Resultados Anuales Encuesta (Datos Subjetivos) [clave organizacion]-subjetivos-anual Indicadores Anuales (Datos Objetivos) [clave organizacion]-objetivos-anual Recopilación de Indicadores(Datos Objetivos) [clave organizacion]-objetivos-lote Recopilación de Resultados(Datos Subjetivos) [clave organizacion]-subjetivos-lote Archivo de todos los resultados [clave organizacion]- archivo Cómo subir información a nuestra plataforma?
Estructura de los datos Dentro de cada dataset, están enlistados los distintos archivos que forman un conjunto de datos. Estos son: Tabla de datos: Tabla donde se almacenan los datos objetivos y subjetivos. Cada fila representa una observación (una ciudad y un año, para los datos objetivos y una encuesta para los datos subjetivos). Cada columna representa una variable (cada indicador, para los datos objetivos y cada pregunta, para los subjetivos) Diccionario de Datos: Entrega una cantidad de información extra sobre las variables descritas en la tabla de datos (las columnas) Entre la información relevante se encuentra el anillo en el que están consideradas las variables, las posibles respuestas, entre otras. Cómo subir información a nuestra plataforma?
Proceso de subida de datos para una ciudad Cada año, nuevos datos se añadirán a las bases. En este sentido, son relevantes los datasets actualizados por años, los cuales llevarán a actualizar de manera automática los datos de los datos que componen todos los años. A continuación, el proceso recomendado para subir un nuevo año de datos, suponiendo que se parte del archivo del año corriente, tanto de datos subjetivos como objetivos: Cómo subir información a nuestra plataforma?
Proceso de subida de datos para una ciudad 1. Estandarizar el archivo actual de datos: Se recomienda revisar el archivo de diccionario de datos del año anterior y el archivo de datos del año anterior. a. La tabla actual deberá mostrar observaciones en las filas, y las variables/indicadores estarán en las columnas. b. Para cada pregunta se recomienda usar el diccionario de datos del archivo completo (en la organización de Cómo Vamos) para encontrar la relación entre la pregunta y los nombres de variables. Verificar además, el uso de la codificación de las respuestas, siendo solo necesario usar el código de la pregunta c. De no existir una variable en el diccionario de datos que responda a la pregunta o indicador seleccionado, favor de construir un código de pregunta de la forma: XX-YY- ###* donde XX es el anillo de la pregunta, YY son las primeras dos letras de la ciudad. d. Agregar los nombres de variables y sus características, a un archivo CSV, de la misma forma en la que se encuentran en el año anterior: considerando los anillos y los tipos de respuestas. Deberá también ser categorizada la variable con respecto al tipo de variable: i. Para los datos subjetivos: Separar las variables entre categóricas (aquellas que pueden responderse con distintas categorias) y de niveles (aquellas que se pueden contestar desde "muy malo" a "muy bueno" con una escala numérica. e. Nombrar los archivos objetivos y subjetivos conforme a los nombres de los archivos ya subidos en el dataset anual correspondiente: solo cambiando el año de la toma de datos. Guardar el archivo de excel como.csv. Verificar el encoding del archivo guardándolo con esa codificación Cómo subir información a nuestra plataforma?
Proceso de subida de datos para una ciudad 2. Subir los archivos de datos en el dataset correspondiente. Esto es, en la organización de la ciudad que se representa, sea en el archivo de datos objetivos o subjetivos. a) Para el dataset de Bogotá del 2015, se vería una pantalla así: Cómo subir información a nuestra plataforma?
Proceso de subida de datos para una ciudad b) Dar click en el botón de Manage c) Luego dar click en el botón resources d) Luego dar click en el botón add resource. e) Luego dar click en el botón de upload y seleccionar el archivo localizado en su máquina/dispositivo. f) Dar nombre al archivo de diccionário basándose en el nombre de archivo que acabó de subir (diccionario_encuestas_bogota_2015. csv / encuestas_bogota_2015.csv) 3. Tras terminar este proceso, comunicar al administrador que ya ha sido subido el archivo anual. Él ejecutará la rutina debida sobre el dataset anual para formar los archivos comprimidos para el resto de años. Cómo subir información a nuestra plataforma?
Calle 70 # 7-30 Bogotá, Colombia Tel: (57+1) 4000031 Información: comunicaciones@fcorona.org Línea Ética: seamosintegrosfundacion@fcorona.org GRACIAS