NAME

Net::LDAP::Batch::Action::Update - update entry on LDAP server

SYNOPSIS

 use Net::LDAP::Batch::Action::Update;
 my $action = Net::LDAP::Batch::Action::Update->new(
            {
                ldap => $net_ldap_object,
                search => [
                        base    => 'name=foo,dc=company,dc=com'
                        scope   => 'base'
                    ],
                replace => {
                        mail    => 'bar@company.com'
                    },
                delete  => {
                        someAttr => ['val1', 'val2'],
                    },
            });
 $action->execute or $action->rollback;

DESCRIPTION

Updates an entry from a LDAP server, restoring it on failure of any kind.

init

Override base method to check that search() param is set to an array ref.

execute

If entry() is set, will simply call update() on the Net::LDAP::Entry and croak on any error.

Otherwise, uses search(), replace() and (optionally) delete() to instatiate a Net::LDAP::Entry object, alter its attributes and write it back to the LDAP server.

rollback

Cannot rollback an entry if you did not specify a search() and replace() value (i.e., if you set entry() explicitly prior to execute).

AUTHOR

Peter Karman, <karman at cpan.org>

BUGS

Please report any bugs or feature requests to bug-net-ldap-batch at rt.cpan.org, or through the web interface at http://rt.cpan.org/NoAuth/ReportBug.html?Queue=Net-LDAP-Batch. I will be notified, and then you'll automatically be notified of progress on your bug as I make changes.

SUPPORT

You can find documentation for this module with the perldoc command.

    perldoc Net::LDAP::Batch

You can also look for information at:

* AnnoCPAN: Annotated CPAN documentation: http://annocpan.org/dist/Net-LDAP-Batch
* CPAN Ratings: http://cpanratings.perl.org/d/Net-LDAP-Batch
* RT: CPAN's request tracker: http://rt.cpan.org/NoAuth/Bugs.html?Dist=Net-LDAP-Batch
* Search CPAN: http://search.cpan.org/dist/Net-LDAP-Batch

ACKNOWLEDGEMENTS

The Minnesota Supercomputing Institute http://www.msi.umn.edu/ sponsored the development of this software.

COPYRIGHT

This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.