NAME

WebService::Bugzilla::Bug::History::Change - A single field change within a bug history entry

VERSION

version 0.001

SYNOPSIS

my $history = $bz->bug->history($bug_id);
for my $entry (@{$history}) {
    for my $change (@{ $entry->changes }) {
        say $change->field_name, ': ',
            $change->removed, ' -> ', $change->added;
        if ($change->has_attachment_id) {
            say '  (attachment ', $change->attachment_id, ')';
        }
    }
}

DESCRIPTION

Represents a single field change within a bug history entry. Multiple changes can occur at the same time (in the same WebService::Bugzilla::Bug::History entry), typically when a user modifies several fields in one operation.

Change objects are accessed via the changes attribute of a WebService::Bugzilla::Bug::History object.

ATTRIBUTES

All attributes are read-only.

added

New value for the field. For multi-value fields (like CC) this may be a comma-separated string.

attachment_id

Numeric attachment ID when the change relates to an attachment (e.g. a flag or description change). Use has_attachment_id to check presence.

field_name

Name of the field that was changed (e.g. status, resolution, cc).

removed

Previous value for the field.

METHODS

has_attachment_id

if ($change->has_attachment_id) { ... }

Moo predicate method. Returns true when attachment_id is set.

SEE ALSO

WebService::Bugzilla::Bug::History - history entry objects

WebService::Bugzilla::Bug - bug objects

https://bmo.readthedocs.io/en/latest/api/core/v1/bug.html#bug-history - Bugzilla Bug History REST API

AUTHOR

Dean Hamstead <dean@fragfest.com.au>

COPYRIGHT AND LICENSE

This software is Copyright (c) 2026 by Dean Hamstead.

This is free software, licensed under:

The MIT (X11) License