Skip to main content

Herramienta Datos de salida

Utiliza la herramienta Datos de salida para escribir los resultados de un flujo de trabajo en fuentes de datos o tipos de archivo admitidos.

Selecciona la herramienta Datos de salida en la paleta y arrástrala al lienzo del flujo de trabajo.

Componentes de la herramienta

Output Data with Anchors.png

Figura: Herramienta Datos de salida con ancla.

La herramienta Datos de salida tiene una sola ancla.

Ancla de entrada: conecta el ancla de entrada a tu flujo de trabajo para escribir los resultados de tu flujo de trabajo en una fuente de datos o un tipo de archivo compatible.

Configurar la herramienta

Guardar en Conexiones basadas en archivos

Para escribir los resultados de tu flujo de trabajo en una conexión basada en archivos:

  1. En la ventana de configuración de la herramienta, selecciona Seleccionar ubicación de salida para abrir la ventana Datos de salida.

  2. Selecciona una conexión de datos en la nube en Conexiones o selecciona uno de tus conjuntos de datos existentes.

  3. Ingresa un nombre de archivo. De forma opcional, selecciona el ícono {x} (Agregar parámetro) para agregar parámetros al nombre de archivo. Para obtener más información, consulta Parámetros.

  4. Selecciona un formato de archivo:

    • CSV: valores separados por comas (.csv)

    • XLS: Microsoft Excel 1997-2003 (.xls)

    • XLSX: Microsoft Excel (.xlsx)

  5. A continuación, elige dónde quieres guardar los datos de salida. Puedes utilizar la Ruta de archivo predeterminada o seleccionar la casilla de verificación Personalizar ubicación para elegir una ubicación diferente. Si seleccionas una ubicación personalizada, puedes agregar parámetros a la ruta del archivo con el ícono {x} (Agregar parámetro). Para obtener más información, consulta Parámetros.

  6. Selecciona Siguiente para personalizar las Opciones de salida.

  7. Usa el menú desplegable Acciones de salida en cada ejecución para seleccionar una acción que se realizará si existe un archivo con el mismo nombre al momento de ejecutar el trabajo.

    1. Para archivos CSV:

      1. Crear nuevo

      2. Sobrescribir

    2. Para archivos de Excel:

      1. Crear nuevo libro de trabajo

      2. Sobrescribir libro de trabajo

      3. Crear hoja nueva

      4. Sobrescribir hoja existente

      5. Adjuntar a una hoja

      Ahora puedes escribir en diferentes hojas en un libro de Excel simultáneamente. Esto significa que puedes utilizar dos o más herramientas de salida para escribir en el mismo libro en hojas separadas. No necesitas la herramienta Bloquear hasta finalizar para ejecutar esto. La concurrencia solo es compatible cuando se selecciona Sobrescribir hoja actual.

  8. Si seleccionas un formato de archivo CSV, selecciona un delimitador de columna. Tus opciones son Coma, Tabulación, Pleca y Punto y coma.

  9. Elige opciones adicionales para la salida:

    • Incluir comillas (solo formato de archivo CSV)

    • Nombre de hoja (solo formatos XLS y XLSX)

    • Salida de partición (solo formatos XLS y XLSX): elige si deseas publicar el archivo como un solo archivo o un archivo con varias hojas. Si la seleccionas, utiliza el menú desplegable Particionar con columna para seleccionar la columna que se utilizará para las hojas de partición según los valores de columna.

    • Mantener columna de partición en salida (solo formatos XLS y XLSX): desmárcalo para excluir la columna utilizada para el particionamiento de la salida final. Por ejemplo, si divides por trimestre, puedes excluir la columna “Trimestre” de la salida.

    • Incluir nombres de columnas como primera fila

  10. Selecciona Confirmar para guardar los detalles de tus datos de salida. A continuación, puedes revisar tu selección en el panel de configuración de la herramienta Datos de salida y utilizar el ícono de lápiz para realizar cambios si es necesario.

  11. Selecciona Ejecutar trabajo en tu flujo de trabajo y guarda el archivo en la conexión elegida.

