Skip to main content
Después de conectar tu cuenta de Adobe Experience Manager (AEM), los siguientes nodos están disponibles en Profound Agents. Úsalos para buscar, leer, crear y actualizar Content Fragments de AEM. Todas las operaciones se ejecutan en el entorno Author de AEM conectado y usan los permisos asignados a la cuenta técnica de la credencial OAuth.

Nodos disponibles

List Content Fragments

Recupera Content Fragments del entorno Author conectado.

Entradas obligatorias

  • AEM Instance: el entorno Author conectado

Entradas opcionales

  • Folder: limita la lista a una carpeta aprobada dentro de /content/dam
  • References: controla si los fragmentos vinculados se devuelven e hidratan
  • Limit: cantidad de resultados que se devuelven; el valor predeterminado es 25 y el máximo es 50
  • Cursor: un cursor de paginación de la salida de un nodo List o Search anterior, que se usa para obtener la siguiente página de resultados
  • Projection: usa summary cuando solo necesites datos de resumen

Salida

La salida contiene los Content Fragments coincidentes y, cuando hay más resultados disponibles, un cursor de paginación para la siguiente página.

Conceptos clave

AEM Instance

El entorno Author de AEM conectado. Selecciónalo antes de elegir un modelo, una carpeta o un fragmento.

Content Fragment Model

El esquema de AEM que define los campos, tipos, valores obligatorios y contenido permitido de un fragmento. El modelo debe estar habilitado y permitido por la política de la carpeta de destino.

Rutas del DAM

Las carpetas de Content Fragments usan rutas del repositorio dentro de /content/dam. Los permisos y las políticas de las carpetas controlan qué contenido puede leer o modificar Profound.

Content Fragment ID

Las operaciones de la API de AEM identifican un Content Fragment por su UUID. El selector de Profound muestra información del fragmento que se puede buscar y proporciona el UUID al nodo.

ETag

Un ETag es un identificador único de una versión específica de los datos de un Content Fragment. Pásalo de un nodo Get Content Fragment al nodo Update Content Fragment para evitar que el flujo de trabajo sobrescriba silenciosamente un cambio realizado después de leer el fragmento.

Paginación

Los nodos List y Search devuelven hasta 50 fragmentos por solicitud. Cuando la salida contiene un cursor, proporciónalo al siguiente nodo List o Search para recuperar la siguiente página de resultados.

Content Fragment hidratado

Un Content Fragment que contiene todos los valores de sus campos, en lugar de solo los IDs y las URLs básicos.

References

References controla cómo se incluyen los fragmentos vinculados. Los modos hidratado y de todas las referencias pueden devolver respuestas más grandes, así que úsalos solo cuando el flujo de trabajo necesite contenido vinculado.

Solución de problemas

Un selector de carpeta, fragmento o modelo está deshabilitado o vacío

Selecciona primero una AEM Instance. Si el selector sigue vacío, verifica que la cuenta técnica de tu credencial OAuth pueda leer el modelo, la carpeta o el fragmento correspondiente. Obtén más información en la guía de solución de problemas de configuración.

La búsqueda devuelve un error de consulta no válida

Restablece el filtro Folder a /content/dam o agrega otro filtro. Cuando uses Raw Query, incluye un objeto JSON no vacío y usa campos de filtro y ordenamiento compatibles con Adobe.

El nodo Create informa un campo desconocido o un valor no válido

Selecciona el modelo y usa el formato Structured siempre que sea posible. Si tienes que usar el formato Raw JSON, asegúrate de que cada clave coincida con el nombre de campo del modelo de AEM y proporciona un valor con el tipo y la cardinalidad que espera el modelo.

El nodo Update informa que no hay cambios

Ingresa al menos un valor en Title, Description o en un campo del modelo. Las entradas vacías conservan el contenido actual.

El nodo Update informa un conflicto

El fragmento cambió después de que AEM emitió el ETag. Vuelve a ejecutar el nodo Get Content Fragment, revisa el contenido más reciente y luego aplica la actualización con el nuevo ETag.

Un nodo devuelve un error de permisos

Confirma que el grupo de servicios de la cuenta técnica tenga permiso para esa operación y esa ruta del DAM exactas. El acceso de lectura puede funcionar mientras Create o Update siguen bloqueados. Para agregar permisos a carpetas y archivos específicos de tu entorno de AEM, sigue la guía de Adobe Product Profile and Services user group permission management.

Solo se devuelve la primera página de resultados

Usa el cursor que devuelve el nodo List o Search como el Cursor de la siguiente solicitud. Cada página puede contener como máximo 50 resultados.

Recursos adicionales