Configuración de opciones de tiempo de ejecución de flujo de datos

Puede configurar los flujos de datos de manera tal que sean expuestas las opciones de las etapas para su configuración durante la ejecución del flujo de datos. Esto quiere decir que las etapas pueden usar distintas configuraciones cada vez que se ejecuta el flujo de datos. Las opciones de etapa pueden ajustarse cuando se llama al trabajo mediante un flujo de proceso o mediante la herramienta de línea de comandos del ejecutor del trabajo. Por ejemplo, puede elegir que se especifique el uso de mayúsculas y minúsculas en los datos de salida en tiempo de ejecución, lo que permite elegir el uso de minúsculas o mayúsculas durante la ejecución, en lugar de contar con flujos de datos separados con diferentes opciones entre mayúsculas y minúsculas cada uno.

Este procedimiento describe la forma de configurar un flujo de datos compatible con las opciones de ejecución.

  1. Abra el flujo de datos en Enterprise Designer.
  2. Si desea configurar las opciones de tiempo de ejecución para una etapa en un flujo de datos incrustado, abra este último.
  3. Haga clic en el icono Opciones de flujo de datos en la barra de herramientas o haga clic en Editar > Opciones de flujo de datos. Aparecerá el cuadro de diálogo Opciones de flujo de datos.
  4. Haga clic en Agregar. Aparecerá el cuadro de diálogo Definir opción de flujo de datos.
  5. En el campo Nombre de la opción, especifique el nombre que desea utilizar para esta opción. Este es el nombre de opción que deberá especificarse durante el tiempo de ejecución para definir esta opción.
  6. En el campo Rótulo puede especificar un rótulo diferente o mantenerlo igual que el nombre de la opción.
  7. Ingrese una descripción de la opción en el campo Descripción.
  8. En el campo Destino seleccione si desea que esta opción se aplique a todas las etapas del flujo de datos o solamente a algunas etapas.
    Etapa o etapas seleccionadas
    Seleccione esta opción si desea que se aplique únicamente a las etapas que especificó.
    Todas las etapas
    Seleccione esta opción si desea que se aplique a todas las etapas del flujo de datos.
    Incluye transformaciones
    Seleccione esta opción si desea que la opción de ejecución esté disponible para trasformaciones personalizadas en las etapas Transformer del flujo de datos. Si selecciona esta opción podrá tener acceso al valor especificado durante el tiempo de ejecución en la secuencia de comandos Groovy de una transformación personalizada utilizando la siguiente sintaxis:
    options.get("optionName")
    Por ejemplo, para acceder a una opción denominada casing, debe incluir esto en la secuencia de comandos de transformación personalizada:
    options.get("casing")
  9. Si selecciona Etapa o etapas seleccionadas en el campo Destino, el cuadro Asignar opciones de flujos de datos a etapas muestra una lista de las etapas del flujo de datos. Seleccione la opción que desea exponer como una opción de flujo de datos. Verá completarse los campos Valor predeterminado y Valores válidos con datos cuando seleccione el primer elemento.
    Nota: Puede seleccionar opciones múltiples de modo que la opción de flujo de datos pueda controlar las opciones de etapas múltiples. Si procede de esta manera, cada una de las opciones de etapa que seleccione deben compartir valores válidos. Por ejemplo, si una opción tiene los valores Y y N, cada una de las opciones adicionales debe tener ya sea Y o N en su conjunto de valores, y durante la ejecución usted solamente podrá permitir que esté disponible el valor que tienen en común. Así, si selecciona una opción con los valores Y y N, no podrá seleccionar una opción con los valores de E, T, M, y L, pero sí puede seleccionar una opción con los valores P, S, y N, ya que ambas opciones comparten "N" como valor. Sin embargo, solo "N" sería un valor disponible para esta opción, "Y", "P" y "S". no estarán disponibles
  10. Si desea limitar los valores que pueden especificarse durante el tiempo de ejecución, edite las opciones en el campo Valores válidos haciendo clic en el ícono a la derecha del campo.
  11. Si desea cambiar el valor predeterminado, especifique un valor diferente en el campo Valor predeterminado.
  12. Haga clic en Aceptar.
  13. Continúe agregando opciones, según sus preferencias.
  14. Haga clic en ACEPTAR en el cuadro de diálogo Opciones de flujo de datos cuando haya terminado de agregar opciones.
  15. Si agregó una opción de tiempo de ejecución a un flujo de datos incrustado, debe definir el flujo de datos principal de la opción de tiempo de ejecución, así como también, todos los flujos de datos antecesores, para poner a disposición las opciones en el tiempo de ejecución. Para hacer esto, abra el flujo de datos que contiene el flujo de datos incrustado y exponga la opción que acaba de crear. Si es necesario, abra el elemento principal del flujo de datos y defina la opción allí y así sucesivamente, hasta que todos los antecesores tengan definida la opción del flujo de datos.

    Por ejemplo, considere que tiene un flujo de datos denominado "A" que contiene un flujo de datos incrustado denominado "B", el que contiene un flujo de datos "C", de modo que tiene una jerarquía de flujos de datos incrustado con la siguiente apariencia: A > B > C. Si desea exponer una opción denominada Casing en una etapa en un flujo de datos incrustado "C", debe abrir el flujo de datos incrustado C y definirla. Luego, debe abrir el flujo de datos incrustado "B" y definir la opción. Finalmente, debe abrir el flujo de datos "A" y definir la opción, haciendo que esté disponible en el tiempo de ejecución.

El flujo de datos está ahora configurado para permitir la especificación de opciones durante el tiempo de ejecución. Ahora puede especificar la configuración durante la ejecución a través de los siguientes medios:

  • Para trabajos, pueden especificarse las opciones usando un archivo de propiedades de opciones de flujo de datos y el argumento -o del ejecutor de trabajos.
  • Para servicios, las opciones están disponibles como opciones API.
  • Para los servicios expuestos como servicios web, las opciones estarán disponibles como parámetros de servicios web.
  • Para subflujos las opciones son heredadas por el flujo de datos principal y se exponen a través de alguno de los medios anteriores, en función del tipo de flujo de datos principal (trabajo, servicio, o servicio expuesto como servicio web).