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 de 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 datos en 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 transformación, por ejemplo agregando, editando o eliminando asignaciones. Sin embargo, los mismos controles para realizar ediciones 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, automáticamente sale del modo de vista previa y ingresa al modo de mapeo (si usa un elemento de interfaz donde permanecería en modo de mapeo) o modo de secuencia de comandos (si abre un secuencia de comandos en un campo de destino).

Para elementos de la interfaz de usuario que son compartidos por múltiples 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, existen dos métodos mediante los cuales se pueden proporcionar datos de muestra:

1. Los datos de muestra los proporciona el usuario
   Usted carga los datos de muestra para usarlos en la vista previa de la transformación cuando configura la vista previa de la transformación. Este método está disponible en estos escenarios:

   • Cuando una transformación tiene un esquema de origen definido dentro de una actividad adyacente, con la excepción de una actividad de consulta 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 fuente 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 ciertos extremos. Este método está disponible en estos escenarios:

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

   • Cuando una transformación tiene un NetSuite adyacente, Salesforce, Salesforce Service Cloud, o Actividad ServiceMax — ya sea una actividad de origen o de destino. Estas opciones se describen en Actividad de NetSuite y Salesforce, Salesforce Service Cloud o Actividad 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 llamen 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 mediante funciones como RunOperation(), RunScript(), SendEmailMessage(), o RunPlugin() se ejecutan, ya que son parte de la transformación. Complementos que se aplican a las actividades no se ejecutan durante una vista previa de la transformación, ya que no forman parte de la transformación.

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

Disponibilidad del Modo de Vista Previa¶

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

Acceder al Modo de Vista Previa¶

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

Desde cualquier modo de 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 Transformación¶

El proceso de configuración de la vista previa de la transformación lo guía a través de la configuración de una transformación para obtener una vista previa. Las áreas específicas que se muestran en la configuración de 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 consulta de base de datos adyacente, 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 puede mostrarse en un paso por sí sola o, si la transformación tiene un NetSuite adyacente, Salesforce, Salesforce Service Cloud, o Actividad ServiceMax, primero se debe seleccionar la opción Vista previa usando archivo de muestra para mostrar esta área.
• Transformaciones con una actividad de consulta de base de datos adyacente muestra Defina la cláusula WHERE como el siguiente paso, que se describe a continuación en Actividad de consulta de base de datos.
• Transformaciones con una actividad NetSuite adyacente (ya sea como origen o como destino) proporciona las opciones para Vista previa usando datos de origen o Vista previa usando archivo de muestra, que se describe a continuación en Actividad de NetSuite. Cuando el objetivo de la transformación es una actividad de NetSuite, los datos de muestra se escriben en el objetivo.
• Transformaciones con un Salesforce adyacente, Salesforce Service Cloud, o Actividad ServiceMax (ya sea como origen o como destino) proporciona las opciones para Vista previa usando datos de origen o Vista previa usando archivo de muestra, que se describe a continuación en NetSuite, Salesforce, Salesforce Service Cloud o ServiceMax Actividad de destino. Cuando el destino de la transformación es una actividad de Salesforce, Salesforce Service Cloud o ServiceMax, los datos de muestra se escriben en el destino.

Desplegar Dependencias¶

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

Cuando la transformación y todas las dependencias son válidas, este paso es similar 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 de la lista y continuar con el siguiente paso.

  Nota

  Bajo ciertas circunstancias, se pueden presentar pantallas adicionales. Consulte Despliegue de la operación para obtener una descripción de estas pantallas:

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

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

Si la transformación o cualquier dependencia no es válida, se identifican en la lista y el botón Siguiente está deshabilitado:

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

seleccionar Datos de Muestra¶

