Exportar excepciones a la aplicación Resultados de Diligent One

Si usa Diligent One, puede exportar datos de excepciones de una tabla de Analytics a una tabla de Resultados. Para exportar excepciones, se utiliza el procedimiento estándar de exportación de datos desde Analytics, con algunas diferencias mínimas.

Resultados es una aplicación de automatización de correcciones y flujos de trabajo que administra datos de excepción, agrega contexto humano a través de cuestionarios y hace que su monitoreo sea continuo con disparadores y medidas. Si desea obtener más información, consulte Trabajar con datos en Resultados.

Requisitos de seguridad

La capacidad de exportar datos de excepciones a una prueba de control en Resultados requiere una asignación específica de roles o privilegios de administrador de Diligent One:

• Los usuarios con el rol de Usuario profesional o Gerente profesional para una colección de Resultados pueden exportar resultados a cualquier prueba de control de la colección.

  Nota

  Únicamente los usuarios con el rol de Gerente profesional pueden sobrescribir los datos existentes en una prueba de control.

• Los administradores de la cuenta de Diligent One y los administradores de Resultados obtienen automáticamente el rol de Gerente profesional sobre todas las colecciones de las instancias de Diligent One que administran.

Para obtener más información, consulte Permisos de la aplicación Resultados.

Límites de la exportación

A continuación, se muestran los límites que se aplican al exportar a una prueba de control en Resultados.

Dentro de estos límites, se puede exportar varias veces a la misma prueba de control. Si ya existen datos en la prueba de control, usted tiene la opción de sobreescribirlos o de anexar los nuevos datos.

Elemento	Máximo
Registros por exportación	100.000
Registros por prueba de control	100.000
Campos por registro	500
Caracteres por campo	256

Mantener los campos alineados entre Analytics y Resultados

If you are round-tripping data between Resultados and Analytics, you need to ensure that all field names in the Resultados table meet the more stringent Analytics field name requirements. If you do not, you risk misaligning your Analytics and Resultados data.

For example, any special characters in Resultados field names are automatically converted to underscores when they are imported into Analytics, which means the field names no longer match the original names in Resultados. If you then export the Analytics data back to the original table in Resultados, fields are no longer correctly matched.

To avoid this problem with data that you intend to round-trip, make sure that before you upload the data to Resultados from CSV or Excel files it meets these Analytics field name requirements:

• no special characters or spaces
• does not start with a number
• contains only alphanumeric characters, or the underscore character ( _ )

Opción Sobrescribir y clave primaria de Resultados

Al exportar datos de excepciones desde Analytics a una tabla existente de Resultados, usted puede anexar los datos exportados a la tabla o sobrescribir toda la tabla.

Si la tabla de Resultados tiene un campo especificado como clave primaria y los datos que está exportando contienen un campo correspondiente, el comportamiento de la exportación es algo diferente. Para obtener más información acerca de la especificación de claves primarias en Resultados, consulte Especificación de una clave primaria.

Las diferentes posibilidades se resumen a continuación.

	No hay una clave primaria en Resultados	Clave primaria en Resultados
La opción Sobrescribir no está seleccionada	los datos exportados se anexan a la tabla de Resultados existente	valor de coincidencia si existe un valor de coincidencia en el campo de clave primaria de Resultados y el campo correspondiente exportado desde Analytics, se actualiza el registro de Resultados con los valores presentes en el registro exportadoResultsAnalyticsResults sin valor de coincidencia si no existe un valor de coincidencia en el campo de clave primaria en Resultados y el campo correspondiente exportado desde Analytics, no se actualiza el registro de Resultados y el registro exportado se anexa a la tablaResultsAnalyticsResults
La opción Sobrescribir está seleccionada	los datos exportados reemplazan (sobrescriben) la tabla de Resultados existente	los datos exportados reemplazan (sobrescriben) la tabla de Resultados existente

Exportar excepciones a Resultados

