> For the complete documentation index, see [llms.txt](https://docs.editran.onesait.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.editran.onesait.com/documentacion-editran/editran-connect-v3.3/operacion/libreta_direcciones/contacto/canal/nuevo_canal/programas_usuario/previo_transmision.md).

# Programa previo a la transmisión

Este documento explica el funcionamiento y configuración de los programas previos a una transmisión en Connect.

***

## ¿Qué son los programas previos?

Los programas previos permiten ejecutar los comandos definidos en un script o ejecutable antes de realizar la carga de los ficheros.

***

## Funcionamiento

1. **Carga del programa previo**\
   El sistema permite seleccionar un archivo ubicado el servidor.
2. **Ejecución**\
   Una vez configurado, el programa previo se ejecuta antes de la transmisión principal.
3. **Transición a la transmisión principal**\
   Al finalizar el programa previo, el sistema inicia la transmisión si el resultado ha sido correcto.
4. **Consulta del log**

   Cuando termina la ejecución del programa, lo que haya escrito por la salida estándar y de error puede ser consultado en el log ubicado en `${ruta intalación connect}/core/log/editrang.out`

***

## Configuración en la aplicación

1. **Selección de canal**\
   Elija el canal donde desea configurar el programa previo, se encuenta en la parte "integración con aplicaciones".
2. **Seleccionar archivo**\
   Introduzca la ubicación del fichero en el servidor en el "prograna previo a emisión". Si es un canal bidireccional existirán dos pestañas para cada sentido de la transmisión

   ![Imagen: Carga de archivo previo](https://3558922613-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSQXv5BLHrdIc5WgYzixC%2Fuploads%2Fgit-blob-0b19cfc701309f3d26fab090933a387952a0b494%2FSCRIPT_PREVIO.png?alt=media)
3. **Confirmación y guardado**\
   Confirme la selección y guarde los cambios.

***

## Parámetros recibidos por el programa previo

El programa previo recibe los siguientes parámetros al ejecutarse:

| Variable | Previo SIN GUPGRADE         | PREVIO CON GUPGRADE         |
| -------- | --------------------------- | --------------------------- |
| 0        | Nombre del programa         | Nombre del programa         |
| 1        | Presentación                | Presentación                |
| 2        | Emisión (E) o Recepción (R) | Emisión (E) o Recepción (R) |
| 3        | Código Local                | RESULTADO                   |
| 4        | Código Remoto               | Código Local                |
| 5        | Aplicación                  | Código Remoto               |
| 6        |                             | Aplicación                  |

La variable de entorno `EDI_GUPGRADE` afecta el orden de los parámetros recibidos por el programa previo, permitiendo compatibilidad con scripts de versiones anteriores. Esto pasará como valor en el tercer parámetro "0000"

***

## Recomendaciones

* Verifique que el archivo previo esté presente en la máquina.
* Compruebe la duración y el contenido antes de la transmisión.
* Si se invocan programas en cadena asegurarse que no piden confirmación al usuario, utilizar el modo batch si existe o forzar que no pidan "pulsar una tecla".

***

## Preguntas frecuentes

**¿Puedo cambiar el programa previo después de configurarlo?**\
Sí, puede reemplazar el archivo siguiendo el mismo proceso de edición.

**¿Qué ocurre si no configuro un programa previo?**\
La transmisión principal iniciará directamente.

**¿Qué ocurre si el script devuelve como código de retorno un valor distinto de 0?** La transmisión no será iniciada y el canal saldrá con el estado "bloqueado"

***

## Ejemplos de scripts previos

A continuación se muestran ejemplos de scripts que pueden ejecutarse antes de una transmisión:

* **Preparación de archivos**\
  Un script puede copiar, mover o renombrar archivos necesarios para la transmisión.
* **Verificación de integridad**\
  Se pueden ejecutar scripts que validen la integridad de los archivos a transmitir.
* **Configuración de parámetros**\
  Scripts que ajusten configuraciones específicas del sistema antes de iniciar la transmisión.

***

## Consideraciones técnicas

* Los scripts deben estar ubicados en rutas accesibles por el servidor.
* Es recomendable validar los permisos de ejecución y el correcto funcionamiento de los scripts antes de utilizarlos en producción.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.editran.onesait.com/documentacion-editran/editran-connect-v3.3/operacion/libreta_direcciones/contacto/canal/nuevo_canal/programas_usuario/previo_transmision.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.