Guía de inicio rápido para Jitterbit Design Studio

Introducción

Esta guía está destinada a nuevos usuarios de Design Studio, la aplicación de escritorio de Jitterbit donde puedes diseñar, probar y desplegar proyectos de integración. Esta guía te llevará a través del proceso de diseño de tu primer proyecto en Design Studio.

Si no estás utilizando Design Studio y en su lugar estás usando Studio, nuestra aplicación de diseño de proyectos basada en la web, consulta la guía de inicio rápido de Studio. Contacta a tu Gerente de Éxito del Cliente para determinar qué aplicación de Studio se adapta mejor a tus necesidades para nuevos proyectos, o para programar una Evaluación de Preparación para mover proyectos existentes de Design Studio a Studio.

Para esta guía, comenzamos con el proceso de importar un proyecto existente y ejecutar operaciones. Luego mostramos cómo diseñar un proyecto desde cero, incluyendo la creación de un proyecto y la configuración de dos de las mismas operaciones ya proporcionadas en el proyecto de muestra.

Para seguir, descarga el proyecto de muestra Starter Pack Jitterpak (.JPK).

Las dos partes de esta guía cubren estas tareas en Design Studio:

• Parte 1: Comenzar con un proyecto de muestra
  • Importar un Jitterpak
  • Verificar datos existentes
  • Ejecutar operaciones y verificar nuevos datos
• Parte 2: Diseñar un nuevo proyecto
  • Crear un proyecto
  • Crear operaciones

Parte 1: Comenzar con un proyecto de muestra

Esta parte cubre la importación de un Jitterpak, la verificación de datos existentes en Salesforce y luego la inserción de datos de clientes desde una variedad de fuentes diferentes (CSV, JSON, base de datos, XML) a Salesforce. Después de cada inserción, podemos verificar Salesforce para ver que se han creado datos.

Importar un Jitterpak

Importa el proyecto de muestra Starter Pack Jitterpak (.JPK).

1. Abre la aplicación Design Studio.

   

2. Importa el proyecto de ejemplo Starter Pack Jitterpak (.JPK). Para hacer esto:

   1. Ve a Archivo > Importar Jitterpak:

      

   2. En la ventana Seleccionar Jitterpak, completa cada paso de la siguiente manera:

      1. Seleccionar JPK: Navega hasta o ingresa la ubicación del Jitterpak. Luego haz clic en Siguiente.

         

      2. Opciones: Para aceptar todos los valores predeterminados, haz clic en Siguiente.

         

      3. Variables del Proyecto: Proporciona credenciales para tu cuenta de Salesforce reemplazando el Valor de cada una de las Variables. Luego haz clic en Finalizar.

         

3. Verifica que los elementos del proyecto se hayan importado.

   En el panel izquierdo de Design Studio, deberías ver los elementos del proyecto bajo los encabezados de Operaciones, Transformaciones, Fuentes, Métodos de Servicio Web, Formatos de Archivo, Variables del Proyecto, y Jitterbit Connect > Salesforce.

   

Verificar datos existentes

Verifica la presencia de cuentas existentes creadas hoy en Salesforce.

1. Inicia sesión en tu instancia de Salesforce (fuera de Design Studio).

2. Ve al objeto Cuentas y accede a la vista Nuevas Esta Semana (en la Experiencia Lightning) o Cuentas Nuevas Hoy.

   

3. No deberían devolverse registros. Deja esta pantalla abierta para regresar más tarde en este proceso.

   

Ejecutar operaciones y verificar nuevos datos

Las operaciones incluidas con el Jitterpak importado se utilizan para realizar upsert de datos de clientes desde una variedad de fuentes diferentes a una instancia de Salesforce. Las fuentes incluyen CSV, JSON, bases de datos y XML. Después de cada upsert, también puedes verificar en Salesforce que se han creado datos.

Upsert CSV a Salesforce