Todas las transformaciones previsualizables, excepto aquellas con una actividad de consulta de base de datos adyacente, muestra un área llamada Seleccionar datos de muestra. El área Seleccionar datos de muestra puede mostrarse en un paso por sí solo (como se muestra en la imagen de la izquierda a continuación) o, si la transformación tiene un NetSuite adyacente, Salesforce, Salesforce Service Cloud, o Actividad 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 fuente.

  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 cita de cierre, un archivo XML al que le falta una etiqueta de cierre, etc.

  • Cargar nuevo archivo para probar: Utilice el botón Examinar a la derecha del campo siguiente para buscar un archivo que aún no se haya utilizado para las pruebas de transformación en el proyecto actual. Aunque se pueden cargar archivos de hasta 1,2 MB, tenga en cuenta que los datos de muestra utilizados para el procesamiento de vista previa de la transformación tienen una limitación de tamaño de 51200 bytes. Estos límites se aplican únicamente para esta prueba preliminar.

    Consejo

    Para generar un archivo de muestra válido para una transformación que utiliza un NetSuite, Salesforce, Salesforce Service Cloud, o Actividad 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 icono del archivo 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. 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 archivo nuevo.
    4. Realice las modificaciones necesarias en el nuevo archivo, como editar campos particulares o agregar o eliminar registros.
    5. Proporcione el nuevo archivo usando Cargar nuevo archivo para probar.

  • Seleccione el archivo cargado previamente para probar: Utilice el menú desplegable en el campo siguiente para seleccionar entre un archivo existente que se haya utilizado previamente para las 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.

• Finalizado: 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 explica 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 caducado. Para solucionarlo, vuelve a cargar el archivo e inténtalo de nuevo.

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

Actividad de Consulta 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 consulta de base de datos.

• Defina la cláusula WHERE: La consultar existente se utiliza para proporcionar 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 usando 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 múltiples objetos usando 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 con 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 cotización apropiado 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.

• Finalizado: 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 explica 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 volver a la transformación sin obtener una vista previa de los datos.

Actividad de NetSuite¶

Cuando una transformación tiene una actividad NetSuite adyacente (ya sea como origen o como destino), el paso proporciona las opciones para 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, descrita 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:

• Finalizado: Haga clic para obtener datos de muestra directamente desde la fuente, recuperar los datos transformados de Harmony y continuar con la pantalla de vista previa de la transformación, que se explica 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 volver a la transformación sin obtener una vista previa de los datos.

Salesforce, Salesforce Service Cloud o Actividad ServiceMax¶

Cuando una transformación tiene un Salesforce adyacente, Salesforce Service Cloud, o Actividad ServiceMax (ya sea como origen o como destino), el paso proporciona las opciones para 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, descrita 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 Fuente¶

Si la actividad Salesforce, Salesforce Service Cloud o ServiceMax es una actividad de consulta y se utiliza como origen 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 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. Las cláusulas SOQL y WHERE originales no se pueden editar ni restringir más.

• Finalizado: Haga clic para obtener datos de muestra directamente desde 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 volver a la transformación sin obtener una vista previa de los datos.

Actividad Objetivo¶

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

• Finalizado: Haga clic para obtener datos de muestra directamente desde 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 volver a la transformación sin obtener una vista previa de los datos.

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 probar la transformación con datos de muestra. Si desea editar el mapeo de transformación, al intentar hacerlo se abre automáticamente el modo de mapeo (si usa un elemento de interfaz donde permanecería en el modo de mapeo) o modo secuencia de comandos (si abre un secuencia de comandos en un campo de destino).

El modo de vista previa muestra datos del archivo de muestra proporcionado o consultar 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 cargado actualmente o la actividad de consultar. Haga clic en el archivo de muestra o en la actividad de consultar para mostrar opciones para borrar o cambiar los datos de muestra, descritos en Borrar o cambiar datos de muestra abajo.

  

• Ciclo de registro: Haga clic en las flechas izquierda y derecha para recorrer los registros dentro del archivo de datos de muestra o consultar datos, 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 transformación, del número total de registros disponibles en el archivo o consultar de muestra.

  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 deshacer para revertir su última acción (consulte Deshacer y Rehacer en Permisos, colaboración y guardado de Cloud Studio).

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

• Datos en línea: Haga clic en el ícono 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 ícono 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 icono de cerrar para salir del modo de vista previa y volver a la pantalla de configuración de transformación.

Borrar o Cambiar Datos de Muestra¶

Haga clic en el nombre del archivo de muestra o 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 consultar los datos y volver a la pantalla de configuración de transformación.

• Cambiar: 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 regresa al paso de definición de la cláusula WHERE para modificar la cláusula WHERE.

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