Exportar e importar un proyecto en Jitterbit Studio

Introducción

Studio permite importar componentes de proyectos entre organizaciones y entornos. Puedes exportar proyectos como archivos JSON o trabajar directamente con proyectos dentro del mismo entorno.

En conjunto, las funcionalidades de exportación e importación permiten transferir proyectos y sus componentes a otras organizaciones según sea necesario.

Las exportaciones de proyectos de Studio están en formato de archivo JSON. Una vez que tengas una exportación de proyecto JSON, puedes importarla en cualquier organización.

Exportar un proyecto

Las opciones Exportar o Exportar Proyecto son accesibles desde estas ubicaciones:

• La página Proyectos (consulta Vista de tarjetas o Vista de lista en Proyectos).
• La barra de herramientas del proyecto (consulta Menú de acciones del proyecto en Barra de herramientas del proyecto).

Además, la pantalla de exportación del proyecto es accesible mediante el enlace Exportar en la parte inferior de la pantalla Configuración del Proyecto (consulta Editar configuración del proyecto en Creación y configuración del proyecto).

Al seleccionar Exportar o Exportar Proyecto, se abre la pantalla de exportación del proyecto, donde eliges las opciones de exportación y generas el proyecto como un archivo JSON:

• Incluir Credenciales: Incluye en el proyecto exportado los valores especificados dentro de los campos de credenciales de las pantallas de configuración de componentes del proyecto.

  Nota

  Esta opción puede estar deshabilitada según la política de organización Permitir que se exporten credenciales.

  Los campos de configuración específicos que se tratan como campos de credenciales varían según el componente del proyecto. A menudo incluyen campos como contraseñas o tokens de seguridad. Los desarrolladores de conectores personalizados que utilizan el SDK de Conectores pueden designar tales campos con cualquiera de estos atributos:

  • "secret": "true": Designa solo que el campo se trata como un campo de credenciales. El valor del campo se cifra en la exportación del proyecto.

  • "widgetHint": "password": Designa que el campo se trata como un campo de credenciales y también enmascara el valor en la interfaz de usuario de Studio reemplazando cada carácter con un punto negro. El valor del campo se cifra en la exportación del proyecto.

  Los valores de las variables del proyecto en sí no se tratan como credenciales, incluso si la opción Ocultar Valor está seleccionada en la interfaz de usuario (consulta Variables del proyecto). En su lugar, si se incluyen los valores de las variables del proyecto se controla con la selección Incluir Valores de Variables del Proyecto.

  Si se utiliza una variable del proyecto en un campo de credenciales (independientemente de si Incluir Valores de Variables del Proyecto está seleccionado), el "value" del campo de credenciales es el valor cifrado de la representación de sintaxis de corchetes del nombre de la variable del proyecto y cualquier otra entrada, si está presente.

  Cuando Incluir Credenciales no está seleccionado, el "value" del campo de credenciales no se incluye en la exportación del proyecto, excepto si se utiliza una variable del proyecto en un campo de credenciales. En ese caso, se incluye la entrada de texto sin cifrar del campo de credenciales. Esto puede ser motivo de preocupación si el campo de credenciales utiliza cualquier otra entrada junto con la variable del proyecto, aunque este caso de uso es inusual. Por ejemplo, una entrada de campo de [pv_password]1234suffix se incluiría en la exportación del proyecto como [pv_password]1234suffix.

• Incluir Notificaciones por Correo Electrónico: Incluye notificaciones por correo electrónico en el proyecto exportado. Esta opción se aplica a todas las notificaciones por correo electrónico en un proyecto, independientemente de si están configuradas con acciones de operación para ejecutarse en caso de éxito, fallo o fallo de SOAP o si están referenciadas en un script.

• Incluir valores de variables de proyecto: Incluye los valores predeterminados de variables de proyecto en el proyecto exportado.

  Los valores de las variables de proyecto configuradas con la opción Ocultar valor (consulta Variables de proyecto) se cifran en la exportación del proyecto.

• Incluir programaciones: Incluye programaciones de operaciones en el proyecto exportado.

• Exportar: Genera y descarga el proyecto como un archivo JSON. De forma predeterminada, el nombre del archivo JSON utiliza el nombre del proyecto.

  Nota

  Un proyecto exportado no conserva el historial del proyecto.

Importar

Se puede importar proyectos y componentes utilizando cualquiera de estas dos opciones:

1. Importar un proyecto: Esta opción (accesible desde la página Proyectos) permite importar un proyecto completo desde un archivo JSON a la organización.

2. Importación selectiva: Esta opción (accesible desde el menú de acciones del proyecto en un proyecto) permite importar componentes especificados desde otro proyecto en el mismo entorno o desde un archivo JSON de proyecto a un proyecto existente.

Importar un proyecto