Especificar los campos que se deben exportar

1. Abra la tabla con los datos de excepción que desea exportar.
2. Seleccione Datos > Exportar.
3. En la ficha Principal, seleccione una de las siguientes acciones:
   • Campos especifique qué campos desea exportar

     Cuando seleccione esta opción, los campos se exportarán utilizando los nombres de campo físicos del formato de tabla.

     Si desea obtener información sobre cómo renombrar campos, consulte Renombrar un campo en un formato de tabla.

   • Vista exporte todos los campos de la vista actual

     Cuando seleccione esta opción, los campos se exportarán utilizando los nombres visibles de las columnas. Los campos se exportan en el mismo orden que aparecen en la vista.

     Si desea obtener información sobre cómo renombrar columnas, consulte Cambiar el nombre de las columnas de una vista.

4. Si selecciona Campos, realice una de las siguientes acciones:
   • Seleccione el campo o los campos que exportará desde la lista Exportar campos.

     Consejo

     Puede presionar Ctrl+clic para seleccionar varios campos no adyacentes y Mayús+clic para seleccionar varios campos adyacentes.

   • Haga clic en Exportar campos para seleccionar el campo o los campos, o para crear una expresión.

Seleccionar las opciones de exportación

1. En la lista desplegable Exportar como, seleccione Diligent One.
2. Realice una de las siguientes acciones:
   • Anexar a la tabla de Resultados

     Si desea anexar los datos exportados a la tabla existente de Resultados, deje la opción Sobrescribir sin seleccionar.

     Nota

     Los campos de Analytics solo pueden anexarse a campos de Resultados existentes si los nombres de los campos físicos coinciden, sin importar su nombre visible en cualquiera de las aplicaciones. En Analytics, el nombre de campo físico es el nombre en el formato de la tabla.

     El orden de los campos en las dos aplicaciones no afecta la coincidencia del nombre de campo.

     Los campos exportados con nombres físicos que no coinciden con el nombre físico de un campo en la tabla de Results crean nuevas columnas en la tabla.

   • Reemplazar (sobrescribir) la tabla de Resultados

     Si desea reemplazar la tabla existente en Resultados, seleccione Sobrescribir.

   Si desea obtener más información, consulte Opción Sobrescribir y clave primaria de Resultados.

3. (Opcional) Si desea exportar los nombres visibles de las columnas a Resultados, seleccione Incluir el nombre visible del campo.

   Al seleccionar esta opción, los nombres visibles de las columnas y el nombre físico en Resultados son idénticos a los nombres de Analytics.

   Si no selecciona Incluir el nombre visible del campo, el resultado depende de si está exportando por campos o por vista:

   	Exportar campos	Exportar vista
   Incluir el nombre visible del campo seleccionado	El nombre del campo en Resultados es el nombre del campo de Analytics. Nombre visible en Resultados es el nombre visible de Analytics.
   Incluir el nombre visible del campo no está seleccionado	El nombre del campo y el nombre visible en Resultados son el nombre del campo de Analytics.	Nombre del campo y nombre visible en Resultados son el nombre visible de Analytics.

   Nota

   No seleccione Incluir el nombre visible del campo si está anexando una vista a una tabla de Resultados creada inicialmente por medio de la exportación de una vista desde una versión de Analytics anterior a 14.1. Si lo hace, es posible que exporte columnas con nombres de campo que no sean iguales a los nombres de Resultados y esto hará que se creen nuevas columnas en Resultados y provocará la alineación incorrecta de los datos entre las aplicaciones.

Finalizar la exportación

1. Si hay registros en la vista principal que desee excluir del procesamiento, introduzca una condición en el cuadro de texto Si, o haga clic en Si para crear un enunciado IF usando Generador de expresiones.

   Nota

   La condición If se evalúa únicamente con los registros que quedan en una tabla después de aplicar las opciones de alcance (Primeros, Siguientes, Mientras).

   El enunciado IF considera todos los registros en la vista principal y filtra los que no cumplan la condición especificada.