Guardar en conexiones basadas en SQL

Para escribir los resultados de tu flujo de trabajo en una conexión basada en SQL:

  1. En la ventana de configuración de la herramienta, selecciona Seleccionar ubicación de salida para abrir la ventana Datos de salida.

  2. Selecciona una conexión de datos en la nube en Conexiones o selecciona uno de tus conjuntos de datos existentes.

  3. Ingresa un Nombre de tabla. De forma opcional, selecciona el ícono {x} (Agregar parámetro) para agregar parámetros al Nombre de tabla. Para obtener más información, consulta Parámetros.

  4. A continuación, selecciona el esquema en el que deseas guardar la tabla y, a continuación, selecciona Siguiente.

  5. Usa el menú desplegable Emitir acciones en cada ejecución para seleccionar una acción que se realizará si existe una tabla con el mismo nombre al momento de ejecutar el trabajo.

    • Crear tabla nueva: crea una nueva tabla.

    • Anexar a una tabla: los datos se adjuntan al final de la tabla existente.

    • Truncar tabla existente: los datos de la tabla existente se eliminan y se reemplazan con nuevos datos.

    • Eliminar tabla existente: la tabla existente se elimina y se sustituye por la nueva tabla.

    • Fusionar con la tabla existente: los datos de salida se combinan con la tabla existente.

  6. Selecciona Confirmar para guardar los detalles de tus datos de salida. A continuación, puedes revisar tu selección en el panel de configuración de la herramienta Datos de salida y utilizar el ícono de lápiz para realizar cambios si es necesario.

  7. Selecciona Ejecutar trabajo en tu flujo de trabajo y guarda el archivo en la conexión elegida.

Descargar archivo

Para descargar los datos de salida en tu computadora, primero guárdalos en Alteryx One. La opción más rápida es guardar el archivo en una ubicación predeterminada en el Almacenamiento base. También puedes personalizar la ubicación dentro del Almacenamiento base o elegir otro conector.

Luego, tras ejecutar el flujo de trabajo, ve a la herramienta Salida en el lienzo y selecciona Descargar en la sección Trabajo del panel lateral derecho.

Parámetros

Utiliza parámetros para aplicar valores dinámicos de cadena o marca de tiempo a los datos de salida. Puedes aplicar parámetros al nombre del archivo, la ruta del archivo o el nombre de la tabla, según del tipo de conexión a la nube.

  • Los parámetros de cadena tienen un valor predeterminado que se puede sobrescribir para cada ejecución de tarea, en una programación o en un plan.

  • Los parámetros de marca de tiempo se completan automáticamente con una marca de tiempo con formato al momento de la ejecución del trabajo.

Para utilizar un parámetro en el Nombre de archivo o el Nombre de la tabla

  1. En el campo Nombre de archivo o Nombre de la tabla:, selecciona el ícono {x} (Agregar parámetro) para abrir la ventana Parámetros.

  2. Si creaste un parámetro anteriormente, selecciónalo en la sección Parámetros del espacio de trabajo. Ten en cuenta que los parámetros se insertan en la ubicación del cursor en el campo Nombre de archivo. Para quitar un parámetro de tu nombre de archivo, selecciona el parámetro y, luego, selecciona Quitar.

  3. Si necesitas crear un nuevo parámetro, selecciona + Nuevo. También puedes seleccionar el enlace Administrar parámetros para iniciar la página Parámetros, donde puedes crear nuevos parámetros y editar los existentes.

