DocumentaciónAyuda

Páginas importadas

Reconoce las páginas que llegan desde el repositorio de un producto, entiende por qué no se editan en Elion ITSM y revisa el informe de cada importación.

En esta página

Algunos espacios no se escriben en Elion ITSM: su contenido llega desde la documentación de un producto, que vive en archivos dentro de su repositorio. Cada vez que esa documentación cambia, se importa al espacio. Así la documentación tiene una sola fuente y nunca hay dos versiones distintas del mismo texto.

Cómo reconocer una página importada

Al abrir una página importada verás, arriba del contenido, el aviso Importada desde seguido de la ruta del archivo de origen. El aviso dice que la página se edita en el repositorio del producto y que en Elion ITSM queda en solo lectura.

En una página importada:

  • no aparecen los botones Editar, Subpágina, Mover, Archivar ni Eliminar;

  • si intentas abrir su editor, verás que la página se importa desde su archivo de origen y que aquí queda en solo lectura;

  • sí puedes leerla, ver su Historial, usar Copiar enlace y dejar Comentarios si puedes editar en el espacio. Marcar resuelto no aparece en estas páginas.

¿Por qué no se edita aquí? Si alguien corrigiera la página en Elion ITSM, la próxima importación traería otra vez el texto del repositorio y el cambio se perdería. Para corregir una página importada, avisa al equipo que mantiene la documentación del producto. Un comentario en la página es una buena forma de dejar el aviso.

Qué hace cada importación

Cada archivo del repositorio corresponde a una página, y se reconoce siempre por su ruta. En cada importación:

  • un archivo nuevo crea una página y la publica;

  • un archivo que cambió crea una versión nueva de su página y la publica, con la nota Importado en el historial;

  • un archivo sin cambios no toca su página;

  • un archivo que se borró archiva su página, no la elimina. Si el archivo vuelve, la página vuelve con su mismo número.

Si un archivo viene marcado como borrador en el repositorio, su página queda como borrador en vez de publicarse.

Todo queda en el historial de cada página, como cualquier otra publicación (ver Historial y versiones).

Ver el informe de las importaciones

Antes de empezar

  • Necesitas Administrar en Conocimiento (rol Administrador).

Pasos

  1. Entra al espacio.

  2. Presiona Importaciones. Se abre Importaciones de y el nombre del espacio.

  3. Revisa la lista. Cada importación muestra:

    • la fecha y hace cuánto se hizo;

    • el origen: Terminal, Zip subido o GitHub Action;

    • la versión del repositorio que se importó, si se indicó;

    • el resumen, por ejemplo «3 creadas · 1 actualizada · 12 sin cambios». También informa las archivadas. Si no hubo páginas, dice Sin páginas.

  4. Si la importación tuvo advertencias, presiona advertencias (con su número) para verlas. Cada una indica el archivo y qué pasó.

  5. Presiona Cerrar para salir.

Si el espacio nunca recibió una importación, verás Este espacio todavía no tiene importaciones.

Qué significan las advertencias

Las advertencias no detienen la importación: avisan de algo que conviene corregir en el repositorio del producto. Las más comunes son:

  • un elemento del texto que la base de conocimiento no admite y que se omitió;

  • una imagen que falta o un enlace roto;

  • un archivo que se ignoró porque no es una página ni una imagen, o porque pesa demasiado.

Revisa el informe después de cada cambio grande en la documentación. Corregir las advertencias en el repositorio deja las páginas completas en la siguiente importación.

Relacionado

Buscar en Elion ITSM

Escribe al menos 2 letras para buscar en Elion ITSM.

↑↓ moverse · Enter abrir · Esc cerrar