Edición de variables de tiempo de ejecución

Muestra cómo seleccionar un conjunto de variables que se pueden utilizar como parámetro de tiempo de ejecución para trabajos de pipeline.

En la página Variables, puede seleccionar un conjunto de variables que se pueden utilizar como parámetro de tiempo de ejecución para trabajos de pipeline. Cuando ejecuta un pipeline, se le proporciona un valor de entrada para estas variables, un conjunto de valores de tiempo de ejecución listos para usar, de los cuales se pueden utilizar los valores de parámetro para trabajos individuales. Las variables pueden ser de tipos predefinidos, como: "Período", "Modo de importación" o "Modo de exportación".

También puede agregar un parámetro de variable personalizada como parámetro de trabajo. Por ejemplo, si desea transferir valores estáticos utilizando una variable de sustitución para el periodo inicial, cambie el tipo de variable a "Texto" y, a continuación, especifique una variable de sustitución como parámetro (aceptado por la API de REST de integración), como &ThisMonth#&ThisYear. (Una variable de sustitución es un nombre de variable de usuario precedido por uno o dos ampersands [&]).

Las variables de tiempo de ejecución predeterminadas son:

  • Periodo inicial
  • Periodo final
  • Modo de importación
  • Modo de exportación
  • Enviar correo
  • Enviar a
  • Adjuntar registro
  • Ejecución de etapa

