DocumentaciónAEM GuidesDocumentación de AEM Guides

API de REST para la administración de resultados id175UB30E05Z

Last update: Fri Nov 21 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

Creado para:

  • Experimentado
  • Desarrollador

Las siguientes API de REST están disponibles para administrar los resultados en AEM Guides.

Obtener todos los ajustes preestablecidos de salida para un mapa DITA get-output-presets-dita-map

Método POST que recupera todos los ajustes preestablecidos de salida configurados para un mapa DITA.

URL de solicitud:
http://<aem-guides-server>: <port-number>/bin/publishlistener

Parámetros:

Nombre
Tipo
Requerido
Descripción
:operation
Cadena
Sí
Nombre de la operación a la que se llama. El valor de este parámetro es getalloutputs.
Nota: El valor no distingue entre mayúsculas y minúsculas.
sourcePath
Cadena
Sí
Ruta absoluta del fichero de mapa DITA.

Valores de respuesta:
Devuelve una matriz de objetos JSON Output Preset, cada uno de los cuales contiene los siguientes elementos:

Elemento
Descripción
outputName
Nombre del ajuste preestablecido de salida. Los nombres de salida son únicos en el ámbito del mapa DITA en el que están definidos.
outputType
Tipo de salida generada con este ajuste preestablecido, por ejemplo AEM Site, PDF, EPUB u otro. Las opciones disponibles son:
- AEMSITE
- PDF
- HTML5
- EPUB
- PERSONALIZADO
outputTitle
Un nombre descriptivo para la configuración del ajuste preestablecido de salida. Se utiliza para definir el valor de la propiedad Nombre del valor para el ajuste preestablecido de salida.
ditaValPathList
Matriz de rutas de archivo DITAVAL que se utilizarán para generar la salida deseada.
targetPath
Ruta de acceso en la que se publica o almacena el resultado.
siteName
(Para salida del sitio AEM) Nombre del sitio AEM.
templatePath
(Para salida del sitio AEM) Ruta de acceso del nodo de plantilla que se utilizará para generar la salida deseada.
searchScope
Especifique el ámbito de la operación de búsqueda. El valor de este parámetro debe establecerse en local.
generateTOC
(Para salida del sitio AEM) Especifique si se genera una TDC (true) o no (false).
generateBreadcrumbs
(Para salida del sitio AEM) Especifique si las rutas de exploración se generan (true) o no (false).
overwriteStrategy
(Para salida del sitio AEM) Especifique si los archivos del destino se sobrescriben (true) o no (false).
pdfGenerator
Especifique el motor de generación de PDF que desea utilizar. Los valores posibles son:
- DITAOT
- FMPS
NOTE
El elemento DitaValPath ya no es compatible.

Crear ajuste preestablecido de salida

Método POST que crea un nuevo ajuste preestablecido de salida para un mapa DITA.

URL de solicitud:
http://<aem-guides-server>: <port-number>/bin/publishlistener

Parámetros:

Nombre
Tipo
Requerido
Descripción
:operation
Cadena
Sí
Nombre de la operación a la que se llama. El valor de este parámetro es createoutput.
Nota: El valor no distingue entre mayúsculas y minúsculas.
sourcePath
Cadena
Sí
Ruta absoluta del fichero de mapa DITA.
outputTitle
Cadena
Sí
Un nombre descriptivo para la configuración del ajuste preestablecido de salida. Se usa para definir el valor de la propiedad Nombre de configuración para el ajuste preestablecido de salida.
Nota: Cuando se crea un nuevo ajuste preestablecido de salida, el sistema back-end genera un nombre único para el ajuste preestablecido de salida a partir del título dado.
outputType
Cadena
Sí
Tipo de salida generada con este ajuste preestablecido, por ejemplo AEM Site, PDF, EPUB u otro. Las opciones disponibles son:
- AEMSITE
- PDF
- HTML5
- EPUB
- PERSONALIZADO

Valores de respuesta:

Elemento
Descripción
outputName
Un nombre único para el ajuste preestablecido de salida recién creado. Este nombre se deriva del valor del parámetro outputTitle.

Guardar ajuste preestablecido de salida

Un método POST que guarda los cambios realizados en un ajuste preestablecido de salida.

URL de solicitud:
http://<aem-guides-server>: <port-number>/bin/publishlistener

Parámetros:

Nombre
Tipo
Requerido
Descripción
:operation
Cadena
Sí
Nombre de la operación a la que se llama. El valor de este parámetro es saveoutput.
Nota: El valor no distingue entre mayúsculas y minúsculas.
sourcePath
Cadena
Sí
Ruta absoluta del fichero de mapa DITA.
outputObj
Cadena
Sí
Un objeto JSON que contiene propiedades del ajuste preestablecido de salida que se está actualizando. La propiedad outputObj.outputName contiene el nombre del ajuste preestablecido de salida que se va a actualizar. Para ver el formato del objeto JSON, consulte la tabla Valores de respuesta en Obtener todos los ajustes preestablecidos de salida para un mapa DITA.

Valores de respuesta:
Devuelve una respuesta HTTP 200 (Correcto).

Obtener un ajuste preestablecido de salida específico

Un método POST que recupera un ajuste preestablecido de salida existente.

URL de solicitud:
http://<aem-guides-server>: <port-number>/bin/publishlistener

Parámetros:

