Saltar al contenido

Variables de proyecto en Jitterbit Studio

Introducción

Las variables de proyecto son uno de los tipos de elementos de datos globales disponibles en Harmony. Los otros tipos de elementos de datos globales —variables globales, variables de Jitterbit y palabras clave de nombre de archivo— también están disponibles globalmente en todo un proyecto. Se configuran de manera diferente, como se describe en Variables globales, Variables de Jitterbit y Palabras clave de nombre de archivo, respectivamente. Sin embargo, como todos los elementos de datos globales comparten el mismo espacio de nombres, sus nombres deben ser únicos cuando se comparan con todos los demás elementos de datos globales.

Las variables de proyecto se configuran antes de la ejecución de una operación y están disponibles para usarse en todos los componentes de un proyecto, incluidos scripts, transformaciones y puntos finales creados mediante conectores. Si cambias el valor de una variable de proyecto durante la ejecución de la operación, la variable se trata como una variable global con el valor modificado persistiendo solo durante la cadena de operaciones. Es decir, cambiar el valor de una variable de proyecto en tiempo de ejecución no actualiza su valor para todo el proyecto.

Las variables de proyecto son componentes del proyecto que se implementan con el proyecto. A diferencia de las variables globales, las variables de proyecto se pueden configurar con un valor predeterminado en tiempo de diseño. Esto significa que puedes usarlas en campos de configuración de puntos finales y verificar sus valores mediante la función Probar conexión de un conector antes de la implementación.

Los usos comunes de las variables de proyecto incluyen credenciales de punto final, nombres de archivo o variables que pueden cambiar de un entorno a otro, o cualquier variable que desees poder editar a través de la Consola de administración o Citizen Integrator.

Crear y actualizar variables de proyecto

Creas y actualizas variables de proyecto desde Studio, así como actualizas variables de proyecto existentes de un proyecto implementado desde la Consola de administración y Citizen Integrator.

Las siguientes secciones describen cómo crear una nueva variable de proyecto desde diferentes ubicaciones en Studio:

Las nuevas variables de proyecto se crean con el nombre predeterminado New_Project_Variable. Las variables de proyecto nuevas posteriores con el nombre predeterminado se añaden con un número incrementado.

Una vez que se ha creado una nueva variable de proyecto, la configuras —dependiendo de cómo se haya creado— ya sea en vista de panel o individualmente, como se describe a continuación en Configurar una variable de proyecto.

Pestaña Project Variables del panel de proyecto

La pestaña Project Variables del panel de proyecto contiene una lista de las variables de proyecto creadas para un proyecto. Incluye controles para crear nuevas variables de proyecto y para editar y eliminar variables de proyecto existentes.

No es necesario abrir un proyecto para acceder a sus variables de proyecto. La pestaña Project Variables del panel de proyecto es accesible tanto desde fuera como dentro de un proyecto desde estas ubicaciones:

Al seleccionar Variables de Proyecto, el panel del proyecto se abre en la parte inferior de la pantalla:

project variables

  • Pestañas: Al acceder a registros de operaciones o flujos de trabajo, aparecen pestañas adicionales en la parte superior del panel. Estas pestañas están etiquetadas con Logging seguido del nombre de una operación o flujo de trabajo. Para reordenar pestañas, arrastra y suelta una pestaña. Para cerrar una pestaña, haz clic en su icono de cierre . Al cerrar la última pestaña o usar el icono de cierre más a la derecha, se cierra el panel.
  • Redimensionar: La barra en la parte superior del panel se puede usar para redimensionarlo. Pasa el cursor sobre la barra y arrastra el icono de redimensionamiento hacia arriba o hacia abajo.
  • Contraer: Contrae el panel. Una vez contraído, haz clic en el icono de retorno para volver a la vista anterior.
  • Expandir: Expande el panel a pantalla completa. Una vez expandido, haz clic en el icono de retorno para volver a la vista anterior.
  • Cerrar: Cierra el panel.

Para editar una variable de proyecto existente, haz clic dentro de los campos de la tabla de variables de proyecto y edita los valores en línea.

