¿Como embeber una tabla de documentos de Athento en una web o aplicación externa?

Athento permite embeber una tabla o listado de documentos en una web o aplicación externa.

Para integrar Athento de esta manera, debes acceder a la configuración avanzada y crear una Application en el modelo OAuth de Django.

• En la vista avanzada, busca  Django OAuth.
  
• Utiliza el botón + para añadir una Application. Athento generará un Client id y un Client secret de forma automática. Ajusta las siguientes configuraciones:
  • • Authorization Grant Type: marca la opción Client credentials.
    • User: este es el usuario que se utilizará para la consulta de los documentos, por tanto, este usuario debe tener permisos sobre los documentos. Selecciona aquí el usuario con el que trabajará el embebible. Te recomendamos la creación de un usuario específico para ello.
      
      
      

Elegir los datos que se mostrarán en la tabla.

Para indicar que datos tendremos que hacer una consulta similar a el resulset de la API V1 de Athento. Por lo que necesitaremos el body de esta petición indicándole la consulta ATQL. Ejemplo

{
 "query": "SELECT * FROM Document"
}

Para asegurar que no se pueda cambiar la query deseada y que la comunicación sea segura debes hacer dos cosas con esta query(el body completo, incluir las llaves):

• Encriptar. Debes encriptar el body completo, con la misma clave de encriptación que se tiene en athento.
• Obtener el hash. Obtener el hash de la query(utilizando sha256), al recibir Athento la petición comprobará el hash, asegurando así una comunicación segura y fiable entre nuestra web y Athento.

Introducir la tabla en nuestra web.

Una vez obtenidos los datos anteriores ya podemos introducir todo los datos de la tabla en nuestra web. De igual forma a, rellenando los datos que hemos obtenido anteriormente:

<div id="athento-document-list-root"
data-api-base-url= '<Introducir la url de nuestra instancia de Athento>'
data-search-body='<Introducir la query encriptada>'
data-hash-integrity='<Introducir el hash de la query>'
data-client-id='<Introducir el client id>'
data-client-secret='<Introducir el client secret>'
></div>
<link rel="stylesheet" href="<URL de nuestra instancia de Athento>/site_media/athento-document-table/athento-document-table.css">
<script type="text/javascript" src="<URL de nuestra instancia de Athento>/site_media/athento-document-table/athento-document-table.js"></script>

Nota: Debe ser aceptada la url de nuestra web en la instancia de Athento,