Nombre
Tipo
Requerido
Descripción
:operation
Cadena
Sí
Nombre de la operación a la que se llama. El valor de este parámetro es getoutput.
Nota: El valor no distingue entre mayúsculas y minúsculas.
sourcePath
Cadena
Sí
Ruta absoluta del fichero de mapa DITA.
outputName
Cadena
Sí
Nombre del ajuste preestablecido de salida para el que se deben recuperar los detalles.

Valores de respuesta:

Elemento
Descripción
outputName
Nombre del ajuste preestablecido de salida. Los nombres de salida son únicos en el ámbito del mapa DITA en el que están definidos.
outputType
Tipo de salida generada con este ajuste preestablecido, por ejemplo AEM Site, PDF, EPUB u otro. Las opciones disponibles son:
- AEMSITE
- PDF
- HTML5
- EPUB
-
PERSONALIZADO
outputTitle
Un nombre descriptivo para la configuración del ajuste preestablecido de salida. Se utiliza para definir el valor de la propiedad Nombre del valor para el ajuste preestablecido de salida.
ditaValPathList
Matriz de rutas de archivo DITAVAL que se utilizarán para generar la salida deseada.
targetPath
Ruta de acceso en la que se publica o almacena el resultado.
siteName
(Para salida del sitio AEM) Nombre del sitio AEM.
siteTitle
(Para salida del sitio AEM) Título del sitio AEM.
templatePath
(Para salida del sitio de AEM) Ruta del nodo de plantilla que se utilizará para generar la salida deseada.
searchScope
Especifique el ámbito de la operación de búsqueda. El valor de este parámetro debe establecerse en local.
generateTOC
(Para la salida del sitio de AEM) Especifique si se genera una TDC (true) o no (false).
generateBreadcrumbs
(Para la salida del sitio de AEM) Especifique si las rutas de exploración se generan (true) o no (false).
overwriteFiles
(Para la salida del sitio de AEM) Especifique si los archivos de destino se sobrescriben (true) o no (false).
pdfGenerator
Especifique el motor de generación de PDF que desea utilizar. Los valores posibles son:
- DITAOT
- FMPS
NOTE
El elemento DitaValPath ya no es compatible.

Generar salida

Método de GET que genera resultados mediante uno o varios ajustes preestablecidos de salida.

URL de solicitud:
http://<aem-guides-server>: <port-number>/bin/publishlistener

Parámetros:

Nombre
Tipo
Requerido
Descripción
operation
Cadena
Sí
Nombre de la operación a la que se llama. El valor de este parámetro es GENERATEOUTPUT.
Nota: El valor distingue entre mayúsculas y minúsculas.
source
Cadena
Sí
Ruta absoluta del fichero de mapa DITA.
outputName
Cadena
Sí
Nombre de los ajustes preestablecidos de salida(s) que se utilizarán para generar la salida. Se pueden especificar varios ajustes preestablecidos de salida utilizando un delimitador de barra vertical ("|"), por ejemplo aemsite|pdfoutput.

Valores de respuesta:
Devuelve una respuesta HTTP 200 (Correcto).

Generar salida incremental

Método de GET que genera un resultado incremental para un sitio de AEM mediante uno o varios ajustes preestablecidos de salida.

URL de solicitud:
http://<aem-guides-server>: <port-number>/bin/publishlistener

Parámetros:

Nombre
Tipo
Requerido
Descripción
operation
Cadena
Sí
Nombre de la operación a la que se llama. El valor de este parámetro es INCREMENTALPUBLISH.
Nota: El valor distingue entre mayúsculas y minúsculas.
contentPath
JSON
Sí
Ruta absoluta del fichero de mapa DITA y de los ficheros de tema junto con el nombre de los ajustes preestablecidos de salida. Utilice el siguiente ejemplo como componente:
{
   {
   "ditamap":
      "/content/dam/sample/sample.ditamap",
   "topics": [
      "/content/dam/sample/topic1.xml",
      "/content/dam/sample/topic2.xml"
         ],
   "fullMaps": [
      "/content/dam/sample/submap.ditamap"
      ],
   "maps": [
      "/content/dam/sample/keyspace.ditamap"
      ],
   "outputs": [
      "aemsite"
      ]
   }
}
  • El atributo ditamap toma la ruta absoluta del mapa DITA que se utiliza para generar la salida.
  • El atributo topics toma una matriz de temas que se actualizan y deben volver a publicarse.
  • El atributo fullMaps contiene la ruta de los archivos de asignación (como los submapas fragmentados) que son necesarios junto con sus temas para la generación de resultados incrementales.
  • El atributo maps contiene la ruta de acceso de los archivos de asignación (para resolver referencias del espacio de claves) que se extraen en el disco sin temas.
  • El atributo outputs toma una matriz de nombres de ajustes preestablecidos de salida que se utilizan para generar el resultado.

Valores de respuesta:
Devuelve una respuesta HTTP 200 (Correcto).

Eliminar ajuste preestablecido de salida

Un método POST que elimina un ajuste preestablecido de salida.

URL de solicitud:
http://<aem-guides-server>: <port-number>/bin/publishlistener

Parámetros:

Nombre
Tipo
Requerido
Descripción
:operation
Cadena
Sí
Nombre de la operación a la que se llama. El valor de este parámetro es deleteoutput.
Nota: El valor no distingue entre mayúsculas y minúsculas.
sourcePath
Cadena
Sí
Ruta absoluta del fichero de mapa DITA.
outputName
Cadena
Sí
Nombre del ajuste preestablecido de salida que se va a eliminar.

Valores de respuesta:
Devuelve una respuesta HTTP 200 (Correcto).

recommendation-more-help
11125c99-e1a1-4369-b5d7-fb3098b9b178