Encontrarás información adicional sobre cómo buscar, eliminar y configurar variables de proyecto desde esta vista en Configurar variables de proyecto en la vista de panel más adelante en esta página.

Panel de proyecto

Se puede crear una nueva variable de proyecto desde la pestaña Componentes del panel de proyecto usando la opción Crear Nuevo en la categoría Variables de Proyecto (consulta Menú de acciones de la pestaña Componentes en Pestaña Componentes del panel de proyecto).

Se puede editar una variable de proyecto existente desde la pestaña Componentes del panel de proyecto usando la opción Ver/Editar en un componente de variable de proyecto (consulta Menú de acciones de componentes en Pestaña Componentes del panel de proyecto).

Ambas opciones de menú abren la pantalla de configuración individual de variables de proyecto, como se explica en Configurar una variable de proyecto individualmente más adelante en esta página.

Editor de scripts

Desde el editor de scripts, abre la pestaña Variables de la paleta de componentes y luego ve a la subpestaña Variables de Proyecto:

tab variables

  • Agregar Nuevo: Haz clic para crear una nueva variable de proyecto.

  • Editar: Haz clic para modificar el nombre, valor, etiqueta o descripción de la variable.

  • Información: Haz clic para ver información detallada sobre la variable. Esto incluye su etiqueta, valor actual (si Enmascarar Valor está deshabilitado) y descripción (si se proporciona).
  • Expandir/Contraer: Esta opción es visible solo para variables que están actualmente en uso. Haz clic para ver u ocultar detalles de uso, incluyendo qué componentes leen o escriben en la variable:

    var dependency

    Puedes hacer clic en el nombre de cualquier componente para abrir su pantalla de configuración.

Ambas acciones abren la pantalla de configuración individual de variables de proyecto, como se explica en Configurar una variable de proyecto individualmente más adelante en esta página.

Para renombrar una variable de proyecto, haz clic derecho en su nombre en el área de scripts de un script y selecciona Renombrar variable del menú contextual. Esto actualiza automáticamente todas las referencias en el script actualmente abierto y en los componentes listados en el diálogo de confirmación de cambio de nombre.

Asignación de transformación

Desde la pantalla de configuración de una transformación, abre la pestaña Variables a la izquierda y expande la categoría Project Variables:

variables project variables

  • Create New Project Variable: Haz clic para crear una nueva variable de proyecto.

  • Search: Para buscar una variable particular por nombre, haz clic en el icono de búsqueda e ingresa una palabra clave o varias palabras clave separadas por comas en el cuadro de búsqueda. La búsqueda devuelve una lista de variables que contienen cualquiera de las palabras clave.

  • Edit: Para editar una variable de proyecto existente, coloca el cursor sobre el nombre de la variable y haz clic en el icono de edición :

Tanto la acción de crear una nueva variable de proyecto como la de editar una variable de proyecto existente abren la pantalla de configuración individual de la variable de proyecto, que se describe en Configure a project variable individually más adelante en esta página.

Configuraciones de endpoint

Al usar un conector para configurar un endpoint, en los campos que tienen un icono de variable , haz clic en el icono para mostrar una lista de variables existentes. Para crear una nueva variable de proyecto, haz clic en Add variable en la esquina inferior izquierda:

FTP connection host

  • Para editar una variable de proyecto existente de esta lista, coloca el cursor sobre la fila de la variable de proyecto y haz clic en el icono de edición en el extremo derecho.

  • Cuando una variable de proyecto existente ya se ha utilizado dentro de un campo de configuración, coloca el cursor sobre la etiqueta de variable para ver información sobre la variable, luego haz clic en Edit en la esquina inferior izquierda:

    FTP connection host hover

Todas estas acciones abren la pantalla de configuración individual de la variable de proyecto, que se describe en Configure a project variable individually más adelante en esta página.

Menú de acciones de variable de proyecto

Después de crear una variable de proyecto, se puede acceder a las acciones de menú de esa variable de proyecto desde la pestaña Components del panel de proyecto (consulta Component actions menu en Project pane Components tab).