Esta operación realiza un upsert de datos de clientes desde un archivo CSV a Salesforce para crear nuevos registros de cuentas en Salesforce. Para ejecutar esta operación y verificar si fue exitosa:

1. En el panel izquierdo, haz doble clic en la operación llamada "Upsert Accounts (CSV)" para abrirla en el espacio de trabajo de diseño.

2. Haz clic en el ícono del rayo en la parte superior derecha para ejecutar la operación.

   

3. Si se te solicita, haz clic en Continuar para desplegar los elementos del proyecto necesarios para que la operación se ejecute.

   

4. Verifica el Estado de la operación en la parte inferior del espacio de trabajo de diseño. Haz doble clic en los íconos de estado para mostrar el mensaje de registro de la operación, que debería indicar que la operación se completó con éxito con información.

   

5. Verifica Salesforce para asegurarte de que se han creado datos, luego elimina los datos recién creados. Para hacer esto:

   1. Actualiza la vista de Salesforce que quedó abierta desde el paso anterior Ver datos existentes. Deberían devolverse cinco registros (subidos desde el archivo CSV).

      

   2. Elimina los nuevos registros para limpiar tu instancia de Salesforce a su estado preexistente. Si continúas al siguiente paso de esta guía, deja esta pantalla abierta para regresar más tarde.

      

Upsert JSON a Salesforce

Esta operación inserta o actualiza datos de clientes desde un archivo JSON a Salesforce para crear nuevos registros de cuentas en Salesforce. Para ejecutar esta operación y verificar si fue exitosa:

1. En el panel izquierdo, haz doble clic en la operación llamada "Upsert Accounts (JSON)" para abrirla en el espacio de trabajo de diseño.

2. Haz clic en el ícono del rayo en la parte superior derecha para ejecutar la operación.

   

3. Si se te solicita, haz clic en Continuar para desplegar los elementos del proyecto requeridos para que la operación se ejecute.

   

4. Verifica el Estado de la operación en la parte inferior del espacio de trabajo de diseño. Haz doble clic en el ícono de estado para mostrar el mensaje del registro de la operación, que debería indicar que la operación se completó con éxito.

   

5. Verifica Salesforce para asegurarte de que se han creado datos, luego elimina los datos recién creados. Para hacer esto:

   1. Actualiza la vista de Salesforce que quedó abierta desde el paso anterior. Deberían devolverse cinco registros (subidos desde el archivo JSON).

      

   2. Elimina los nuevos registros para limpiar tu instancia de Salesforce a su estado preexistente. Si continúas con el siguiente paso de esta guía, deja esta pantalla abierta para regresar más tarde.

      

Upsert database to Salesforce

Esta operación inserta o actualiza datos de clientes desde una base de datos a Salesforce para crear nuevos registros de cuentas en Salesforce. Para ejecutar esta operación y verificar si fue exitosa:

1. En el panel izquierdo, haz doble clic en la operación llamada "Upsert Accounts (Read-Only Database)" para abrirla en el espacio de diseño.

2. Haz clic en el ícono del rayo en la parte superior derecha para ejecutar la operación.

   

3. Si se te solicita, haz clic en Continuar para desplegar los elementos del proyecto requeridos para que la operación se ejecute.

   

4. Verifica el Estado de la operación en la parte inferior del espacio de diseño. Haz doble clic en los íconos de estado para mostrar el mensaje del registro de la operación, que debería indicar que la operación se completó con éxito con información.

   

5. Verifica Salesforce para ver que se han creado datos, luego elimina los datos recién creados. Para hacer esto:

   1. Actualiza la vista de Salesforce que dejaste abierta desde el paso anterior. Deberían devolverse cinco registros (subidos desde la base de datos).

      

   2. Elimina los nuevos registros para limpiar tu instancia de Salesforce a su estado preexistente. Si continúas con el siguiente paso de esta guía, deja esta pantalla abierta para regresar más tarde.

      

