This shows you the differences between two versions of the page.
Both sides previous revision Previous revision Next revision | Previous revision | ||
library_functions [2016/06/11 18:15] geelling |
library_functions [2023/04/27 11:44] (current) andrewbreese |
||
---|---|---|---|
Line 1: | Line 1: | ||
====Workflow automation tasks==== | ====Workflow automation tasks==== | ||
- | There are a number of standard automation tasks you can use in your workflows. Set the CALL=automation_task attribute in the [[special_treatment|special treatment]] box to trigger the automation task for a specific field (usually when the field changes to "Ready"). All the return values listed below must be set up as options in the workflow designer (though they can be set to VISIBLE=NEVER where you only want the automation task to be able to select them). | + | There are a number of workflow automation tasks you can use in your workflows. Set the CALL=workflow_automation_task attribute in the [[special_treatment|special treatment]] box to trigger the automation task for a specific field (usually when the field changes to "Ready"). All the return values listed below must be set up as options in the workflow designer (though they can be set to VISIBLE=NEVER where you only want the automation task to be able to select them). |
Required [[lib_fields|library fields]] must be identified in your form using LIB=field_name. Input library fields will be used by the automation task for its work, and output library fields will be used to store the results of the task. | Required [[lib_fields|library fields]] must be identified in your form using LIB=field_name. Input library fields will be used by the automation task for its work, and output library fields will be used to store the results of the task. | ||
Line 19: | Line 19: | ||
* Return values: Calculated | * Return values: Calculated | ||
* Required input library fields: loan_amount,loan_term,loan_monthly_interest | * Required input library fields: loan_amount,loan_term,loan_monthly_interest | ||
+ | * Required output library fields: repayment_amount,total_repayable,interest_amount,loan_apr,repayment_amount,loan_interest_amount | ||
+ | * Optional library fields: api_focus_system_interest (required if using FOCUS API),loan_new_amount,loan_current_balance | ||
+ | * Other behaviour: sets loan_repayment_amount,loan_total_repayable,loan_interest_amount,loan_months,loan_apr,loan_monthly_interest,short_loan_apr,loan_repayment_amount | ||
+ | |||
+ | CALL=calculate_repayments_reverse | ||
+ | * Summary: Calculates repayment values for the credit agreement to allow repayment amount to be set. CALL=calculate_repayments required before use | ||
+ | * Trigger value: Reverese Calculate | ||
+ | * Return values: Calculated | ||
+ | * Required input library fields: loan_amount,loan_term,loan_monthly_interest,repayment_amount | ||
* Required output library fields: repayment_amount,total_repayable,interest_amount,loan_apr,repayment_amount,loan_interest_amount | * Required output library fields: repayment_amount,total_repayable,interest_amount,loan_apr,repayment_amount,loan_interest_amount | ||
* Optional library fields: api_focus_system_interest (required if using FOCUS API),loan_new_amount,loan_current_balance | * Optional library fields: api_focus_system_interest (required if using FOCUS API),loan_new_amount,loan_current_balance | ||
Line 75: | Line 84: | ||
* Required library fields: person_last_name,person_title, person_first_names, person_dob, address_postcode, person_bank_account_no, person_bank_sort_code | * Required library fields: person_last_name,person_title, person_first_names, person_dob, address_postcode, person_bank_account_no, person_bank_sort_code | ||
* Other behaviour: sets cb_raw_result[PDS],cb_html_result[PDS] | * Other behaviour: sets cb_raw_result[PDS],cb_html_result[PDS] | ||
+ | |||
+ | CALL=id_bank_check | ||
+ | * Summary: As for bank_check, but returns both cv_action and cb_action (requires CallValidate API) | ||
+ | * Trigger value: Ready | ||
+ | * Return values: Pass, Decline, Refer | ||
+ | * Required library fields: person_last_name,person_title, person_first_names, person_dob, address_postcode, person_bank_account_no, person_bank_sort_code | ||
+ | * Other behaviour: sets cb_raw_result[PDS],cb_html_result[PDS],sets cv_raw_result[PDS],cv_html_result[PDS] | ||
CALL=bank_check_refer | CALL=bank_check_refer | ||
Line 92: | Line 108: | ||
* Required library fields: none | * Required library fields: none | ||
* Optional library fields: update_straight_thru_NI (set to Ready on Pass) | * Optional library fields: update_straight_thru_NI (set to Ready on Pass) | ||
+ | |||
+ | CALL=lookup_match | ||
+ | * Summary: match values in the form against a lookup table (stored in a custom form) - optionally read values into the current form | ||
+ | * Format: CALL=lookup_match:article_id:LIB1,LIB2[:LIBA,LIBB] (eg CALL=lookup_match:123:person_nino,person_last_name (lookup only) or CALL=lookup_match:123:person_nino,person_last_name:person_member_id,person_member_type (lookup and read) | ||
+ | * Trigger value: Ready | ||
+ | * Return values: Pass, Fail | ||
+ | * Required library fields: as defined in function call | ||
+ | * Optional library fields: update_lookup_match (set to Ready on Pass) | ||
+ | |||
+ | CALL=lookup_nomatch (from v5.1) | ||
+ | * Identical to lookup_match, but returns Pass when NO match is found and Fail is a match is found | ||
+ | * Optional library fields: update_lookup_nomatch (set to Ready on Pass) | ||
+ | |||
+ | CALL=check_pdf | ||
+ | * Summary: check that a PDF file has been correctly created for credit agreements, etc | ||
+ | * Format: CALL=check_pdf:article_id (eg CALL=check_pdf:123 where 123 is the credit agreement PDF form template ID) | ||
+ | * Trigger value: Agreed | ||
+ | * Return values: PDF OK, PDF Failed | ||
+ | * Required library fields: none | ||
+ | * Optional library fields: none |