Guía de Inicio Rápido de 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 e desplegar proyectos de integración. Esta guía le guiará en el diseño de su primer proyecto de Design Studio.

Si no está utilizando Design Studio y en su lugar está utilizando Cloud Studio, nuestra aplicación de diseño de proyectos basada en web, consulte la Guía de inicio rápido de Cloud Studio. Comuníquese con su Gerente de éxito del cliente para determinar qué aplicación de Studio se adapta mejor a sus necesidades para nuevos proyectos o para programar una verificación de evaluación de preparación para mover proyectos existentes de Design Studio a Cloud 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, incluida la creación de un proyecto y la configuración de dos de las mismas operaciones que ya se proporcionaron en el proyecto de muestra.

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

Las dos partes de este tutorial cubren estas tareas en Design Studio:

• Parte 1: Comience 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: Comience 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 de 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 los datos.

Importar un Jitterpak¶

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

1. Abra la aplicación Design Studio.

   

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

   1. Vaya a Archivo > Importar Jitterpak:

      

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

      1. Seleccione JPK: Busque o ingrese la ubicación del Jitterpak. Luego haga clic en Siguiente.

         

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

         

      3. Variables del proyecto: Proporcione las credenciales para su cuenta de Salesforce reemplazando el Valor para cada una de las Variables. Luego haga clic en Finalizar.

         

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

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

   

Verificar Datos Existentes¶

Verifique la presencia de cuentas existentes creadas hoy en Salesforce.

1. Inicie sesión en su instancia de Salesforce (fuera de Design Studio).

2. Vaya al objeto Cuentas y acceda a la vista Nuevo esta semana (en Lightning Experience) o Cuentas nuevas hoy.

   

3. No se deben devolver registros. Deje esta pantalla abierta para regresar más adelante en este proceso.

   

Ejecutar Operaciones y Verificar Nuevos Datos¶

Las operaciones incluidas con el Jitterpak importado se utilizan para insertar datos de clientes de una variedad de fuentes diferentes en una instancia de Salesforce. Las fuentes incluyen CSV, JSON, bases de datos y XML. Después de cada inserción, también puede consultar Salesforce para ver que se han creado los datos.

Insertar CSV en Salesforce¶

Esta operación actualiza los datos del cliente desde un archivo CSV a Salesforce para crear nuevos registros de cuenta en Salesforce. Para ejecutar esta operación y comprobar si fue exitosa:

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

2. Haga clic en el icono del rayo en la esquina superior derecha para ejecutar la operación.

   

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

   

4. Verifique el Estado de la operación en la parte inferior del espacio de trabajo de diseño. Haga doble clic en los íconos de estado para mostrar el mensaje de registro de operación, que debe indicar que la operación se completó correctamente con información.

   

5. Verifique Salesforce para ver que se hayan creado los datos y luego elimine los datos recién creados. Para hacer esto:

   1. Actualice la vista de Salesforce que quedó abierta desde el paso anterior Verificar datos existentes. Se deben devolver cinco registros (cargados desde el archivo CSV).

      

   2. Elimine los nuevos registros para limpiar su instancia de Salesforce a su estado preexistente. Si continúa con el siguiente paso de esta guía, deje esta pantalla abierta para volver más tarde.

      

Insertar JSON en Salesforce¶

Esta operación actualiza los datos del cliente desde un archivo JSON a Salesforce para crear nuevos registros de cuenta en Salesforce. Para ejecutar esta operación y comprobar si fue exitosa:

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

2. Haga clic en el icono del rayo en la esquina superior derecha para ejecutar la operación.

   

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

   

4. Verifique el Estado de la operación en la parte inferior del espacio de trabajo de diseño. Haga doble clic en el icono de estado para mostrar el mensaje de registro de operación, que debería indicar que la operación se completó correctamente.

   

5. Verifique Salesforce para ver que se hayan creado los datos y luego elimine los datos recién creados. Para hacer esto:

   1. Actualice la vista de Salesforce que quedó abierta en el paso anterior. Se deben devolver cinco registros (cargados desde el archivo JSON).

      

   2. Elimine los nuevos registros para limpiar su instancia de Salesforce a su estado preexistente. Si continúa con el siguiente paso de esta guía, deje esta pantalla abierta para volver más tarde.

      