Upsert XML a Salesforce

Esta operación inserta o actualiza datos de clientes desde un archivo XML a Salesforce para crear nuevos registros de cuentas en Salesforce. Para ejecutar esta operación y verificar si fue exitosa:

1. En el panel izquierdo, haz doble clic en la operación llamada "Upsert Accounts (XML)" para abrirla en el espacio de trabajo de diseño.

2. Haz clic en el ícono de rayo en la parte superior derecha para ejecutar la operación.

   

3. Si se solicita, haz clic en Continuar para desplegar los elementos del proyecto necesarios para que la operación se ejecute.

   

4. Verifica el Estado de la operación en la parte inferior del espacio de trabajo de diseño. Haz doble clic en el ícono de estado para mostrar el mensaje del registro de la operación, que debería indicar que la operación se completó con éxito.

   

5. Verifica Salesforce para ver que se han creado datos, luego elimina los datos recién creados. Para hacer esto:

   1. Actualiza la vista de Salesforce que dejaste abierta desde el paso anterior. Deberían devolverse cinco registros (subidos desde el archivo XML).

      

   2. Elimina los nuevos registros para limpiar tu instancia de Salesforce a su estado preexistente. Si continúas al siguiente paso de esta guía, deja esta pantalla abierta para regresar más tarde.

      

Consejos

Aprende más sobre las operaciones que acabas de ejecutar echando un vistazo a cómo funcionan las transformaciones y las variables del proyecto.

Transformaciones

Doble clic en la transformación llamada "Upsert Accounts (CSV) Request" para abrirla en el espacio de diseño. Dentro de la transformación, el lado izquierdo representa la estructura de la fuente, y el lado derecho representa la estructura del destino. Los campos de origen listados aquí, ID, Company, Street, City, State, Country, Phone, Zipcode, Industry, Type, y Annual_Revenue, están mapeados desde el archivo CSV a los campos dentro del objeto Account en Salesforce.

Variables del proyecto

Durante la importación del Jitterpak de muestra, se establecieron tres variables del proyecto como parte de tu proyecto: SFDC_Username, SFDC_Password, y SFDC_Security_Token. Estas variables del proyecto permiten que las credenciales de la organización de Salesforce incluidas en este Jitterpak se cambien sin modificar la configuración de la organización de Salesforce en sí.

Si tú o otro usuario tiene cambios en estas credenciales en el futuro, pueden cambiarlas actualizando el valor de la variable del proyecto en la sección Project Variables en el panel izquierdo. Los valores tomarán efecto automáticamente en Jitterbit Connect > Salesforce > Salesforce Orgs en tu organización.

Otro lugar dentro del proyecto de muestra donde se utiliza la organización de Salesforce es dentro de las operaciones de upsert. Bajo Jitterbit Connect > Salesforce > Salesforce Upserts para cada operación, puedes ver y editar todos los parámetros utilizados para configurar la operación.

Parte 2: Diseñar un nuevo proyecto

La parte anterior mostró cómo importar y ejecutar operaciones utilizando Design Studio. Esta parte cubre cómo crear un proyecto y configurar dos de las mismas operaciones ya proporcionadas en el proyecto de muestra: (1) upsert de datos de clientes desde una base de datos a Salesforce, y (2) upsert de datos de clientes desde un archivo JSON a Salesforce.

Crear un proyecto

Primero, crea un nuevo proyecto utilizando Design Studio.

1. Abre la aplicación Design Studio.

   

2. Ve a Archivo > Nuevo Proyecto:

   

3. En la ventana de Nuevo Proyecto, en el campo Nombre del Proyecto, ingresa "Jitterbit Get Started." Puedes dejar los otros campos como predeterminados.

   

4. Haz clic en Aceptar para crear tu proyecto y abrir el espacio de trabajo de diseño.

Crear operaciones

