Modo de Vista Previa¶

Introducción¶

El modo de vista previa proporciona una interfaz de solo lectura para usar datos de muestra para probar cómo la transformación procesará los datos.

El modo de vista previa se basa en la visualización del modo de mapeo, donde se muestra una descripción general del mapeo de transformación. Además de mostrar los elementos de la interfaz del modo de mapeo, el modo de vista previa incluye una visualización en línea de los datos de cada campo de origen y destino, así como controles para interactuar con la interfaz del modo de vista previa, como se describe en esta página.

En el modo de vista previa, no es posible editar la configuración de la transformación, por ejemplo, agregando, editando o eliminando asignaciones. Sin embargo, los mismos controles para realizar modificaciones que se muestran en el modo de asignación también se muestran en el modo de vista previa.

Cuando intenta editar la transformación, sale automáticamente del modo de vista previa y entra en el modo de mapeo (si se utiliza un elemento de interfaz en el que permanecería en modo de mapeo) o modo de secuencia de comandos (si se abre un secuencia de comandos en un campo de destino).

Para los elementos de la interfaz de usuario que comparten varios modos de visualización, consulte Elementos del modo común.

Procesamiento de Vista Previa de Transformación¶

Al configurar una vista previa de transformación, hay dos métodos mediante los cuales se pueden proporcionar datos de muestra:

1. Los datos de muestra son proporcionados por el usuario Los datos de muestra que se utilizarán para la vista previa de la transformación se cargan cuando se configura la vista previa de la transformación. Este método está disponible en estos casos:

   • Cuando una transformación tiene un esquema de origen definido dentro de una actividad adyacente, con la excepción de una Actividad de consultar de base de datos.
   • Cuando una transformación tiene un esquema de origen definido dentro de la transformación (ya sea con o sin una actividad de origen adyacente).

   Esta opción se describe en Seleccionar datos de muestra más adelante en esta página.

2. Los datos de muestra los proporciona la operación Los datos de muestra se obtienen de la operación para determinados extremos. Este método está disponible en estos escenarios:

   • Cuando una transformación tiene una Actividad de consultar de base de datos. Tiene la opción de aplicar una cláusula WHERE adicional para limitar la cantidad de registros recuperados para fines de vista previa. Esta opción se describe en Actividad de consultar de base de datos más adelante en esta página.

   • Cuando una transformación tiene un NetSuite, Salesforce, Salesforce Service Cloud, o actividad de ServiceMax — ya sea una actividad de origen o de destino. Estas opciones se describen en Actividad de NetSuite y actividad de Salesforce, Salesforce Service Cloud o ServiceMax más adelante en esta página.

El modo de vista previa muestra los datos de muestra tal como se escribirán en el destino de la transformación utilizando cualquier secuencias de comandos especificado dentro de la transformación. En general, los pasos abajo en la cadena en la misma operación o las operaciones abajo en la cadena en sí no se ejecutan a menos que se las llame dentro de un secuencia de comandos de transformación. (Como se indica al final de esta sección, cuando ciertas actividades son el objetivo de la transformación, los datos de muestra se escriben en el objetivo).

Por ejemplo, operaciones, secuencias de comandos, notificaciones correo o complementos que se llaman en una transformación utilizando funciones como RunOperation(), RunScript(), SendEmailMessage(), o RunPlugin() se ejecutan, ya que son parte de la transformación. Plugins que se aplican en las actividades no se ejecutan durante una vista previa de la transformación, ya que no son parte de la transformación.

El límite de tamaño de un registro individual durante la vista previa de una transformación es de 384 KB comprimido o aproximadamente 512 KB sin comprimir. No hay límite de tamaño de registro en el tiempo de ejecución de la operación.

Disponibilidad del Modo de Vista Previa¶

El modo de vista previa solo está disponible cuando la transformación tiene un esquema de origen y uno de destino especificados. Los esquemas de origen y destino pueden estar definidos por una actividad adyacente de cualquier tipo de extremo o pueden estar definidos en una transformación.

