Exportar e importar un proyecto en Jitterbit Integration Studio

Introducción

Esta página describe cómo exportar e importar un proyecto, e importar componentes individuales desde un archivo JSON de proyecto a un proyecto.

Juntas, 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 Integration Studio están en formato de archivo JSON. Una vez que tenga una exportación de proyecto en JSON, se puede importar a cualquier organización.

Exportar un proyecto

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

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

Además, la pantalla de exportación del proyecto es accesible utilizando el enlace Exportar en la parte inferior de la pantalla de Configuración del Proyecto (ver 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 elige las opciones de exportación y genera 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 dependiendo de la política de organización Permitir que las credenciales sean exportadas.

  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 únicamente 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 oculta el valor en la interfaz de usuario de Integration 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 (ver Variables del proyecto). En cambio, 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 se selecciona Incluir Valores de Variables del Proyecto), 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, la entrada de texto claro no cifrada del campo de credenciales se incluye. 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 error SOAP o si están referenciadas en un script.

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

  Los valores de las variables del proyecto configuradas con la opción Ocultar valor (ver Variables del proyecto) están encriptados en la exportación del proyecto.

• Incluir horarios: Incluye horarios de operación en el proyecto exportado.

• Exportar: Genera y descarga el proyecto como un archivo JSON. Por defecto, el nombre del archivo JSON utiliza el nombre del proyecto.

  Nota

  Un proyecto exportado no retiene el historial del proyecto.

Importar

Una vez que un proyecto ha sido exportado, puedes importar el archivo JSON del proyecto utilizando cualquiera de estas dos opciones de importación:

1. Importar un proyecto: Esta opción (accesible desde la página de Proyectos) te permite importar todo el proyecto en tu organización.

2. Importar componentes de un proyecto: Esta opción (accesible desde el menú de acciones del proyecto en un proyecto) te permite importar solo componentes específicos del archivo JSON del proyecto en un proyecto existente en tu organización.

Importar un proyecto

Puedes importar un proyecto haciendo clic en Importar en la página de Proyectos:

En la siguiente pantalla, importas el proyecto:

• Archivo del proyecto: Usa el botón Examinar para buscar un archivo JSON de proyecto que ha sido exportado desde Integration Studio.

  Consejo

  Si el proyecto utiliza conectores personalizados, 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 Implementación de un conector de Harmony.

  Al seleccionar un archivo, estos campos se vuelven disponibles:

  • Nombre del proyecto: El nombre del proyecto se completa automáticamente desde el archivo JSON. Para usar un nombre diferente, puedes editarlo aquí. El nombre del proyecto debe cumplir con estos criterios:

    • Ser único para cada entorno.

    • No puede estar ya en uso como un 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 de Consola de Administración > Proyectos para gestionar el proyecto desplegado.

  • Organización: Usa el menú desplegable para seleccionar la organización a la que deseas importar el proyecto. Si solo tienes una organización, se selecciona por defecto.

  • Entorno: Usa el menú desplegable para seleccionar el entorno en el que deseas importar el proyecto.

    Precaución

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

  • Incluir Notificaciones por Correo Electrónico: Por defecto, si las notificaciones por correo electrónico se incluyeron 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, fallo o error de SOAP, o si están referenciadas en un script. Para excluir las notificaciones por correo electrónico de ser importadas, desmarca la casilla.

    Precaución

    Las referencias a un componente de notificación por correo electrónico en un script no se eliminan incluso si se excluyen las notificaciones por correo electrónico, por lo que es posible que debas corregir cualquier referencia rota después de excluir los correos electrónicos.

  • Incluir horarios: Por defecto, si los horarios de operación se incluyeron como parte del proyecto cuando se exportó, se incluyen cuando se importa el proyecto. Para excluir horarios de ser importados, desmarca la casilla.

  • Puntos finales globales: Cualquier punto final global utilizado por el proyecto que se está importando se lista y debe ser agregado al entorno seleccionado utilizando cualquiera 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. Usa 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, el punto final de entorno deberá configurarse 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 importe el proyecto, el punto final global se agregará al entorno seleccionado y deberá configurarse después de la importación.

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

Después de que el proyecto se importe, aún no está desplegado. Cuando estés listo para desplegar, consulta Despliegue del proyecto.

Importar componentes de un proyecto

Para importar solo componentes específicos de un archivo JSON de proyecto a un proyecto, utiliza el menú de acciones del proyecto en un proyecto y haz clic en Importar:

Se abre un cuadro de diálogo de selección de archivos. Selecciona un archivo JSON de proyecto que haya sido exportado. En la pantalla de configuración, seleccionas los componentes a importar en el proyecto que se está accediendo actualmente:

• Importar desde el proyecto: Este panel muestra el nombre del proyecto del archivo JSON de proyecto y los componentes disponibles para ser importados desde el archivo JSON de proyecto.

• Importar al proyecto: Este panel muestra el nombre del proyecto que se está accediendo y cualquier componente en el proyecto.

• 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 el proyecto, utiliza las casillas de verificación para seleccionar los componentes que se importarán al proyecto que se está accediendo actualmente.

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

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

  

• Mover al proyecto: Habilitado cuando se selecciona un componente en el panel de Importar desde el proyecto. Una vez clicado, los componentes seleccionados y sus dependencias se añaden al panel de Importar al proyecto. Los componentes añadidos al proyecto se indican con un ícono azul de Nuevo:

  

• Conflictos: Cuando un componente importado comparte el mismo nombre que un componente en la misma categoría de componentes, 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 endpoints con conflictos tienen estas acciones:

  

  • Usar endpoint existente: Selecciona para usar un endpoint que está configurado en el proyecto que se está accediendo actualmente. Usa el menú para seleccionar el endpoint existente.

    • Reemplazar o copiar componente: Si el endpoint existente del proyecto y el endpoint importado tienen el mismo tipo de actividad con nombres coincidentes, estas opciones se vuelven disponibles:

      • Reemplazar: Selecciona para reemplazar el tipo de actividad existente con el tipo de actividad que se está importando.

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

  • Crear nuevo endpoint: Selecciona para crear un nuevo endpoint en el proyecto que se está accediendo actualmente. Usa el menú para seleccionar Global (ver Endpoints Globales) o Nivel de proyecto.

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

  • Reemplazar: Reemplaza el componente existente con el componente que se está importando. Los componentes importados que se utilizan como reemplazo se indican con un ícono morado de Reemplazar:

    

  • Mantener ambos: Mantiene ambos componentes. El nombre del componente que se está importando se le añade un número incrementado entre paréntesis. Estos componentes se indican visualmente con un ícono azul de Nuevo:

    

  Estas acciones están habilitadas solo cuando se realizan cambios en los conflictos:

  • Reemplazar todo: Haz clic para seleccionar en bloque Reemplazar (descrito arriba) para todos los conflictos de componentes.

  • Mantener todo: Haz clic para seleccionar en bloque Mantener ambos (descrito arriba) para todos los conflictos de componentes.

  • Confirmar cambios: Habilitado solo cuando se selecciona una acción para todos los conflictos. Haz clic para guardar las acciones de conflicto seleccionadas. Una vez clicado, el botón Finalizar se habilita.

  • Editar cambios: (Visible después de hacer clic en Confirmar cambios.) Haz clic para editar las resoluciones de conflicto.

• Restablecer todo: Restablece el proyecto a su estado original, eliminando cualquier componente nuevo o reemplazado del panel Importar al proyecto.

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

  

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