2. Realice una de las siguientes acciones:

   Si conoce el número de ID de la tabla a la que está exportando:

   Introduzca el número del identificador en el cuadro de texto En.

   • Escriba el número sin comillas; por ejemplo 99
   • Ingrese solo el número. No introduzca un nombre de archivo.
   • Si está exportando a un centro de datos que no está en Estados Unidos, también debe especificar el código del centro de datos. El número de ID de la prueba de control y el código del centro de datos deben estar separados por el signo (@); por ejemplo, 99@eu. El código del centro de datos especifica a qué servidor regional de Diligent One va a exportar los datos.
     • af – África (Sudáfrica)
     • ap – Asia-Pacífico (Singapur)
     • au – Asia-Pacífico (Australia)
     • ca – Norteamérica (Canadá)
     • eu – Europa (Alemania)
     • jp – Asia-Pacífico (Tokio)
     • sa – América del Sur (Brasil)
     • us –Norteamérica (EE. UU.)

     Puede utilizar únicamente los códigos de centros de datos autorizados para la instancia de Diligent One de su organización. El centro de datos de Norteamérica (US) es el valor predeterminado, por lo que especificar "@us" es opcional.

   Si no conoce el número de ID de la tabla a la que está exportando, o si desea crear una nueva tabla:

   1. Haga clic en En, y en el cuadro de diálogo Seleccionar prueba de destino navegue a la carpeta de análisis correspondiente.
   2. Realice una de las siguientes acciones:
      • Seleccione una tabla existente y haga clic en Aceptar.
      • En el campo Nuevo estudio analítico de datos, escriba un nombre y haga clic en Crear.

      Volverá al cuadro de diálogo Exportar y el número de identificación de la prueba de control y el código del centro de datos se precargarán en el cuadro de texto En.

3. Haga clic en la ficha Propiedades.

4. En el panel Alcance, seleccione la opción que corresponda:

   • Todo
   • Primeros
   • Siguiente
   • Mientras
   Mostrar más

   Opción de alcance	Detalles
   Todo	(Predeterminado) Especifica que se procesen todos los registros de la vista.
   Primeros	Ingrese un número en el cuadro de texto. Inicia el procesamiento en el primer registro de la vista e incluye solo el número de registros especificado.
   Siguiente	Ingrese un número en el cuadro de texto. Inicia el procesamiento en el registro seleccionado actualmente en la vista e incluye solo el número de registros especificado. El número real de registros debe seleccionarse en la columna ubicada en el extremo izquierdo de la vista, no en los datos de la fila.
   Mientras	Utilice un enunciado WHILE para limitar el procesamiento de registros en la vista basándose en un criterio o un conjunto de criterios. Ingrese una condición en el cuadro de texto While o haga clic en While para crear un enunciado WHILE con el Generador de expresiones. Un enunciado WHILE permite que los registros en la vista principal sean procesados sólo mientras la condición especificada se evalúe como verdadera. Tan pronto como la condición se evalúa como falsa, el procesamiento termina, y no se consideran más registros. Puede utilizar la opción Mientras junto con las opciones Todos, Primero o Siguiente. El procesamiento de registros se detiene en cuanto se alcanza un límite.

   Nota

   Las opciones Primero o Siguiente hacen referencia al orden físico o al orden indexado de los registros en una tabla. Primero o Siguiente ignoran cualquier filtrado u ordenación rápida que se aplique a una vista de tabla. Sin embargo, los resultados de salida de las operaciones analíticas respetan cualquier filtrado.

   Si a una vista se aplica ordenación rápida, Siguiente se comporta como Primero.

5. Haga clic en Aceptar.

   Aparecerá un indicador de avance mientras se exportan los datos de las excepciones a Resultados. Cuando la operación de exportación está completa se crea una entrada en el log.

