(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/C++ Library Downloads
MS Visual C/C++ Linux/CentOS C/C++ Alpine Linux C/C++ MAC OS X C/C++	armhf/aarch64 C/C++ C++ Builder iOS C/C++ Android C/C++	Solaris C/C++ MinGW C/C++

#include <C_CkHttp.h>
#include <C_CkStringBuilder.h>
#include <C_CkFileAccess.h>
#include <C_CkJsonObject.h>
#include <C_CkDateTime.h>

void ChilkatSample(void)
    {
    HCkHttp http;
    HCkStringBuilder sbJson;
    BOOL success;
    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;

    // 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 != TRUE) {
        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();

    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.
            lastModLocal = CkFileAccess_GetLastModified(fac,CkStringBuilder_getAsString(localPath));
            if (CkFileAccess_getLastMethodSuccess(fac) == TRUE) {
                // 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;
                }

                CkDateTime_Dispose(lastModLocal);
            }
            else {
                printf("Unable to get the local file's last-modified date/time.\n");
                printf("%s\n",CkFileAccess_lastErrorText(fac));
            }

        }

        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 != TRUE) {
                printf("%s\n",CkHttp_lastErrorText(http));
                CkHttp_Dispose(http);
                CkStringBuilder_Dispose(sbJson);
                CkFileAccess_Dispose(fac);
                CkJsonObject_Dispose(json);
                CkDateTime_Dispose(lastModRemote);
                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);
    CkStringBuilder_Dispose(localPath);
    CkStringBuilder_Dispose(fileUrl);

    }