Attachment 296019 Details for Bug 427885 – v2 for function Bugzilla::WebService::Bug::get_activity() + POD

[patch] v2 for function Bugzilla::WebService::Bug::get_activity() + POD

patch.diff (text/plain), 3.40 KB, created by Noura El hawary on 2008-02-27 03:34:39 UTC

(hide)

Description:

Filename:

MIME Type:

Creator: Noura El hawary

Created: 2008-02-27 03:34:39 UTC

Size: 3.40 KB

patch

obsolete

>Index: Bugzilla/WebService/Bug.pm
>===================================================================
>RCS file: /cvsroot/mozilla/webtools/bugzilla/Bugzilla/WebService/Bug.pm,v
>retrieving revision 1.11
>diff -3 -p -u -r1.11 Bug.pm
>--- Bugzilla/WebService/Bug.pm	12 Feb 2008 01:32:52 -0000	1.11
>+++ Bugzilla/WebService/Bug.pm	27 Feb 2008 03:21:53 -0000
>@@ -111,6 +111,38 @@ sub get {
>     return { bugs => \@return };
> }
> 
>+# this is a function that gets bug activity for list of bug ids 
>+# it can be called as the following:
>+# $call = $rpc->call( 'Bug.get_activity', { ids => [1,2] });
>+sub get_activity {
>+    my ($self, $params) = @_;    
>+
>+    my $ids = $params->{ids};
>+    defined $ids || ThrowCodeError('param_required', { param => 'ids' });
>+
>+    my %item;
>+    my @return;
>+    foreach my $bug_id (@$ids) {
>+        ValidateBugID($bug_id);
>+        $item{id} = $bug_id;
>+
>+        ( $item{operations}, $item{incomplete_data} ) = Bugzilla::Bug::GetBugActivity($bug_id);    
>+
>+        my $bug = new Bugzilla::Bug($bug_id);
>+        if (Bugzilla->params->{'usebugaliases'}) {
>+            $item{'alias'} = type('string')->value($bug->alias);
>+        }
>+        else {
>+            # For API reasons, we always want the value to appear, we just
>+            # don't want it to have a value if aliases are turned off.
>+            $item{'alias'} = undef;
>+        }
>+
>+        push(@return, \%item);
>+    }
>+
>+    return { bugs => \@return };  
>+} 
> 
> sub create {
>     my ($self, $params) = @_;
>@@ -367,7 +399,83 @@ You do not have access to the bug_id you
> 
> =back
> 
>+=item C<get_activity> B<EXPERIMENTAL>
>+
>+=over
>+
>+=item B<Description>
>+
>+Gets activity about particular bugs in the database.
>+
>+=item B<Params>
>+
>+=over
>+
>+=item C<ids>
>+
>+An array of numbers and strings.
>+
>+If an element in the array is entirely numeric, it represents a bug_id
>+from the Bugzilla database to fetch. If it contains any non-numeric 
>+characters, it is considered to be a bug alias instead, and the bug with 
>+that alias will be loaded. 
>+
>+Note that it's possible for aliases to be disabled in Bugzilla, in which
>+case you will be told that you have specified an invalid bug_id if you
>+try to specify an alias. (It will be error 100.)
>+
>+=back
>+
>+=item B<Returns>
>+
>+A hash containing a single element, C<bugs>. This is an array of hashes. 
>+Each hash contains the following items:
>+
>+=over
> 
>+=item id
>+
>+C<int> The numeric bug_id of this bug.
>+
>+=item alias
>+
>+C<string> The alias of this bug. If there is no alias or aliases are 
>+disabled in this Bugzilla, this will be an empty string.
>+
>+=item operations
>+
>+C<array> An array of hashes with each hash containing C<when>, which is a 
>+string that holds the date the bug activity/change happened, C<who> which is
>+a string that holds the login name for the person who performed the change,
>+and C<changes> which is an array of hashes that holds the change details.
>+
>+=item incomplete_data
>+
>+C<boolean> Is set to 1 to indicate that there is an old Bugzilla data 
>+corruption bug, otherwise 0.
>+
>+=back
>+
>+=item B<Errors>
>+
>+=over
>+
>+=item 100 (Invalid Bug Alias)
>+
>+If you specified an alias and either: (a) the Bugzilla you're querying
>+doesn't support aliases or (b) there is no bug with that alias.
>+
>+=item 101 (Invalid Bug ID)
>+
>+The bug_id you specified doesn't exist in the database.
>+
>+=item 102 (Access Denied)
>+
>+You do not have access to the bug_id you specified.
>+
>+=back
>+
>+=back
> 
> =item C<create> B<EXPERIMENTAL>
>

Actions: View | Diff

Attachments on bug 427885: 291686 | 296019 | 296199 | 296301