Cada una de estas acciones de menú está disponible:

Elemento de menú
Descripción
view edit View/Edit abre la pantalla de configuración individual de la variable de proyecto para que configures la variable de proyecto. Para obtener más detalles, consulta Configure a project variable individually más adelante en esta página.
cut Cut coloca una copia de la variable de proyecto en el portapapeles y elimina la variable de proyecto original del proyecto (consulta Component reuse).
copy Copy coloca una copia de la variable de proyecto en el portapapeles (consulta Component reuse).
duplicate Duplicate crea una nueva variable de proyecto sin referencias utilizando la misma configuración que la variable de proyecto original (consulta Component reuse).
rename Rename posiciona el cursor en el nombre de la variable de proyecto para que realices los cambios necesarios.
view dependencies View Dependencies cambia la vista en el panel de proyecto para mostrar cualquier otra parte del proyecto de la que depende la variable de proyecto (consulta Component dependencies, deletion, and removal).
add to group Add to Group abre un diálogo para crear un nuevo grupo personalizado o para agregar la variable de proyecto a un grupo existente (consulta Component groups).
delete Delete elimina permanentemente la variable de proyecto (consulta Component dependencies, deletion, and removal).
remove Remove actualmente no es funcional.

Ver dependencias de variables de proyecto

Las dependencias de una variable de proyecto son los otros componentes que hacen referencia a esa variable al leer de ella o escribir en ella. Después de crear y usar una variable de proyecto en un proyecto, se pueden ver estas dependencias.

Después de crear una variable de proyecto, la opción Ver dependencias está disponible en la pestaña Componentes del panel del proyecto. Para obtener más información sobre la pestaña Componentes, consulta Menú de acciones de componentes en Pestaña Componentes del panel del proyecto.

La opción Ver dependencias cambia la vista en el panel del proyecto para mostrar otros componentes del proyecto que hacen referencia a la variable de proyecto.

Alternativamente, se pueden ver las dependencias de variables de proyecto directamente en la pestaña Variables de la paleta de componentes del script.

Vista de dependencias de variables de proyecto

En la vista de dependencias, el nombre de la variable de proyecto seleccionada aparece en la parte superior, debajo de las opciones de búsqueda y filtro existentes. El nombre de la variable de proyecto va seguido de una lista de Dependencias que hacen referencia a la variable.

Las dependencias se organizan por categorías como Actividad y Script. Dentro de cada categoría, los componentes se clasifican como Lectura o Escritura para mostrar cómo se accede a la variable.

Se puede hacer clic en el nombre de cualquier componente para abrir su pantalla de configuración:

dependencies project variable

Configurar una variable de proyecto

Una vez que se crea una variable de proyecto, se configura de una de dos formas:

Configurar una variable de proyecto en vista de panel

Configurar una variable de proyecto en el panel del proyecto es una de dos vistas utilizadas para configurar variables de proyecto. (La otra vista se utiliza al configurar una variable de proyecto individual.)

El panel de variables de proyecto es accesible tanto desde fuera como dentro de un proyecto. No es necesario abrir un proyecto para acceder al panel. La opción Variables de proyecto se puede acceder desde estas ubicaciones:

Al acceder al panel de variables de proyecto, estas acciones están disponibles:

project variables

  • Eliminar variable(s): Se habilita solo cuando se selecciona al menos una variable de proyecto. Haz clic para eliminar permanentemente la variable de proyecto (consulta Dependencias de componentes, eliminación y extracción).

  • Nueva variable: Agrega una nueva fila de variable de proyecto al final de la tabla de variables de proyecto. Alternativamente, se puede agregar una nueva fila de variable de proyecto colocando el cursor en el campo Descripción de la última fila y luego presionando la tecla Tab. Con cualquiera de los métodos para crear una nueva variable de proyecto, el cursor se coloca en el campo Nombre para que cambies el nombre de la variable de proyecto:

project variables rename

Precaución

