Portal Manager: Guides

Toda la documentación que desee poner a disposición pública se puede gestionar mediante Guides.

Guides funciona como una plataforma de desarrollo de sitios web, lo que le permite crear libremente contenido que tenga sentido para usted y sus asociados de negocio.

Vea sobre la página Guides en el Developer Portal.

Creando una nueva página

Siga los pasos a continuación para crear una nueva página de Guides para su portal.

  1. Haga clic en + junto a Pages.
    También puede crear subpáginas. Haga clic en + junto al nombre de una página existente y la nueva página se creará como su "hija".

    detalle de una pantalla de Guides con lista de páginas

  2. Introduzca el nombre de la página. Este campo es obligatorio.
    parte de la pantalla con el campo del nombre de la página en el centro de la imagen

  3. Seleccione el rol (role) que el usuario deberá tener para visualizar y acceder a la guía. Este campo es obligatorio. Lea sobre asignación de roles.

    parte de la pantalla guides con el campo role en el centro

  4. Cree el nuevo contenido de la página en el campo ubicado debajo de barra de herramientas.
    El texto debe tener un mínimo de 3 caracteres y un tamaño máximo de 5 MB.

  5. Haga clic en SAVE o BACK.
    Si regresa sin guardar, los cambios se perderán.

  6. Habilite Publish page para que se publiquen los cambios.
    Los pasos 6 y 7 no son obligatorios. Puede publicar su página en otro momento.

  7. Haga clic en icono que representa el enlace para copiar el enlace de la página creada.

    Animación que muestra la secuencia para crear y publicar una nueva página


Identifique qué páginas aún no se han publicado buscando imagen de una nube con una línea diagonal que la atraviesa junto al nombre de la página.

Su página permanecerá publicada mientras Public page esté habilitado.

Las actualizaciones realizadas y guardadas se aplicarán a la página publicada cada vez que haga clic en SAVE — no es necesario volver a publicarla.

Puede reorganizar el orden de las páginas de la lista y también cambiar la jerarquía convirtiendo las subpáginas en páginas y viceversa. Simplemente haga clic y arrastre la página a la posición deseada.

Asignación de roles

La asignación de roles permite controlar de forma precisa quién puede visualizar y acceder a cada guía. Con este recurso, los administradores definen permisos específicos, garantizando que los usuarios vean solo el contenido relevante para sus funciones.

Principales ventajas:

  • Mayor protección para informaciones sensibles y configuraciones del sistema.

  • Personalización granular de permisos conforme a las necesidades de cada grupo.

  • Control eficiente sobre la disponibilidad del contenido, sea público o restringido.

Los roles se configuran durante la creación/edición de una guía en el Portal Manager.

Hay dos roles predefinidos en el sistema:

  • Authenticated: rol predeterminado (default role), que permite el acceso a la guía solo por usuarios autenticados.

  • Public: rol que permite el acceso a la guía por cualquier usuario, incluyendo no autenticados (sin necesidad de inicio de sesión).

Usted puede aún crear roles personalizados definiendo permisos dedicados para el consumo de diferentes públicos (internos, socios, clientes, etc.).

Para crear un rol personalizado, siga los pasos a continuación:

  1. Acceda a la pantalla Settings por el menú lateral izquierdo.

  2. Seleccione la pestaña Roles en la parte superior de la pantalla.

  3. Haga clic en + NEW ROLE para crear un nuevo rol.

Consulte la documentación sobre la creación de nuevos roles.
  • Los roles personalizados exigen autenticación del usuario.

  • Es posible asociar uno o más roles a cada guía.

  • Las guías con el rol "public" quedan visibles para todos los usuarios, incluyendo no autenticados. Esta visibilidad se extiende automáticamente a todas las subguías.

  • Las guías con roles diferentes de "public" quedan visibles solo para usuarios autenticados que posean al menos uno de los roles configurados. Esta restricción se aplica tanto a la guía como a sus subguías.

  • Los usuarios que no posean ninguno de los roles configurados no conseguirán visualizar la guía ni sus subguías.