El modo de vista previa no se puede utilizar en archivos de origen o datos en formato XSD o ZIP, ya que los valores no están presentes en estos tipos de archivos. (Se puede utilizar un archivo XML que implemente XSD).

Acceder al Modo de Vista Previa¶

Cuando el modo de vista previa está disponible, una el icono de vista previa se muestra dentro de la barra de herramientas de transformación.

Desde cualquiera de los dos modos mapeo o modo secuencia de comandos, haga clic en el icono de vista previa:

Luego, proporciona información para configurar la vista previa de la transformación, como se describe a continuación.

Configurar una Vista Previa de la Transformación¶

El proceso de configuración de la vista previa de la transformación lo guía a través del proceso de configuración de una transformación para obtener una vista previa. Las áreas específicas que se muestran en la configuración de la vista previa dependen de estos criterios:

• Las Transformaciones que dependen de componentes que aún no se han implementado muestran Componentes requeridos como el primer paso de configuración, que se describe a continuación en Desplegar dependencias.
• Todas las transformaciones previsualizables, excepto aquellas con una Actividad de consultar de base de datos, muestra un área llamada Seleccionar datos de muestra, que se describe a continuación en Seleccionar datos de muestra. El área Seleccionar datos de muestra se puede mostrar en un paso por sí sola o, si la transformación tiene un NetSuite adyacente, Salesforce, Salesforce Service Cloud, o actividad de ServiceMax, primero se debe seleccionar la opción Vista previa usando archivo de muestra para mostrar esta área.
• Transformaciones con una Actividad de consultar de base de datos muestra Definir la cláusula WHERE como el siguiente paso, descrito a continuación en Actividad de consultar de base de datos.
• Transformaciones con una actividad NetSuite (ya sea como fuente o como destino) proporciona las opciones para Obtener una vista previa usando datos de origen o Obtener una vista previa usando un archivo de muestra, que se describen a continuación en Actividad de NetSuite. Cuando el objetivo de la transformación es una actividad de NetSuite, se escriben datos de muestra en el objetivo.
• Transformaciones con un Salesforce, Salesforce Service Cloud, o actividad de ServiceMax (ya sea como origen o destino) proporciona las opciones para Obtener una vista previa usando datos de origen o Obtener una vista previa usando un archivo de muestra, que se describen a continuación en Actividad de destino de NetSuite, Salesforce, Salesforce Service Cloud o ServiceMax. Cuando el objetivo de la transformación es una actividad de Salesforce, Salesforce Service Cloud o ServiceMax, se escriben datos de muestra en el objetivo.

Desplegar Dependencias¶

El paso Componentes requeridos está presente solo si aún no ha implementado todas las operaciones de las que depende la transformación. Si ya ha implementado todas las operaciones de las que depende la transformación, el primer paso se basa en los otros criterios enumerados al comienzo de esta sección.

Cuando la transformación y todas las dependencias son válidas, este paso se parece al que se muestra a continuación:

• Componentes requeridos: Revise los componentes que se desplegarán al hacer clic en Siguiente.

• Siguiente: Haga clic para desplegar los componentes en la lista y continuar con el siguiente paso.

  Nota

  En determinadas circunstancias, pueden aparecer pantallas adicionales. Consulte Despliegue de la operación para obtener una descripción de estas pantallas:

  • Seleccionar cronogramas y variables del proyecto: Si hay variables o cronogramas de proyecto que se están implementando y que ya se han implementado en la nube de Harmony, una pantalla le presentará opciones para seleccionar qué valores usar.
  • Agregar etiquetas y comentarios: Si las configuraciones de despliegue a nivel de proyecto se han configurado para requerir una etiqueta y/o un comentario durante la despliegue, se presenta un cuadro de diálogo para ingresar la etiqueta y/o el comentario requerido.

• Cancelar: Haga clic para cerrar la pantalla de configuración de vista previa y regresar a la transformación sin obtener una vista previa de los datos.

Si la transformación o alguna dependencia no son válidas, se identifican en la lista y se deshabilita el botón Siguiente:

Cancele o cierre la pantalla de configuración de vista previa para corregir la validez de los componentes no válidos antes de intentar obtener una vista previa de la transformación nuevamente. Para obtener información sobre la validez, consulte Validez de la asignación de Transformación y Validez del componente.

