failed-step
Devuelve el resultado de un paso de ejecución fallido. Esta función es la indicada si está controlando errores con bloques protegidos, como se describe en Control de errores. La función failed-step debe formar parte del identificador de errores "Cuando haya errores" o de lo contrario el paso en el que la está utilizando dará lugar a error porque no hay ningún paso erróneo.
Esta función devuelve u valor de tipo resultado que representa el resultado del paso erróneo. Para averiguar los atributos del resultado, pase esta función como argumento de las funciones de expresión stdout o stderr, por ejemplo.
stderr(failed-step()) stdout(failed-step()) |
Querrá usar stderr o stdout en función de si el paso erróneo devuelve la información correspondiente en las secuencias del error estándar o en las del resultado estándar.
Firma
failed-step() -> result |
Ejemplos
El trabajo del ejemplo siguiente usa la función de gestión de errores, por lo que admite la ejecución de llamadas a la función failed-step. El primer paso de ejecución intenta ejecutar un comando de shell que se suministra como parámetro de entrada de un trabajo. Si el comando falla y genera un error se ejecuta el controladores "Cuando haya errores". El primer y único paso de este controlador consiste en llamar a un trabajo secundario creado aparte y que explicamos a continuación.
Aunque se puede configurar de otra forma, el trabajo secundario del controlador de errores de este ejemplo toma dos parámetros de entrada:
1.inputResult, el resultado de la función failed-step, de tipo resultado.
2.workingDirectory, el directorio en el que se escriben los detalles del error del archivo de registro.
Este trabajo secundario consiste en:
El paso de ejecución anterior invoca a la función copy para crear un archivo error.log en el directorio de trabajo. Esto es lo que hace la expresión de la caja de texto Origen:
1.La función de expresión stderr convierte el error estándar suministrado por inputResult en una secuencia. Como hemos mencionado más arriba, en algunos casos puede que tenga que usar stdout en vez de stderr. Las dos funciones toman un valor de tipo resultado como argumento. Este es precisamente el tipo devuelto por la función failed-step (a la que en este ejemplo llamamos en el trabajo principal).
2.La función as-file convierte la secuencia en un archivo y lo escribe en disco. La ruta de acceso al archivo seleccionado es relativa al directorio de trabajo.
Para ver otros ejemplos consulte: