Conector de entrada de jerarquía de organización
Acerca del conector de entrada de la jerarquía de organización
Puede utilizar el conector de entrada Jerarquía de organización para cargar y actualizar jerarquías de organización a través de archivos almacenados en un servidor de protocolo de transferencia segura de archivos (SFTP) en XM Discover. Este conector de entrada le permite hacer lo siguiente:
- Cargar y programar actualizaciones en jerarquías de organización.
- Extraer archivos de un archivo Zip o Gzip antes de procesarlos.
- Descifrar archivos antes de procesar.
- Configurar notificaciones avanzadas.
- Aplicar transformaciones.
Consejo Q: Las jerarquías de organización funcionan igual independientemente de dónde (Studio o Conectores) se creen o mantengan.
Formatos de archivo de jerarquía de organización
Antes de configurar un job utilizando el conector de entrada Jerarquía de organización, asegúrese de que tiene el archivo de jerarquía de organización relevante preparado en 1 de los siguientes formatos de archivo admitidos:
- Archivos Excel (XLS, XLSX)
- Archivos de texto delimitados (CSV)
Requisitos de jerarquía de organización en formato Excel
El conector de entrada Jerarquía de organización le permite definir todos los aspectos de una organización a través de una única hoja de cálculo de MS Excel.
- Puede guardar su jerarquía de organización como una hoja de cálculo de MS Excel con una extensión XLS o XLSX.
- Le recomendamos que coloque todos los datos de jerarquía de organización en la primera hoja del archivo Excel.
- Asegúrese de que la primera fila de la hoja de cálculo contenga nombres de columna. Estos nombres se utilizarán para asignar columnas a parámetros de organización.
- Las columnas de la hoja de cálculo pueden estar en cualquier orden.
- Cada columna se asigna a un determinado parámetro de jerarquía de organización durante el paso de asignación.
Jerarquía de organización en requisitos de formato CSV
El conector de entrada Jerarquía de organización le permite definir todos los aspectos de una organización mediante un único archivo CSV.
- Guarde su jerarquía de organización como un archivo CSV.
- Separe las columnas con una coma.
- Todas las filas deben tener el mismo número de columnas, en el mismo orden.
- Asegúrese de que la primera fila del archivo CSV contenga nombres de columna. Estos nombres se utilizarán para asignar columnas a parámetros de jerarquía de organización.
- El orden de las columnas no importa.
- Cada columna se asigna a un parámetro de jerarquía de organización concreto durante la definición de la jerarquía de pasos de asignación en un archivo CSV.
Para obtener ejemplos y consejos de resolución de problemas para jerarquías de organización en XM Discover, consulte Mejores prácticas para jerarquías de organización (Studio).
Configurar la conexión
Creación de un job de conector de entrada de jerarquía de organización
Después de configurar la conexión, siga estos pasos para crear un job de conector de entrada Jerarquía de organización y configurar los datos que se envían a XM Discover:
- Paso 1: Proporcionar nombre de job
- Paso 2: Especificar el proyecto y la descripción
- Paso 3: Proporcionar credenciales para una carpeta SFTP de Qualtrics
- Paso 4: Token de API de jerarquía
- Paso 5: Configuración de la jerarquía de la organización
- Paso 6: Proporcionar configuración de archivos
- Paso 7: Asignar los campos deseados a XM Discover
- Paso 8: Configuración de notificación (opcional)
- Paso 9: Configurar opciones adicionales para el trabajo
- Paso 10: Confirmar todas las opciones de job
Paso 1: Proporcionar nombre de job
Introduzca un nombre de job reconocible en el cuadro Nombre de job en la parte superior izquierda de la página.
Paso 2: Especificar el proyecto y la descripción
- En la página Especificar proyecto y descripción, seleccione el proyecto en el que se deben cargar los datos desde el menú desplegable de proyectos.
Consejo Q: Tiene la opción de introducir una nota sobre el job en el cuadro Descripción del job. La descripción del trabajo que introduce en el cuadro Descripción del trabajo solo es accesible en la lista Conectores y no se carga como parte de los datos de un trabajo. - Haga clic en Siguiente.
Paso 3: Proporcionar credenciales para una carpeta SFTP de Qualtrics
- En la página Proporcionar credenciales para una carpeta SFTP de Qualtrics, puede seleccionar un conjunto existente de credenciales de servidor SFTP del menú desplegable.
Consejo Q: Puede añadir un nuevo conjunto de credenciales SFTP siguiendo los pasos indicados Añadir nuevas credenciales SFTP . - Haga clic en Siguiente.
Paso 4: Token de API de jerarquía
- En la página Token de API de jerarquía, indique su token de autenticación de jerarquía en el cuadro Token de API de jerarquía.
Consejo Q: Para obtener más información sobre cómo generar un token de autenticación de jerarquía y actualizar un token de autenticación de jerarquía después de crear un puesto, consulte API de jerarquía. - Haga clic en Siguiente.
Paso 5: Configuración de la jerarquía de la organización
- En la página Configuración de jerarquía de organización, indique el nombre de la jerarquía de organización en el cuadro NOMBRE.
- Seleccione 1 de las siguientes opciones de modo de carga para especificar cómo debe gestionar el sistema las jerarquías de organización.
- Cargar jerarquía de organización (predeterminado): crear y activar una jerarquía de organización. Para obtener más información, consulte la Cargar jerarquía de organización .
Consejo Q: De forma predeterminada, la jerarquía de organización activada no está publicada y solo activará la personalización del dashboard.
- Cargar jerarquía de organización y publicar: cree, active y publique una jerarquía de organización. Para obtener más información, consulte la Cargar jerarquía de organización y publicar .
Consejo Q: Publicar una jerarquía de organización le permite agrupar datos por niveles. Este es un requisito previo para la gestión de informes entre iguales y superior, así como para la gestión de informes de destino y desviación. Para obtener más información, consulte Gestión de informes de compañeros y superiores e Informes de objetivo y desviación.Consejo Q: Para obtener más información sobre la actualización de la configuración de la jerarquía de la organización después de crear un job, consulte Actualización de las opciones de los jobs del conector de entrada de la jerarquía de la organización .
- Haga clic en Siguiente.
Paso 6: Proporcionar configuración de archivos
- En la página Proporcionar configuración de archivos, marque 1 de las siguientes casillas de selección para seleccionar el tipo de archivo que contiene los datos que se deben cargar:
- Aplique las opciones de configuración para el tipo de archivo seleccionado:
- Archivos de texto delimitados (CSV): para obtener más información, consulte la Opciones de archivos de texto delimitados (CSV) .
- Archivos Excel (XLS, XLSX): Para obtener más información, consulte la Opciones de archivos de Microsoft Excel .
- Haga clic en Examinar en la sección Ubicación de archivos para apuntar a la carpeta en la que se almacenan los archivos en el servidor SFTP.
- En la ventana Seleccionar ubicación de archivos, seleccione la carpeta en la que se almacenan los archivos.
Consejo Q: Haga clic en el nombre de la carpeta para seleccionarla. Haga clic en el icono de carpeta para abrirla. - Una vez seleccionada la carpeta en la que se almacenan los archivos, haga clic en Aceptar.
Atención: solo se procesan los archivos de la carpeta seleccionada; las subcarpetas deben procesarse por separado. - Introduzca una expresión regular para procesar solo archivos con nombres coincidentes en el cuadro Expresión regular de nombre de archivo.
Consejo Q: Puede actualizar la configuración de ubicación de los archivos después de crear un job.Atención: Las funciones de codificación personalizada se proporcionan tal cual y requieren conocimientos de programación para implementarlas. El soporte técnico de Qualtrics no ofrece asistencia o consultoría sobre codificación personalizada. En su lugar, puede preguntar a los usuarios especializados de nuestra comunidad. Si desea obtener más información sobre nuestros servicios de codificación personalizada, póngase en contacto con su Ejecutivo de cuentas de Qualtrics. - En la página Proporcionar configuración de archivos, vaya a la sección Descifrado y compresión (opcional).
- Si los archivos se almacenan en un archivo zip o Gzip, marque la casilla de selección Descomprimir archivos.
- Introduzca una expresión regular solo para descomprimir archivos con nombres coincidentes en el cuadro Expresión regular de nombre de archivo comprimido.
Atención: Las funciones de codificación personalizada se proporcionan tal cual y requieren conocimientos de programación para implementarlas. El soporte técnico de Qualtrics no ofrece asistencia o consultoría sobre codificación personalizada. En su lugar, siempre puede intentar preguntarles a los usuarios especializados de nuestra comunidad. Si desea obtener más información sobre nuestros servicios de codificación personalizada, póngase en contacto con su Ejecutivo de cuentas de Qualtrics.
- Si los archivos están cifrados, seleccione la casilla de verificación Descifrar archivos.
- Introduzca una expresión regular solo para descifrar archivos con nombres coincidentes en el cuadro Expresión regular de nombre de archivo cifrado.
Atención: Las funciones de codificación personalizada se proporcionan tal cual y requieren conocimientos de programación para implementarlas. El soporte técnico de Qualtrics no ofrece asistencia o consultoría sobre codificación personalizada. En su lugar, siempre puede intentar preguntarles a los usuarios especializados de nuestra comunidad. Si desea obtener más información sobre nuestros servicios de codificación personalizada, póngase en contacto con su Ejecutivo de cuentas de Qualtrics.
- Introduzca una clave PGP/GPG para el descifrado en el cuadro Clave PGP/GPG.
- Introduzca una frase de contraseña para el descifrado en el cuadro Frase de contraseña.
- Si un archivo no cifrado contiene archivos cifrados, seleccione Descomprimir y, a continuación, Descifrar. Si un archivo cifrado contiene archivos no cifrados, seleccione la opción Descifrar y luego descomprimir.
Consejo Q: Estas opciones solo están disponibles si las opciones Descomprimir archivo(s) y Descifrar archivo(s) están seleccionadas.Atención: No se admiten archivos cifrados con archivos cifrados.Consejo Q: Puede actualizar la configuración de descifrado y compresión después de crear la tarea.
- Para proporcionar un archivo de muestra para las asignaciones de campo, puede seleccionar 1 de las siguientes opciones:
- Descargue una muestra desde el almacenamiento de archivos: Para obtener más información, consulte la Descarga de un archivo de muestra desde el servidor SFTP .
- Cargue un archivo desde su ordenador: Para obtener más información, consulte la Carga de un archivo de muestra desde su ordenador .
Paso 7: Asignar los campos deseados a XM Discover
- En la página Asignar campos deseados en XM Discover, defina la jerarquía de organización asignando los campos a los parámetros de jerarquía adecuados en la pestaña ASIGNACIÓN DE FUENTES:
- Nombre de campo: El nombre del campo del archivo.
- Valores posibles: Ejemplos de valores posibles.
- Transformaciones: utilice esta opción para transformar sus datos. Para obtener más información, consulte Aplicación de transformaciones.
- Asignación: seleccione el aspecto de jerarquía de organización al que asignar los campos. Valores posibles:
- Nivel 1 a nivel 10. Defina la estructura de su jerarquía. Los niveles de estructura de la organización se definen mediante columnas en el archivo Excel o CSV.
Consejo Q: El número máximo de niveles de jerarquía es 10. - Usuarios: asigne los usuarios a su jerarquía.
- Filtros: Defina los filtros para su jerarquía.
- Enriquecimientos: Crear parámetros de enriquecimiento para su jerarquía..|
Consejo Q: El número máximo de enriquecimientos es 6.Consejo Q: Haga clic en el icono más (+) a la derecha para añadir nuevos campos de datos personalizados; haga clic en el icono menos (– )) para eliminar campos.
- Nivel 1 a nivel 10. Defina la estructura de su jerarquía. Los niveles de estructura de la organización se definen mediante columnas en el archivo Excel o CSV.
Paso 8: Configuración de notificación (opcional)
- En la página Configuración de notificación, puede seleccionar las notificaciones que los examinadores de un trabajo deben recibir si se produce alguno de los eventos enumerados a continuación.
- Notificar cuando falle la ejecución del job
- Notificar cuando no se encuentren archivos para procesar
- Notificar cuando el job finalice con un timeout
Paso 9: Configurar opciones adicionales para el trabajo
- En la página Configurar opciones adicionales para job, en la sección Programar job histórico/incremental, seleccione 1 de las siguientes opciones:
- Programar ejecuciones incrementales: para configurar una programación para extracciones de datos incrementales.
Consejo Q: Para obtener más información sobre la programación de ejecuciones incrementales, consulte Programación de tareas.
- Configurar pull único: para realizar un pull de datos único.
Consejo Q: Para obtener más información, consulte Programar una ejecución incremental para un job pull único.
- En la página Configurar opciones adicionales para job, en la sección Período de retención, puede especificar el período de retención para archivar ficheros por job durante un período de tiempo definido.
Consejo Q: Para obtener más información sobre la configuración de retención, consulte Actualizar configuración de retención. - Haga clic en Siguiente.
Paso 10: Confirmar todas las opciones de job
- En la página Confirmar todas las opciones de job, puede ver un resumen de todas las opciones de una tarea y editar las opciones, si es necesario, antes de ejecutar la carga de datos.
- Para ejecutar la carga de datos, haga clic en el botón Finalizar cuando esté listo para ejecutar la carga de datos.
Aparecerá un mensaje de confirmación que confirmará que el job se ha enviado correctamente. Al hacer clic en Finalizar, sucede lo siguiente:
- Las tiradas únicas se ejecutan inmediatamente.
- A menos que haya activado la opción “Crear job pero no extraer datos”, las transferencias programadas se ejecutan inmediatamente y, a continuación, se fijan para que se ejecuten según la programación que ha definido.
Para obtener más información sobre los jobs de supervisión, consulte Resumen de página de jobs.
Añadir nuevas credenciales SFTP
En la página Proporcionar credenciales para una carpeta SFTP de Qualtrics, puede añadir nuevas credenciales de SFTP.
- Para añadir un nuevo conjunto de credenciales SFTP, seleccione Añadir nuevo en el menú desplegable de credenciales.
- Introduzca el nombre del nuevo conjunto de credenciales en el cuadro NOMBRE DE CONEXIÓN.
- Introduzca el nombre de usuario de SFTP en el cuadro NOMBRE DE USUARIO DE SFTP.
- Proporcione la contraseña de SFTP en la casilla CONTRASEÑA DE SFTP.
- Introduzca la dirección del servidor SFTP en el cuadro HOST SFTP.
- Proporcione el puerto SFTP en el cuadro PUERTO SFTP.
Consejo Q: El puerto predeterminado es 22.
- Puede configurar sus credenciales SFTP para que caduquen después de un período de tiempo determinado (opcional). Para definir una fecha de vencimiento para este conjunto de credenciales y establecer un recordatorio para todos los examinadores de trabajos, marque la casilla de selección Enviar notificaciones de expiración. Esto activa la casilla Días antes del vencimiento.
- Introduzca un valor en el cuadro Días antes del vencimiento para establecer cuántos días antes del vencimiento deben comenzar las notificaciones. Los valores posibles van de 1 a 100 días.
Consejo Q: Este recordatorio se desencadena cada vez que el job se ejecuta una vez que la fecha de vencimiento es inferior al número de días establecido en el cuadro Días antes del vencimiento.
- Seleccione la Fecha de vencimiento del selector de fecha de calendario. La fecha de vencimiento se agregará a la casilla Fecha de vencimiento.
Descarga de un archivo de muestra desde el servidor SFTP
- Seleccione Descargar muestra desde Almacenamiento de archivos.
- Haga clic en el botón Seleccionar archivo de muestra en el cuadro Examinar almacenamiento de archivos.
- En la ventana Seleccionar archivo de muestra, abra la carpeta en la que se almacena el archivo de muestra.
- Seleccione el archivo de muestra.
- Haga clic en OK.
- Espere hasta que XM Discover cargue el archivo de muestra y muestre una vista previa.
Consejo Q: Para obtener información sobre posibles errores de validación, consulte Errores de archivo de muestra.
Carga de un archivo de muestra desde su ordenador
- Seleccione Cargar muestra de mi ordenador.
- Haga clic en el botón Haga clic para seleccionar archivo para cargar y señale el archivo de datos o suelte el archivo en el área de diseño gris.
- Espere hasta que XM Discover cargue el archivo de muestra y muestre una vista previa.
Consejo Q: Para obtener información sobre posibles errores de validación, consulte Errores de archivo de muestra.Consejo Q: Puede actualizar las asignaciones de campos actualizando la configuración de las cabeceras de archivo mediante un archivo de muestra después de crear una tarea.
Opciones de archivos de texto delimitados (CSV)
Puede aplicar las opciones de configuración para archivos de texto delimitados (CSV) en la página Seleccionar archivo.
- Seleccione el sistema de codificación utilizado en el archivo del menú.
- Introduzca el carácter utilizado para delimitar entradas de datos en el archivo en el cuadro Carácter delimitador.
Consejo Q: Introduzca solo 1 carácter.Consejo Q: El delimitador predeterminado es una coma, que se puede utilizar para archivos CSV. - Introduzca el carácter utilizado para encerrar cada campo de datos del archivo en el cuadro de caracteres Cierre.
Consejo Q: Introduzca solo 2 caracteres.Consejo Q: Marque la casilla de selección Carácter de cierre si los caracteres de cierre son opcionales.
- Puede hacer clic en el enlace aquí para descargar y utilizar una plantilla predeterminada con una estructura predefinida, filtros, usuarios y enriquecimientos almacenados en un único archivo como punto de partida para crear su propia jerarquía de organización.
El archivo de plantilla CSV para la estructura organizativa se guardará en la ubicación predeterminada para las descargas en su ordenador. Después de descargar la plantilla, modifíquela para que coincida con su estructura organizativa.
Opciones de archivos de Microsoft Excel
Puede aplicar las opciones de configuración para archivos de Microsoft Excel en la página Seleccionar archivo. Puede hacer clic en el enlace aquí para descargar y utilizar una plantilla predeterminada con una estructura predefinida, filtros, usuarios y enriquecimientos almacenados en un único archivo como punto de partida para crear su propia jerarquía de organización.
El archivo de plantilla de Excel para la estructura organizativa se guardará en la ubicación predeterminada para las descargas en su ordenador. Después de descargar la plantilla, modifíquela para que coincida con su estructura organizativa.
Actualización de las opciones de los jobs del conector de entrada de la jerarquía de la organización
Puede actualizar las opciones para los jobs de conector de entrada Jerarquía de organización para especificar cómo debe gestionar el sistema las jerarquías de organización después de crear un job. Se trata principalmente de actualizaciones por debajo del capricho. Para cada ejecución incremental del conector Jerarquía de la organización, se lleva a cabo lo siguiente:
- Se crea una versión de la jerarquía de organización original.
- La versión creada se edita con archivos nuevos.
- Si se actualizan la estructura o los filtros, se publica la versión. La versión no se publica si solo se actualizan los usuarios y los enriquecimientos.
- La jerarquía de organización original se sustituye por una nueva versión.
- Se borra la versión temporal.
- La jerarquía de organización se activa si no está activa.
Cómo actualizar las opciones de los jobs del conector de entrada de la jerarquía de la organización
- Inicie sesión en Conectores.
- Asegúrese de que la pestaña JOBS esté seleccionada.
- Busque el job que desea actualizar utilizando filtros o búsqueda.
- Expanda el menú de acciones junto al trabajo.
- Seleccione Actualizar configuración de jerarquía de organización.
- En la ventana Actualizar opciones de jerarquía de organización, puede seleccionar 1 de las siguientes opciones de modo de carga para especificar cómo debe gestionar el sistema las jerarquías de organización:
- Cargar jerarquía de organización (predeterminado): crear y activar una jerarquía de organización. Para obtener más información, consulte la sección Cargar jerarquía de organización.
Consejo Q: De forma predeterminada, la jerarquía de organización activada no está publicada y solo activará la personalización del dashboard.
- Cargar jerarquía de organización y publicar: cree, active y publique una jerarquía de organización. Para obtener más información, consulte la sección Cargar jerarquía de organización y publicar.
Consejo Q: Publicar una jerarquía de organización le permite agrupar datos por niveles. Este es un requisito previo para la gestión de informes entre iguales y superior, así como para la gestión de informes de destino y desviación. Para obtener más información, consulte Gestión de informes de compañeros y superiores e Informes de objetivo y desviación.
- Haga clic en Guardar.
Esto actualiza el job y aplica las nuevas opciones.
Cargar jerarquía de organización
Si selecciona la opción de modo de carga Cargar jerarquía de organización, puede marcar la casilla de selección Generar grupos basados en este archivo de usuario para crear grupos con su jerarquía de organización.
Cargar jerarquía de organización y publicar
Si selecciona la opción Cargar jerarquía de organización y publicar modo de carga, puede hacer lo siguiente:
- Seleccione Generar grupos a partir de este archivo de usuarios para crear grupos con su jerarquía de organización.
- Seleccione Incluir registros sin texto para incluir registros vacíos textualmente en la jerarquía de su organización.
- Desmarque Incluir registros sin texto para excluir registros vacíos textualmente de su jerarquía de organización.
- Seleccione Incluir en flujos de datos incrementales para incluir el modelo de jerarquía de organización en ejecuciones incrementales.
- Desmarque Incluir en flujos de datos incrementales para excluir el modelo de jerarquía de organización de las ejecuciones incrementales. Si espera que la publicación de una jerarquía de organización entre en conflicto con otros flujos de datos en tiempo real Downstream, le recomendamos que desmarque esta opción. El modelo que se crea y se clasifica posteriormente no bloqueará otros flujos de datos si esta opción no está seleccionada.
Consejo Q: La publicación de una jerarquía de organización crea un modelo de categoría correspondiente oculto para admitir casos de uso adicionales. El modelo de categoría creado reflejará la estructura y los filtros de la jerarquía de organización y se comportará como un modelo cuando corresponda.