Upsert Base de Datos a Salesforce¶

Esta operación actualiza los datos del cliente desde una base de datos a Salesforce para crear nuevos registros de cuenta en Salesforce. Para ejecutar esta operación y comprobar si fue exitosa:

1. En el panel izquierdo, haga doble clic en la operación llamada "Insertar cuentas (base de datos de solo lectura)" para abrirla en el espacio de trabajo de diseño.

2. Haga clic en el icono del rayo en la esquina superior derecha para ejecutar la operación.

   

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

   

4. Verifique el Estado de la operación en la parte inferior del espacio de trabajo de diseño. Haga doble clic en los íconos de estado para mostrar el mensaje de registro de operación, que debe indicar que la operación se completó correctamente con información.

   

5. Verifique Salesforce para ver que se hayan creado los datos y luego elimine los datos recién creados. Para hacer esto:

   1. Actualice la vista de Salesforce que quedó abierta en el paso anterior. Se deben devolver cinco registros (cargados desde la base de datos).

      

   2. Elimine los nuevos registros para limpiar su instancia de Salesforce a su estado preexistente. Si continúa con el siguiente paso de esta guía, deje esta pantalla abierta para volver más tarde.

      

Insertar XML en Salesforce¶

Esta operación actualiza los datos del cliente desde un archivo XML a Salesforce para crear nuevos registros de cuenta en Salesforce. Para ejecutar esta operación y comprobar si fue exitosa:

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

2. Haga clic en el icono del rayo en la esquina superior derecha para ejecutar la operación.

   

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

   

4. Verifique el Estado de la operación en la parte inferior del espacio de trabajo de diseño. Haga doble clic en el icono de estado para mostrar el mensaje de registro de operación, que debería indicar que la operación se completó correctamente.

   

5. Verifique Salesforce para ver que se hayan creado los datos y luego elimine los datos recién creados. Para hacer esto:

   1. Actualice la vista de Salesforce que quedó abierta en el paso anterior. Se deben devolver cinco registros (cargados desde el archivo XML).

      

   2. Elimine los nuevos registros para limpiar su instancia de Salesforce a su estado preexistente. Si continúa con el siguiente paso de esta guía, deje esta pantalla abierta para volver más tarde.

      

Consejos¶

Obtenga más información sobre las operaciones que acaba de ejecutar observando cómo funcionan las variables de transformación y proyecto.

Transformaciones¶

Haga doble clic en la transformación llamada "Solicitud de inserción de cuentas (CSV)" para abrirla en el espacio de trabajo de diseño. Dentro de la transformación, el lado izquierdo representa la estructura del origen y el lado derecho representa la estructura del destino. Los campos de origen enumerados aquí, ID, Company, Street, City, State, Country, Phone, Zipcode, Industry, Type, y Annual_Revenue, se asignan desde el archivo CSV a campos dentro del objetivo Account objeto en Salesforce.

Variables del Proyecto¶

Durante la importación del Jitterpak de muestra, se establecieron tres variables de proyecto como parte de su proyecto: SFDC_Username, SFDC_Password, y SFDC_Security_Token. Estas variables del proyecto permiten cambiar las credenciales de la organización de Salesforce incluidas en este Jitterpak sin cambiar la configuración de la propia organización de Salesforce.

Si usted u otro usuario tiene cambios en estas credenciales en el futuro, puede cambiarlos actualizando el valor de la variable del proyecto en la sección Variables del proyecto en el panel izquierdo. Los valores entrarán en vigor automáticamente en Jitterbit Connect > Salesforce > Salesforce Orgs en su organización.

Otro lugar dentro del proyecto de muestra donde se utiliza la organización de Salesforce es dentro de las propias operaciones de inserción. En Jitterbit Connect > Salesforce > Salesforce Upserts para cada operación, puede 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 usando Design Studio. Esta parte cubre cómo crear un proyecto y configurar dos de las mismas operaciones que ya se proporcionaron en el proyecto de muestra: (1) insertar datos de clientes desde una base de datos a Salesforce y (2) insertar datos de clientes desde un archivo JSON a Salesforce.

Crear un Proyecto¶