Como todos los elementos de datos globales (variables globales, variables de proyecto y variables de Jitterbit) comparten el mismo espacio de nombres, sus nombres deben ser únicos cuando se comparan con todos los demás elementos de datos globales.

Una vez que se hace clic fuera de los campos de la nueva variable de proyecto, la variable de proyecto se guarda. Se puede cambiar el orden de clasificación haciendo clic en el encabezado de la columna Nombre, Valor predeterminado, Etiqueta o Descripción.

Las variables de proyecto se pueden configurar haciendo clic o tabulando en cada campo dentro de la tabla y editándolo en línea.

Para las nuevas variables de proyecto, la configuración se guarda cuando se cambia el enfoque fuera de la fila de la nueva variable de proyecto. Para las variables de proyecto existentes, la configuración se guarda cada vez que se cambia el enfoque a otro campo, incluso dentro de la misma fila de variable de proyecto.

  • Búsqueda: Ingresa una palabra clave única o una cadena de palabras clave en el cuadro de búsqueda para buscar una variable de proyecto por su Nombre o Descripción.

Columnas de la tabla de variables de proyecto

A continuación se describe cada columna de la tabla de variables de proyecto:

project variables

  • Seleccionar: La columna del extremo izquierdo se puede usar para seleccionar una, varias o todas las variables de proyecto para su eliminación. Después de seleccionar al menos una variable de proyecto, el botón Eliminar variable(s) en la parte superior de la tabla está disponible para que elimines permanentemente la variable de proyecto (consulta Dependencias de componentes, eliminación y extracción).

  • Nombre: Ingresa el nombre de la variable de proyecto. El nombre de la variable de proyecto debe ser único dentro del proyecto, no debe contener espacios y puede estar compuesto por estos caracteres: letras, números (0-9), puntos y guiones bajos. No se recomiendan otros caracteres y pueden causar problemas. Los nombres de variables de proyecto no distinguen entre mayúsculas y minúsculas; por ejemplo, una variable llamada ProjectVar se trata igual que projectvar. Como todos los elementos de datos globales (variables globales, variables de proyecto y variables de Jitterbit) comparten el mismo espacio de nombres, sus nombres deben ser únicos cuando se comparan con todos los demás elementos de datos globales.

    Al crear nuevas variables de proyecto, es una buena práctica prefijar las variables de proyecto para que sean fáciles de buscar más adelante. Por ejemplo, una variable de proyecto org.netsuite.auth.username se prefija primero con org, luego netsuite, etc. para organizarla efectivamente en una lista entre otras variables de proyecto. Sin embargo, si planeas usar las variables de proyecto en JavaScript más adelante, recomendamos usar guiones bajos en lugar de puntos. Más información se proporciona a continuación en Recuperar variables de proyecto en scripts o transformaciones.

    Una variable global existente se puede convertir en una variable de proyecto ingresando su nombre en el campo Nombre. Consulta Convertir una variable global en una variable de proyecto para obtener más detalles.

  • Valor predeterminado: Ingresa un valor predeterminado opcional que se usará como valor inicial para la variable de proyecto. Este valor se puede modificar más adelante mediante scripts. Si no deseas que la variable de proyecto tenga un valor predeterminado, deja este campo en blanco.

  • Enmascarar valor: Usa el control deslizante para activar la opción Enmascarar valor. Al habilitar esta opción, se oculta el valor predeterminado reemplazándolo con puntos negros en varios lugares de la interfaz de usuario. Es posible que desees usar esto si el valor contiene información confidencial que no deseas que sea visible en la pantalla. A partir de la versión 12.5 del agente, los valores enmascarados también se ocultan en la salida del script de prueba, en los mensajes del registro de operaciones escritos usando WriteToOperationLog y en los mensajes de error escritos usando RaiseError.

  • Etiqueta: Ingresa una etiqueta opcional para describir la variable. Esta etiqueta aparece al pasar el cursor sobre la variable en scripts y en pantallas de configuración.

  • Descripción: Ingresa una descripción opcional para proporcionar más detalles sobre la variable. Esta descripción aparece al pasar el cursor sobre la variable en scripts y en pantallas de configuración.

