Conector de entrada de jerarquía de organización

Acerca del conector de entrada de la jerarquía de organización

Las jerarquías de organización le permiten cargar su estructura organizativa en XM Discover para mejorar los análisis de datos, la personalización del usuario y el control de acceso a datos. Puede utilizar el conector de entrada de jerarquía de organización para cargar y actualizar jerarquías de organización.

Preparación de un archivo de jerarquía de organización

Antes de poder configurar un job de entrada de jerarquía de organización, debe asegurarse de que los datos de jerarquía de organización estén en el formato adecuado y contengan su estructura organizativa.

Las jerarquías de organización se pueden cargar mediante un archivo CSV o Excel (XLS o XLSX).

Consulte las mejores prácticas para jerarquías de organización para obtener ejemplos y directrices de formato para cada tipo de archivo.

Ejemplo: A continuación se muestra un archivo Excel que muestra un ejemplo de estructura organizativa para una empresa hotelera.

Configuración de un job de entrada de jerarquía de organización

Siga los pasos siguientes para configurar un job de entrada de jerarquía de organización. Esta configuración requiere que genere un token de API de jerarquía en Studio, que se recomienda antes de completar los pasos siguientes.

1. En la ficha Jobs, haga clic en Job nuevo.
   
2. Seleccione Jerarquía de organización.
   
3. Asigne un nombre a su trabajo para que pueda identificarlo.
   
4. Seleccione el proyecto en el que desea cargar los datos.
5. Dele una descripción a su trabajo para que conozca su propósito.
6. Haga clic en Siguiente.
7. Elija una cuenta SFTP para utilizar o seleccione Añadir nueva para añadir una nueva.
   
8. Si añade una cuenta nueva, introduzca la siguiente información para su cuenta SFTP:
   • Nombre de conexión: Asigne un nombre a la conexión para que pueda reconocerla más adelante.
   • Nombre de usuario de SFTP: Introduzca el nombre de usuario para conectarse al servidor SFTP.
   • Contraseña de SFTP: Introduzca la contraseña para conectarse al servidor SFTP.
   • Host SFTP: introduzca la URL de host del servidor SFTP.
   • Puerto SFTP: Introduzca su puerto SFTP. Normalmente es 22.
   • Enviar notificaciones de vencimiento: si desea que sus credenciales de SFTP caduquen después de un cierto período de tiempo, seleccione esta opción.
   • Días antes del vencimiento: si activa las notificaciones de expiración, introduzca cuántos días desea que se le notifique antes del vencimiento. Puede introducir un valor entre 1 y 100 días.
   • Fecha de vencimiento: establezca la fecha en la que vencerán las credenciales. Haga clic en la casilla para abrir un calendario para elegir la fecha.
9. Haga clic en Siguiente.
10. Introduzca su Token de API de jerarquía.
    
11. Haga clic en Siguiente.
12. Asigne un nombre a la jerarquía de su organización.
    
13. Elija si desea publicar la jerarquía de su organización o no:
    • Cargar jerarquía de organización: cree y active una jerarquía de organización. Por defecto, 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. La publicación de 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 y la gestión de informes de destino y desviación.
      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.
14. Seleccione opciones de jerarquía adicionales en función de sus preferencias:
    • Generar grupos a partir de este archivo de usuarios: crear grupos basados en el archivo de jerarquía de la organización.
    • Incluir registros sin texto: Incluir registros con literales vacíos en la jerarquía de su organización. Esta opción solo está disponible si publica su jerarquía de organización.
    • Incluir en flujos de datos incrementales: Incluir la jerarquía de organización en ejecuciones de flujo de datos incrementales. Esta opción solo está disponible si publica su jerarquía de organización.
      Consejo Q: Si espera que la publicación de una jerarquía de organización entre en conflicto con otros flujos de datos, 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 está desactivada.
15. Haga clic en Siguiente.
16. Seleccione el tipo de archivo que desea cargar:
    
    • Archivos “planos” separados por delimitadores
    • Archivos Excel (XLS, XLSX)