Para utilizar un parámetro en tu Ruta del archivo

  1. Selecciona la casilla de verificación Personalizar ubicación.

  2. Selecciona el ícono editar (lápiz) junto a la Ruta del archivo.

  3. Selecciona el ícono {x} (Agregar parámetro) para abrir la ventana Parámetros.

  4. Si creaste un parámetro anteriormente, selecciónalo en la sección Parámetros del espacio de trabajo. Ten en cuenta que los parámetros se insertan en la ubicación del cursor en el campo Nombre de archivo. Para quitar un parámetro de tu nombre de archivo, selecciona el parámetro y, luego, selecciona Quitar.

  5. Si necesitas crear un nuevo parámetro, selecciona + Nuevo. También puedes seleccionar el enlace Administrar parámetros para iniciar la página Parámetros, donde puedes crear nuevos parámetros y editar los existentes.

Crear parámetro de cadena

Utiliza un parámetro de cadena para etiquetar dinámicamente tus datos de salida.

  1. Para crear un parámetro de cadena, selecciona + Nuevo en la ventana Parámetros y, a continuación, selecciona Cadena en el menú desplegable Tipo.

  2. Ingresa un Nombre de parámetro. Esto es lo que se muestra en el campo nombre de archivo si utilizas el parámetro.

  3. Ingresar una Descripción. Esto debe ser algo claro que te ayude a ti y a otros usuarios en el futuro.

  4. Ingresa un Valor predeterminado para el parámetro. Este valor se utiliza si el parámetro no se actualiza dinámicamente.

  5. Selecciona Crear para crear el parámetro y agregarlo al nombre o la ruta. Para quitar un parámetro, selecciona el parámetro y selecciona Quitar.

Crear parámetro de marca de tiempo

Utiliza un parámetro de marca de tiempo para completar automáticamente una marca de tiempo con formato al momento de la ejecución del trabajo.

Nota

A diferencia de los parámetros de cadena, los parámetros de marca de tiempo no se almacenan en la página Parámetros.

  1. Para crear un parámetro de marca de tiempo, selecciona + Nuevo en la ventana Parámetros y, a continuación, selecciona Marca de tiempo en el menú desplegable Tipo.

  2. Personaliza el formato de marca de tiempo según sea necesario. El formato predeterminado es aaaa-MM-dd. Selecciona el botón + para ver tus opciones de personalización. La Vista previa de formato muestra la fecha de hoy con el formato seleccionado.

  3. A continuación, establece el valor de la marca de tiempo. Elige entre…

    • Exacto en el inicio del trabajo: genera el valor exacto de la marca de tiempo cuando se inicia el trabajo.

    • Relativo al inicio del trabajo: genera la marca de tiempo relativa a la hora de inicio del trabajo. Por ejemplo, es posible que desees una marca de tiempo una hora después de la hora de inicio del trabajo.

      • Ocurrencia: elige generar una marca de tiempo que esté después o antes de la hora de inicio del trabajo.

      • Valor: elige un valor numérico para tu marca de tiempo relativa.

      • Unidad: elige una unidad para tu marca de tiempo relativa. Estas son tus opciones:

        • Minutos

        • Horas

        • Días

        • Semanas

        • Meses

        • Trimestres

        • Años

  4. A continuación, selecciona una Zona horaria para el parámetro de marca de tiempo.

  5. Por último, selecciona Crear para crear el parámetro e insertarlo en la posición del cursor.

Parámetros de anulación

Cuando ejecutas el flujo de trabajo con parámetros de cadena, el flujo de trabajo utiliza el valor predeterminado especificado cuando se creó el parámetro. Sin embargo, tienes la opción de reemplazar este valor.

Para reemplazar el valor predeterminado de los parámetros de cadena…

  1. Selecciona el ícono del menú desplegable que forma parte del botón Ejecutar trabajo.

  2. Selecciona Parámetros para abrir la ventana Anular parámetros.

  3. Ingresa valores de anulación en la columna Valor de anulación para todos los parámetros en los que no deseas utilizar el valor predeterminado.

  4. Selecciona Guardar y ejecutar trabajo para ejecutar el flujo de trabajo con los valores de parámetros actualizados.