Introducción
Atlassian Confluence es una herramienta para gestionar la documentación: aquí se pueden compartir en formato web textos e imágenes que ayuden a informar y documentar, con un aspecto muy similar a la Wikipedia.
La UPV utiliza este producto de manera integrada con Atlassian JIRA, de manera que se puede conseguir que querer generar un Gregal, al usuario se le ofrezcan usuarios en función del texto escrito. Esta es la parte que nos interesa destacar a nosotros.
Lo primero será acceder al sitio web https://wiki.upv.es . Para ello nos fijaremos que tenemos que iniciar sesión: al estar habilitada la autenticación integrada, si previamente nos hemos identificado en la Intranet de la UPV, no nos pedirá de nuevo las credenciales. En caso que no sea así, nos pedirá que nos identifiquemos:
- En la parte superior, podemos encontrar la barra principal. En la cual podemos consultar el directorio de espacios, las personas, herramienta de búsqueda, perfil de usuario…
- En la parte izquierda de la pantalla, nos aparecen los espacios del sitio para poder navegar por la información.
- En la parte derecha nos aparece el flujo de actividad de Confluence en la cual podemos ver las últimas páginas actualizadas.
Una vez que nos identifiquemos, en la parte superior derecha nos aparecerá nuestra foto si la hemos incorporado, o bien un icono de usuario en el que podemos hacer click y ver nuestro perfil. Nos iremos a "Espacios" para ver sobre qué espacios tenemos permisos:
Terminología
- Página: una página es lo que estás viendo en estos momentos. Tiene una dirección propia, y contiene texto e imágenes. Está sometida a una jerarquía, pudiendo tener páginas hijas y páginas padres.
- Etiqueta: cada página puede etiquetarse para permitir luego organizar el contenido. Se trata de una palabra o varias que libremente añade cada persona con permisos a las páginas. Por ejemplo, la etiqueta "gregal" ha sido añadida a esta página. Se visualizan al final de la misma.
- Espacio: una página puede pertenecer a un único espacio. Un espacio es como una carpeta. Tendrá su URL específica y todas las páginas de ese espacio serán navegables a través de los menús de navegación de la parte izquierda.
- Permisos: sobre cada página y sitio puede aplicarse restricciones o permisos de visualización para personas o grupos, así que puede que en esta Wiki haya
Crear páginas
Para crear, tendremos que posicionarnos en la página desde la que queremos que cuelgue y darle al "Crear". Podemos crearla en el raíz del espacio, o colgando dentro de una página ya existente:
En ese momento nos aparecerá un menú, donde tendremos:
- Indicar cuál es el espacio al que pertenecerá
- Indicar que queremos una “página en blanco” (podemos elegir otros tipos de página)
- Pulsar el botón “crear”:
Exportar/importar
Podemos importar un documento Word directamente al Confluence. Para ello nos iremos a los puntos que hay en la parte superior derecha y le diremos "Importar documento de Word:
Nos preguntará por un título para la página, y si queremos reemplazar la página actual, o bien crearla como página hija de la página actual:
En los mismos tres puntos dónde está "Importar documento de Word" tenemos la opción de exportar la página a Word o a PDF.
Permisos y visibilidad
Al lado del título de la página, hay un candado abierto (sin restricciones) o cerrado (con restricciones) que nos indica si hay limitaciones para visualizar una página:
Al hacer click en ese candado, podremos ver y cambiar los permisos para la página y sus páginas hijas (ya que los permisos de este nivel, se aplican sobre los hijos):
Etiquetas
Las etiquetas se ven en la parte derecha al final de la página (en este ejemplo no hay etiquetas):
Esta página que estás leyendo tiene la etiqueta "gregal". Trata de localizarla al final.
Si quieres añadir/modificar las etiquetas, y tienes permiso para ello, lo puedes hacer al lado del título: se abrirá una ventana de diálogo en la que tienes las etiquetas actuales y la posibilidad de añadir más:
Una etiqueta aparecerá en los resultados de las búsquedas, y como verás un poco más abajo, resulta útil en la integración con JIRA.
Integración con JIRA
El espacio de la Wiki FAQS GREGAL lo tenemos asociado a Gregal Centros y a Gregal.
Esto quiere decir que cuándo alguien va a poner un Gregal Centros, si suele ser algo que se puede autoresponder leyendo una entrada de la Wiki, haremos ver en crearla y etiquetarla de manera que le aparezca cuándo vaya a poner ese Gregal y evitarnos la entrada:
Para ello, necesitas terner permisos en FAQS GREGAL → CENTROS. Hemos asignado permisos a todos los informáticos de los centros.