Exportar e importar un proyecto en Jitterbit Integration Studio

Introducción

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

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

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

Exportar un proyecto

Las opciones Exportar o Exportar proyecto están disponibles 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 puede elegir las opciones de exportación y generar 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.

  Nota

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

  Los campos de configuración específicos que se consideran campos de credenciales varían según el componente del proyecto. Suelen incluir campos como contraseñas o tokens de seguridad. Desarrolladores de conectores personalizados que utilizan el SDK del conector pueden designar dichos campos con cualquiera de estos atributos:

  • "secret": "true": Indica únicamente que el campo se considera un campo de credenciales. El valor del campo se cifra en la exportación del proyecto.

  • "widgetHint": "password": Indica que el campo se trata como un campo de credenciales y, además, enmascara el valor en la interfaz de usuario de Integration Studio 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 se selecciona la opción Ocultar valor en la interfaz de usuario (consulte Variables del proyecto). En cambio, la inclusión de los valores de las variables del proyecto se controla con la opció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 sintáctica entre 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 y sin cifrar del campo de credenciales. Esto puede ser preocupante 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, error o falla 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 (vea 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 usa el nombre del proyecto.

  Nota

  Un proyecto exportado no conserva el historial del proyecto.

Importar

Una vez que se haya exportado un proyecto#projectexportsandimports-export), puede importar el archivo JSON del proyecto mediante cualquiera de estas dos opciones de importación:

1. Importar un proyecto: Esta opción (accesible desde Proyectos página) le permite importar el proyecto completo a su organización.

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

Importar un proyecto

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

Nota

Para importar solo los componentes especificados de un archivo JSON de proyecto, utilice la opción Importar, que se describe en Importar componentes de un proyecto a continuación.

En la siguiente pantalla, importe el proyecto:

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

  Consejo

  Si el proyecto utiliza conectores personalizados, estos deben existir en la organización antes de importar el proyecto. Para exportar un conector del Generador de conectores e importarlo en otra organización, consulte Exportaciones e importaciones del Generador de conectores. 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 predefine a partir del archivo JSON. Para usar 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 gestionar 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, esta estará seleccionada por defecto.

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

    Precaución

    Si el proyecto de origen utiliza conectores que solo están disponibles en agentes privados, no se puede importar a un ambiente asociado a un grupo de agentes de la nube. Estos ambientes siguen apareciendo 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 al exportarlo, se incluyen al importarlo. 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, error o falla 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 al exportarlo, se incluyen al importarlo. Para excluir las programaciones de la importación, desmarque la casilla.

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

    

    • Usar extremo global existente: Visible solo cuando el extremo global ya existe en la organización. Seleccione esta opción para agregar un extremo de 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, extremo se usará para el proyecto importado. Si el extremo global existente no tiene un extremo de ambiente ambiente el ambiente seleccionado, se usarán 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 se importó correctamente, se abrirá en el tela de diseño. Además, el nuevo proyecto está disponible en Proyectos página.

Una vez importado el proyecto, aún no se ha implementado. Cuando esté listo para desplegar, consulte Despliegue del proyecto.

Importar componentes de un proyecto

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

Nota

Para importar un archivo JSON de un proyecto completo como un nuevo proyecto, utilice la opción Importar, que se describe en Importar un proyecto arriba.

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 accede actualmente:

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

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

• 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 se ordenan alfabéticamente. 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 accede 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 introducir una palabra clave o una cadena de palabras clave. La cadena de palabras clave se resaltará en azul dentro del nombre del componente:

  

• Mover al proyecto: Se habilita al seleccionar un componente en el panel Importar desde el proyecto. Al hacer clic, los componentes seleccionados y sus dependencias se añaden al panel Importar al proyecto. Los componentes añadidos al proyecto se indican con un icono azul Nuevo:

  

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

  

  Cuando existan conflictos, estos 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 usar un extremo configurado en el proyecto al que se accede 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 importa se añade con un número incremental entre paréntesis.

  • Crear nuevo extremo: Seleccione esta opción para crear un nuevo extremo en el proyecto al que se accede 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 por el componente que se está importando. Los componentes importados que se usan como reemplazo se indican con un icono morado de Reemplazar.

    

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

    

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

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

  • Conservar todo: Haga clic para seleccionar 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. Al hacer 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 los conflictos.

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

• Finalizar: Haga clic para importar los componentes y volver al proyecto. Los componentes importados se clasifican en un grupo personalizado llamado Importado adjunto con la fecha y hora de la importación (en YYYY-MM-DD HH:MM:SSformato):

  

• Cancelar: Haga clic para cancelar la importación y regresar al proyecto.