Primero, cree un nuevo proyecto usando Design Studio.

1. Abra la aplicación Design Studio.

   

2. Vaya a Archivo > Nuevo proyecto:

   

3. En la ventana Nuevo proyecto, en el campo Nombre del proyecto, ingrese "Jitterbit Get Started". Puede dejar los demás campos como predeterminados.

   

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

Crear Operaciones¶

Después de crear su nuevo proyecto, estos pasos muestran cómo crear operaciones de muestra para insertar datos de clientes desde una base de datos a Salesforce e insertar datos de clientes desde un archivo JSON a Salesforce.

Upsert Base de Datos a Salesforce¶

Esta operación actualiza los datos del cliente desde una base de datos a Salesforce para crear nuevos registros de cuenta en Salesforce. Para crear esta operación:

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

   1. En el panel izquierdo, haga clic derecho en Fuentes y seleccione Nueva fuente.

      

   2. En la ventana Seleccionar tipo, seleccione Base de datos. Luego haga clic en Continuar.

      

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

      • Nombre: Ingrese Base de datos.
      • Parámetros de conexión
        • Conductor: Haga clic en el botón Seleccionar para abrir la ventana Seleccionar controlador. En esta ventana, seleccione el controlador PostgreSQL [JDBC] y luego haga clic en Aceptar para continuar.
        • Nombre del servidor: Ingrese demodb.jitterbit.com.
        • Nombre de la base de datos: Ingrese JitterbitDemoDB.
        • Iniciar sesión: Ingrese usuario de solo lectura.
        • Contraseña: Ingrese usuario de solo lectura.

      

   4. En la misma pantalla de configuración de Nueva fuente, junto a Parámetros de conexión, haga clic en Probar conexión para verificar que Jitterbit pueda conectarse a la base de datos. Luego haga clic en Aceptar para continuar.

      

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

   1. En el panel izquierdo, en Jitterbit Connect > Salesforce, haga clic derecho en Organizaciones de Salesforce y seleccione Nueva organización de Salesforce.

      

   2. En la pantalla de configuración Nueva organización de Salesforce, ingrese el Nombre de usuario, Contraseña y el Token de seguridad para su instancia de Salesforce. Luego haga clic en Probar inicio de sesión de Salesforce para verificar que Jitterbit pueda conectarse a la instancia de Salesforce. Luego haga clic en Aceptar para continuar.

      

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

   1. En el panel izquierdo, en Jitterbit Connect > Salesforce, haga clic derecho en Salesforce Upserts y seleccione Nuevo Salesforce Upsert.

      

   2. En el paso Iniciar sesión, utilice el menú desplegable para seleccionar la organización de Salesforce que acaba de configurar. Luego haga clic en Siguiente para continuar.

      

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

      1. En Seleccione el objeto de Salesforce, haga clic en Cuenta para seleccionar este objeto.

         

      2. En Seleccione un campo de ID externo, haga clic en el botón Seleccionar campo y en la ventana emergente seleccione el campo "Id". Haga clic en Aceptar. Luego haga clic en **Siguiente para continuar.

         

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

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

         

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

         

      3. En la siguiente pantalla, haga clic en Descargar lista de tablas para enumerar las tablas y vistas disponibles dentro de la fuente de la base de datos. En Mesas disponibles a la izquierda, seleccione el customers tabla y haga clic en la flecha derecha para mover la tabla debajo de Tablas seleccionadas a la derecha. Haga clic en Siguiente para continuar.

         

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

         

   5. En el paso Programación y opciones, puede programar operaciones para que se ejecuten en los intervalos que usted especifique. Para este ejercicio omitiremos agregar un cronograma. Haga clic en Siguiente para continuar.

      

   6. En el paso Resumen, ingrese "Upsert Accounts DB" como el nombre que se utilizará para esta operación. Luego haga clic en Mapear y finalizar.

      

4. Configurar 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, asigne campos de origen a campos de destino arrastrando individualmente cada campo de origen y soltándolo encima del campo de destino correspondiente de la siguiente manera. Cuando se complete el mapeo, haga clic en Finalizar para continuar.

   Fuente	Objetivo
   ID	Account Number
   Company	Name
   Street	Billing Street
   City	Billing City
   State	Billing State
   Country	Billing Country
   Phone	Phone
   Zipcode	Billing Postal Code
   Industry	Industry
   Type	Type
   Annual Revenue	Annual Revenue

   

