2026-05-12 UHE: v1 6.8.0.17 ScriptModuleSetLocale module_setlocale false # # coding: windows-1252 # # Name: module_setlocale # Class: - # ObjectScript: - # ContainerScript: # EventType: - # EventClass: - # EventMembers: - import locale def get_required_locale(current_language): """ Gets required locale according to the user's language or default language when user's language is not set. If no language is set, setting default to Swiss German. """ if current_language == "DD": required_locale = "deu_deu" elif current_language == "EN": required_locale = "eng_UK" elif current_language == "FR": required_locale = "fra_fra" elif current_language == "IT": required_locale = "ita_ita" elif current_language == "NL": required_locale = "nld_nld" else: # fallback to CH required_locale = "deu_che" return required_locale def set_locale_by_language(language=""): """ Sets locale according to: 1. given language, or when not given, then according to 2. the user's language or 3. default language If no language is set, setting default to Swiss German. """ if language: required_locale = get_required_locale(language) else: # user's language current_language = vtcapp.currentlogin().language if not current_language: # fallback to default language when not set current_language = vtcapp.getpropertyvalue("Language", "") required_locale = get_required_locale(current_language) locale.setlocale(locale.LC_ALL, required_locale) None false false false Python3 ScriptModuleVacationBalanceInDays module_vacation_balance_in_days false # coding: windows-1252 # # Designation: module_vacation_balance_in_days # Show in Vertec menus: # Classes: # Display condition: # Event script for: # Event classes: # Event fields: # Extended rights: # Contains functions to display vacations as days # 2026-05-12 UHE: Initial version import vtcapp # type:ignore import locale from module_setlocale import set_locale_by_language BUTTON_INFO = "info" NO_BUTTON = "" LABEL_DAYS = "days" LABEL_DAY = "day_pv" LABEL_HOURS = "h" MAX_LINES = 12 class Vacation(): """ Helper class to store the vacations for display in dialog. We cannot use the Vertec objects as for vacations with intersection in two periods we need two entries. """ def __init__(self, date_string, time_string, balance_string, is_selected): self.date_string = date_string self.time_string = time_string self.balance_string = balance_string self.is_selected = is_selected class VacationPeriod(): """ Helper class to store the vacation periods (periods, without a change in the vacation settings). """ def __init__(self, user, start_date, end_date, working_time_per_day, working_days_per_week): self.user = user self.start_date = start_date self.end_date = end_date self.working_time_per_day = working_time_per_day self.working_days_per_week = working_days_per_week def _format_days_hours_string(self, minutes): """ Formats minutes as a combined days/hours display string 'x Days / hh:mm h'. """ return "{} / {}".format( _get_days_string_from_minutes(minutes, self.working_time_per_day), _get_hours_string(minutes), ) def get_balance_start_string(self, date): """ Returns the vacation balance at the start of the given date as a display string. """ return self._format_days_hours_string(get_vacation_balance_start(self.user, date)) def get_employment_level_string(self, date): """ Returns the employment level in the period as a display string. """ return "{} %".format(_format_number(get_employment_level(self.user, date)*100.0)) def get_working_time_string(self): """ Returns the average working time in the period as a display string. """ if self.working_days_per_week == 5: result = vtcapp.translate("({} per day)").format(_get_hours_string(self.working_time_per_day)) else: result = vtcapp.translate("({} per day on {} days)").format(_get_hours_string(self.working_time_per_day), _format_number(self.working_days_per_week)) return result def get_taken_string(self, start_date, end_date): """ Returns the vacation taken in the given period as a display string. """ return self._format_days_hours_string(get_vacation_taken(self.user, start_date, end_date)) def get_balance_string(self, date): """ Returns the vacation balance at the end of the given date as a display string. """ return self._format_days_hours_string(get_vacation_balance(self.user, date)) def get_vacation_credit_string(self, start_date, end_date): """ Returns the vacation credit for the given period as a display string. """ return self._format_days_hours_string(get_vacation_credit(self.user, start_date, end_date)) def get_vacation_entries(self, selected_id): """ Returns all vacation entries overlapping with this period. Entries that span across period boundaries are clipped to fit within start_date and end_date, so each entry reflects only the time within this period. """ start_date_ocl = vtcapp.ocldate(self.start_date) end_date_ocl = vtcapp.ocldate(self.end_date) ocl_query = ( "absences->select(type=1)" "->select((endDate.notNull and (endDate>={0})) or (endDate.isNull and (entryDate>={0})))" "->select(entryDate<={1})->orderby(entryDate)" ).format(start_date_ocl, end_date_ocl) vacations = [] for vacation in self.user.evalocl(ocl_query): vacation_start_date = max(vacation.entryDate.date(), self.start_date.date()) vacation_end_date = ( min(vacation.endDate.date(), self.end_date.date()) if vacation.endDate else vacation_start_date ) date_string = " - ".join([ vtcapp.datetostr(vacation_start_date), vtcapp.datetostr(vacation_end_date) ]) time_string = self.get_taken_string(vacation_start_date, vacation_end_date) balance_string = self.get_balance_string(vacation_end_date) is_selected = (vacation.objid == selected_id) vacations.append(Vacation(date_string, time_string, balance_string, is_selected)) return vacations def show_vacation_balance(user, vacation=None): """ Show a dialog with vacation periods. If a vacation is given, it is marked as bold in the dialog. The displayed period is the one with the vacation inside or - if no vacation is given - for the current date. """ day = vacation.evalocl("entryDate") if vacation else vtcapp.currentdatetime() start_date, end_date = get_relevant_period(user, day) if not start_date or not end_date: return # Get all settings for the user in the specified period + the first period ocl_query = ("self->union(groups).orderedSettings->select(weeklyStdhours.notNull or vacationCarryover.notNull)" "->collect(s|s->select(entryDate>={0})->select(entryDate<={1})->orderdescending(entryDate)" "->union(s->select(entryDate<={0})->last))" ).format(vtcapp.ocldate(start_date), vtcapp.ocldate(end_date)) settings_list = user.evalocl(ocl_query) period_end_date = end_date periods = [] # We need to find all periods with different target time. # If a to-date is given, this might be different from the settings given. while period_end_date.date() > start_date.date(): # Get the (in time) last setting before end_date setting = get_target_time_setting(user, period_end_date, settings_list) # We set the start date as period start. if setting: period_start_date = setting.entryDate else: # The very first entry for a setting is not included in the settings_list. period_start_date = start_date setting = get_target_time_setting(user, start_date, settings_list) # We have to consider settings, that are lying completely inside another period. # In this case we divide into three periods: # before intersecting period, intersecting period, after intersecting period intersecting_setting = _get_intersecting_setting(period_start_date, period_end_date, settings_list) if intersecting_setting: period_start_date = vtcapp.incday(intersecting_setting.endDate, 1) # This is the very first period. We set the start date to the first of the # year/ entry date of user/ date of last manual vacation setting if period_start_date < start_date: period_start_date = start_date # This is the setting with the end_date inside. If the end_date is not the period_end_date, we divide into two periods. # One from start_date until day and one from day+1 until end_date if period_end_date > end_date and period_start_date <= end_date: period_start_date = vtcapp.incday(end_date, 1) if not setting: break working_time_per_day, working_days_per_week = get_working_time_information(setting) vacation_period = VacationPeriod(user, period_start_date, period_end_date, working_time_per_day, working_days_per_week ) # Update lists with current values periods.append(vacation_period) period_end_date = vtcapp.incday(period_start_date, -1) show_dialog(user, periods, vacation) return def _format_number(value): """ Format days as integer with locale grouping. """ if value is None: return "" return locale.format_string("%.2f", float(value), grouping=True) def _get_days_string(days): """ Format days as localized string. """ if days == 1: label = vtcapp.translate(LABEL_DAY) else: label = vtcapp.translate(LABEL_DAYS) days_formatted = _format_number(days) return vtcapp.translate("{} {}").format(days_formatted, label) def _get_days_string_from_minutes(minutes, minutes_per_day): """ Convert minutes to days and format. """ days = get_ratio(minutes, minutes_per_day) return _get_days_string(days) def _get_hours_string(minutes): """ Formats minutes as a localized hours string, e.g. '20:00 h'. """ hours = vtcapp.formatminutes(int(minutes)) return vtcapp.translate("{} {}").format(hours, vtcapp.translate(LABEL_HOURS)) def show_dialog(user, periods, selected_vacation): """ Renders and displays the paginated vacation balance dialog. Supports navigation and highlights a selected vacation if provided. """ set_locale_by_language() if not periods: return # Determine overall period range start_period = periods[-1] end_period = periods[0] overall_start_date = start_period.start_date overall_end_date = end_period.end_date.date() selected_vacation_id = selected_vacation.objid if selected_vacation else None # Translated labels overall_start_date_str = vtcapp.datetostr(overall_start_date) overall_end_date_str = vtcapp.datetostr(overall_end_date) label_balance_brought_forward = vtcapp.translate("{} {}").format( vtcapp.translate("Vacation bfw. per"), overall_start_date_str ) label_vacation_credit = vtcapp.translate("Vacation credit {} - {}").format( overall_start_date_str, overall_end_date_str ) credit_explanation = vtcapp.translate( "The vacation credit is calculated pro rata on the basis of calendar days per period and multiplied by the annual entitlement. The number of hours of vacation days depends on the employment level." ) # Totals total_vacation_credit = get_vacation_credit(user, overall_start_date, overall_end_date) total_vacation_days = sum( get_ratio( get_vacation_credit(user, period.start_date, period.end_date), period.working_time_per_day ) for period in periods ) is_only_one_period = (len(periods) == 1) # Prepare periods prepared_periods = [] for period in reversed(periods): prepared_periods.append({ "start": vtcapp.datetostr(period.start_date), "end": vtcapp.datetostr(period.end_date), "employment_level": period.get_employment_level_string(period.start_date), "avg_work_time": period.get_working_time_string(), "balance_start": period.get_balance_start_string(period.start_date), "taken": period.get_taken_string(period.start_date, period.end_date), "balance_end": period.get_balance_string(period.end_date), "credit": period.get_vacation_credit_string(period.start_date, period.end_date), "vacations": period.get_vacation_entries(selected_vacation_id) }) # Build pages pages = [] current_page = [] current_line_count = 0 for period_entry in prepared_periods: vacations = period_entry["vacations"] if not vacations: if current_line_count + 1 > MAX_LINES: pages.append(current_page) current_page = [] current_line_count = 0 current_page.append({**period_entry, "vacations": []}) current_line_count += 1 continue vacation_index = 0 while vacation_index < len(vacations): remaining_space = MAX_LINES - current_line_count if remaining_space == 0: pages.append(current_page) current_page = [] current_line_count = 0 remaining_space = MAX_LINES vacation_chunk = vacations[vacation_index: vacation_index + remaining_space] current_page.append({ **period_entry, "vacations": vacation_chunk }) current_line_count += len(vacation_chunk) vacation_index += len(vacation_chunk) if current_page: pages.append(current_page) # Determine initial page containing the selected vacation initial_step = 0 if selected_vacation_id: for page_index, page in enumerate(pages): if any( getattr(vacation_entry, "is_selected", False) for period_entry in page for vacation_entry in period_entry.get("vacations", []) ): initial_step = page_index break # Summary summary = { "balance_brought_forward": _get_hours_string( get_vacation_carryforwardbalance(user, overall_start_date) ), "total_days": _get_days_string(total_vacation_days), "total_hours": _get_hours_string(total_vacation_credit), "balance_brought_forward_days": _get_days_string_from_minutes( get_vacation_carryforwardbalance(user, overall_start_date), start_period.working_time_per_day ) } dialog_definition = """ <Dialog Title="{Translate 'Vacation balance'}" {% if show_credit_details %} Width="1250" {% else %}Width="1030" {% endif %} > <Group> <Group Orientation="Vertical" FlexWidth="7"> <TextBlock ShowLabel="True" LabelWidth="220" Label="{{label_balance_brought_forward}}" Text="{% if is_only_one_period %}{{summary.balance_brought_forward_days}} / {% endif %}{{summary.balance_brought_forward}}" ContentAlignment="Right" /> <TextBlock ShowLabel="True" LabelWidth="220" Label="{{label_vacation_credit}}" Text="{% if is_only_one_period %} {{summary.total_days}} / {% endif %}{{summary.total_hours}}" ContentAlignment="Right" /> </Group > <TextBlock Visible="{{show_credit_details}}" Text="{{credit_explanation}}" FitMode="Wrap" VerticalAlignment="Bottom" Appearance="Info" FlexWidth="7" /> <Spacer Visible="{{not show_credit_details}}" FlexWidth="6" /> </Group > <Button Name="ShowCreditDetailsButton" Text="{Translate 'Show details'}" Visible="{{not is_only_one_period and not show_credit_details}}" IsAccept="True" Command="{Binding CloseCommand}" Appearance="Input" Width="125" HorizontalAlignment="Left" /> <Button Name="HideCreditDetailsButton" Text="{Translate 'Hide details'}" Visible="{{not is_only_one_period and show_credit_details}}" IsAccept="True" Command="{Binding CloseCommand}" Appearance="Input" Width="125" HorizontalAlignment="Left" /> <Spacer Height="10" /> <Group> <TextBlock Text="{Translate 'Period'}" Appearance="Info" FlexWidth="2" /> <TextBlock Text="{Translate 'Level of capacity'}" Appearance="Info" FlexWidth="3" /> <TextBlock Visible="{{show_credit_details}}" Text="{Translate 'Vacation credit in period'}" Appearance="Info" ContentAlignment="Right" IsBold="True" FlexWidth="3" /> <TextBlock Text="{Translate 'Opening balance'}" Appearance="Info" ContentAlignment="Right" FlexWidth="2" /> <TextBlock Text="{Translate 'Vacation taken'}" Appearance="Info" ContentAlignment="Left" FlexWidth="2" /> <Spacer FlexWidth="2" /> <TextBlock Text="{Translate 'Remaining balance'}" Appearance="Info" ContentAlignment="Right" FlexWidth="2" /> </Group> {% for period in periods %} <Group Separator="Always"> <TextBlock Text="{{period.start}} - {{period.end}}" Appearance="Info" FlexWidth="2" /> <TextBlock Text="{{period.employment_level}} {{period.avg_work_time}}" Appearance="Info" FlexWidth="3" /> <TextBlock Visible="{{show_credit_details}}" Text="{{period.credit}}" Appearance="Info" ContentAlignment="Right" IsBold="True" FlexWidth="3" /> <TextBlock Text="{{period.balance_start}}" Appearance="Info" ContentAlignment="Right" FlexWidth="2" /> {% if period.vacations %} {% for vacation in period.vacations %} <TextBlock Text="{{vacation.date_string}}" {% if vacation.is_selected %}IsBold="True"{% endif %} Appearance="Info" FlexWidth="2" /> <TextBlock Text="{{vacation.time_string}}" {% if vacation.is_selected %}IsBold="True"{% endif %} Appearance="Info" ContentAlignment="Right" FlexWidth="2" /> <TextBlock Text="{{vacation.balance_string}}" {% if vacation.is_selected %}IsBold="True"{% endif %} Appearance="Info" ContentAlignment="Right" FlexWidth="2" /> </Group> <Group> <Spacer FlexWidth="2" /> <Spacer FlexWidth="3" /> <Spacer FlexWidth="2"/> <Spacer Visible="{{show_credit_details}}" FlexWidth="3" /> {% endfor %} <Spacer FlexWidth="2" /> <Spacer FlexWidth="2" /> <Spacer FlexWidth="2"/> {% else %} <Spacer FlexWidth="2" /> <Spacer FlexWidth="2" /> <TextBlock Text="{{period.balance_end}}" Appearance="Info" ContentAlignment="Right" FlexWidth="2" /> {% endif %} </Group> {% endfor %} {% if last_step %} <Group Separator="Always" Visible="{{show_credit_details}}"> <TextBlock IsBold="True" Label="{{label_vacation_credit}}" LabelWidth="300" ShowLabel="True" IsLabelBold="True" Text="{{summary.total_days}} / {{summary.total_hours}}" Appearance="Info" ContentAlignment="Right" /> <Spacer /> </Group> {% endif %} <Spacer Height="10" /> <Dialog.Buttons> {% if not step == 0 %} <Button Name="BackButton" Text="{Translate 'Back'}" IsAccept="True" Command="{Binding CloseCommand}" /> {% endif %} {% if not last_step %} <Button Name="NextButton" Text="{Translate 'Next'}" IsAccept="True" Command="{Binding CloseCommand}" /> {% endif %} {% if total_pages > 1 %} <TextBlock Text="{{label_page}}" Width="100"/> {% endif %} <Button Name="CloseButton" Text="{Translate 'Close'}" IsAccept="False" Command="{Binding CancelCommand}" HorizontalAlignment="Left" /> </Dialog.Buttons> </Dialog> """ dialog_values = {} play_dialog = True step = initial_step show_credit_details = False while play_dialog: label_page = vtcapp.translate("{} {} {} {}").format( vtcapp.translate("Page"), step + 1, vtcapp.translate("of"), len(pages) ) dlg_rnd = vtcapp.rendertemplate( dialog_definition, periods=pages[step], summary=summary, label_balance_brought_forward=label_balance_brought_forward, label_vacation_credit=label_vacation_credit, is_only_one_period=is_only_one_period, step=step, last_step=(step == len(pages) - 1), show_credit_details=show_credit_details, credit_explanation=credit_explanation, label_page=label_page, total_pages=len(pages), ) ok, values = vtcapp.showcustomdialog(dlg_rnd, dialog_values) if not ok: return if values.get("ShowCreditDetailsButton"): show_credit_details = True values.pop("ShowCreditDetailsButton", None) continue if values.get("HideCreditDetailsButton"): show_credit_details = False values.pop("HideCreditDetailsButton", None) continue go_forward = not values.get("BackButton", False) values.pop("BackButton", None) values.pop("NextButton", None) dialog_values[step] = values step = step + 1 if go_forward else step - 1 if step < 0 or step >= len(pages): play_dialog = False def _get_intersecting_setting(start_date, end_date, settingchange_list): """ Checks, if we have intersecting settings (completely inside periode). """ ocl_query = "self->select(entryDate>={0})->select(endDate.notNull and (endDate<{1}))" \ "->orderby(endDate)->last" \ .format(vtcapp.ocldate(start_date), vtcapp.ocldate(end_date)) return settingchange_list.evalocl(ocl_query) def get_ratio(total, average): """ Calculates how often `average` fits into `total`. Returns 0 if `average` is None or 0. This is used especially to calculate the number of days for given minutes and working time per day. """ if not average: return 0 return total / float(average) def get_working_time_information(setting): """ Returns: - the maximum working time per day - the calculated number of working days A full working day is defined as a day with the maximum working time. Days with fewer hours are counted proportionally. """ working_times = [ float(working_time) for working_time in setting.evalocl("stdhoursPerWeekday->stringtolist") if working_time not in ("", "0", None) ] if not working_times: return 0, 0 maximum_working_time = max(working_times) calculated_working_days = sum( working_time / maximum_working_time for working_time in working_times ) return maximum_working_time, calculated_working_days def get_working_time_per_day(setting): """ Returns the maximum working time per day for the current setting. """ maximum_working_time, _calculated_working_days = ( get_working_time_information(setting) ) return maximum_working_time class BaseAbsenceRenderer: """ Most values are shown readonly. """ is_readonly = True value_type = 'float' def _has_values(self, rowobj): """ Returns True if the row has a valid type and a non-null user of type User. """ # We need a user, a date and a carryover if self.evalocl("(type <> 1) or user.isnull", rowobj): return False # User cannot be a user group if not self.evalocl("user.oclistypeof(User)", rowobj): return False return True class AbsenceInDaysRenderer(BaseAbsenceRenderer): """ Displays the absence in days on absence entries. """ def get_value(self, rowobj, expression, subscriber): """ Calculates and returns the absence duration in days for the given period. """ # Ensure the necessary values are set if not self._has_values(rowobj): return # Store variables user = self.evalocl("user", rowobj) start_date = self.evalocl("entryDate", rowobj) end_date = self.evalocl("if endDate.notnull then endDate else entryDate endif", rowobj) # Subscribe to all members ocl_absences_subscriber = "self->collect(typelink.art.asstring+"\ "minutesabsent.asstring+entryDate.asstring+endDate.asstring" \ "+user.asstring+active.asstring)" self.evalocl(ocl_absences_subscriber, rowobj) # Loop over every day to count the days day = start_date number_of_vacation_days = 0 while day <= end_date: minutes_taken = get_vacation_taken(user, day, day) setting = get_target_time_setting(user, day) working_time_per_day = get_working_time_per_day(setting) if minutes_taken and working_time_per_day: number_of_vacation_days += get_ratio(minutes_taken, working_time_per_day) day = vtcapp.incday(day, 1) return number_of_vacation_days class VacationBalanceInDaysRenderer(BaseAbsenceRenderer): """ Displays the vacation balance in days on absence entries. """ def get_value(self, rowobj, expression, subscriber): """ Calculates and returns the vacation balance in days for the relevant date. """ # Ensure the necessary values are set if not self._has_values(rowobj): return # Store variables user = self.evalocl("user", rowobj) day = self.evalocl("if endDate.notnull then endDate else entryDate endif", rowobj) setting = get_target_time_setting(user, day) working_time_per_day = get_working_time_per_day(setting) # Subscribe to all absences ocl_absences_subscriber = "absences->reject(entryDate>{})->collect(typelink.art.asstring+"\ "minutesabsent.asstring+entryDate.asstring+endDate.asstring" \ "+user.asstring+active.asstring)" self.evalocl(ocl_absences_subscriber.format(vtcapp.ocldate(day)), user) return get_ratio(get_vacation_balance(user, day), working_time_per_day) class VacationBalanceDetailsRenderer(BaseAbsenceRenderer): """ Displays a button to open the vacation balance detail dialog on absence entries. """ display_type = "button" def get_buttoniconid(self, rowobj, expression, subscriber): """ Returns the button icon identifier if the row has valid values, otherwise no button. """ # Ensure the necessary values are set if not self._has_values(rowobj): return NO_BUTTON return BUTTON_INFO def button_clicked(self, rowobj, expression): """ Opens the vacation balance detail dialog for the given row. """ # Ensure the necessary values are set if not self._has_values(rowobj): return user = self.evalocl("user", rowobj) show_vacation_balance(user, rowobj) return class VacationSettingsInDaysRenderer(BaseAbsenceRenderer): """ Allows the user to set and view the vacation carryover in days on the settings. """ def _has_values(self, rowobj, ocl_prefix=""): """ Returns True if the row has a non-null entry date and user not of type user group, considering an optional OCL prefix. """ # We need a user, a date and a carryover if self.evalocl(ocl_prefix + "entryDate.isnull or user.isnull", rowobj): return False # User cannot be a user group if not self.evalocl("user.oclistypeof(User)", rowobj): return False return True def get_value(self, rowobj, expression, subscriber): """ Calculates and returns the vacation carryover in days based on working time if all required values are present. """ # Ensure the necessary values are set if not self._has_values(rowobj, ocl_prefix="vacationCarryover.isnull or "): return # Store variables day = self.evalocl("entryDate", rowobj) vacation_carryforward = self.evalocl("vacationCarryover", rowobj) user = self.evalocl("user", rowobj) # Calc and return values setting = get_target_time_setting(user, day) working_time = get_working_time_per_day(setting) return get_ratio(vacation_carryforward, working_time) def set_value(self, rowobj, expression, value): """ Sets the vacation carryover in minutes based on the given value and working time if inputs are valid. """ # Ensure the necessary values are set if not self._has_values(rowobj): return if value is None: rowobj.vacationCarryover = None return # Store variables day = self.evalocl("entryDate", rowobj) user = self.evalocl("user", rowobj) # Calc and return values setting = get_target_time_setting(user, day) working_time = get_working_time_per_day(setting) # We do not accept non-integer values try: vacation_minutes = int(value) * int(working_time) except Exception: return # set_value rowobj.vacationCarryover = vacation_minutes def get_is_readonly(self, rowobj, expression, subscriber): """ Returns True if the field should be read-only because the user is a user group. """ return self.evalocl("not user.oclistypeof(User)", rowobj) def get_vacation_credit(user, start_date, end_date): """ Returns the vacation entitlement during a period. """ return _base_get_generic_function(user, "getVacationCredit", start_date, end_date) def get_employment_level(user, day): """ Returns the employment level of the user on a certain day. """ return _base_get_generic_function(user, "getEmploymentLevel", day) def get_vacation_taken(user, start_date, end_date=None): """ Returns the vacation taken in a period. """ end_date = end_date or start_date return _base_get_generic_function(user, "getVacationTaken", start_date, end_date) def get_vacation_balance_start(user, day): """ Returns the vacation balance at the start of a period. This means, the vacation balance plus vacation taken on the first day """ return get_vacation_balance(user, day) + get_vacation_taken(user, day, day) def get_vacation_balance(user, day): """ Returns the vacation balance on the day given. """ return _base_get_generic_function(user, "getVacationBalance", day) def get_vacation_carryforwardbalance(user, day): """ Returns the vacation carryover on the given day. """ return _base_get_generic_function(user, "getvacationCarryover", day) def get_vacation_end(user, day): """ Returns the next end of a vacation period. """ return _base_get_generic_function(user, "getvacationEnd", day) def get_target_time_setting(user, day, settingchange_list=None): """ Returns the last relevant setting before the given date and user. """ if not settingchange_list: ocl_query = "self->union(groups).orderedSettings" baseobject = user else: ocl_query = "self" baseobject = settingchange_list ocl_query += "->select(weeklyStdhours.notNull)->select(entryDate<={0})->select(endDate.isNull or (endDate>={0}))" \ "->orderby(entryDate)->last".format(vtcapp.ocldate(day)) return baseobject.evalocl(ocl_query) def _base_get_generic_function(user, oclfunction, start_date, end_date=None): """ Middleware to call generic ocl functions with one or two dates. """ if not user or not start_date or not oclfunction: return None if end_date is not None: ocl_query = "self->{}({}, {})".format(oclfunction, vtcapp.ocldate(start_date), vtcapp.ocldate(end_date)) else: ocl_query = "self->{}({})".format(oclfunction, vtcapp.ocldate(start_date)) return user.evalocl(ocl_query) def get_relevant_period(user, day): """ Depending on the day and the users entry and exit dates, we return the interval with the corresponding vacation period. """ # Do not show, if day is before entry date. if user.joiningDate > day: return None, None # If day is after the exit date, update date to exit date. if user.exitDate and user.exitDate <= day: day = user.exitDate # Default is vacation period, normally the full year end_date = get_vacation_end(user, day) # As end_date gives us the next end of a vacation period after the date given # we can calculate the start date start_date = vtcapp.incday(vtcapp.incyear(end_date, -1), 1) # Make sure whole period is in the intervall between entry and exit if start_date.date() < user.joiningDate.date(): start_date = user.joiningDate if user.exitDate and user.exitDate.date() <= end_date.date(): end_date = user.exitDate return start_date, end_date None false false false Python3 ScriptShowVacationBalance Show vacation balance User false self->size=1 # coding: windows-1252 # # Designation: Show vacation balance # Show in Vertec menus: Y # Classes: User # Display condition: self->size=1 # Event script for: # Event classes: # Event fields: # Extended rights: # Shows a dialog with vacation balance in days # to be called on a user # 2026-05-12 UHE: Initial version import module_vacation_balance_in_days module_vacation_balance_in_days.show_vacation_balance(argobject) None false false true Python3 TranslationAbsencesDays Abwesenheiten (Tage) Absences (days) Absences (jours) Assenze (giorni) Abwesenheiten (Tage) Absences (days) TranslationOpeningBalance Saldo zum Start Opening balance Solde d’ouverture Saldo di apertura Saldo zum Start Opening balance TranslationPerDayOnDaysWithBrackets ({} pro Tag an {} Tagen) ({} per day on {} days) ({} par jour pendant {} jours) ({} al giorno su {} giorni) ({} pro Tag an {} Tagen) ({} per day on {} days) TranslationPerDayWithBrackets ({} pro Tag) ({} per day) ({} par jour) ({} al giorno) ({} pro Tag) ({} per day) TranslationPrerequisitesDays Vorgaben (Tage) Settings (days) Données obligatoires (jours) Dati requisiti (giorni) Vorgaben (Tage) Prerequisites (days) TranslationRemainingBalance Verbleibender Saldo Remaining balance Solde restant Saldo residuo Verbleibender Saldo Remaining balance TranslationShowVacationBalance Feriensaldo anzeigen Show vacation balance Afficher le solde des vacances Mostra il saldo delle vacanze Urlaubssaldo anzeigen Show vacation balance TranslationTheVacationBalanceIsCalculatedProRataOnTheBasisOfCalendarDaysPerPeriodAndMultipliedByTheAnnualEntitlementTheNumberOfHoursOfVacationDaysDependsOnTheEmploymentLevel Der Ferienanspruch wird pro Periode anteilig nach Kalendertagen berechnet und mit dem Jahresanspruch multipliziert. Die Stundenanzahl der Ferientage richtet sich nach dem Beschäftigungsgrad. The vacation credit is calculated pro rata on the basis of calendar days per period and multiplied by the annual entitlement. The number of hours of vacation days depends on the employment level. Le crédit de vacances est calculé au prorata des jours civils par période et multiplié par le droit annuel. Le nombre d’heures de vacances dépend du Taux d’emploi. L’avere per ferie sarà calcolato per periodo in proporzione ai giorni di calendario e moltiplicato per il diritto annuo. Il numero di ore di ferie dipende dal Tasso di occupazione. Der Urlaubsanspruch wird pro Periode anteilig nach Kalendertagen berechnet und mit dem Jahresanspruch multipliziert. Die Stundenanzahl der Urlaubstage richtet sich nach dem Beschäftigungsgrad. The vacation credit is calculated pro rata on the basis of calendar days per period and multiplied by the annual entitlement. The number of hours of vacation days depends on the employment level. TranslationVacationBfwInDays Ferienvortrag in Tagen Vacation bfw. in days Rep. vacances en jours Riporto vacanze in giorni Urlaubsvortrag in Tagen Vacation bfw. in days TranslationVacationCreditFromToPeriod Ferienanspruch {} – {} Vacation credit {} – {} Crédit vacances {} – {} Credito vacanza {} – {} Urlaubsanspruch {} – {} Vacation credit {} - {} TranslationVacationCreditInPeriod Ferienanspruch in Periode Vacation credit in period Crédit vacances en période Credito per ferie in periodo Urlaubsanspruch in Periode Vacation credit in period TranslationVacationDays Ferientage Vacation days Jours de congé Giorni di vacanza Urlaubstage Vacation days LnkUserAbsencesWithDays true true true false 200 true false abwesenheiten Absence 62 AbwesenheitenContainer Absences (days) true true CurrentView 17 true true 0 0 cmbdatepicker false entryDate false 1 Date true 75 false false false 0 1 cmbdatepicker false enddate false 0 To date true 75 false false false 0 2 cmbAbwesenheitsTyp false typelink false 0 Type true 80 false false false 0 3 false description false 0 Description true 118 false false false 1 4 dbmTIM.MinuteRenderer false minutesabsent false 0 Hours true 50 false false false 1 5 module_vacation_balance_in_days.AbsenceInDaysRenderer false '' false 0 Vacation days true 80 false false false 1 6 module_vacation_balance_in_days.VacationBalanceInDaysRenderer false false 0 Remaining balance true 100 false false false 2 8 module_vacation_balance_in_days.VacationBalanceDetailsRenderer false '' false 0 true 22 false false false abwesenheiten false false false 0 false false User -1 WrapperLinkContainer Processor false true CurrentView user false LnkUserPrerequisitesDays true false false false 770 true false settings UserSetting 100 WrapperLinkContainer Prerequisites (days) true true CurrentView 17 true true 0 0 rndUserSettingDate false entryDate false 0 Date true 70 false false false 1 10 rndUserSettingMinute false stdhours false 0 Std hours true 80 false false false 1 11 rndUserSettingMinute false vacationAbsolute false 0 Vacation abs. true 80 false false false 0 12 rndUserSettingBoolean false ismonth false 0 Monthly true 60 false false false 0 13 rndUserSettingDate false endDate false 0 To date true 70 false false false 0 14 clgreen false '' true 0 false 3 false false false 1 15 rndUserSettingCurrency false overheads false 0 General costs true 80 false false false 1 16 rndUserSettingCurrency false salary false 0 Salary true 80 false false false 0 17 rndUserSettingRemarks false remarks false 0 Remark true 200 false false false 1 3 edtWeekTime rndUserSettingMinute false weeklyStdhours false 0 Weekly std. hours true 90 false false false 1 4 rndUserSettingMinute false vacation false 0 Vacation 100% true 80 false false false 0 5 clgreen false '' true 0 false 3 false false false 1 6 rndUserSettingMinute false overtimeCarryover false 0 Overtime bfw. true 80 false false false 1 7 rndUserSettingMinute false vacationCarryover false 0 Vacation bfw. true 80 false false false 1 8 if user.oclIsTypeOf(User) then 'cltransparent' else 'clgray' endif module_vacation_balance_in_days.VacationSettingsInDaysRenderer false false 0 Vacation bfw. in days true 115 false false false 0 9 clgreen false '' true 0 false 3 false false false orderedSettings false false false 0 false false User -1 WrapperLinkContainer Processor false true CurrentView user false