seleccionar Datos de Muestra¶

Todas las transformaciones previsualizables, excepto aquellas con una Actividad de consultar de base de datos, muestra un área llamada Seleccionar datos de muestra. El área Seleccionar datos de muestra puede mostrarse en un paso por sí sola (como se muestra en la imagen de la izquierda a continuación) o, si la transformación tiene un NetSuite, Salesforce, Salesforce Service Cloud, o actividad de ServiceMax, primero se debe seleccionar la opción Vista previa usando archivo de muestra para mostrar esta área (que se muestra en la imagen de la derecha a continuación).

• Seleccionar datos de muestra: Seleccione una de las opciones para proporcionar datos de muestra para obtener una vista previa en la transformación. El contenido y el formato del archivo de muestra deben ser compatibles con el esquema de origen (los archivos XSD y ZIP no son compatibles).

  Nota

  Si el archivo tiene un formato no válido, un mensaje de error genérico indica "sampleDataLoadFailure". Las posibles causas de un formato no válido incluyen un archivo CSV al que le falta el encabezado, un archivo JSON al que le falta una comilla de cierre, un archivo XML al que le falta una etiqueta de cierre, etc.

  • Cargar nuevo archivo para probar: Use el botón Explorar a la derecha del campo que se encuentra a continuación para buscar un archivo que aún no se haya usado para la prueba de transformación en el proyecto actual. Si bien se pueden cargar archivos de hasta 1,2 MB, tenga en cuenta que los datos de muestra utilizados para el procesamiento de la vista previa de la transformación tienen un límite de tamaño de 51200 bytes. Estos límites se aplican solo para esta prueba de vista previa.

    Consejo

    Para generar un archivo de muestra válido para una transformación que utiliza un NetSuite, Salesforce, Salesforce Service Cloud, o actividad de ServiceMax:

    1. Utilice Crear datos simulados a partir de la estructura de origen para generar un registro de muestra.
    2. Cambie la vista de la transformación haciendo clic en el botón icono de archivo de muestra para ver los datos de origen de muestra y el archivo de destino con los datos de muestra que se generarían si se ejecutara la transformación. Esta vista incluye etiquetas adicionales que no se generan al reflejar un esquema.
    3. Copie y pegue el contenido del lado de origen o de destino (según corresponda) en un nuevo archivo.
    4. Realice las modificaciones necesarias en el nuevo archivo, como editar campos específicos o agregar o eliminar registros.
    5. Proporcione el nuevo archivo utilizando Cargar nuevo archivo para probar.

  • Seleccionar archivo cargado previamente para probar: Utilice el menú desplegable en el campo a continuación para seleccionar un archivo existente que se haya utilizado previamente para pruebas de transformación en el proyecto actual.

  • Crear datos simulados a partir de la estructura de origen: Seleccione para generar datos aleatorios basados en la estructura del esquema de origen.

• Terminado: Haga clic para cargar los datos de muestra, recuperar los datos transformados de Harmony y continuar con la pantalla de vista previa de la transformación, que se describe más adelante en esta página en Vista previa de una transformación.

  Precaución

  Los archivos fuente cargados que se utilizan para obtener una vista previa de una transformación se eliminan periódicamente de Harmony. En este caso, es posible que reciba un error que indique que no hay ningún archivo fuente disponible para realizar pruebas o que el archivo fuente puede haber expirado. Para resolver el problema, vuelva a cargar el archivo e inténtelo de nuevo.

• Cancelar: Haga clic para cerrar la pantalla de configuración de vista previa y regresar a la transformación sin obtener una vista previa de los datos.

Actividad de Consultar de Base de Datos¶

El paso Definir la cláusula WHERE se muestra cuando la transformación utiliza una fuente con un esquema definido a partir de una actividad de consultar de base de datos.

