Net-SharePoint-Basic
DESCRIPTION
Net::SharePoint::Basic - Basic interface to Microsoft SharePoint REST API.
This module provides a basic interface for managing the Shared Folders
catalog in the Microsoft SharePoint site via its REST API. In the
current version only the following actions are supported:
* generating a connection token
* upload file or string
* download file content and save it
* list contents of folder
* create new folder
* delete file or folder
More actions are expected to be added in the future as well as we plan
to increase the versatility of the arguments accepted by this module
and the sample implementation of a client, 'sp-client', that comes
with it.
The interface is object oriented. A few constants are exported.
The full testing (and naturally the full usage) of the module requires
a working SharePoint site configuration. The structure of the
configuration file will be described in this manual as well. The
sample configuration file provided in this distribution will not work
against SharePoint and plays the role of a placeholder only.
use Net::SharePoint::Basic;
my $sp = Net::SharePoint::Basic->new({config_file => 'sharepoint.conf'});
# creates Shared Documents/test
my $response = $sp->makedir({retries => 1}, '/test');
# uploads a string as Shared Documents/test/teststring
$sp->upload({}, '/test/teststring', 'abcd');
# uploads a file 'testfile' into Shared Documents/test/
$sp->upload({type => 'file'}, '/test/', 'testfile');
# downloads contents of a file
$sp->download({}, '/test/teststring');
# downloads contents and saves it to a file
$sp->download({save_file => 'testfile'}, '/test/teststring');
# lists contents of a folder
$sp->list({}, '/test');
# deletes the folder
$sp->delete({}, '/test');
This module was developed based on the MSDN SharePoint REST API at
https://msdn.microsoft.com/en-us/library/office/jj860569.aspx .
INSTALLATION
For testing your own SharePoint configuration you need to provide the
path to the file containing it in the environment variable
NET_SHAREPOINT_CONFIG. For more information on the configuration file
please read the section 'CONFIGURATION FILE' in the POD of
Net::SharePoint::Basic . The file provided is a placeholder and will
not work against your setup. It will be ignored for most of the API
testing stages.
To install this module, run the following commands:
perl Build.PL
./Build
./Build test
./Build install
SUPPORT AND DOCUMENTATION
After installing, you can find documentation for this module with the
perldoc command.
perldoc Net::SharePoint::Basic
You can also look for information at:
RT, CPAN's request tracker (report bugs here)
http://rt.cpan.org/NoAuth/Bugs.html?Dist=Net-SharePoint-Basic
AnnoCPAN, Annotated CPAN documentation
http://annocpan.org/dist/Net-SharePoint-Basic
CPAN Ratings
http://cpanratings.perl.org/d/Net-SharePoint-Basic
Search CPAN
http://search.cpan.org/dist/Net-SharePoint-Basic/
GitHub Repository
https://github.com/vmware/perl-net-sharepoint-basic
LICENSE AND COPYRIGHT
Copyright (C) 2018-2019 VMware Inc. All rights reserved.
This program is free software; you can redistribute it and/or modify it
under the terms of either: the GNU General Public License as published
by the Free Software Foundation; or the Artistic License.
See LICENSE.txt for more information.
