Una fuente de datos es un sistema donde se almacenan y administran los datos de su organización. Estos son los sistemas de registro como JIRA, bases de datos SQL, PIM o PLM. AEM Guides proporciona la función para conectarse con la fuente de datos y utilizar los datos de ellas.
También puede conectarse a archivos de datos JSON mediante un conector de archivo. Cargue el archivo JSON desde el equipo o navegue desde los recursos de Adobe Experience Manager. A continuación, cree fragmentos de contenido o temas utilizando los generadores.
Panel Fuentes de datos
Seleccione Fuentes de datos en el panel izquierdo para ver las fuentes de datos conectadas. El panel Fuentes de datos se abre y muestra todas las fuentes de datos conectadas.
En función de la configuración, el administrador puede configurar un conector de fuente de datos:
Si usa la versión de julio de 2023 o septiembre de 2023, aprenda a configurar un conector de origen de datos en la Guía de instalación y configuración de Cloud Service.
Verá las fuentes de datos para las que el administrador ha configurado el conector.
Mostrar vista de lista o vista de mosaico
Puede alternar entre la vista de lista o la vista de mosaico para ver los distintos orígenes de datos en forma de lista o como mosaicos.
Seleccione una fuente de datos para ver los generadores de fragmentos de contenido y los generadores de temas disponibles para la fuente de datos seleccionada.
Vista de lista
Lista de orígenes de datos conectados.
Vista en mosaico
Ver los orígenes de datos conectados como mosaicos.
Los datos de las fuentes de datos se pueden utilizar de dos maneras:
Insertar un fragmento de contenido
Crear un tema
Inserción de un fragmento de contenido desde la fuente de datos
AEM Guides proporciona la función para conectarse a la fuente de datos. Puede recuperar los datos, insertarlos en los temas y editarlos. Puede crear fácilmente un fragmento de contenido mediante el generador de fragmentos de contenido y reutilizarlo dentro de sus temas.
Realice los siguientes pasos para crear un fragmento de contenido mediante el generador de fragmentos de contenido e insertarlo en el tema:
Seleccionar orígenes de datos en el panel izquierdo para ver las fuentes de datos conectadas.
Seleccione una fuente de datos para ver los generadores de fragmentos de contenido disponibles para la fuente de datos seleccionada.
{width="300"}
El panel Fuentes de datos enumera los generadores de fragmentos de contenido disponibles.
Seleccione Agregar para agregar un nuevo generador de fragmentos de contenido. Se abre el panel Agregar generador de fragmentos de contenido.
Escriba la consulta en el cuadro de texto Consulta de datos. Seleccione Copiar consulta de ejemplo para copiar rápidamente una consulta de datos. En lugar de crear manualmente la consulta, puede copiar y pegar la consulta de ejemplo en el cuadro de texto Consulta de datos. A continuación, simplemente edite la consulta según sus necesidades de datos.
note note
NOTE
Experience Manager proporciona diferentes consultas de muestra para todos los recursos en los distintos orígenes de datos. Estos se asignan a la fuente de datos desde la que se recuperan los datos.
Si utiliza un conector de archivos, puede cargar el archivo JSON desde el equipo o examinar un archivo JSON desde los recursos de Adobe Experience Manager.
note note
NOTE
Verá las opciones para cargar o examinar archivos en lugar de una consulta de datos si utiliza un conector de archivo.
Seleccione la plantilla que se asigna al origen de datos en la lista desplegable Plantilla de asignación de datos. Las plantillas listas para usar del origen de datos seleccionado se muestran en la lista desplegable. Por ejemplo, puede ver la plantilla "sql-table" para la fuente de datos denominada "PostgreSQL".
note note
NOTE
Si el administrador ha configurado plantillas personalizadas, también se le mostrarán esas plantillas en la lista desplegable (según las configuraciones de ruta de plantilla realizadas por el administrador).
También puede utilizar las herramientas de Velocity en las plantillas. Más información sobre cómo usar las herramientas de Velocity.
La lista desplegable Recurso aparece para algunos conectores como Cliente REST, Salsify, Akeneo y ADO de Microsoft. Seleccione cualquier recurso del menú desplegable y conéctese a él para crear un fragmento de contenido o un tema con el generador.
note note
NOTE
El administrador puede configurar los recursos predeterminados o agregar recursos para varias direcciones URL al configurar los conectores de origen de datos.
Haga clic en Recuperar para recuperar los datos del origen de datos y aplicar la plantilla a los datos resultantes de la consulta SQL.
Los datos se pueden ver en la vista previa o en la vista de origen DITA.
La vista previa muestra cómo se mostrarán los datos cuando se inserten en el contenido. La vista previa muestra una pequeña fracción de los datos con el formato de la plantilla seleccionada. Por ejemplo:
Si ha seleccionado la plantilla de tabla SQL, puede ver los datos SQL en formato de tabla.
Si ha seleccionado la plantilla de lista ordenada por jira, puede ver una lista ordenada para los problemas de Jira.
La vista de origen muestra los datos en la vista de origen DITA.
{width="800"} *Agregar un generador de fragmentos de contenido. Ver los datos en modo de origen o vista previa.*
Para guardar los resultados de la consulta, escriba el nombre del generador y haga clic en AGREGAR. Se agrega a la lista un nuevo generador de fragmentos de contenido.
note note
NOTE
Debe seguir la convención de nomenclatura de archivos para el nombre del nuevo generador de contenido. No puede haber un espacio en el nombre del generador de fragmentos de contenido. Tampoco puede guardar un nuevo generador de contenido con el nombre de un generador de contenido existente. Se produce un error.
Opciones de un generador de fragmentos de contenido
Haga clic con el botón derecho en un generador de fragmentos de contenido para abrir Opciones. Con las opciones, puede realizar las siguientes operaciones:
Vista previa: utilice esta opción para abrir un panel y ver una pequeña fracción de cómo se muestran los datos en la salida.
Insertar: utilice esta opción para insertar el fragmento de contenido seleccionado en el tema abierto para su edición en el Editor Web. A medida que los datos se insertan como un fragmento, también puede editarlos dentro del tema en el Editor Web.
note note
NOTE
La opción Insertar sólo aparece mientras está editando un tema.
Editar: utilice esta opción para realizar cambios en el generador de fragmentos de contenido y guardarlo.
Eliminar: utilice esta opción para eliminar el generador de fragmentos de contenido seleccionado.
Duplicate: use esta opción para crear un duplicado o una copia del generador de fragmentos de contenido seleccionado. El duplicado se crea con un sufijo (como generator_1) de forma predeterminada.
Insertar un fragmento de consulta
También puede usar Insertar fragmento de consulta en la barra de herramientas principal para insertar el fragmento de datos en los temas. Puede seleccionar un generador en la lista desplegable, editar la consulta o cambiar la plantilla e insertar los datos en el tema.
Editar e insertar un fragmento de datos.
Creación de un tema mediante el generador de temas
Un generador de temas le ayuda a crear temas que contienen datos de sus fuentes. Puede crear rápidamente un generador de temas y, a continuación, generar los temas mediante el generador. Cada tema puede contener datos en varios formatos, como tablas, listas y párrafos. Por ejemplo, en un tema, puede agregar una tabla que incluya los detalles de todos los productos nuevos y una lista de todos los productos que se suspenderán para su venta.
El generador de temas puede crear los temas que contienen los datos y un mapa DITA para todos los temas. También puede <conref> estos temas en el contenido. Esto le permite mantener los datos sincronizados con la fuente de datos y actualizarlos fácilmente.
Crear un tema
Realice los siguientes pasos para crear un tema con el generador de temas:
Seleccione una fuente de datos para ver los generadores de fragmentos de contenido y los generadores de temas disponibles para la fuente de datos seleccionada.
{width="300"}
Agregar un generador de temas para un origen de datos conectado.
Seleccione Agregar y seleccione Generador de temas en el menú desplegable para agregar un nuevo generador de temas. Se abre el panel Agregar generador de temas.
Escriba los valores en los campos de las tres fichas siguientes del panel Agregar generador de temas:
Recuperar configuración
{width="300"}
Agregue los detalles de Consulta de datos, Plantilla de asignación de datos y Nodo raíz para el generador de temas y asígnele un nombre único en el panel Recuperar configuración.
Escriba la consulta en el cuadro de texto Consulta de datos. Seleccione Copiar consulta de ejemplo para copiar rápidamente una consulta de datos. En lugar de crear manualmente la consulta, puede copiar y pegar la consulta de ejemplo en el cuadro de texto Consulta de datos. A continuación, simplemente edite la consulta según sus necesidades de datos.
note note
NOTE
Experience Manager proporciona diferentes consultas de muestra para todos los recursos en los distintos orígenes de datos. Estos se asignan a la fuente de datos desde la que se recuperan los datos.
Si utiliza un conector de archivos, puede cargar el archivo JSON desde el equipo o examinar un archivo JSON desde los recursos de Adobe Experience Manager.
note note
NOTE
Verá las opciones para cargar o examinar archivos en lugar de una consulta de datos si utiliza un conector de archivo.
Seleccione la plantilla que se asigna al origen de datos en la lista desplegable Plantilla de asignación de datos.
note note
NOTE
Si el administrador ha configurado plantillas personalizadas, también se mostrarán dichas plantillas en la lista desplegable (según las configuraciones de ruta de plantilla realizadas por el administrador). Por ejemplo, se puede crear una plantilla de tema que contenga una lista ordenada, tablas, párrafos u otros elementos DITA.
Escriba el nodo raíz. Este es el nodo en el que desea acceder a los datos. A continuación, el generador de temas crea cada tema en el nivel definido en el nodo raíz. Por ejemplo, puede agregar "problemas" como nodo raíz en Jira. Por lo tanto, si una consulta devuelve 13 problemas, obtendrá 13 temas, un tema para cada problema.
Haga clic en Recuperar para recuperar los datos del origen de datos y aplicar la plantilla a los datos resultantes de la consulta SQL. La vista previa muestra una pequeña fracción de cómo aparece el tema en el formato de la plantilla seleccionada. Por ejemplo, puede ver un solo problema de Jira con todos los campos resultantes de la consulta.
Introduzca el nombre del generador del tema.
note note
NOTE
Debe seguir la convención de nomenclatura de archivos para el nombre del nuevo generador de temas. No puede haber un espacio en el nombre del generador de temas. Tampoco puede guardar un nuevo generador de temas con el nombre de un generador de temas existente. Se produce un error.
Configuración de salida
{width="300"}
Escriba la ruta de salida y los detalles de convención de nomenclatura de temas en el panel Configuración de salida. Genere un mapa DITA y asígnele el nombre.
Escriba los detalles de la ruta de acceso de salida en la que desea guardar los temas.
En la convención de nombres de temas, puede escribir un valor o una variable con etiquetas de velocidad. Los nuevos temas seguirán la convención. Por ejemplo, puede escribir $key para crear temas basados en claves Jira.
Habilite la opción Generar un mapa si desea crear un mapa que contenga todos los temas generados.
Introduzca el nombre del nuevo mapa DITA.
note note
NOTE
El generador de temas genera el mapa DITA en la misma ruta de salida que los temas.
Metadatos
Seleccione las propiedades de metadatos de la lista desplegable para pasarlas a los temas. La lista desplegable Nombre enumera las propiedades personalizadas y predeterminadas.
Por ejemplo, en la siguiente captura de pantalla, dc:description, dc:language, dc:title y docstate son las propiedades predeterminadas para las que puede definir los valores. Puede crear una propiedad personalizada como autor y definir su valor.
{width="300"}
Agregue las propiedades de metadatos en el panel Metadatos para pasarlas a los temas.
Escriba el nombre del generador y haga clic en Guardar para guardar los resultados de la consulta. Se agrega un nuevo generador de temas a la lista.
Haga clic en Guardar y generar para guardar el generador de temas y generar nuevos temas a partir del generador de temas.
{width="650"}
Generar nuevos temas a partir de un generador de temas existente.
note note
NOTE
Si los temas ya existen, el generador actualiza los datos de los temas existentes.
Opciones para un generador de temas
Haga clic con el botón secundario en un generador de temas para abrir Opciones. Con las opciones, puede realizar las siguientes operaciones:
Generar: esta opción genera los temas para el generador de temas seleccionado. También puede utilizar esta opción para actualizar los temas existentes. Se conecta a la fuente de datos y obtiene los datos actualizados. Al generar el contenido, esta opción está desactivada y se ve un cargador.
note note
NOTE
Si el tema ya existe, puede sobrescribir los datos del tema o guardarlos como una nueva versión.
Genere un tema y, si el archivo ya existe, guárdelo como una nueva versión o reemplácelo.
Ver registro: seleccione esta opción para ver el archivo de registro de generación de contenido. El archivo de registro se abre en una nueva pestaña. Puede ver los errores, advertencias, mensajes de información y excepciones en el archivo de registro. Esta opción está habilitada si ha generado el contenido para el generador de temas seleccionado.
Vista previa: utilice esta opción para abrir un panel y ver una pequeña fracción de cómo se muestran los datos en la salida.
Editar: utilice esta opción para cambiar y guardar el generador de temas. Esta opción está desactivada mientras se genera el contenido.
Eliminar: utilice esta opción para eliminar el generador de temas seleccionado. Esta opción está desactivada mientras se genera el contenido.
Duplicate: esta opción crea un duplicado o una copia del generador de temas seleccionado. El duplicado se crea con un sufijo (como topic-sample_1) de forma predeterminada.
Uso de las herramientas de Velocity en las plantillas de fuente de datos use-velocity-tools
Las plantillas de Experience Manager también admiten las herramientas de Velocity (versión 2.0). Estas herramientas le ayudan a aplicar varias funciones a los datos que obtiene de las fuentes de datos. Obtenga más información acerca del uso de herramientas de Velocity y las funciones que puede aplicar.
Siga estos pasos para utilizar una herramienta Velocity en una plantilla:
Edite una plantilla de Velocity en el editor web.
Agregue una herramienta y su función en formato <tool.function>. Por ejemplo:
Para generar un número aleatorio con la herramienta matemática, use $mathTool.random.
Para generar la suma de números con la herramienta matemática, use $mathTool.add(num1, num2).
Utilice la plantilla para crear un fragmento de contenido o un tema.
Después de aplicar la plantilla a los datos, se pueden ver los datos en la vista previa o en la vista de origen DITA.
Puede utilizar las siguientes herramientas dentro de las plantillas de Velocity para aplicar varias funciones a los datos que recupere del conector: -$alternatorTool