Para modificar las variables de tiempo de ejecución del pipeline:

  1. En la página de inicio de Data Integration, haga clic en La imagen muestra el icono Seleccionar. a la derecha del pipeline y, a continuación, seleccione Detalles de pipeline.

  2. En la página Pipeline, seleccione el separador Variables.

  3. Seleccione la variable que desee modificar.

  4. En Nombre de la variable, agregue o modifique un nombre de variable predefinido, especifique el nombre.

    Se puede hacer referencia al nombre de variable como un parámetro de trabajo. El nombre no puede tener más de 20 caracteres y no puede contener espacios.

  5. En Nombre mostrado, especifique el nombre mostrado de la petición de datos para la variable.

  6. En Orden de visualización, especifique el orden de visualización de la variable.

  7. Marque Necesario si es necesario un valor para la variable para ejecutar el pipeline.

  8. En la lista desplegable Tipo de validación, seleccione el tipo de valor que se utiliza para validar la variable.

    Los tipos de validación son:

    • Lista: utilice una consulta de lista de valores, y son necesarios valores de enlace.
    • Texto: campos de texto con formato libre
    • Archivo: nombre de archivo. Hay disponible una ventana de explorador de archivos para seleccionar un archivo.

    • Lista personalizada: lista de valores definida por el usuario

      Para utilizar este tipo de validación, proporcione una lista de valores en la ventana Parámetro de validación Los valores se deben especificar con el formato Value,Label y cada línea debe terminar con un carácter de nueva línea; por ejemplo,

      M,Month
      Q,Quarter
      Y,Year
    • Búsqueda: está disponible el uso de valores de búsqueda.

  9. En la lista desplegable Parámetros de validación, seleccione los parámetros predefinidos para la variable según el tipo de validación.

    Por ejemplo, puede seleccionar un parámetro de variable Período inicial basado en un tipo de validación de lista, como:

    • Estado del pipeline
    • Consulta de lista de valores de modo de exportación de pipeline
    • Consulta de lista de valores de nombre de período global
    • Consulta de lista de valores de número de ubicación
    • Balance de comprobación de saldos convertido por consulta de cuenta/entidad de destino
    • Consulta de supervisión de procesos
  10. En Valor predeterminado, seleccione el valor predeterminado para la variable.

    El valor predeterminado puede ser un valor estático o una variable de sustitución de Planning.

    Las variables de tiempo de ejecución predeterminadas y sus descripciones se proporcionan en la siguiente tabla.

    Table 12-40 Variables y descripciones de tiempo de ejecución predeterminadas

    Nombre de la variable Valores disponibles
    Periodo inicial Especifique el primer período de tiempo incluido en el ámbito de procesamiento de importación/exportación del pipeline. Define el inicio del rango de períodos utilizado por el paso Intercambio de datos (a menudo junto con el Período final) para determinar los datos de períodos que se van a procesar.
    Periodo final Especifique el último período de tiempo incluido en el ámbito de procesamiento de importación/exportación del pipeline. Define el final del rango de períodos (utilizado con Período inicial) para definir los datos de períodos que procesará el paso Intercambio de datos.
    Modo de importación

    Especifica cómo debe manejar el pipeline de intercambio de datos la carga de los datos entrantes durante un paso de importación, es decir, si la importación reemplaza los datos existentes o agrega/actualiza los datos existentes en el destino.

    • Reemplazar: (valor predeterminado) reemplaza los datos de destino existentes para el ámbito de importación y, a continuación, carga los nuevos datos.
    • Anexar: retiene los datos de destino existentes y agrega nuevos registros o actualiza los registros coincidentes según las reglas de importación.
    • Sin importar: no carga los datos.
    • Asignar y validar: ejecuta la importación mediante las asignaciones y las reglas de validación definidas para transformar y validar los datos de origen, pero no escribe los datos en el destino. Se utiliza para confirmar el archivo/formato, la cobertura de asignación y las validaciones de reglas, así como para revisar los errores o las advertencias antes del modo de carga/confirmación.
    Modo de exportación

    Especifica cómo debe exportar los datos el pipeline de Intercambio de datos:

    • Fusionar: (valor predeterminado) exporta solo los datos del ámbito de ejecución actual y los combina con cualquier salida de exportación existente para el archivo/ubicación de destino. Puede que se actualicen los registros existentes cuando coincidan las claves; se agregan nuevos registros.
    • Acumular: agrega la salida de exportación de la ejecución actual a la salida existente como un conjunto adicional de registros (solo anexo), conservando el contenido exportado anteriormente.
    • Reemplazar: genera una nueva salida de exportación para el ámbito de ejecución actual y sobrescribe el contenido/archivo de exportación existente en la ubicación de destino.
    • Ejecución en seco: ejecuta el proceso de exportación (selección de ámbito, formato, validaciones) sin producir ni escribir la salida de exportación final, lo que le permite verificar los resultados y detectar incidencias antes de generar archivos.
    • Sin exportar: no exporta los datos.
    Enviar correo

    Controla si el pipeline envía una notificación por correo electrónico para la ejecución del pipeline:

    • Siempre: envía una notificación por correo electrónico para cada ejecución de pipeline, independientemente del resultado (correcto, advertencia o fallo).
    • No: (valor predeterminado) no envía ninguna notificación por correo electrónico para la ejecución del pipeline.
    • Con ejecución fallida: envía una notificación por correo electrónico solo cuando falla la ejecución del pipeline (o finaliza con un estado de error).
    • Con ejecución correcta: envía una notificación por correo electrónico solo cuando la ejecución del pipeline se completa correctamente.
    Enviar a Especifique la lista de destinatarios de correo electrónico para las notificaciones de ejecución de pipeline cuando la opción Enviar correo está activada.
    Adjuntar registros

    Controla si los registros de ejecución de la ejecución del pipeline se incluyen como archivos adjuntos con los resultados/notificaciones del pipeline (por ejemplo, en la salida del trabajo o en cualquier carga útil de notificación/correo electrónico configurada).

    • No: (valor predeterminado) no adjunta registros
    • Sí: adjunta registros
    Ejecución de etapa
    • Iniciar desde el principio: (valor predeterminado) cuando falle el pipeline, reinicie el proceso desde el principio.
    • Iniciar desde fallo: cuando falla el pipeline, en lugar de reiniciar el proceso, inicia el trabajo desde la última etapa con fallos. Cuando un pipeline se reinicia desde una etapa con fallos, el estado de los trabajos desde la etapa anterior se traslada a la nueva ejecución de pipeline.

    Note:

    Si selecciona Iniciar desde fallo, pero el pipeline se ha realizado correctamente, el pipeline no se ejecutará.
  11. Haga clic en Guardar.