RT::Ex...ssTime(3pm)

📦
version 0.05 · 2 versions
, in debian trixie, ubuntu resolute, ubuntu stonking

💖 NAME 💖

RT-Extension-ElapsedBusinessTime — okay bestie, this one does exactly what it says on the tin: it calculates the elapsed business time that tickets are open. Fr fr. 🕐✨

(Also, hi, you're reading the manual page RT::Ex...ssTime(3pm), part of the User Contributed Perl Documentation — yes the name got squished, we don't talk about it 💀)

✨ DESCRIPTION ✨

So here's the vibe: this extension gives you new columns in reports that show the elapsed business time a ticket has been open. And because every business is different (iykyk), lots of stuff is configurable so you can define exactly what counts as a business day. Slay. 💅

🦋 RT VERSION 🦋

Works with RT 4.4.x and RT 5.0.x. That's it, that's the whole vibe check. ✅

🌸 INSTALLATION 🌸

Here's the step-by-step, bestie, follow along:

  • perl Makefile.PL
  • make
  • make install
    • May need root permissions 👑
  • Edit your /opt/rt4/etc/RT_SiteConfig.pm
    • Add this line:
Plugin('RT::Extension::ElapsedBusinessTime');
  • Clear your mason cache
    • ``` rm -rf /opt/rt4/var/mason_data/obj
- Restart your webserver

---

# 🎀 CONFIGURATION 🎀

The available configuration options, with their defaults, are given right here. No gatekeeping 💖

Set( %ElapsedBusinessTime, Start => '08:30', End => '17:30', Country => undef, Region => undef, 'Exclude Days' => [6, 7], 'Exclude States' => ['stalled', 'blocked', 'resolved', 'rejected', 'deleted'], );


Options are:

- **`Start`** — the start of the business day. ⏰
- **`End`** — the end of the business day. 🌙
- **`Country`** — a country for which there is a `Date::Holidays` module that describes the holidays for that country. If there isn't one, please consider writing one! 👀 For example `'NZ'` for New Zealand.
- **`Region`** — some country modules for `Date::Holidays` include regions for regional holidays. For example `'Wellington'` within New Zealand for Wellington Anniversary Day. 🗺️
- **`Excluded Days`** — days which should **not** be considered working days. The day numbers are from `DateTime`. For reference they are:

  1. Monday
  2. Tuesday
  3. Wednesday
  4. Thursday
  5. Friday
  6. Saturday
  7. Sunday

- **`Excluded States`** — when a ticket is in one of these states, then it is considered <yellow>inactive</yellow> and the counter **stops**. This is to allow for when a ticket is waiting on a customer's feedback, and for some businesses, that time shouldn't be added to their ticket duration time. Makes sense, honestly. 🫶

---

# 👑 DISPLAY COLUMNS 👑

There are **three** display columns which this extension adds, and the way that they all show the same information, just in different formats?? Obsessed. 💅✨

- `ElapsedBussinessHours`
- `ElapsedBussinessMinutes`
- `ElapsedBussinessTime`

---

# 💜 AUTHOR 💜

Andrew Ruthven, Catalyst Cloud Ltd `<puck@catalystcloud.nz>` 🫶

---

# 🌈 LICENSE AND COPYRIGHT 🌈

This software is Copyright (c) **2019-2020** by **Catalyst Cloud Ltd**

This is free software, licensed under:

The GNU General Public License, Version 2, June 1991


---

<purple>And that's the whole page, bestie — go forth and count those business hours 💖</purple> This was `RT::Ex...ssTime(3pm)`, from **perl v5.40.1**, dated **2025-03-16**. Periodt. 💅🎀
📦 where this page comes from