Después de que se crea tu nuevo proyecto, estos pasos muestran cómo crear operaciones de ejemplo para insertar datos de clientes desde una base de datos a Salesforce, y para insertar datos de clientes desde un archivo JSON a Salesforce.

Insertar base de datos a Salesforce

Esta operación inserta datos de clientes desde una base de datos a Salesforce para crear nuevos registros de cuentas en Salesforce. Para crear esta operación:

1. Define la fuente de los datos. Para hacer esto:

   1. En el panel izquierdo, haz clic derecho en Fuentes y selecciona Nueva Fuente.

      

   2. En la ventana de Seleccionar Tipo, selecciona Base de Datos. Luego haz clic en Continuar.

      

   3. Completa la pantalla de configuración de Nueva Fuente de la siguiente manera, utilizando información de una base de datos PostgreSQL alojada por Jitterbit:

      • Nombre: Ingresa Base de Datos.
      • Parámetros de Conexión
        • Controlador: Haz clic en el botón Seleccionar para abrir la ventana de Seleccionar Controlador. En esta ventana, selecciona el controlador PostgreSQL [JDBC], luego haz clic en Aceptar para continuar.
        • Nombre del Servidor: Ingresa demodb.jitterbit.com.
        • Nombre de la Base de Datos: Ingresa JitterbitDemoDB.
        • Inicio de Sesión: Ingresa readonlyuser.
        • Contraseña: Ingresa readonlyuser.

      

   4. En la misma pantalla de configuración de Nueva Fuente, junto a Parámetros de Conexión, haz clic en Probar Conexión para verificar que Jitterbit puede conectarse a la base de datos. Luego haz clic en Aceptar para continuar.

      

2. Crea la conexión a Salesforce. Para hacer esto:

   1. En el panel izquierdo, bajo Jitterbit Connect > Salesforce, haz clic derecho en Salesforce Orgs y selecciona Nueva Org de Salesforce.

      

   2. En la pantalla de configuración de Nueva Org de Salesforce, ingresa el Nombre de usuario, Contraseña y Token de seguridad para tu instancia de Salesforce. Luego haz clic en Probar inicio de sesión de Salesforce para verificar que Jitterbit puede conectarse a la instancia de Salesforce. Luego haz clic en Aceptar para continuar.

      

3. Crea el upsert de Salesforce utilizando la fuente definida y la conexión de Salesforce configurada. Para hacer esto:

   1. En el panel izquierdo, bajo Jitterbit Connect > Salesforce, haz clic derecho en Upserts de Salesforce y selecciona Nuevo Upsert de Salesforce.

      

   2. En el paso de Inicio de sesión, utiliza el menú desplegable para seleccionar la org de Salesforce que acabas de configurar. Luego haz clic en Siguiente para continuar.

      

   3. En el paso de Objeto, puedes ver todos los objetos de Salesforce disponibles para la cuenta, incluidos cualquier objeto personalizado. Este paso tiene dos partes:

      1. Bajo Seleccionar el Objeto de Salesforce, haz clic en Cuenta para seleccionar este objeto.

         

      2. Bajo Seleccionar un Campo de ID Externo, haz clic en el botón Seleccionar Campo y desde la ventana emergente selecciona el campo "Id". Haz clic en Aceptar. Luego haz clic en Siguiente para continuar.

         

   4. En el paso Fuente, selecciona la fuente de base de datos que ya has configurado. Para hacer esto:

      1. Usa el primer menú desplegable para seleccionar Base de datos (Oracle, SQL Server, MySQL, etc.) y el segundo menú desplegable para seleccionar la fuente de base de datos que ya has configurado. Haz clic en Siguiente para continuar.

         

      2. En la siguiente pantalla, tienes la opción de proporcionar una declaración SQL. Para este ejercicio, omite este paso haciendo clic en Siguiente para continuar.

         

      3. En la siguiente pantalla, haz clic en Descargar lista de tablas para listar las tablas y vistas disponibles dentro de la fuente de base de datos. Bajo Tablas disponibles a la izquierda, selecciona la tabla customers y haz clic en la flecha derecha para mover la tabla a Tablas seleccionadas a la derecha. Haz clic en Siguiente para continuar.

         

      4. En la siguiente pantalla, tienes la opción de agregar una cláusula WHERE. Para este ejercicio, dejaremos esto en blanco. Haz clic en Siguiente para continuar.

         

   5. En el paso Programación y opciones, puedes programar operaciones para que se ejecuten en intervalos que especifiques. Para este ejercicio, omitiremos agregar una programación. Haz clic en Siguiente para continuar.

      

   6. En el paso Resumen, ingresa "Upsert Accounts DB" como el nombre a utilizar para esta operación. Luego haz clic en Mapear y finalizar.

      