Se puede importar un proyecto haciendo clic en Importar en la página Proyectos:

En la siguiente pantalla, importas el proyecto:

• Archivo de proyecto: Utiliza el botón Examinar para buscar un archivo JSON de proyecto que se haya exportado desde Studio.

  Consejo

  Si el proyecto utiliza conectores personalizados, estos deben existir en la organización antes de importar el proyecto. Para exportar un conector de Connector Builder e importarlo en otra organización, consulta Exportaciones e importaciones de Connector Builder. Para instalar un conector de Connector SDK en otra organización, consulta Implementar un conector de Harmony.

  Al seleccionar un archivo, estos campos quedan disponibles:

  • Nombre del proyecto: El nombre del proyecto se completa previamente desde el archivo JSON. Para utilizar un nombre diferente, se puede editar aquí. El nombre del proyecto debe cumplir estos criterios:

    • Ser único para cada entorno.

    • No puede estar ya en uso como nombre de proyecto de Design Studio en el mismo entorno.

    Nota

    Si ya existe un proyecto con el mismo nombre en la nube de Harmony, ve a la página Consola de administración > Proyectos para administrar el proyecto implementado.

  • Organización: Utiliza el menú desplegable para seleccionar la organización a la que deseas importar el proyecto. Si tienes solo una organización, se selecciona de forma predeterminada.

  • Entorno: Utiliza el menú desplegable para seleccionar el entorno al que deseas importar el proyecto.

    Precaución

    Si el proyecto de origen utiliza conectores que están disponibles solo en agentes privados, no se puede importar a un entorno asociado con un grupo de agentes en la nube. Estos entornos aún aparecen en el menú desplegable Entorno, pero no se pueden seleccionar.

  • Incluir notificaciones por correo electrónico: De forma predeterminada, si se incluyeron notificaciones por correo electrónico como parte del proyecto cuando se exportó, se incluyen cuando se importa el proyecto. Esta opción se aplica a todas las notificaciones por correo electrónico en un proyecto, independientemente de si están configuradas con acciones de operación para ejecutarse en caso de éxito, error o fallo de SOAP o si están referenciadas en un script. Para excluir las notificaciones por correo electrónico de la importación, desactiva la casilla de verificación.

    Precaución

    Las referencias a un componente de notificación por correo electrónico en un script no se eliminan aunque se excluyan las notificaciones por correo electrónico, por lo que es posible que sea necesario corregir las referencias rotas después de excluir los correos electrónicos.

  • Incluir Programaciones: De forma predeterminada, si las programaciones de operaciones se incluyeron como parte del proyecto cuando se exportó, se incluyen cuando se importa el proyecto. Para excluir las programaciones de la importación, desactiva la casilla de verificación.

  • Puntos finales globales: Cualquier punto final global utilizado por el proyecto que se está importando se enumera y debe agregarse al entorno seleccionado utilizando una de estas opciones:

    

    • Usar punto final global existente: Visible solo cuando el punto final global ya existe en la organización. Selecciona para agregar un punto final de entorno a un punto final global existente para el entorno seleccionado. Utiliza el menú para seleccionar el punto final global existente:

      

      Si el punto final global existente ya tiene un punto final de entorno para el entorno seleccionado, se utiliza el punto final de entorno existente para el proyecto importado. Si el punto final global existente no tiene un punto final de entorno para el entorno seleccionado, se utilizan las credenciales proporcionadas en el proyecto importado (si corresponde). De lo contrario, será necesario configurar el punto final del entorno después de la importación.

    • Crear nuevo punto final global: Selecciona para crear un nuevo punto final global para la organización:

      

      Cuando se importa el proyecto, el punto final global se agrega al entorno seleccionado y será necesario configurarlo después de la importación.

• Importar: Haz clic para importar el proyecto. Si el proyecto se importó correctamente, el proyecto importado se abre en el lienzo de diseño. Además, el nuevo proyecto está disponible en la página Proyectos.

  Después de importar el proyecto, aún no se ha implementado. Cuando estés listo para implementar, consulta Implementación de proyectos.

Importación selectiva

Para importar solo componentes especificados en un proyecto existente, utiliza el menú de acciones del proyecto y haz clic en Importar desde Proyecto. Puedes importar componentes desde un archivo JSON de proyecto o desde otro proyecto en el mismo entorno.

Paso 1: Opciones de importación

Selecciona o carga un proyecto:

• Elige cargar un archivo local: Puedes proporcionar un archivo JSON de proyecto desde la zona de carga. Puedes arrastrar y soltar un archivo JSON de proyecto en la zona de carga o seleccionar un archivo manualmente.

  Cuando se hace clic, se abre un cuadro de diálogo de selección de archivo. Selecciona el archivo y luego haz clic en Cargar:

  