Configurar una variable de proyecto individualmente

Configurar una variable de proyecto en un diálogo es una de dos vistas utilizadas para configurar variables de proyecto. (La otra vista es la vista de panel de variables de proyecto.)

Esta vista se utiliza cuando creas o editas una variable de proyecto directamente desde el panel del proyecto, dentro de un script o transformación, o dentro de una pantalla de configuración de endpoint.

Cuando creas una variable de proyecto nueva o editas una existente individualmente, se muestra el diálogo Project Variable:

project variable configuration

  • Nombre de la variable de proyecto: Ingresa el nombre de la variable de proyecto que deseas declarar. El nombre de la variable de proyecto debe ser único dentro del proyecto, no debe contener espacios y puede estar compuesto por estos caracteres: letras, números (0-9), puntos y guiones bajos. No se recomiendan otros caracteres y pueden causar problemas. Los nombres de variables de proyecto no distinguen entre mayúsculas y minúsculas; por ejemplo, una variable llamada ProjectVar se trata igual que projectvar. Como todos los elementos de datos globales (variables globales, variables de proyecto y variables de Jitterbit) comparten el mismo espacio de nombres, sus nombres deben ser únicos cuando se comparan con todos los demás elementos de datos globales.

    Al crear nuevas variables de proyecto, es una buena práctica prefijar las variables de proyecto para que sean fáciles de buscar más adelante. Por ejemplo, una variable de proyecto org.netsuite.auth.username se prefija primero con org, luego netsuite, etc. para organizarla efectivamente en una lista entre otras variables de proyecto. Sin embargo, si planeas usar las variables de proyecto en JavaScript más adelante, recomendamos usar guiones bajos en lugar de puntos. Encontrarás más información a continuación en Recuperar variables de proyecto en scripts o transformaciones.

    Una variable global existente se puede convertir en una variable de proyecto ingresando su nombre en el campo Name. Consulta Convertir una variable global en una variable de proyecto para obtener detalles.

  • Valor predeterminado: Ingresa un valor predeterminado opcional que se utilizará como valor inicial para la variable de proyecto. Este valor se puede modificar más adelante mediante scripts. Si no deseas que la variable de proyecto tenga un valor predeterminado, deja este campo en blanco.

  • Ocultar valor en la interfaz de usuario: Usa el control deslizante para activar la opción Enmascarar valor. Al habilitar esta opción, se oculta el valor predeterminado reemplazándolo con puntos negros en varios lugares de la interfaz de usuario. Puedes usar esto si el valor contiene información confidencial que no deseas que sea visible en la pantalla. A partir de la versión 12.5 del agente, los valores enmascarados también se ocultan en la salida de scripts de prueba, mensajes de registro de operaciones escritos usando WriteToOperationLog y mensajes de error escritos usando RaiseError. Después de habilitar esta opción, se te pide que confirmes que deseas ocultar el valor:

    Texto del diálogo

    Enmascarar valor
    ¿Estás seguro? Esta acción enmascarará el valor actual y no se puede deshacer.

    Si deshabilitas esta opción después de habilitarla, se te pide que confirmes que deseas eliminar el valor actual (ya que un valor previamente oculto no se puede desenmascarar):

    Texto del diálogo

    Desenmascarar y actualizar valor
    ¿Estás seguro? Esta acción actualizará el valor actual y no se puede deshacer.

Después de hacer clic en Continuar, el cursor se posiciona en un campo Valor predeterminado vacío.

  • Etiqueta: Ingresa una etiqueta opcional para describir la variable. Esta etiqueta aparece al pasar el cursor sobre la variable en scripts y en pantallas de configuración.

  • Descripción: Ingresa una descripción opcional para proporcionar más detalles sobre la variable. Esta descripción aparece al pasar el cursor sobre la variable en scripts y en pantallas de configuración.

  • Guardar: Haz clic para guardar y cerrar la configuración de la variable de proyecto.

  • Guardar y nuevo: Haz clic para guardar y abrir la configuración de la variable de proyecto para una nueva variable.

  • Eliminar: Después de abrir una variable de proyecto existente, haz clic para eliminar permanentemente la variable de proyecto y cerrar la configuración (consulta Dependencias de componentes, eliminación y remoción).

