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

📦 version 0.05, in ubuntu jammy

✨ NAME ✨

ok so bestie, welcome to the manual page for RT::Ex...toName(3pm) 💖 (yes that's the truncated title, it's giving mysterious, but the real one is right here) — this is RT-Extension-AssetAutoName, and it does literally one iconic thing: auto generate a name for an asset. 🎀

🌸 DESCRIPTION 🌸

So here's the vibe. This extension lets you define templates for asset categories, and those templates get used whenever no name is set on an asset. You can use it to build the name out of CustomFields (or, like, other values too — no cap). ✨

It was originally developed for tracking components of servers, where the name should be based on the make, model, and serial number of a component. But here's the tea: those things should still be stored individually as Custom Fields, so that searching and reporting stay easy. 🧚 The template just glues them together for the display name.

💅 RT VERSION 💅

Works with RT 4.4.x and 5.0.x. That's it, that's the whole section. 🫶

🦋 INSTALLATION 🦋

Okay, installation era. Do these in order, bestie:

  1. Run this:
perl Makefile.PL
  1. Then this:
make
  1. And then this:
make install
  • May need root permissions 👑
  1. Edit your /opt/rt4/etc/RT_SiteConfig.pm — and add this line:
Plugin('RT::Extension::AssetAutoName');
  1. Still in there, add templates for the categories you'd like to have use this extension:
Set( %AssetAutoName, 2 => 'Card: __CF.28__ (__Status__)' );
  • 28 is the CustomField to use — you can also specify the name here.
  • If the CustomField is a multi-value, then only the first value is used. 👀
  1. Clear your mason cache, babes:
rm -rf /opt/rt4/var/mason_data/obj
  1. Restart your webserver. 🔥

⭐ USAGE ⭐

If the asset name is not set, is the empty string, or is just an x, we'll dynamically generate a name based on a template. Slay. 💫

And why would anyone allow a lonely little x in there? Because it's useful when data is being bulk updated — it's been reported that with some tools, setting a short string is easier than deleting the text. iykyk. 🙈

👑 AUTHOR 👑

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

This software is Copyright (c) 2018-2020 by Catalyst Cloud Ltd.

This is free software, licensed under:

The GNU General Public License, Version 2, June 1991

aaaand that's the whole page, bestie 💜 this lil legend was generated by perl v5.32.1 and stamped 2021-02-27, under the <rainbow>User Contributed Perl Documentation</rainbow> umbrella. go forth and name those assets, periodt. 🎀✨

📦 where this page comes from