4. Configura la transformación. En el lado izquierdo de la transformación están los campos de origen de la base de datos, y en el lado derecho están los campos de destino de Salesforce.

   Para configurar la transformación, mapea los campos de origen a los campos de destino arrastrando individualmente cada campo de origen y soltándolo sobre el campo de destino correspondiente de la siguiente manera. Cuando el mapeo esté completo, haz clic en Finalizar para continuar.

   Source	Target
   ID	Número de Cuenta
   Company	Nombre
   Street	Calle de Facturación
   City	Ciudad de Facturación
   State	Estado de Facturación
   Country	País de Facturación
   Phone	Teléfono
   Zipcode	Código Postal de Facturación
   Industry	Industria
   Type	Tipo
   Annual Revenue	Ingresos Anuales

   

5. En el panel izquierdo, haz doble clic en la operación "Upsert Accounts DB" para mostrar la operación dentro del espacio de trabajo de diseño. Para este ejemplo, el marcador de posición de destino no se utiliza dentro de la operación, por lo que podemos eliminarlo. En el gráfico de la operación, haz clic derecho en el ícono Target y selecciona Remove From Graph.

   

6. En la barra de menú de íconos, haz clic en el ícono de guardar todo para guardar todos los elementos del proyecto. Luego haz clic en el ícono de desplegar para desplegar el proyecto.

   

7. ¡Felicidades! Ahora has creado la misma operación "Upsert Accounts (Base de Datos de Solo Lectura)" que se proporcionó en Parte 1: Comienza con un proyecto de muestra. Consulta los pasos en Ejecutar operaciones para ejecutar la operación, verificar el estado y ver los nuevos registros en Salesforce.

Upsert JSON a Salesforce

Esta operación inserta o actualiza datos de clientes desde un archivo JSON a Salesforce para crear nuevos registros de cuentas en Salesforce. Para crear esta operación:

1. Define la fuente de los datos. Para hacer esto:

   1. En el panel izquierdo, haz clic derecho en Sources y selecciona New Source.

      

   2. En la ventana Select Type, selecciona HTTP, donde se encuentra el archivo JSON proporcionado para este tutorial. Luego haz clic en Continue.

      

   3. Completa la pantalla de configuración de New Source de la siguiente manera:

      • Name: Ingresa JSON Data.
      • Connection Parameters
        • URL: Ingresa https://download.jitterbit.com/se/templates/sampledata/Customer_Data_JSON.json.
        • Test Connection: Haz clic en este botón para verificar que Jitterbit puede conectarse a la URL. Luego haz clic en OK para continuar.

      

2. Si no lo has hecho ya, crea la conexión a Salesforce como se cubrió en el tutorial de creación de operaciones anterior. Consulta el paso 2 en Upsert database to Salesforce para obtener instrucciones.

