Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
# Drupal
**nota**
El conector de Drupal seguirá siendo totalmente compatible con los clientes actuales hasta el 31 de mayo de 2026. Si bien este conector ya no está disponible para los nuevos usuarios, los usuarios actuales pueden seguir utilizándolo sin interrupciones. Desarrollamos de forma continua nuestra cartera de conectores para ofrecer soluciones más escalables y personalizables. Para futuras integraciones, le recomendamos que valore el marco de conectores personalizados de Amazon Kendra[1], diseñado de manera más flexible para una variedad más amplia de casos de uso empresariales.
Drupal es un sistema de administración de contenidos (CMS) de código abierto que se puede utilizar para crear sitios web y aplicaciones web. Puedes usarlo Amazon Kendra para indexar lo siguiente en Drupal:
+ Contenido: artículos, páginas básicas, bloques básicos, tipos de contenido definidos por el usuario, tipos de bloques definidos por el usuario, tipos de contenido personalizados, tipos de bloques personalizados
+ Comentario: para cualquier tipo de contenido y tipo de bloque
+ Adjuntos: para cualquier tipo de contenido y tipo de bloque
Puedes conectarte Amazon Kendra a tu fuente de datos de Drupal mediante la [Amazon Kendraconsola](https://console.aws.amazon.com/kendra/) o la [TemplateConfiguration](https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html)API.
Para solucionar problemas de su conector de fuente de datos de Amazon Kendra Drupal, consulte. [Solución de problemas con los orígenes de datos](troubleshooting-data-sources.md)
**Topics**
+ [Características admitidas](#supported-features-drupal)
+ [Requisitos previos](#prerequisites-drupal)
+ [Instrucciones de conexión](#data-source-procedure-drupal)
+ [Notas](#drupal-notes)
## Características admitidas
Amazon KendraEl conector de fuente de datos de Drupal admite las siguientes funciones:
+ Asignaciones de campos
+ Filtrado de contexto de usuario
+ Filtros de inclusión/exclusión
+ Sincronizaciones completas e incrementales del contenido
+ Nube privada virtual (VPC)
## Requisitos previos
Antes de que pueda utilizarla Amazon Kendra para indexar su fuente de datos de Drupal, realice estos cambios en su Drupal y en sus cuentas. AWS
**En Drupal, asegúrese de que:**
+ Ha creado una cuenta de Drupal (Standard) Suite y un usuario con un rol de administrador.
+ Ha copiado el nombre de su sitio de Drupal y configurado una URL de host. Por ejemplo, *https:///*.
+ Ha configurado credenciales de autenticación básicas que contienen un nombre de usuario (nombre de usuario de inicio de sesión en el sitio web de Drupal) y una contraseña (contraseña del sitio web de Drupal).
+ **Recomendado: configuré** un token de credenciales OAuth 2.0. Use este token junto con la contraseña de Drupal, el ID de cliente, el secreto de cliente, el nombre de usuario (nombre de usuario de inicio de sesión en el sitio web de Drupal) y la contraseña (contraseña del sitio web de Drupal) para conectarse a Amazon Kendra.
+ Ha añadido los siguientes permisos a la cuenta de Drupal utilizando un rol de administrador:
+ administer blocks
+ administer block\$1content display
+ administer block\$1content fields
+ administer block\$1content form display
+ administer views
+ view user email addresses
+ view own unpublished content
+ view page revisions
+ view article revisions
+ view all revisions
+ view the administration theme
+ access content
+ access content overview
+ access comments
+ search content
+ access files overview
+ access contextual links
**nota**
Si hay tipos de contenido definidos por el usuario o tipos de bloques definidos por el usuario, o si se añaden vistas y bloques al sitio web de Drupal, se les debe proporcionar acceso de administrador.
**En el tuyoCuenta de AWS, asegúrate de tener:**
+ [Creó un Amazon Kendra índice](https://docs.aws.amazon.com/kendra/latest/dg/create-index.html) y, si usa la API, anotó el ID del índice.
+ [Creó un IAM rol](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html#iam-roles-ds) para su fuente de datos y, si usa la API, anotó el ARN del IAM rol.
**nota**
Si cambias el tipo de autenticación y las credenciales, debes actualizar tu IAM rol para acceder al ID AWS Secrets Manager secreto correcto.
+ Ha guardado sus credenciales de autenticación de Drupal en un secreto de AWS Secrets Manager y, si utiliza la API, ha anotado el ARN del secreto.
**nota**
Le recomendamos que actualice o modifique con regularidad las credenciales y el secreto. Por su propia seguridad, proporcione solo el nivel de acceso necesario. **No** se recomienda volver a utilizar las credenciales y los datos secretos en varios orígenes de datos ni en las versiones 1.0 y 2.0 del conector (si procede).
Si no tienes un IAM rol o secreto existente, puedes usar la consola para crear un nuevo IAM rol y un Secrets Manager secreto al conectar tu fuente de datos de Drupal. Amazon Kendra Si utiliza la API, debe proporcionar el ARN de un IAM rol y un Secrets Manager secreto existentes y un ID de índice.
## Instrucciones de conexión
Para conectarse Amazon Kendra a su fuente de datos de Drupal, debe proporcionar los detalles de sus credenciales de Drupal para que Amazon Kendra pueda acceder a sus datos. Si aún no ha configurado Drupal, consulte. Amazon Kendra [Requisitos previos](#prerequisites-drupal)
------
#### [ Console ]
**Para conectarse a Amazon Kendra Drupal**
1. Inicia sesión en la [Amazon Kendraconsola Consola de administración de AWS](https://console.aws.amazon.com/kendra/) y ábrela.
1. En el panel de navegación izquierdo, elija **Índices** y, a continuación, elija el índice que desee usar de la lista de índices.
**nota**
Puede elegir configurar o editar los ajustes de **Control de acceso de usuarios** en la **Configuración del índice**.
1. En la página **Introducción**, seleccione **Agregar origen de datos**.
1. En la página **Agregar origen de datos**, seleccione **Conector de Drupal** y, a continuación, seleccione **Agregar conector**. Si usa la versión 2 (si corresponde), elija el **Conector de Drupal** con la etiqueta “V2.0”.
1. En la página **Especificar detalles del origen de datos**, introduzca la siguiente información:
1. En **Nombre y descripción**, en **Nombre del origen de datos**: introduzca un nombre para el origen de datos. Puede incluir guiones, pero no espacios.
1. (Opcional)** Descripción**: introduzca una descripción opcional para el origen de datos.
1. En **Idioma predeterminado**: elija un idioma para filtrar los documentos para el índice. A menos que especifique lo contrario, el idioma predeterminado es el inglés. El idioma especificado en los metadatos del documento anula el idioma seleccionado.
1. En **Etiquetas**, para **añadir una nueva etiqueta**: incluye etiquetas opcionales para buscar y filtrar tus recursos o realizar un seguimiento de tus AWS costes.
1. Elija **Siguiente**.
1. En la página **Definir acceso y seguridad**, introduzca la siguiente información:
1. En **Origen**, en **URL de host**: la URL de host del sitio de Drupal. Por ejemplo, *https:///*.
1. En **Ubicación del certificado SSL**: introduzca la ruta al certificado SSL almacenado en el bucket de Amazon S3.
1. **Autorización**: active o desactive la información de la lista de control de acceso (ACL) para los documentos, si tiene una ACL y desea usarla para el control de acceso. La ACL especifica a qué documentos pueden acceder los usuarios y los grupos. La información de la ACL se utiliza para filtrar los resultados de búsqueda en función del acceso del usuario o su grupo a los documentos. Para obtener más información, consulte [Filtrado de contexto de usuario](https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html#context-filter-user-incl-datasources).
1. Para la **autenticación**: elija entre la **autenticación básica** y la **autenticación OAuth 2.0** según su caso de uso.
1. **AWS Secrets Managersecreto**: elija un secreto existente o cree uno nuevo para almacenar sus Secrets Manager credenciales de autenticación de Drupal. Si decide crear un secreto nuevo, se abrirá una ventana de secreto de AWS Secrets Manager.
1. Introduzca la siguiente información en la **ventana Crear un secreto de AWS Secrets Manager**:
1. Si ha elegido la **Autenticación básica**, introduzca un **Nombre del secreto**, el **Nombre de usuario** (nombre de usuario del sitio de Drupal) y la **Contraseña** (contraseña del sitio de Drupal) que ha copiado y seleccione **Guardar y agregar secreto**.
1. **Si ha elegido la **autenticación OAuth 2.0**, introduzca un **nombre secreto, un nombre** de **usuario (nombre** de usuario del sitio de Drupal), una **contraseña (contraseña** del sitio de Drupal), un **ID de cliente** y un **secreto de cliente** generados en su cuenta de Drupal y seleccione Guardar y añadir secreto.**
1. Seleccione **Save**.
1. **Nube privada virtual (VPC)**: puede optar por utilizar una VPC. Si es así, debe agregar **Subredes** y **Grupos de seguridad de VPC**.
1. **Rastreador de identidades**: especifique si se debe activar el rastreador de identidades de Amazon Kendra. El rastreador de identidades utiliza la información de la lista de control de acceso (ACL) de los documentos para filtrar los resultados de la búsqueda en función del acceso del usuario o del grupo a los documentos. Si tiene una ACL para sus documentos y decide utilizarla, también puede optar por activar el rastreador de identidades para configurar el [filtrado Amazon Kendra de los resultados de búsqueda según el contexto de usuario](https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html#context-filter-user-incl-datasources). De lo contrario, si el rastreador de identidades está desactivado, todos los documentos se pueden buscar públicamente. Si quieres usar el control de acceso para tus documentos y el rastreador de identidad está desactivado, también puedes usar la [PutPrincipalMapping](https://docs.aws.amazon.com/kendra/latest/APIReference/API_PutPrincipalMapping.html)API para cargar información de acceso de usuarios y grupos para filtrar el contexto de los usuarios.
1. **IAMrol**: elija un IAM rol existente o cree uno nuevo IAM para acceder a las credenciales del repositorio y al contenido del índice.
**nota**
IAMlos roles utilizados para los índices no se pueden usar para las fuentes de datos. Si no está seguro de si un rol existente se utiliza para un índice o para las preguntas frecuentes, elija **Crear un nuevo rol** para evitar errores.
1. Elija **Siguiente**.
1. En la página **Configurar ajustes de sincronización**, introduzca la siguiente información:
1. En **Ámbito de sincronización**, seleccione de entre las siguientes opciones:
**nota**
Si elige rastrear **Artículos**, **Páginas básicas** y **Bloques básicos**, sus campos predeterminados se sincronizarán automáticamente. También puede optar por sincronizar los comentarios, archivos adjuntos, campos personalizados y otras entidades personalizadas.
1. En **Entidades seleccionadas**:
+ **Artículos**: elija si desea rastrear los **Artículos**, sus **Comentarios** y sus **Archivos adjuntos**.
+ **Páginas básicas**: elija si desea rastrear las **Páginas básicas**, sus **Comentarios** y sus **Archivos adjuntos**.
+ **Bloques básicos**: elija si desea rastrear los **Bloques básicos**, sus **Comentarios** y sus **Archivos adjuntos**.
+ También puede optar por añadir **Tipos de contenido personalizados** y **Bloques personalizados**.
1. En **Configuración adicional (opcional)**:
+ En **Patrón regex**: agregue patrones de expresiones regulares para incluir o excluir títulos de entidades y nombres de archivos específicos. Puede añadir hasta 100 patrones.
1. **Modo de sincronización**: elija cómo desea actualizar el índice cuando cambie el contenido del origen de datos. Al sincronizar la fuente de datos Amazon Kendra por primera vez, todo el contenido se rastrea e indexa de forma predeterminada. Debe ejecutar una sincronización completa de los datos si la sincronización inicial falló, incluso si no selecciona la sincronización completa como opción de modo de sincronización.
+ Sincronización completa: se vuelve a indexar todo el contenido, reemplazando el contenido existente cada vez que el origen de datos se sincronice con el índice.
+ Sincronización nueva, modificada o eliminada: indexe solo el contenido nuevo, modificado y eliminado cada vez que la fuente de datos se sincronice con el índice. Amazon Kendrapuede usar el mecanismo de la fuente de datos para realizar un seguimiento de los cambios en el contenido e indexar el contenido que ha cambiado desde la última sincronización.
1. En **Programa de ejecución de sincronización**, **Frecuencia**: la frecuencia con la que Amazon Kendra se sincronizará con el origen de datos.
1. Elija **Siguiente**.
1. En la página **Establecer asignaciones de campos**, especifique la siguiente información:
1. Para el **contenido**, **los comentarios** y **los archivos adjuntos**: seleccione uno de los campos de fuente de datos predeterminados Amazon Kendra generados que desee asignar a su índice.
1. **Agregar campo**: para agregar campos de origen de datos personalizados para crear un nombre de campo de índice al que asignarlos y el tipo de datos del campo.
1. Elija **Siguiente**.
1. En la página **Revisar y crear**, compruebe que la información que ha introducido es correcta y, a continuación, seleccione **Añadir origen de datos**. También puede elegir editar la información desde esta página. El origen de datos aparecerá en la página **Orígenes de datos** una vez que el origen de datos se haya agregado correctamente.
------
#### [ API ]
**Para conectarse a Amazon Kendra Drupal**
Debe especificar un JSON del [esquema del origen de datos](https://docs.aws.amazon.com/kendra/latest/dg/ds-schemas.html#ds-drupal-schema) mediante la API [https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html](https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html). Debe proporcionar la siguiente información:
+ **Origen de datos**: defina el tipo de origen de datos como `DRUPAL` cuando utilice el esquema JSON [https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html](https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html). Además, defina el origen de datos como `TEMPLATE` al llamar a la API [https://docs.aws.amazon.com/kendra/latest/dg/API_CreateDataSource.html](https://docs.aws.amazon.com/kendra/latest/dg/API_CreateDataSource.html).
+ **Modo de sincronización**: especifique cómo Amazon Kendra debe actualizarse el índice cuando cambie el contenido de la fuente de datos. Al sincronizar el origen de datos con Amazon Kendra por primera vez, todo el contenido se rastrea y se indexa de forma predeterminada. Debe ejecutar una sincronización completa de los datos si la sincronización inicial falló, incluso si no selecciona la sincronización completa como opción de modo de sincronización. Puede elegir entre las siguientes opciones:
+ `FORCED_FULL_CRAWL` para volver a indexar todo el contenido, reemplazando el contenido existente cada vez que el origen de datos se sincronice con el índice.
+ `FULL_CRAWL` para indexar solo el contenido nuevo, modificado y eliminado cada vez que el origen de datos se sincronice con el índice. Amazon Kendra puede utilizar el mecanismo del origen de datos para realizar un seguimiento de los cambios en el contenido e indexar el contenido modificado desde la última sincronización.
+ `CHANGE_LOG` para indexar solo el contenido nuevo y modificado cada vez que el origen de datos se sincronice con el índice. Amazon Kendra puede utilizar el mecanismo del origen de datos para realizar un seguimiento de los cambios en el contenido e indexar el contenido modificado desde la última sincronización.
+ **Nombre secreto del recurso de Amazon (ARN)**: proporciona el nombre del recurso de Amazon (ARN) de un Secrets Manager secreto que contenga las credenciales de autenticación que creaste en tu cuenta de Drupal.
Si utiliza la autenticación básica, el secreto se almacena en una estructura JSON con las siguientes claves:
```
{
"username": "user name",
"password": "password"
}
```
Si utilizas la autenticación OAuth 2.0, el secreto se almacena en una estructura JSON con las siguientes claves:
```
{
"username": "user name",
"password": "password",
"clientId": "client id",
"clientSecret": "client secret"
}
```
**nota**
Le recomendamos que actualice o modifique con regularidad las credenciales y el secreto. Por su propia seguridad, proporcione solo el nivel de acceso necesario. **No** se recomienda volver a utilizar las credenciales y los datos secretos en varios orígenes de datos ni en las versiones 1.0 y 2.0 del conector (si procede).
+ **IAMrol**: especifique `RoleArn` cuándo llama `CreateDataSource` para proporcionar a un IAM rol permisos para acceder a su Secrets Manager secreto y para llamar al público requerido APIs para el conector de Drupal y. Amazon Kendra Para obtener más información, consulte [Roles de IAM para orígenes de datos de Drupal](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html#iam-roles-ds).
También puede añadir las siguientes características opcionales:
+ **Nube privada virtual (VPC)**: especifique a `VpcConfiguration` cuándo llamar a `CreateDataSource`. Para obtener más información, consulte [¿Se está configurando Amazon Kendra para usar un Amazon VPC](vpc-configuration.md).
+ **Filtros de inclusión y exclusión**: puede especificar si desea incluir contenido, comentarios y archivos adjuntos. También puede especificar patrones de expresiones regulares para incluir o excluir contenido, comentarios y archivos adjuntos.
**nota**
La mayoría de los orígenes de datos utilizan patrones de expresiones regulares, que son patrones de inclusión o exclusión denominados filtros. Si especifica un filtro de inclusión, solo se indexará el contenido que coincida con el filtro de inclusión. Los documentos que no coincidan con el filtro de inclusión no se indexan. Si especifica un filtro de inclusión y exclusión, los documentos que coincidan con el filtro de exclusión no se indexarán, aunque coincidan con el filtro de inclusión.
+ **Rastreador de identidades**: especifique si se debe activar el rastreador de identidades de Amazon Kendra. El rastreador de identidades utiliza la información de la lista de control de acceso (ACL) de los documentos para filtrar los resultados de la búsqueda en función del acceso del usuario o del grupo a los documentos. Si tiene una ACL para sus documentos y decide utilizarla, también puede optar por activar el rastreador de identidades para configurar el [filtrado Amazon Kendra de los resultados de búsqueda por contexto de usuario](https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html#context-filter-user-incl-datasources). De lo contrario, si el rastreador de identidades está desactivado, todos los documentos se pueden buscar públicamente. Si quieres usar el control de acceso para tus documentos y el rastreador de identidad está desactivado, también puedes usar la [PutPrincipalMapping](https://docs.aws.amazon.com/kendra/latest/APIReference/API_PutPrincipalMapping.html)API para cargar información de acceso de usuarios y grupos para filtrar el contexto de los usuarios.
+ **Asignaciones de campos**: elija asignar los campos del origen de datos de Drupal a los campos de índice de Amazon Kendra. Para obtener más información, consulte [Asignación de campos de origen de datos](https://docs.aws.amazon.com/kendra/latest/dg/field-mapping.html).
**nota**
El campo del cuerpo del documento o el cuerpo del documento equivalente de sus documentos es obligatorio Amazon Kendra para poder buscarlos. Debe asignar el nombre del campo del cuerpo del documento en el origen de datos al nombre del campo del índice `_document_body`. Todos los demás campos son opcionales.
Para obtener una lista de otras claves JSON importantes que debe configurar, consulte [Esquema de plantilla de Drupal](ds-schemas.md#ds-drupal-schema).
------
## Notas
+ Drupal no APIs tiene límites de regulación oficiales.
+ Java no SDKs está disponible para Drupal.
+ Los datos de Drupal solo se pueden obtener mediante API JSON nativas.
+ No se pueden rastrear los tipos de contenido que no estén asociados a ninguna **Vista** de Drupal.
+ Necesita acceso de administrador para rastrear los datos de los **Bloques** de Drupal.
+ No hay ninguna API JSON disponible para crear el tipo de contenido definido por el usuario mediante verbos HTTP.
+ El cuerpo del documento y los comentarios de los **Artículos**, las **Páginas básicas**, los **Bloques básicos**, el tipo de contenido definido por el usuario y el tipo de bloque definido por el usuario se muestran en formato HTML. Si el contenido HTML no está bien formado, las etiquetas relacionadas con el HTML aparecerán en el cuerpo del documento y en los comentarios y estarán visibles en los resultados de búsqueda de Amazon Kendra.
+ No se incorporarán los tipos de contenido ni los tipos de **bloques** sin descripción o cuerpo. Amazon Kendra Solo **los comentarios** y **archivos adjuntos** de este tipo de **contenido** o tipo de **bloque** se incorporarán a tu Amazon Kendra índice.