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. de un archivo JSON de proyecto a un proyecto.

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

Integration Studio Las exportaciones de proyectos se realizan en formato de archivo JSON. Una vez que tenga una exportación de proyecto JSON, podrá importarla a cualquier organización.

Exportar un proyecto

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

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

Además, se puede acceder a la pantalla de exportación del proyecto mediante el enlace Exportar en la parte inferior de la pantalla Configuración del proyecto (consulte 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 se eligen las opciones de exportación y se genera el proyecto como un archivo JSON:

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

  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 conector puede designar dichos campos con cualquiera de estos atributos:

  • "secret": "true": Indica ú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 enmascara el valor en el Integration Studio UI reemplazando cada carácter con una viñeta negra. 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 UI (consulte Variables del proyecto). En cambio, si se incluyen los valores de las variables del proyecto se controla con la selección Incluir valores de las variables del proyecto.

  Si se utiliza una variable del proyecto en un campo de credenciales (independientemente de si se selecciona Incluir valores de las variables del proyecto), el campo de credenciales "value" 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 no se selecciona Incluir credenciales, el campo de credenciales "value" no se incluye en la exportación del proyecto, excepto si se utiliza una variable de proyecto en un campo de credenciales. En ese caso, se incluye la entrada de texto claro no cifrado del campo de credenciales. Esto puede ser un problema si el campo de credenciales utiliza cualquier otra entrada junto con la variable de 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 Correo: Incluye notificaciones correo en el proyecto exportado. Esta opción se aplica a todas las notificaciones correo de un proyecto, independientemente de si están configuradas con acciones de operación para ejecutarse en caso de éxito, falla o error de SOAP o si están referenciados en un secuencia de comandos.

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

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

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

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

  Nota

  Un proyecto exportado no conserva el historial del proyecto.

Importar

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

1. Importar un proyecto: Esta opción (accesible desde Proyectos page) le permite importar todo el proyecto a su organización.

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

Importar un proyecto

Puede importar un proyecto haciendo clic en Importar en Proyectos página:

En la siguiente pantalla, importe el proyecto:

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

  Sugerencia

  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, consulte Exportaciones e importaciones de Connector Builder. Para instalar un conector SDK de Connector en otra organización, consulte Despliegue de un conector Harmony.

  Al seleccionar un archivo, estos campos estarán disponibles:

  • Nombre del proyecto: El nombre del proyecto se rellena previamente a partir del archivo JSON. Para utilizar un nombre diferente, puede editarlo aquí. El nombre del proyecto debe cumplir estos criterios:

    • Ser único para cada ambiente.

    • No puede estar ya en uso como Design Studio nombre del proyecto en el mismo ambiente.

    Nota

    Si ya existe un proyecto con el mismo nombre en la nube de Harmony, vaya a la Management Console > Proyectos página para administrar el proyecto implementado.

  • Organización: Use el menú desplegable para seleccionar la organización a la que desea importar el proyecto. Si solo tiene una organización, estará seleccionada de manera predeterminada.

  • Ambiente: Utilice el menú desplegable para seleccionar el ambiente al que desea importar el proyecto.

    Precaución

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

  • Incluir notificaciones Correo: De forma predeterminada, si notificaciones correo 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 correo de un proyecto, independientemente de si están configuradas con acciones de operación para ejecutarse en caso de éxito, falla o error de SOAP o si están referenciados en un secuencia de comandos. Para excluir la importación de notificaciones correo, desmarque la casilla de verificación.

    Precaución

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

  • Incluir horarios: De forma predeterminada, si horarios de operación se incluyeron como parte del proyecto cuando se exportó, se incluyen cuando se importa el proyecto. Para excluir los cronogramas de la importación, desmarque la casilla de verificación.

  • Extremos globales: Cualquier extremos global utilizados por el proyecto que se está importando se enumeran y deben agregarse al ambiente seleccionado mediante cualquiera de estas opciones:

    

    • Usar extremo global existente: Visible solo cuando el extremo global ya existe en la organización. Seleccione para agregar un extremo del ambiente a un extremo global existente para el ambiente seleccionado. Use el menú para seleccionar el extremo global existente:

      

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

    • Crear nuevo extremo global: Seleccione para crear un nuevo extremo global para la organización:

      

      Cuando se importa el proyecto, el extremo global se agregará al ambiente seleccionado y será necesario configurarlo después de la importación.

• Importar: Haga clic para importar el proyecto. Si el proyecto se importó correctamente, se abrirá en el tela de diseño. Además, el nuevo proyecto está disponible en Proyectos página.

  Una vez que se importa el proyecto, aún no se implementa. Cuando esté listo para desplegar, consulte Despliegue del proyecto.

Importar componentes desde un proyecto (beta)

Para importar solo componentes específicos de un archivo JSON de proyecto a un proyecto, use el menú de acciones del proyecto en un proyecto y haga clic en Importar (Beta):

Se abre un cuadro de diálogo de selección de archivos. Seleccione un archivo JSON del proyecto que se haya exportado. En la pantalla de configuración, seleccione los componentes que desea importar al proyecto al que se está accediendo actualmente:

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

• Importar al proyecto: Este panel muestra el nombre del proyecto al que se accede y todos los componentes del proyecto.

• Componentes del proyecto: Cada proyecto 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 de una categoría de componentes se enumeran en orden alfabético. En el panel Importar desde el proyecto, utilice las casillas de verificación para seleccionar los componentes que se importarán al proyecto al que se está accediendo actualmente.

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

• Buscar: Utilice 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: Se habilita cuando se selecciona un componente en el panel Importar desde el proyecto. Una vez que se hace clic, los componentes seleccionados y sus dependencias se agregan al panel Importar al proyecto. Los componentes agregados al proyecto se indican con un ícono Nuevo azul:

  

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

  

  Cuando estén presentes, los conflictos deben resolverse para completar la importación. Utilice el flechas arriba y abajo para navegar a cada conflicto.

  Los Extremos con conflictos tienen estas acciones:

  

  • Usar extremo existente: Seleccione esta opción para utilizar un extremo que esté configurado en el proyecto al que se está accediendo actualmente. Use 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 estarán disponibles:

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

      • Mantener ambos: Seleccione esta opción para mantener ambos tipos de actividad de extremo como componentes independientes. El nombre del componente que se está importando se adjunta con un número incrementado entre paréntesis.

  • Crear nuevo extremo: Seleccione esta opción para crear un nuevo extremo en el proyecto al que se está accediendo actualmente. Use el menú para seleccionar Global (consulte Conexiones globales) o Nivel de proyecto.

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

  • Reemplazar: Reemplaza el componente existente con el componente que se está importando. Los componentes importados que se usan como reemplazo se indican con un ícono Reemplazar de color púrpura:

    

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

    

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

  • Reemplazar todo: Haga clic para seleccionar en masa Reemplazar (descrito anteriormente) para todos los conflictos de componentes.

  • Conservar todo: Haga clic para seleccionar en masa Conservar ambos (descrito anteriormente) para todos los conflictos de componentes.

  • Confirmar cambios: Solo se habilita cuando se selecciona una acción para todos los conflictos. Haga clic para guardar las acciones de conflicto seleccionadas. Una vez que se hace clic, se habilita el botón Finalizar.

  • Editar cambios: (visible después de hacer clic en Confirmar cambios). Haga clic para editar las resoluciones de conflictos.

• Restablecer todo: Restablece el proyecto a su estado original y elimina todos los componentes nuevos o reemplazados del panel Importar al proyecto.

• Finalizar: Haz clic para importar los componentes y regresar al proyecto.

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