Service...L::Task(3)

🎀 Task module 🎀

okay so bestie, welcome to Service...L::Task from the Service-now Perl API 💅 this is the page for the Task module, and honestly? it's giving backbone. everything else kinda hangs off it.

---

💖 Desciption 💖

(yes that's the heading, typos are canon, we don't fix the vibes ✨)

So Task is an object representation of a Task in the Service-now platform. It comes with subroutines for querying, updating, and creating tasks.

And here's the iconic part — Task is the parent class of Incident, Problem, Change, SC_Task and Ticket. 👑 All of those child classes inherit subroutines from this class, so when you learn Task you basically learned the whole family. main character energy fr fr.

🌸 System Requirements 🌸

The Service-now Perl API needs Perl 5.8 plus these modules installed:

• SOAP::Lite (prerequisites http://soaplite.com/prereqs.html) 0.71 or later
• Crypt::SSLeay
• IO::Socket::SSL

---

✨ Constructor ✨

new

new(Configuration);

Example:

$task = ServiceNow::ITIL::Task->new($CONFIG);

It takes a configuration object and manufactures a Task object connected to the Service-now instance. that's it, that's the whole vibe check 🦋

---

🫶 Subroutines 🫶

create

create(optional paramaters)

Example:

$task->create();

Creates and inserts a Task/Incident/Ticket/SC_Task record into the respective table. 🧚 Returns the number of created record on success, and undef on failure. so like, always check your return value, no cap.

close

close(number of record, optional parameters)

Example:

$task->close('INC1000312');

Sets the state of Task/Incident/Ticket/SC_Task to closed and updates the respective table. Returns the number of created record on success, undef on failure. 💀

reopen

reopen(number of record, optional parameters)

Example:

$task->reopen('TKT1003010');

Sets the state of Task/Incident/Ticket/SC_Task to open and updates the respective table. the glow-up reversal we all needed ✨

reassign

reassign(number, group, user);

Example:

$incident->reassign($number, 'Database', 'user')

Re-assign an incident to the group and user specified. lowkey the most useful thing ever when someone's ticket lands in the wrong queue 🙈

queryJournal

queryJournal(configuration file, optional field name)

Example:

$task->queryJournal($config, 'work_notes');

Returns an array of hash references to each journal associated with the current Task/Incident/Ticket/SC_Task. The optional field name refines the search to a specified field. 🔥

attach

attach(file path)

Example:

$task->attach("/Users/davidloo/Desktop/test_files/number_test.xls");

Attach a file to a record of Task. 🍓

---

that's the whole page bestie, go forth and slay your tasks 💜

perl v5.42.0 · 2025-07-25 · Service...L::Task(3) — mwah, that's the source, the version and the date, sign-off complete 🎀🫶