DataFlex

SharePoint -- Check Out a File (or Undo a Checkout)

In SharePoint, you can check out a file to make sure nobody can change it before you update it. After updating, you can check in the file. This example shows how to check out a SharePoint file.

Note: To undo a checkout, replace the string "checkout" with "undocheckout" in the line of code that sets the request's path.

DataFlex

Use ChilkatAx-win32.pkg

Procedure Test
    Boolean iSuccess
    Handle hoHttp
    Variant vReq
    Handle hoReq
    Boolean iBUseTls
    Variant vResp
    Handle hoResp
    Handle hoXml
    String sTemp1
    Integer iTemp1

    Move False To iSuccess

    // This requires the Chilkat API to have been previously unlocked.
    // See Global Unlock Sample for sample code.

    Get Create (RefClass(cComChilkatHttp)) To hoHttp
    If (Not(IsComObjectCreated(hoHttp))) Begin
        Send CreateComObject of hoHttp
    End

    // If SharePoint Windows classic authentication is used, then set the 
    // Login, Password, LoginDomain, and NtlmAuth properties.
    Set ComLogin Of hoHttp To "SHAREPOINT_USERNAME"
    Set ComPassword Of hoHttp To "SHAREPOINT_PASSWORD"
    Set ComLoginDomain Of hoHttp To "SHAREPOINT_NTLM_DOMAIN"
    Set ComNtlmAuth Of hoHttp To 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

    // 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

    // This example will check out the file named "penguins2.jpg" 
    // which is located in the "/Documents" folder.

    Get Create (RefClass(cComChilkatHttpRequest)) To hoReq
    If (Not(IsComObjectCreated(hoReq))) Begin
        Send CreateComObject of hoReq
    End
    Set ComHttpVerb Of hoReq To "POST"
    // Note that our path uses GetFileByServerRelativeUrl and not GetFolderByServerRelativeUrl
    // Also, if your Sharepoint site is within a site collection, the URL is formatted like this (where "teamA" is the name of the site)
    // /sites/teamA/_api/web/GetFileByServerRelativeUrl('/sites/teamA/Documents/penguins2.jpg')/checkout

    // Note: To undo a checkout, replace "checkout" with "undocheckout" in the following line of code.
    Set ComPath Of hoReq To "/_api/web/GetFileByServerRelativeUrl('/Documents/penguins2.jpg')/checkout"

    // We need to add a form digest value in the X-RequestDigest header field.
    // See this example for details on
    // how to get (and cache) a form digest value
    Send ComAddHeader To hoReq "X-RequestDigest" "SHAREPOINT_FORM_DIGEST"

    // Send the POST using HTTPS (TLS). Port 443 is the default port for https.
    Move True To iBUseTls
    Get Create (RefClass(cComChilkatHttpResponse)) To hoResp
    If (Not(IsComObjectCreated(hoResp))) Begin
        Send CreateComObject of hoResp
    End
    Get pvComObject of hoReq to vReq
    Get pvComObject of hoResp to vResp
    Get ComHttpSReq Of hoHttp "SHAREPOINT_HTTPS_DOMAIN" 443 iBUseTls vReq vResp To iSuccess
    If (iSuccess = False) Begin
        Get ComLastErrorText Of hoHttp To sTemp1
        Showln sTemp1
        Procedure_Return
    End

    // The response body contains XML.
    Get Create (RefClass(cComChilkatXml)) To hoXml
    If (Not(IsComObjectCreated(hoXml))) Begin
        Send CreateComObject of hoXml
    End
    Get ComBodyStr Of hoResp To sTemp1
    Get ComLoadXml Of hoXml sTemp1 To iSuccess

    Get ComStatusCode Of hoResp To iTemp1
    If (iTemp1 <> 200) Begin
        Get ComStatusCode Of hoResp To iTemp1
        Showln "Response status code = " iTemp1
        Get ComGetXml Of hoXml To sTemp1
        Showln sTemp1
        Showln "Failed"
        Procedure_Return
    End

    // Show the successful XML response.
    Get ComGetXml Of hoXml To sTemp1
    Showln sTemp1
    Showln "Success."

    // A successful XML response looks like this:
    // <?xml version="1.0" encoding="utf-8" ?>
    // <d:CheckOut xmlns:d="http://schemas.microsoft.com/ado/2007/08/dataservices" 
    // 	xmlns:m="http://schemas.microsoft.com/ado/2007/08/dataservices/metadata"
    // 	xmlns:georss="http://www.georss.org/georss" 
    // 	xmlns:gml="http://www.opengis.net/gml" m:null="true" />
    // 
    // 


End_Procedure