• O selecciona un proyecto existente de tu entorno: Selecciona un proyecto existente del entorno del proyecto al que se accede actualmente.

• Siguiente: Haz clic para continuar al siguiente paso.

• Cancelar: Haz clic para cancelar el proceso de importación y volver al proyecto.

Paso 2: Elegir componentes

Selecciona los componentes a importar:

• Importar desde proyecto: Este panel muestra el nombre del proyecto de origen y los componentes disponibles para importar.

• Importar a proyecto: Este panel muestra el nombre del proyecto al que se accede y cualquier componente en el proyecto.

  • Mostrar / Ocultar elementos no afectados: Muestra (predeterminado) u oculta componentes no afectados por la importación.

• Componentes del proyecto: Cada categoría de componente disponible en un proyecto se muestra junto a un número entre paréntesis que indica cuántos componentes hay en la categoría. Los componentes en una categoría de componente se enumeran alfabéticamente. Desde el panel Importar desde proyecto, utiliza las casillas de verificación para seleccionar los componentes a importar al proyecto al que se accede actualmente.

• Seleccionar dependencias automáticamente: Activa esta opción para controlar cómo se manejan las dependencias de componentes durante la importación. Cuando está habilitada (predeterminado), seleccionar un componente selecciona automáticamente todas sus dependencias requeridas, que no se pueden deseleccionar individualmente. Cuando está deshabilitada, puedes seleccionar componentes individuales sin incluir automáticamente sus dependencias.

• Búsqueda: Utiliza el cuadro de búsqueda para ingresar una palabra clave única o una cadena de palabras clave. La cadena de palabras clave se resalta en azul dentro del nombre del componente:

  

• Expandir / Contraer todas las categorías: Expande o contrae todas las categorías de componentes del proyecto.

• Mover a proyecto: Se habilita cuando se selecciona un componente en el panel Importar desde proyecto. Una vez que se hace clic, los componentes seleccionados y sus dependencias se agregan al panel Importar a proyecto. Los componentes agregados al proyecto se indican con un icono azul Nuevo:

  

• Agregar componentes importados a un nuevo flujo de trabajo: Selecciona esta opción para importar cualquier operación en un nuevo flujo de trabajo. El flujo de trabajo se denomina Importado e incluye la fecha y hora de la importación en formato YYYY-MM-DD HH:MM:SS (por ejemplo, Importado 2025-10-15 08:30:00). Esta opción no está disponible hasta que selecciones al menos una operación para importar.

• Conflictos: Cuando un componente importado comparte el mismo nombre que un componente en la misma categoría de componente, ocurre un conflicto:

  

  Cuando están presentes, los conflictos deben resolverse para completar la importación. Utiliza las flechas hacia arriba y hacia abajo para navegar a cada conflicto.

  Los extremos con conflictos tienen estas acciones:

  

  • Usar extremo existente: Selecciona para usar un extremo que está configurado en el proyecto al que se accede actualmente. Utiliza el menú para seleccionar el extremo existente.

    • Reemplazar o copiar componente: Si el extremo existente del proyecto y el extremo importado tienen el mismo tipo de actividad con nombres coincidentes, estas opciones están disponibles:

      • Reemplazar: Selecciona para reemplazar el tipo de actividad existente con el tipo de actividad que se importa.

      • Mantener ambos: Selecciona para mantener ambos tipos de actividad de extremo como componentes independientes. El nombre del componente que se importa se añade con un número incrementado entre paréntesis.

  • Crear nuevo extremo: Selecciona para crear un nuevo extremo en el proyecto al que se accede actualmente. Utiliza el menú para seleccionar Global (consulta Extremos globales) o Nivel de proyecto.

  Todos los componentes con conflictos (excepto extremos) tienen estas acciones:

  • Reemplazar: Reemplaza el componente existente con el componente que se importa. Los componentes importados que se utilizan como reemplazo se indican con un icono morado Reemplazar:

• Mantener ambos: Mantiene ambos componentes. El nombre del componente que se importa se añade con un número incrementado entre paréntesis. Estos componentes se indican visualmente con un icono azul Nuevo:

  

Para componentes en conflicto que incluyen diferencias de contenido o configuración, aparece un botón Ver cambios junto al conflicto. Haz clic en Ver cambios para abrir una vista de diferencias que muestra el contenido o la configuración del componente en el proyecto al que se accede actualmente en comparación con el componente entrante. La vista de diferencias permanece accesible antes y después de confirmar las resoluciones de conflictos, y está disponible nuevamente si haces clic en Editar cambios. El botón aparece solo cuando existen diferencias.

La barra de título de la vista de diferencias muestra el tipo y nombre del componente (por ejemplo, "Decision: Decision" u "Operation: Bulk Insert"). Los siguientes controles están disponibles en la barra de título:

• Abrir en ventana emergente: Abre la vista de diferencias en una nueva ventana emergente. Haz clic nuevamente para devolverla a la posición insertada.
• Maximizar / Restaurar: Expande la vista de diferencias para llenar el espacio de pantalla disponible o la devuelve a su tamaño predeterminado.
• Cerrar: Cierra la vista de diferencias.

Puedes arrastrar la vista de diferencias por su barra de título para reposicionarla en cualquier lugar de la pantalla, y redimensionarla arrastrando sus bordes o esquinas. Una barra de desplazamiento vertical está disponible cuando la diferencia contiene muchos cambios.

La vista de diferencias utiliza uno de los siguientes formatos, según el tipo de componente:

• Vista de diferencias de código: Se utiliza para scripts y transformaciones. Muestra dos paneles lado a lado:

  • Panel izquierdo: Muestra el contenido del componente en el proyecto al que se accede actualmente. Las líneas eliminadas se resaltan en rojo.

  • Panel derecho: Muestra el contenido del componente entrante. Las líneas añadidas se resaltan en verde.

  Para transformaciones, cada regla de mapeo modificada aparece como una sección contraíble etiquetada con la ruta del campo (por ejemplo, "Mapping rule json/isActive"). Haz clic en el símbolo de intercalación para expandir o contraer secciones individuales.

• Vista de diferencias de comparación de campos: Se utiliza para herramientas, notificaciones por correo electrónico, operaciones (incluidos sus horarios, acciones y opciones), variables de proyecto, puntos finales de conectores y actividades de conectores. Muestra una tabla con columnas Nombre, Antes y Después que enumeran cada campo modificado:

  

  Una fila modificada se tiñe de rojo en la columna Antes y de verde en la columna Después, y los caracteres o palabras específicos que cambiaron dentro de un valor se resaltan más intensamente. Los campos relacionados se agrupan bajo encabezados de sección, como las condiciones individuales de una herramienta Decision, los grupos de opciones anidados de un punto final de conector o los pasos de una operación. Un campo cuyo valor hace referencia a una variable de proyecto o variable global se muestra como una referencia vinculada que muestra el nombre de la variable en lugar de su valor literal. Un campo de credencial, como una contraseña o token de seguridad, se enmascara en las columnas Antes y Después.

  Un campo cuyo nombre o valor es demasiado largo para mostrarse en la tabla, o cuyo valor es un objeto o matriz (mostrado como una cadena JSON), incluye un icono de expansión. Haz clic en el icono para abrir una diferencia insertada de ese contenido del campo, mostrada como una diferencia de código con líneas eliminadas resaltadas en rojo y líneas añadidas resaltadas en verde.

  Para una actividad de conector que consulta o recupera datos, un campo Response puede mostrar el esquema de respuesta como un árbol expandible. Los campos añadidos al esquema se resaltan en verde.

  Para un conflicto de punto final de conector, esta misma vista de diferencias de comparación de campos está disponible desde el botón Ver cambios junto a la actividad enumerada en Reemplazar o copiar componente (descrito arriba).

Una fila de Steps enumera las actividades utilizadas por una operación, y una fila de Operation enumera la operación referenciada por una herramienta Decision o Invoke Operation. Cuando una actividad u operación referenciada comparte un nombre con un componente ya existente en el proyecto al que se accede actualmente, se añade "(source project)" a su nombre en la columna After para distinguir el componente entrante del existente con el mismo nombre.

Si una actividad u operación referenciada es en sí misma un conflicto y lo resuelves reutilizando el componente existente en el proyecto, la columna After se actualiza para mostrar el nombre que el componente entrante tendrá una vez importado.

Estas acciones se habilitan solo cuando se realizan cambios en conflictos:

• Replace All: Haz clic para seleccionar en masa Replace (descrito arriba) para todos los conflictos de componentes.

• Keep All: Haz clic para seleccionar en masa Keep both (descrito arriba) para todos los conflictos de componentes.

• Confirm changes: Se habilita solo cuando se selecciona una acción para todos los conflictos. Haz clic para guardar las acciones de conflicto seleccionadas. Una vez hecho clic, se habilita el botón Finish.

• Edit changes: (Visible después de hacer clic en Confirm changes.) Haz clic para editar las resoluciones de conflictos.

• Reset all: Restablece el proyecto a su estado original, eliminando cualquier componente nuevo o reemplazado del panel Import to project.

• Cancel: Haz clic para cancelar el proceso de importación y volver al proyecto.

• Prev / Next:

• Import: Haz clic para importar los componentes y volver al proyecto. Los componentes importados se categorizan en un grupo personalizado llamado Imported seguido de la fecha y hora de la importación (en formato YYYY-MM-DD HH:MM:SS):