5. En el panel izquierdo, haga 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 operación, haga clic con el botón derecho en el icono Objetivo y seleccione Eliminar del gráfico.

   

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

   

7. ¡Felicitaciones! Ahora ha creado la misma operación "Upsert Accounts (Base de datos de solo lectura)" que se proporcionó en la Parte 1: Cómo comenzar con un proyecto de muestra. Consulte los pasos en Ejecutar operaciones para ejecutar la operación, verificar el estado y ver los nuevos registros en Salesforce.

Insertar JSON en Salesforce¶

Esta operación actualiza los datos del cliente desde un archivo JSON a Salesforce para crear nuevos registros de cuenta en Salesforce. Para crear esta operación:

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

   1. En el panel izquierdo, haga clic derecho en Fuentes y seleccione Nueva fuente.

      

   2. En la ventana Seleccionar tipo, seleccione HTTP, donde reside el archivo JSON proporcionado para este tutorial. Luego haga clic en Continuar.

      

   3. Complete la pantalla de configuración Nueva fuente de la siguiente manera:

      • Nombre: Introduzca Datos JSON.
      • Parámetros de conexión
        • URL: Ingresar https://download.jitterbit.com/se/templates/sampledata/Customer_Data_JSON.json.
        • Probar conexión: Haga clic en este botón para verificar que Jitterbit pueda conectarse a la URL. Luego haga clic en Aceptar para continuar.

      

2. Si aún no lo ha hecho, cree la conexión a Salesforce como se describe en el tutorial de creación de operación anterior. Consulte el paso 2 en Insertar base de datos en Salesforce para obtener instrucciones.

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

   1. En el panel izquierdo, en Jitterbit Connect > Salesforce, haga clic derecho en Salesforce Upserts y seleccione Nuevo Salesforce Upsert.

      

   2. En el paso Iniciar sesión, utilice el menú desplegable para seleccionar su organización de Salesforce. Haga clic en Probar inicio de sesión en Salesforce para verificar su conexión. Haga clic en Aceptar. Luego haga clic en **Siguiente para continuar.

      

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

      1. En Seleccione el objeto de Salesforce, haga clic en Cuenta para seleccionar este objeto.

         

      2. En Seleccione un campo de ID externo, haga clic en el botón Seleccionar campo y en la ventana emergente seleccione el campo "Id". Haga clic en Aceptar. Luego haga clic en **Siguiente para continuar.

         

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

      

   5. En la siguiente pantalla, seleccione JSON como tipo de archivo. Haga clic en Siguiente para continuar.

      

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

      

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

      1. En Seleccione un archivo de muestra, seleccione URL a un archivo JSON remoto e ingrese la misma URL que la de su fuente HTTP: https://download.jitterbit.com/se/templates/sampledata/Customer_Data_JSON.json.

         

      2. En Generar el XSD, haga clic en Generar para generar la estructura. Luego haga clic en Siguiente para continuar.

         

   8. En el paso Programación y opciones, puede programar operaciones para que se ejecuten cuando lo especifique. Para este ejercicio omitiremos agregar un cronograma. Haga clic en Siguiente para continuar.

      

   9. En el paso Resumen, ingrese "Upsert Accounts JSON" como el nombre que se utilizará para esta operación. Luego haga clic en Mapear y finalizar.

      

4. Configurar 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, asigne campos de origen a campos de destino arrastrando individualmente cada campo de origen y soltándolo encima del campo de destino correspondiente de la siguiente manera. Cuando se complete el mapeo, haga clic en Finalizar para continuar.

   Fuente	Objetivo
   ID	Account Number
   Company	Name
   Street	Billing Street
   City	Billing City
   State	Billing State
   Country	Billing Country
   Phone	Phone
   Zipcode	Billing Postal Code
   Industry	Industry
   Type	Type
   Annual Revenue	Annual Revenue

   

5. En el panel izquierdo, haga 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 operación, haga clic con el botón derecho en el icono Objetivo y seleccione Eliminar del gráfico.

   

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

   

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