• Definir la cláusula WHERE: La consultar existente se utiliza para proporcionar los datos de muestra para la vista previa. En este paso, puede limitar aún más los datos de muestra que se cargan proporcionando una cláusula WHERE.

  • SQL original: Si se crea a partir de una consultar de un solo objeto mediante el asistente o una consultar manual, la declaración SQL original utilizada en la actividad de origen se incluye como referencia. El SQL original no se mostrará para una consultar de varios objetos que utilice el asistente.

  • Cláusula WHERE original: La cláusula WHERE original, si está presente, se incluye como referencia.

  • Cláusula WHERE que se utilizará en esta vista previa (opcional): Si lo desea, ingrese una cláusula WHERE que se aplicará para obtener una vista previa de la transformación. Esto se puede utilizar para limitar la cantidad de registros recuperados para fines de vista previa. Si tiene una cláusula WHERE original, se utiliza otra cláusula WHERE proporcionada aquí además de la cláusula original, que no se sobrescribe.

    Nota

    La sintaxis utilizada para la cláusula WHERE distingue entre mayúsculas y minúsculas y debe utilizar el identificador de comillas adecuado del tipo de base de datos específico. Para ver ejemplos de cláusulas WHERE, consulte Información específica de la base de datos.

• Terminado: Haga clic para cargar los datos de muestra, recuperar los datos transformados de Harmony y continuar con la pantalla de vista previa de la transformación, que se describe más adelante en esta página en Vista previa de una transformación.

• Cancelar: Haga clic para cerrar la pantalla de configuración de vista previa y regresar a la transformación sin obtener una vista previa de los datos.

Actividad de NetSuite¶

Cuando una transformación tiene una actividad de NetSuite (ya sea como origen o como destino), el paso proporciona las opciones Vista previa usando datos de origen o Vista previa usando archivo de muestra. La opción Vista previa usando archivo de muestra muestra el área Seleccionar datos de muestra, que se describe en Seleccionar datos de muestra anteriormente en esta página.

Cuando se selecciona Vista previa usando datos de origen, se muestra el texto Haga clic en Finalizar para ejecutar la operación y obtener datos de vista previa:

• Terminado: Haga clic para obtener datos de muestra directamente de la fuente, recuperar los datos transformados de Harmony y continuar con la pantalla de vista previa de la transformación, que se describe más adelante en esta página en Vista previa de una transformación.
• Cancelar: Haga clic para cerrar la pantalla de configuración de vista previa y regresar a la transformación sin obtener una vista previa de los datos.

Actividad de Salesforce, Salesforce Service Cloud o Servicemax¶

Cuando una transformación tiene un Salesforce, Salesforce Service Cloud, o actividad de ServiceMax (ya sea como origen o como destino), el paso proporciona las opciones Vista previa usando datos de origen o Vista previa usando archivo de muestra. La opción Vista previa usando archivo de muestra muestra el área Seleccionar datos de muestra, que se describe en Seleccionar datos de muestra anteriormente en esta página.

Lo que se muestra para la opción Vista previa usando datos de origen depende de si la actividad es una actividad de origen o de destino para la transformación:

Actividad de Origen¶

Si la actividad de Salesforce, Salesforce Service Cloud o ServiceMax es una actividad de consulta y se utiliza como fuente para la transformación, se muestran la declaración SOQL y la cláusula WHERE original:

• SOQL: Revise la declaración de consultar existente de la actividad, que se utiliza para proporcionar los datos de muestra para la vista previa.

  • Cláusula WHERE original: Revise la cláusula WHERE existente, si está presente, que se utiliza para limitar los datos de muestra para obtener una vista previa en la transformación.

  Nota

  Este paso es solo para fines informativos. La cláusula SOQL y WHERE original no se puede editar ni restringir más.

• Terminado: Haga clic para obtener datos de muestra directamente de la fuente, recuperar los datos transformados de Harmony y continuar con la pantalla de vista previa de la transformación, que se describe a continuación en Vista previa de una transformación.

• Cancelar: Haga clic para cerrar la pantalla de configuración de vista previa y regresar a la transformación sin obtener una vista previa de los datos.

Actividad Objetivo¶

Si la actividad de Salesforce, Salesforce Service Cloud o ServiceMax es una actividad distinta de una actividad de consulta y se utiliza como destino de la transformación, se muestra el texto Haga clic en Finalizar para ejecutar la operación y obtener datos de vista previa.

