Unicode C++ Requires Chilkat v11.0.0+
Unicode C++
SharePoint -- Download Newer Files
See more SharePoint Examples
Demonstrates how to download all files from a SharePoint folder that are newer than the local files.Chilkat Unicode C++ Downloads
#include <CkHttpW.h>
#include <CkStringBuilderW.h>
#include <CkFileAccessW.h>
#include <CkJsonObjectW.h>
#include <CkDateTimeW.h>
void ChilkatSample(void)
{
bool success = false;
// This requires the Chilkat API to have been previously unlocked.
// See Global Unlock Sample for sample code.
// -------------------------------------------------------------------------
// The following comments apply to SharePoint Windows classic authentication.
// -------------------------------------------------------------------------
// For example, imagine our SharePoint endpoint is https://xyzoffice.mycompany.com/
// The SHAREPOINT_NTLM_DOMAIN would be "mycompany.com"
// The SHAREPOINT_HTTPS_DOMAIN would be "xyzoffice.mycompany.com"
// Also, the SHAREPOINT_USERNAME would be just the name, not a full email address.
// for example, "chilkat" instead of "chilkat@mycompany.com"
CkHttpW http;
// If SharePoint Windows classic authentication is used, then set the
// Login, Password, LoginDomain, and NtlmAuth properties.
http.put_Login(L"SHAREPOINT_USERNAME");
http.put_Password(L"SHAREPOINT_PASSWORD");
http.put_LoginDomain(L"SHAREPOINT_NTLM_DOMAIN");
http.put_NtlmAuth(true);
// -------------------------------------------------------------------------
// The more common case is to use SharePoint Online authentication (via the SPOIDCRL cookie).
// If so, do not set Login, Password, LoginDomain, and NtlmAuth, and instead
// establish the cookie as shown at SharePoint Online Authentication
// -------------------------------------------------------------------------
// First we'll download a list of all the files in the /Documents folder.
// This provides the names and last-modified date/times of the files located
// on the SharePoint server.
http.put_Accept(L"application/json;odata=verbose");
http.put_AcceptCharset(L"utf-8");
CkStringBuilderW sbJson;
success = http.QuickGetSb(L"https://SHAREPOINT_HTTPS_DOMAIN/_api/web/GetFolderByServerRelativeUrl('/Documents')/Files",sbJson);
if (success == false) {
wprintf(L"%s\n",http.lastErrorText());
return;
}
// Before proceeding, make sure the local directory where we'll be downloading files exists.
CkFileAccessW fac;
fac.DirEnsureExists(L"qa_output/sharepoint/Documents");
// OK.. load the JSON and iterate over each file
CkJsonObjectW json;
json.LoadSb(sbJson);
int numFiles = json.SizeOfArray(L"d.results");
wprintf(L"Number of Files in the SharePoint /Documents folder = %d\n",numFiles);
CkDateTimeW lastModRemote;
CkDateTimeW lastModLocal;
CkStringBuilderW localPath;
CkStringBuilderW fileUrl;
int i = 0;
while (i < numFiles) {
json.put_I(i);
const wchar_t *filename = json.stringOf(L"d.results[i].Name");
const wchar_t *sLastModified = json.stringOf(L"d.results[i].TimeLastModified");
wprintf(L"%d: %s (%s)\n",i + 1,filename,sLastModified);
lastModRemote.SetFromTimestamp(sLastModified);
bool bDownload = false;
// Check to see if the local file exists. If not, then download.
localPath.SetString(L"qa_output/sharepoint/Documents/");
localPath.Append(filename);
if (fac.FileExists(localPath.getAsString()) != true) {
wprintf(L"This file does not exist locally.\n");
bDownload = true;
}
else {
// Get the local file's date time and compare with the remote file date/time.
lastModLocal.SetFromTimestamp(fac.getFileTimeStr(localPath.getAsString(),0));
// Get the difference in seconds between the local and remote last-modified times.
// if the return value is negative, then the caller's time is
// older than the argument. (in this case, a negative return value means
// the local file is older than the remote file.
// Note: The DiffSeconds method was found to be missing in the Chilkat .NET build
// (and possibly in other builds). It will be present in the v9.5.0.67 release and later.
int numSeconds = lastModLocal.DiffSeconds(lastModRemote);
if (numSeconds < 0) {
wprintf(L"The local file is older than the remote file.\n");
bDownload = true;
}
}
if (bDownload == true) {
fileUrl.SetString(L"https://SHAREPOINT_HTTPS_DOMAIN/_api/web/GetFolderByServerRelativeUrl('/Documents')/Files('");
fileUrl.Append(filename);
fileUrl.Append(L"')/$value");
wprintf(L"Downloading %s\n",filename);
success = http.Download(fileUrl.getAsString(),localPath.getAsString());
if (success == false) {
wprintf(L"%s\n",http.lastErrorText());
return;
}
// Set the local file's last-modified date/time to that of the server's.
fac.SetLastModified(localPath.getAsString(),lastModRemote);
}
i = i + 1;
}
wprintf(L"All finished.\n");
}