Recuperar variables de proyecto en scripts o transformaciones

En Studio, el valor de una variable de proyecto se puede obtener usando Jitterbit Script en scripts o transformaciones, o usando JavaScript solo en scripts creados como componente de proyecto.

Jitterbit Script

En scripts y transformaciones, puedes comenzar con un signo de dólar $ o usar la función Get para recuperar el valor de una variable de proyecto.

  • $: Con el prefijo de un signo de dólar $, el ejemplo de código $org.netsuite.auth.username recupera el valor de la variable de proyecto llamada "org.netsuite.auth.username".
  • Get: Usando la función Get, el ejemplo de código Get("org.netsuite.auth.username") devuelve el mismo valor.

En scripts y transformaciones, las variables de proyecto existentes se muestran en la pestaña Variables de la paleta de componentes de script dentro de la subpestaña Variables de proyecto. Consulta Agregar una variable de proyecto a un script a continuación.

JavaScript

En JavaScript usado dentro de scripts dentro de una operación, la sintaxis utilizada para recuperar el valor de una variable de proyecto depende de si el nombre de la variable de proyecto contiene un punto.

  • El nombre no incluye un punto (recomendado): El valor de una variable de proyecto que no contiene puntos en su nombre se puede recuperar con el prefijo de un signo de dólar $.

    • $: Con el prefijo de un signo de dólar $, el ejemplo de código $org_netsuite_auth_username recupera el valor de la variable de proyecto llamada "org_netsuite_auth_username".
  • Nombre con puntos (recomendado solo para variables de Jitterbit y valores de objetos JavaScript): Una variable que contiene un punto en su nombre se puede actualizar o recuperar en JavaScript solo con las funciones Jitterbit.SetVar y Jitterbit.GetVar. Como estas funciones no están destinadas a variables de proyecto definidas por el usuario, consulta la sección sobre variables de Jitterbit para obtener más información.

En scripts y transformaciones, las variables de proyecto existentes se muestran en la pestaña Variables de la paleta de componentes de script dentro de la subpestaña Variables de proyecto. Consulta Agregar una variable de proyecto a un script a continuación.

Advertencia

Las funciones Jitterbit.SetVar y Jitterbit.GetVar de JavaScript están diseñadas específicamente para acceder a las variables predefinidas de Jitterbit. No deben usarse para acceder a variables de proyecto definidas por el usuario.

En JavaScript, no mezcles el uso de SetVar (y GetVar) con el prefijo $ al establecer (y recuperar) una variable. Usa solo una sintaxis. Mezclar las dos sintaxis diferentes para la misma variable puede causar problemas en tiempo de ejecución.

Si falla un JavaScript, se pierden los cambios realizados en el valor de una variable de proyecto. Solo si el JavaScript se completa exitosamente, los valores de variables de proyecto modificados están disponibles fuera del script.

Agregar una variable de proyecto a un script

En Jitterbit Script o JavaScript utilizados dentro de scripts creados dentro de una operación, las variables de proyecto existentes se muestran en la pestaña Variables de la paleta de componentes dentro de la subpestaña Project Variables:

project variables

Para agregar la sintaxis de variable a un script (Jitterbit Script o JavaScript), usa uno de estos métodos:

  • Arrastra la variable desde la paleta al script para insertar la sintaxis de variable.
  • Haz doble clic en la variable en la paleta para insertar la sintaxis de variable en la ubicación del cursor dentro del script.
  • Comienza a escribir el nombre de la variable y luego presiona Control+Espacio para mostrar una lista de sugerencias de autocompletado. Selecciona una variable para insertar la sintaxis de variable.
  • Ingresa manualmente la sintaxis de variable.

Usar variables de proyecto en pantallas de configuración

Durante la configuración de ciertos componentes del proyecto, incluida la configuración de puntos finales mediante conectores, puedes usar variables de proyecto en cualquier campo que tenga un icono de variable . Las variables se pueden usar en campos junto con otra entrada, incluyendo otras variables o palabras clave.