17. Para los archivos planos separados por delimitadores, existen opciones adicionales para que seleccione:
    
    • Codificación de archivos: elija el sistema de codificación del archivo (UTF-8, ASCII, etc.)
    • Carácter delimitador: introduzca el carácter utilizado para delimitar entradas de datos. De forma predeterminada, es una coma para los archivos CSV.
    • Carácter de cierre: introduzca el carácter que encierra la entrada de datos. Deje este campo en blanco si se selecciona “Sin cierre”.
    • Sin cierre: active esta opción si el archivo no contiene caracteres de cierre.
18. Haga clic en Examinar y seleccione la ruta de la carpeta en el servidor SFTP que contiene el archivo que desea cargar.
    Consejo Q: Al elegir una ruta de carpeta, puede hacer clic en un icono de carpeta para expandirla. Haga clic en el nombre de la carpeta para seleccionarla y, a continuación, haga clic en Aceptar cuando haya terminado.
19. Introduzca la expresión regular del nombre de archivo que coincida con los archivos que desea cargar.
20. Si sus archivos están comprimidos, active Descomprimir archivo(s) e introduzca la expresión regular Nombre de archivo comprimido que coincida con los archivos que se deben descomprimir.
    
21. Si sus archivos están descifrados, active Descifrar archivos e introduzca lo siguiente:
    • Expresión regular de nombre de archivo cifrado: introduzca la expresión regular de nombre de archivo para los archivos que deben descifrarse.
    • Clave PGP/GPG: introduzca la clave PGP/GPG utilizada para el cifrado.
    • Frase de contraseña: Ingrese la frase de contraseña para el descifrado.
22. Si sus archivos están comprimidos y cifrados, debe elegir cuál debe suceder primero:
    • Descomprimir y luego Descifrar: Los archivos se descomprimen y luego se descifran.
    • Descifrar y luego descomprimir: los archivos se descifran y luego se descomprimen.
23. Debe proporcionar un archivo de muestra, que se puede guardar en su equipo o en su servidor SFTP:
    
    • Seleccione Descargar muestra del almacenamiento de archivos si el archivo de muestra se guarda en su servidor SFTP.
    • Seleccione Cargar muestra de mi ordenador si la muestra se guarda en su ordenador.
      Consejo Q: Si es necesario, puede descargar un archivo de plantilla haciendo clic en el enlace que se muestra aquí en la configuración del trabajo.
24. De forma predeterminada, su archivo de muestra no se utiliza para generar la jerarquía de organización. Si desea que su archivo de muestra se utilice para la primera ejecución del trabajo, active Utilizar archivo de muestra cargado para la ejecución inicial del trabajo.
25. Haga clic en el botón Seleccionar archivo y elija el archivo de muestra en su equipo o en su servidor SFTP.
26. Aparecerá una vista previa del archivo. Si ve un mensaje de error o el contenido del archivo sin procesar en lugar de la vista previa, puede haber un problema con las opciones de formato de datos que seleccionó. Consulte Errores de archivo de muestra para obtener ayuda sobre la resolución de problemas de su archivo.
27. Haga clic en Siguiente.
28. Comience a asignar campos de su archivo de muestra a campos de jerarquía de organización en XM Discover. Haga clic en el cuadro de la columna Asignación para seleccionar un campo de jerarquía de organización XM Discover para asignarlo a su campo importado. Los posibles campos de jerarquía de organización incluyen:
    
    • Nivel 1 a nivel 10: Defina la estructura de su jerarquía. 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: cree parámetros de enriquecimiento para su jerarquía. El número máximo de enriquecimientos es 6.
29. Si es necesario, puede transformar los datos entrantes haciendo clic en el icono de engranaje de la columna Transformaciones.
30. Puede añadir campos adicionales haciendo clic en el signo más ( + ) o eliminar campos haciendo clic en el signo menos ( – ) adjunto al campo.
31. Haga clic en Siguiente cuando haya terminado de asignar campos.
32. Seleccione sus opciones de notificación.
    
33. Haga clic en Siguiente.
34. Seleccione Programar ejecuciones incrementales si desea que el job se ejecute periódicamente en una programación o Configurar pull único si desea que el job se ejecute solo una vez. Consulte Programación de jobs para obtener más información.
    
35. Seleccione un período de retención para los archivos procesados. Los archivos se borran después del período establecido.
36. Haga clic en Siguiente.
37. Revise su configuración. Si necesita cambiar una configuración específica, haga clic en el botón Editar para ir a ese paso en la configuración del conector.
    
38. Haga clic en Finalizar para grabar el job.