3. Crea el upsert de Salesforce utilizando la fuente definida y la conexión configurada de Salesforce. Para hacer esto:

   1. En el panel izquierdo, bajo Jitterbit Connect > Salesforce, haz clic derecho en Salesforce Upserts y selecciona New Salesforce Upsert.

      

   2. En el paso Login, utiliza el menú desplegable para seleccionar tu organización de Salesforce. Haz clic en Test Salesforce Login para verificar tu conexión. Haz clic en OK. Luego haz clic en Next para continuar.

      

   3. En el paso Object, puedes ver todos los objetos de Salesforce disponibles para la cuenta, incluidos los objetos personalizados. Este paso tiene dos partes:

      1. Bajo Select the Salesforce Object, haz clic en Account para seleccionar este objeto.

         

      2. Bajo Seleccionar un campo de ID externo, haz clic en el botón Seleccionar campo y en la ventana emergente selecciona el campo "Id". Haz clic en Aceptar. Luego haz clic en Siguiente para continuar.

         

   4. En el paso Fuente, utiliza el primer menú desplegable para seleccionar HTTP y el segundo menú desplegable para seleccionar la fuente HTTP que ya has configurado. Haz clic en Siguiente para continuar.

      

   5. En la siguiente pantalla, selecciona JSON como el tipo de archivo. Haz clic en Siguiente para continuar.

      

   6. En la siguiente pantalla, si ya tienes un esquema de archivo, puedes seleccionarlo aquí. Para este ejercicio, selecciona Crear una nueva estructura JSON a partir de un archivo de muestra (página siguiente). Haz clic en Siguiente para continuar.

      

   7. En la siguiente pantalla, completa los pasos de la siguiente manera:

      1. Bajo Seleccionar un archivo de muestra, selecciona URL a un archivo JSON remoto e ingresa la misma URL que la de tu fuente HTTP: https://download.jitterbit.com/se/templates/sampledata/Customer_Data_JSON.json.

         

      2. Bajo Generar el XSD, haz clic en Generar para generar la estructura. Luego haz clic en Siguiente para continuar.

         

   8. En el paso Programación y opciones, puedes programar operaciones para que se ejecuten cuando lo especifiques. Para este ejercicio, omitiremos agregar una programación. Haz clic en Siguiente para continuar.

      

   9. En el paso Resumen, ingresa "Upsert Accounts JSON" como el nombre a utilizar para esta operación. Luego haz clic en Mapear y finalizar.

      

4. Configura la transformación. En el lado izquierdo de la transformación están los campos de origen del archivo JSON, y en el lado derecho están los campos de destino de Salesforce.

   Para configurar la transformación, mapea los campos de origen a los campos de destino arrastrando individualmente cada campo de origen y soltándolo sobre el campo de destino correspondiente de la siguiente manera. Cuando el mapeo esté completo, haz clic en Finalizar para continuar.

   Origen	Destino
   ID	Número de Cuenta
   Company	Nombre
   Street	Calle de Facturación
   City	Ciudad de Facturación
   State	Estado de Facturación
   Country	País de Facturación
   Phone	Teléfono
   Zipcode	Código Postal de Facturación
   Industry	Industria
   Type	Tipo
   Annual Revenue	Ingresos Anuales

   

5. En el panel izquierdo, haz doble clic en la operación "Upsert Accounts JSON" para mostrar la operación dentro del espacio de trabajo de diseño. Para este ejemplo, el marcador de posición de destino no se utiliza dentro de la operación, por lo que podemos eliminarlo. En el gráfico de la operación, haz clic derecho en el ícono de Destino y selecciona Eliminar del Gráfico.

   

6. En la barra de menú de íconos, haz clic en el ícono de guardar todo para guardar todos los elementos del proyecto. Luego haz clic en el ícono de desplegar para desplegar el proyecto.

   

7. ¡Felicidades! Ahora has creado la misma operación "Upsert Accounts (JSON)" que se proporcionó en Parte 1: Comienza con un proyecto de muestra. Consulta los pasos en Ejecutar operaciones para ejecutar la operación, verificar el estado y ver los nuevos registros en Salesforce.