¿Cómo condicionar la ejecución de una operación?

Tabla de contenidos

Es posible añadir condiciones en la ejecución de las operaciones, para que éstas sólo se ejecuten si la condición se evalúa como verdadera.

Para condicionar la operación, debes hacerlo desde la administración avanzada.

 

condicion-operacion.png

 

En las condiciones, puedes usar las mismas expresiones dinámicas que usas por ejemplo en los campos. A continuación os damos algunos ejemplos.

 

Condicionar la ejecución a que el valor de un campo boolean sea verdadero

fil.gmv('metadata.mi_campo') == True 
#reemplaza mi campo por el nombre interno de tu campo.

 

Condicionar la ejecución en un formulario concreto

fil.doctype.name == "mi_formulario"
#reemplaza mi_formulario por el nombre interno del formulario

 

Condicionar la ejecución a que el valor de un Choice de tipo Diccionario

fil.gmv('metadata.mi_campo') == "valor_del_termino"
#reemplaza mi campo por el nombre interno del campo y valor_del_termino por el
valor interno del término del diccionario.

 

Condicionar la ejecución a que no exista una característica del documento

not fil.get_feature_value('nombre_de_la_feature')
#reemplaza el nombre de la feature por el valor de la característica, por ejemplo,
feature.text

 

Condicionar a que el valor de un campo de tipo fecha sea menor a la fecha actual

fil.get_metadata("metadata.mi_campo_fecha").date_value <= datetime.date.today()
#reemplaza "metadata.mi_campo_fecha" por el nombre interno de tu campo de tipo fecha

En esta expresión con fil.get_metadata() obtenemos el objeto completo del metadato, con .date_value obtenemos el valor de tipo fecha. Si utilizas fil.gmv() obtendrás únicamente el valor del campo como una cadena.

La expresión del ejemplo sólo te servirá para trabajar con campos tipo Fecha/Date. Si estás trabajando con un campo Fecha-hora/Datetime, tendrás que modificar esta expresión ligeramente.

fil.get_metadata("metadata.mi_campo_fecha").datetime_value <= datetime.date.today()
#reemplaza "metadata.mi_campo_fecha" por el nombre interno de tu campo de tipo fecha

En este caso, utilizamos la propiedad .datetime_value para obtener el valor datetime.

 

Condicionar a que el documento tenga un estado del ciclo de vida

fil.life_cycle_state.name == "estado_ciclo_de_vida"

Reemplaza «estado_ciclo_de_vida» por el estado del ciclo de vida que debe tener el documento.

 

Condicionar a que el documento NO esté en un estado del ciclo de vida

fil.life_cycle_state.name != "estado_ciclo_de_vida"

Reemplaza «estado_ciclo_de_vida» por el estado del ciclo de vida que debe tener el documento.

 

Condicionar la ejecución de la operación a que los valores de un campo coincidan en el documento padre y en el hijo

En Athento, es posible condicionar la ejecución de una operación a que el valor de un campo específico en el documento hijo coincida con el valor del mismo campo en el documento padre. Esto es especialmente útil en procesos donde se requiere validar la coherencia de información entre ambos documentos, por ejemplo, para verificar que una evidencia o un documento relacionado corresponde efectivamente al expediente principal.

Para ello, puedes utilizar el método fil.get_parent(unique=True) para acceder al documento padre desde el hijo y comparar el valor del campo deseado usando el método gmv().

 

Ejemplo de condición

Supongamos que quieres que la operación solo se ejecute si el campo start_date_parent del documento padre coincide con el campo start_date_child del documento hijo. La condición sería:

fil.get_parent(unique=True).gmv("metadata.start_date_parent") == fil.gmv("start_date_child") 

Importante:

El parámetro unique=True asegura que se obtenga un único documento padre. Si no se especifica, se devolverá un queryset y la comparación no funcionará correctamente.