Webservices relacionados con formularios
Las APIs de participación en formularios se pueden utilizar para vincular Actito con formularios que no necesariamente han sido definidos por Actito.
Esto puede ser útil, por un lado, para poder recopilar datos que provienen de un socio externo y enviarlos a Actito con el fin de enriquecerlos, manteniendo al mismo tiempo la fuente de la información de acuerdo con la regulación de RGPD.
Por otro lado, esto se puede utilizar típicamente cuando el diseño del formulario es gestionado por otra plataforma. Las respuestas proporcionadas por los perfiles pueden ser enviadas directamente a un formulario técnico de Actito utilizando las APIs de formularios.
El diseño real de un formulario de Actito no es posible utilizando las APIs. Esto debe hacerse a través de la interfaz de Actito. Para obtener más información al respecto, consulte el capítulo dedicado a los formularios.
Sin embargo, las APIs relacionadas con formularios le permiten:
- obtener la estructura de un formulario
- obtener los detalles de participación de un perfil
- crear y actualizar participaciones en un formulario, aplicando las reglas de enriquecimiento
Preparar un formulario compatible con el uso de API
El uso de las APIs relacionadas con formularios implica que su formulario debe cumplir con ciertas restricciones para garantizar que el uso de los servicios web se realice con éxito. Es importante tener esto en cuenta al crear su formulario en la interfaz de Actito.
Nombres de visualización y traducciones
Cuando creas un formulario en la interfaz de Actito y optas por preguntas de respuestas múltiples, tienes la opción de definir valores de visualización diferentes a los valores técnicos. También puedes traducir estos valores según el idioma.
Sin embargo, esta noción no se tiene en cuenta en las APIs relacionadas con los formularios. Solo se pueden obtener o enviar los valores técnicos, que son los mismos independientemente del idioma.
Sin embargo, las preguntas se pueden traducir, ya que se pueden asociar con nombres técnicos.
Definición de nombres técnicos para el formulario
Las APIs relacionadas con los formularios utilizan nombres técnicos para enviar los datos. Es importante dar nombres claros y precisos a tus preguntas, tanto por facilidad de uso como para evitar cualquier riesgo de error en la configuración de las APIs.
El texto corto que puedes asociar a cada pregunta al crear tu formulario se utiliza para el informe, pero no es el nombre técnico. Estos deben agregarse posteriormente. Para hacerlo, ve a la lista de formularios existentes en la pestaña "Activados". Haz clic en el botón "Más" y, en el menú desplegable, selecciona "Definir nombres técnicos".
Luego puedes definir nombres técnicos relevantes tanto para la encuesta general como para cada pregunta individual.
Consejo
Si has incluido "Preguntas predefinidas", estas ya tendrán un nombre técnico predefinido.
Reglas de enriquecimiento de la base de datos
Los formularios permiten que tus contactos modifiquen directamente su información de perfil. Al crear un formulario destinado a ser utilizado con una API de Actito, es importante definir buenas reglas de registro de perfiles.
En efecto, una de las reglas de enriquecimiento disponibles consiste en enriquecer la base de datos si las respuestas de una página en particular están registradas. Sin embargo, la noción de página no se tiene en cuenta en el caso de utilizar las APIs.
Por lo tanto, es necesario no utilizar esta regla, sino privilegiar una condición de enriquecimiento cuando "la participación en el formulario ha finalizado".
Para obtener información más completa sobre las reglas de enriquecimiento, le invitamos a consultar la página "Enriquecer una base de datos".
