/ 
Livelink-DAV-0.0013
River stage zero No dependents
/ Livelink::DAV

NAME

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.

SYNOPSIS

use Livelink::DAV;

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 great 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;

DESCRIPTION

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/');

EXPORT

None by default.

SEE ALSO

CopyTree::VendorProof CopyTree::VendorProof::LocalFileOp SharePoint::SOAPHandler

AUTHOR

dbmolester, dbmolester de gmail.com

COPYRIGHT AND LICENSE

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.