Seleccionar una variable de proyecto

Para acceder a las variables de proyecto, puedes hacer clic en el icono de variable o escribir un corchete de apertura [ para mostrar un menú que enumera variables y palabras clave (si están disponibles para el campo actual).

Dentro de la lista, el tipo de variable o palabra clave se indica mediante el icono junto a su nombre:

  • para palabra clave de nombre de archivo
  • para variable global
  • para variable de proyecto
  • para variable de Jitterbit

El fondo del icono es sólido si la variable de proyecto tiene un valor predeterminado especificado en la configuración de la variable de proyecto misma, o vacío si no lo tiene.

Selecciona una variable para agregarla al campo en la ubicación del cursor, en cualquier parte de la cadena. La variable se muestra en un formato de píldora similar al que se muestra a continuación:

FTP connection host pill

Para revisar información sobre la variable, pasa el cursor sobre la píldora de variable para mostrar una ventana emergente de información:

FTP connection host hover

Para editar la configuración de la variable, haz clic en Edit para abrir el diálogo Project Variable.

Eliminar una variable

Para eliminar una variable, haz clic en el icono de eliminación :

FTP connection host pill remove

Guías prácticas de variables de proyecto

Esta sección proporciona información sobre cómo completar tareas específicas con variables de proyecto.

Convertir una variable global en una variable de proyecto

Para convertir una variable global existente en una variable de proyecto, ingresa el nombre de la variable global existente en un campo Project Variable Name. Al guardar (desplazando el enfoque fuera de la fila si estás en vista de cajón o haciendo clic en Save si estás en vista individual), se te solicita que confirmes que deseas convertir la variable global en una variable de proyecto:

Texto del diálogo

La Variable Global ya existe
Ya existe una Variable Global con el mismo nombre en el proyecto. ¿Deseas convertir la Variable Global existente en una Variable de Proyecto?

Al hacer clic en Continuar, todas las referencias y dependencias de la variable global se transfieren a la variable de proyecto. Esto incluye referencias a la variable global anterior dentro de scripts, que ahora hacen referencia a la variable de proyecto. Ten en cuenta que un valor para una variable de proyecto establecido en un script durante la ejecución de la cadena de operaciones anula el valor predeterminado especificado en la configuración de la variable de proyecto. Al hacer clic en Cancelar se cancela la conversión de la variable global.

Nota

Si algún campo de configuración hacía referencia a la variable global convertida utilizando sintaxis de valor predeterminado en línea (por ejemplo, [myVar{defaultValue}]), esa sintaxis permanece en su lugar después de la conversión. Sin embargo, las variables de proyecto ignoran el valor predeterminado en línea. Una variable de proyecto obtiene su valor predeterminado del campo Valor Predeterminado en su configuración, no de la sintaxis de valor predeterminado en línea en los campos de configuración.

Transferir variables de proyecto

Cuando Transfieres un proyecto, tienes la capacidad de seleccionar qué variables de proyecto tendrán sus valores excluidos en el entorno de destino.

Esto te permite mantener los valores de las variables de proyecto segregados por entorno. Por ejemplo, es posible que desees mantener valores de variables de proyecto separados para una URL de host de endpoint en un entorno de Producción y una URL de host de endpoint de sandbox separada para un entorno de QA.

Es posible que desees excluir ciertos valores de variables de proyecto de la transferencia para evitar rellenar sus valores en la transferencia inicial o para evitar sobrescribir sus valores en transferencias posteriores.

Para excluir variables de proyecto de la transferencia, selecciona la opción Seleccionar Valores de Variables a Migrar en la pantalla de transferencia de proyecto. Cuando se selecciona esta opción, ningún valor de variable de proyecto se selecciona para transferencia de forma predeterminada. Si deseas incluir algún valor de variable de proyecto durante la transferencia, puedes seleccionarlos individualmente. Para obtener más detalles, consulta Transferencia de proyecto en Transferir un proyecto.