Livelink-DAV version 0.0013 ========================= Livelink::DAV - Perl extension for providing a Opentext Livelink EWS WebDAV connecter instance for CopyTree::VendorProof. This module provides a new [sic.] contructor and necessary subclass methods for CopyTree::VendorProof in order to deal with remote Livelink EWS WebDAV file operations. What? Oh, yes. You've probabaly stumbled across this module because you wanted to copy something recursively. Did you want to move some files into or off your SharePoint file server? Did you buy Opentext's Livelink EWS and wish to automate some file transfers? Well, this is kinda the right place, but it gets righter. Check out the documentation on my CopyTree::VendorProof module, where I have a priceless drill and screw analogy for how these modules all work together. The information on this page is a tad too technical if all you're trying to decide is whether this is the module you need. The subclass methods provided in this connector objects include: new fdls is_fd read_info_memory write_from_memory copy_local_files cust_mkdir cust_rmdir cust_rmfile The functionality of these methods are described in perldoc CopyTree::VendorProof Under the section "Object specific instance methods for the base class CopyTree::VendorProof" To create a Livelink::DAV connector instance: my $llobj = Livelink::DAV->new; To set up connection parameters: first, define the livelink server location: $llobj->lldsite('http://www.livelink.server.org/'); second, find out the root directory of your webdav resource, for example, if it's at http://www.livelink.server.org/somedir/webdav_dir/ then for llddav use: 'somedir/webdav_dir' $llobj->llddav('somedir/webdav_dir'); #then enter your user account name: $llobj->lldusern('username'); #then, enter your password: $llobj->llduserp('password'); As of this writing, only simple authentication has been tested, though with a lot of imagination, simple authentication over ssl (https) should work too. To add a source or destination item to a CopyTree::VendorProof instance: my $ctvp_inst = CopyTree::VendorProof ->new; Add a Livelink::DAV source, which always starts with the dir / file right underneath the webdav_dir. Do not include the webdav_dir itself, or any leading slashes. $ctvp_inst ->src ('~username/path to your source', $llobj); #create a new directory in Livelink: $llobj->cust_mkdir('~username/newdir'); #set the destination to be in the new directory: $ctvp_inst -> dst ('~username/newdir',$llobj); #copies the file / dir $ctvp_inst->cp; Livelink::DAV provides different types of methods. First, it provides connection methods to allow us to connect to Livelink EWS's WebDAV. These connection methods that you see in the SYNOPSIS are pretty self explanatory. Second, Livelink::DAV provides methods for its parent class (CopyTree::VendorProof), which includes new fdls is_fd read_info_memory write_from_memory copy_local_files cust_mkdir cust_rmdir cust_rmfile The functionality of these methods are described in perldoc CopyTree::VendorProof It is worth nothing that fdls comes in quite handy for testing whether you can actually connect to your livelink resource using this module. Simply open up your web browser and go to your livelink site, and fdls any resource that has a webdav property. If you do a Dumper print, you should get something back. use Data::Dumper; print Dumper $llobj -> fdls('', '~username/'); INSTALLATION To install this module type the following: perl Makefile.PL make make test make install DEPENDENCIES This module requires these other modules and libraries: 'CopyTree::VendorProof'=>0.0011, 'namespace::autoclean' => 0.13, 'HTTP::DAV' =>0.47, 'Moose' =>2.0602, 'MooseX::NonMoose' =>0.22 , 'Data::Dumper' =>2.121, 'Carp' =>1.02, 'File::Basename'=>2.82, 'Term::ReadKey' =>2.30,#only needed for test suite 'MIME::Base64=>3.01' #only needed for test suite COPYRIGHT AND LICENCE Copyright (C) 2012 by dbmolester This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself, either Perl version 5.14.2 or, at your option, any later version of Perl 5 you may have available.