> 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/excepcion_transmision.md).

# Programa de excepción

Este documento explica el funcionamiento y configuración de los programas de excepción en Connect, que permiten ejecutar scripts o comandos cuando ocurre un error durante la transmisión de datos por un canal.

***

## ¿Qué son los programas de excepción?

Los programas de excepción son scripts o ejecutables que se invocan automáticamente cuando se produce un error en la transmisión o en la carga/descarga de ficheros. Su objetivo es permitir la gestión personalizada de incidencias, como notificaciones, registros o acciones correctivas.

***

## Funcionamiento

1. **Detección de error**

   Cuando ocurre un problema en la transmisión, el sistema identifica la incidencia y activa el programa de excepción configurado.
2. **Ejecución**

   El programa de excepción se ejecuta con los parámetros definidos, permitiendo realizar acciones específicas según el tipo de error.
3. **Consulta del log**

   La salida estándar y de error del script puede consultarse en el log ubicado en `${ruta instalació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 de excepción, en la sección de "integración con aplicaciones".
2. **Seleccionar archivo**

   Introduzca la ubicación del fichero en el servidor en el campo "programa de excepción".

   ![Carga de archivo de excepción](https://3558922613-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSQXv5BLHrdIc5WgYzixC%2Fuploads%2Fgit-blob-b17815003baa21a3716a5ac0f849f733a6293b29%2FSCRIPT_EXCEPCION.png?alt=media)
3. **Confirmación y guardado**

   Confirme la selección y guarde los cambios.

***

## Parámetros recibidos por el programa de excepción

El programa de excepción recibe los siguientes parámetros al ejecutarse:

| Variable | Descripción                       |
| -------- | --------------------------------- |
| 0        | Nombre del programa               |
| 1        | Presentación                      |
| 2        | Emisión (E) o Recepción (R)       |
| 3        | Resultado transmisión (4 dígitos) |
| 4        | Código Local                      |
| 5        | Código Remoto                     |
| 6        | Aplicación                        |

La variable de entorno `EDI_GUPGRADE` no afecta a los parámetros del programa de excepción.

***

## Recomendaciones

* Verifique que el archivo de excepción esté presente y tenga permisos de ejecución.
* Pruebe el script en un entorno controlado antes de utilizarlo en producción.
* Implemente acciones como notificación, registro de errores o limpieza de recursos según las necesidades del canal.

***

## Ejemplos de scripts de excepción

* **Registro de error** Guardar información detallada del error en un fichero de auditoría.
* **Notificación** Enviar un correo o alerta al administrador cuando ocurre una excepción.
* **Acciones correctivas** Intentar recuperar ficheros o reiniciar procesos afectados por el error.

***

## 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/excepcion_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.