Cómo funciona la herencia de roles y visibilidad entre guías

  • Las subguías heredan automáticamente la visibilidad de la guía principal y, por eso, no muestran la opción de configuración de roles.

  • Al mover una guía principal dentro de otra guía, se convierte en una subguía y pasa a usar automáticamente los roles de la nueva guía padre.

  • Al mover una subguía a otra guía principal, asume automáticamente los roles del nuevo padre.

  • Al transformar una subguía en guía principal, mantiene los roles anteriores, evitando liberar acceso indebido a usuarios sin permiso.

Editar una página

Independientemente de si la página está publicada o no, siempre puede editarla.

Haga clic en el nombre de la página y luego haga clic en EDIT.

Eliminando una página

Para eliminar una página, haga clic en el nombre de la página, luego haga clic en imagen de una papelera.

Alternativamente, puede simplemente anular la publicación de la página. Para hacer esto, haga clic en el nombre de la página y luego deshabilite Publish page.

Barra de herramientas

La barra de herramientas se muestra al crear una nueva página o editar una existente.

Le da acceso a varios comandos para formatear y personalizar su página.

imagen de la barra de herramientas

Comando

Descripción

Estilo de párrafo

cuadro para elegir el estilo de párrafo

Define el estilo de formato para un párrafo o una oración. Elija entre: párrafo simple y tres niveles de encabezados.

Código fuente

icono que indica el código fuente y la palabra Source

Muestra la página en código fuente para que pueda ver o editar así

Negrita

letra B mayúscula en negrita

Aplica formato de negrita al texto seleccionado. También se puede usar el atajo Ctrl+B.

Itálico

letra I mayúscula en itálico

Pone en itálico el texto seleccionado. También se puede usar el atajo Ctrl+I.

Tachado

letra S mayúscula tachada

Aplica formato de tachado al texto seleccionado. También se puede usar el atajo Ctrl+Shift+X.

Código

signos mayor que y menor que

Marca una palabra o parte de un párrafo como fragmento de código.

Bloque de código

signos mayor que y menor que en la parte inferior de una página con una lista con viñetas

Marca un párrafo como fragmento de código. Seleccione el idioma del código en el menú desplegable.

Enlace

icono de un enlace

Inserta enlace. Informe el enlace y haga clic en la marca de verificación para guardarlo o en la X para cancelar.

Lista con viñetas

icono para lista con viñetas

Aplica formato de lista con viñetas al texto seleccionado.

Lista numerada

icono para lista numerada

Aplica formato de lista numerada al texto seleccionado.

Lista de tareas

icono de lista de tareas

Inserta casillas de verificación delante de cada línea del texto seleccionado.

Imagen

icono para imagen

Abra el cuadro de diálogo para seleccionar y cargar un archivo.

Cita en bloque

imagen de comillas dobles

Aplica formato de cotización en bloque: sangra el bloque y lo marca con una línea vertical al lado izquierdo del texto.

Insertar tabla

icono que representa una tabla de hoja de cálculo

Determine el tamaño de la tabla para insertarla en el texto

Caracteres especiales

Letra griega omega

Elija un carácter especial para insertarlo en el texto

Deshacer y rehacer

tres puntos dispuestos verticalmente

Muestra los comandos de deshacer y rehacer. También se pueden utilizar los atajos Ctrl+Z y Ctrl+Y.

Página publicada

El enlace a la página publicada está disponible en la esquina superior derecha de la pantalla, junto a Publish page, como se muestra en la imagen a continuación.

pantalla de guías del portal para desarrolladores con página abierta para editar

El acceso a las páginas publicadas en Guías es público. No se requiere acceso de desarrollador.

Las páginas están disponibles en su portal, en Guías, como se muestra en la imagen a continuación.

Pantalla del portal con páginas publicadas destacando guides

Thanks for your feedback!
EDIT

Share your suggestions with us!
Click here and then [+ Submit idea]