(PureBasic) SharePoint -- Approve a File Submitted for Content Approval

Approves the file submitted for content approval with the specified comment.

Note: The SharePoint list or library should have the settings enabled to require approval for submitted items. This is done in the "Versioning Settings" for the list or library.

Chilkat PureBasic Module Download Chilkat PureBasic Module

IncludeFile "CkHttpResponse.pb"
IncludeFile "CkHttp.pb"
IncludeFile "CkJsonObject.pb"
IncludeFile "CkHttpRequest.pb"

Procedure ChilkatExample()

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

    http.i = CkHttp::ckCreate()
    If http.i = 0
        Debug "Failed to create object."
        ProcedureReturn
    EndIf

    ;  If SharePoint Windows classic authentication is used, then set the
    ;  Login, Password, LoginDomain, and NtlmAuth properties.
    CkHttp::setCkLogin(http, "SHAREPOINT_USERNAME")
    CkHttp::setCkPassword(http, "SHAREPOINT_PASSWORD")
    CkHttp::setCkLoginDomain(http, "SHAREPOINT_NTLM_DOMAIN")
    CkHttp::setCkNtlmAuth(http, 1)

    ;  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

    ;  Indicate that we want a JSON reply
    CkHttp::setCkAccept(http, "application/json;odata=verbose")

    ;  Only persons who have Full Control or Design permissions can approve or reject
    ;  items or files in a list or library that requires approval. Other site users
    ;  can only view what they have permission to view or what they have uploaded
    ;  themselves.
    ; 
    ;  Important:  Approval or rejection of items or files in lists or libraries must
    ;  be done one at a time. You cannot approve or reject multiple items or files in
    ;  one operation.
    ; 

    req.i = CkHttpRequest::ckCreate()
    If req.i = 0
        Debug "Failed to create object."
        ProcedureReturn
    EndIf

    CkHttpRequest::setCkHttpVerb(req, "POST")
    CkHttpRequest::setCkPath(req, "/_api/web/GetFileByServerRelativeUrl('/ChilkatDocLibrary/sample.docx')/approve(comment='Check-in comment for the approval.')")

    ;  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
    CkHttpRequest::ckAddHeader(req,"X-RequestDigest","SHAREPOINT_FORM_DIGEST")

    ;  Send the request to approve the document.
    bUseTls.i = 1
    resp.i = CkHttp::ckSynchronousRequest(http,"SHAREPOINT_HTTPS_DOMAIN",443,bUseTls,req)
    If CkHttp::ckLastMethodSuccess(http) <> 1
        Debug CkHttp::ckLastErrorText(http)
        CkHttp::ckDispose(http)
        CkHttpRequest::ckDispose(req)
        ProcedureReturn
    EndIf

    ;  A successful update will return a 200 status code with an empty body.
    ;  A non-successful update will return a JSON response body..
    If CkHttpResponse::ckStatusCode(resp) <> 200
        Debug "Response status code = " + Str(CkHttpResponse::ckStatusCode(resp))
        json.i = CkJsonObject::ckCreate()
        If json.i = 0
            Debug "Failed to create object."
            ProcedureReturn
        EndIf

        CkJsonObject::ckLoad(json,CkHttpResponse::ckBodyStr(resp))
        CkJsonObject::setCkEmitCompact(json, 0)
        Debug CkJsonObject::ckEmit(json)
        Debug "Failed"
        CkHttpResponse::ckDispose(resp)

        CkHttp::ckDispose(http)
        CkHttpRequest::ckDispose(req)
        CkJsonObject::ckDispose(json)
        ProcedureReturn
    EndIf

    CkHttpResponse::ckDispose(resp)

    Debug "Success."


    CkHttp::ckDispose(http)
    CkHttpRequest::ckDispose(req)
    CkJsonObject::ckDispose(json)


    ProcedureReturn
EndProcedure