Se necesita una contraseña

No se necesita una contraseña

No es necesario especificar una contraseña para exportar a Resultados si ha utilizado la activación en línea para activar su copia de Analytics. La contraseña se crea automáticamente y se envía a Resultados en función de la información de activación almacenada en su equipo.

Se necesita una contraseña

Necesita especificar una contraseña para exportar a Resultados en estas situaciones:

• Utilizó la activación sin conexión para activar su copia de Analytics.

• Utiliza un script para exportar a Resultados y ejecuta el script en Robots.

El valor de la contraseña obligatoria es un token de acceso a Diligent One.

Adquiera un token de acceso de Diligent One

Utilice un token de acceso existente, a menos que tenga un motivo para crear uno nuevo. Si el token existente no funciona, cree uno nuevo. El uso de un token existente reduce la cantidad de tokens que necesita administrar.

1. Realice una de las siguientes acciones:

   • En el menú principal de Analytics, seleccione Herramientas > Token de acceso Diligent One.

   • En el Editor de scripts, haga clic con el botón derecho del ratón y seleccione Insertar > Token de Diligent One.

   Se abre la página Administrar tokens de API en el navegador. Es posible que deba iniciar sesión primero en Diligent One.

   Acceder a la página Administrar tokens de API desde Analytics es una función muy práctica. También puede iniciar sesión en Diligent One para acceder a la página desde su perfil de usuario sin usar Analytics.

2. Realice una de las siguientes acciones:

   • Usar un token existente

     1. En la columna Token, haga clic en el token parcialmente enmascarado que desea utilizar.

     2. Introduzca la contraseña de su cuenta de Diligent One y haga clic en Confirmar.Diligent One

        Se muestra el token sin enmascarar.

     3. Haga clic en Copiar para copiar el token.

        Consejo

        No cierre el cuadro de diálogo que contiene el token hasta que haya pegado el token correctamente.

   • Cree un nuevo token

     1. Haga clic en Agregar token > Analytics.

     2. En el panel lateral Nuevo token de Analytics, especifique la siguiente información:

        Campo u opción	Descripción
        Descripción	Introduzca una descripción que proporcione información útil, por ejemplo: El propósito del token Dónde se utiliza el token, por ejemplo, el nombre y la ubicación del script de Analytics, o el nombre y la ubicación de la tarea del robot
        Caducidad del token	Activado el token caduca después del número de días que especifique Desactivado el token nunca caduca Nota Es posible que su organización tenga una política de seguridad que requiera que los tokens caduquen después de cierto tiempo. La creación de tokens con fecha de caducidad es una buena práctica. Diligent One le envía por correo electrónico una notificación automatizada antes de la fecha de caducidad.
        Caduca en	Especifique los días que faltan para que el token caduque (de 1 a 365).
        Contraseña	Introduzca la contraseña de su cuenta de Diligent One.

     3. Haga clic en Generar token.

     4. Haga clic en Copiar para copiar el token.

        Consejo

        No cierre el panel lateral que contiene el token hasta que haya pegado el token correctamente.

3. En función del método de definición de contraseña y de acceso a los datos que utilice, realice una de estas acciones:

   Interfaz de usuario de Analytics

   Pegue el token que ha copiado en la solicitud de contraseña que aparezca al acceder a Diligent One manualmente.

   Script de Analytics

   • Comando PASSWORD Pegue el token que ha copiado en la solicitud de contraseña que aparezca durante la ejecución del script.

   • Comando SET PASSWORD Pegue el token que ha copiado en el lugar adecuado de la sintaxis del comando SET PASSWORD de un script.

4. En Launchpad, cierre el cuadro de diálogo o el panel lateral que contiene el token.

   Si creó un nuevo token, se agrega una versión parcialmente enmascarada del token en la parte superior de su lista de tokens.

   Si desea más información, consulte Creación y administración de tokens de acceso de Diligent One.