• Terminado: Haga clic para obtener datos de muestra directamente de la fuente, recuperar los datos transformados de Harmony y continuar con la pantalla de vista previa de la transformación, que se describe a continuación en Vista previa de una transformación.
• Cancelar: Haga clic para cerrar la pantalla de configuración de vista previa y regresar a la transformación sin obtener una vista previa de los datos.

Obtener una Vista Previa de una Transformación¶

La pantalla de transformación se carga en modo de vista previa. Este modo es similar al modo de mapeo, excepto que es de solo lectura y tiene opciones adicionales relacionadas con la prueba de la transformación con datos de muestra. Si desea editar la asignación de transformación, al intentar hacerlo se abre automáticamente el modo de asignación (si usa un elemento de interfaz en el que permanecería en el modo de asignación) o modo de secuencia de comandos (si se abre un secuencia de comandos en un campo de destino).

El modo de vista previa muestra datos del archivo de muestra o consultar proporcionados en línea junto a cada campo de origen y cada campo de destino asignado:

En el modo de vista previa, la barra de herramientas de transformación proporciona un conjunto de herramientas para interactuar con la interfaz del modo de vista previa:

• Datos de muestra: Se muestra el nombre del archivo de muestra o de la actividad de consultar cargados actualmente. Haga clic en el archivo de muestra o en la actividad de consultar para mostrar las opciones para borrar o cambiar los datos de muestra, que se describen en Borrar o cambiar datos de muestra a continuación.

  

• Ciclo de registro: Haga clic en las flechas izquierda y derecha para recorrer los registros dentro del archivo de datos de muestra o los datos de consultar, actualizando la lectura de datos de vista previa:

  

  El primer número indica qué datos de registro se muestran actualmente en la vista previa de la transformación, del número total de registros disponibles en el archivo de muestra o consultar.

  Nota

  Dentro de los datos de vista previa, hay flechas adicionales disponibles en los nodos que tienen múltiples subregistros dentro de un registro para recorrerlos:

  

• Deshacer: Haga clic en el icono de deshacer para revertir su última acción (vea Deshacer y rehacer en Permisos, colaboración y guardado de Cloud Studio).

• Rehacer: Haga clic en el icono de rehacer para revertir su última acción Deshacer (vea Deshacer y rehacer en Permisos, colaboración y guardado de Cloud Studio).

• Datos en línea: Haga clic en el botón icono de datos en línea para ver la vista previa en línea de los datos. Esta es la vista predeterminada.

• Archivos de muestra: Haga clic en el icono icono de archivos de muestra para ver los datos de origen de muestra y el archivo de destino con datos de muestra que se generarían si se ejecutara la transformación:

  

• Cerrar: Haga clic en el Cerrar icono para salir del modo de vista previa y regresar a la pantalla de configuración de la transformación.

Borrar o Cambiar Datos de Muestra¶

Haga clic en el nombre del archivo de muestra o de la actividad de consultar para mostrar opciones para borrar o cambiar los datos de muestra:

• Borrar: Haga clic para eliminar los datos del archivo de muestra o los datos de la consultar y regresar a la pantalla de configuración de la transformación.

• Cambio: Haga clic para reemplazar los datos del archivo de muestra o los datos de la consultar. El comportamiento depende de cómo se hayan definido los datos de muestra:

  • Archivo de muestra: Si usa un archivo de muestra, esto lo regresa al paso de selección de datos de muestra para seleccionar otro archivo.

  • Consulta de base de datos: Si utiliza una actividad de consulta de base de datos, esto lo lleva de regreso al paso de definición de la cláusula WHERE para modificar la cláusula WHERE.

  • Consulta de Salesforce / Salesforce Service Cloud / ServiceMax: Si usa una actividad de consulta de Salesforce, Salesforce Service Cloud o ServiceMax, esto lo regresa al paso 2 de la configuración de esa actividad consultar de Salesforce, consultar de Salesforce Service Cloud, o Actividad de consulta de ServiceMax para modificar la declaración de consultar.