C Requires Chilkat v11.0.0+
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 C Downloads
#include <C_CkHttp.h>
#include <C_CkStringBuilder.h>
#include <C_CkFileAccess.h>
#include <C_CkJsonObject.h>
#include <C_CkDateTime.h>
void ChilkatSample(void)
{
BOOL success;
HCkHttp http;
HCkStringBuilder sbJson;
HCkFileAccess fac;
HCkJsonObject json;
int numFiles;
HCkDateTime lastModRemote;
HCkDateTime lastModLocal;
HCkStringBuilder localPath;
HCkStringBuilder fileUrl;
int i;
const char *filename;
const char *sLastModified;
BOOL bDownload;
int numSeconds;
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"
http = CkHttp_Create();
// If SharePoint Windows classic authentication is used, then set the
// Login, Password, LoginDomain, and NtlmAuth properties.
CkHttp_putLogin(http,"SHAREPOINT_USERNAME");
CkHttp_putPassword(http,"SHAREPOINT_PASSWORD");
CkHttp_putLoginDomain(http,"SHAREPOINT_NTLM_DOMAIN");
CkHttp_putNtlmAuth(http,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.
CkHttp_putAccept(http,"application/json;odata=verbose");
CkHttp_putAcceptCharset(http,"utf-8");
sbJson = CkStringBuilder_Create();
success = CkHttp_QuickGetSb(http,"https://SHAREPOINT_HTTPS_DOMAIN/_api/web/GetFolderByServerRelativeUrl('/Documents')/Files",sbJson);
if (success == FALSE) {
printf("%s\n",CkHttp_lastErrorText(http));
CkHttp_Dispose(http);
CkStringBuilder_Dispose(sbJson);
return;
}
// Before proceeding, make sure the local directory where we'll be downloading files exists.
fac = CkFileAccess_Create();
CkFileAccess_DirEnsureExists(fac,"qa_output/sharepoint/Documents");
// OK.. load the JSON and iterate over each file
json = CkJsonObject_Create();
CkJsonObject_LoadSb(json,sbJson);
numFiles = CkJsonObject_SizeOfArray(json,"d.results");
printf("Number of Files in the SharePoint /Documents folder = %d\n",numFiles);
lastModRemote = CkDateTime_Create();
lastModLocal = CkDateTime_Create();
localPath = CkStringBuilder_Create();
fileUrl = CkStringBuilder_Create();
i = 0;
while (i < numFiles) {
CkJsonObject_putI(json,i);
filename = CkJsonObject_stringOf(json,"d.results[i].Name");
sLastModified = CkJsonObject_stringOf(json,"d.results[i].TimeLastModified");
printf("%d: %s (%s)\n",i + 1,filename,sLastModified);
CkDateTime_SetFromTimestamp(lastModRemote,sLastModified);
bDownload = FALSE;
// Check to see if the local file exists. If not, then download.
CkStringBuilder_SetString(localPath,"qa_output/sharepoint/Documents/");
CkStringBuilder_Append(localPath,filename);
if (CkFileAccess_FileExists(fac,CkStringBuilder_getAsString(localPath)) != TRUE) {
printf("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.
CkDateTime_SetFromTimestamp(lastModLocal,CkFileAccess_getFileTimeStr(fac,CkStringBuilder_getAsString(localPath),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.
numSeconds = CkDateTime_DiffSeconds(lastModLocal,lastModRemote);
if (numSeconds < 0) {
printf("The local file is older than the remote file.\n");
bDownload = TRUE;
}
}
if (bDownload == TRUE) {
CkStringBuilder_SetString(fileUrl,"https://SHAREPOINT_HTTPS_DOMAIN/_api/web/GetFolderByServerRelativeUrl('/Documents')/Files('");
CkStringBuilder_Append(fileUrl,filename);
CkStringBuilder_Append(fileUrl,"')/$value");
printf("Downloading %s\n",filename);
success = CkHttp_Download(http,CkStringBuilder_getAsString(fileUrl),CkStringBuilder_getAsString(localPath));
if (success == FALSE) {
printf("%s\n",CkHttp_lastErrorText(http));
CkHttp_Dispose(http);
CkStringBuilder_Dispose(sbJson);
CkFileAccess_Dispose(fac);
CkJsonObject_Dispose(json);
CkDateTime_Dispose(lastModRemote);
CkDateTime_Dispose(lastModLocal);
CkStringBuilder_Dispose(localPath);
CkStringBuilder_Dispose(fileUrl);
return;
}
// Set the local file's last-modified date/time to that of the server's.
CkFileAccess_SetLastModified(fac,CkStringBuilder_getAsString(localPath),lastModRemote);
}
i = i + 1;
}
printf("All finished.\n");
CkHttp_Dispose(http);
CkStringBuilder_Dispose(sbJson);
CkFileAccess_Dispose(fac);
CkJsonObject_Dispose(json);
CkDateTime_Dispose(lastModRemote);
CkDateTime_Dispose(lastModLocal);
CkStringBuilder_Dispose(localPath);
CkStringBuilder_Dispose(fileUrl);
}