(Tcl) 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 Tcl Extension Downloads Chilkat Tcl Extension Downloads

load ./chilkat.dll

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

set http [new_CkHttp]

# If SharePoint Windows classic authentication is used, then set the 
# Login, Password, LoginDomain, and NtlmAuth properties.
CkHttp_put_Login $http "SHAREPOINT_USERNAME"
CkHttp_put_Password $http "SHAREPOINT_PASSWORD"
CkHttp_put_LoginDomain $http "SHAREPOINT_NTLM_DOMAIN"
CkHttp_put_NtlmAuth $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_put_Accept $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.
# 

set req [new_CkHttpRequest]

CkHttpRequest_put_HttpVerb $req "POST"
CkHttpRequest_put_Path $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_AddHeader $req "X-RequestDigest" "SHAREPOINT_FORM_DIGEST"

# Send the request to approve the document.
set bUseTls 1
# resp is a CkHttpResponse
set resp [CkHttp_SynchronousRequest $http "SHAREPOINT_HTTPS_DOMAIN" 443 $bUseTls $req]
if {[CkHttp_get_LastMethodSuccess $http] != 1} then {
    puts [CkHttp_lastErrorText $http]
    delete_CkHttp $http
    delete_CkHttpRequest $req
    exit
}

# 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_get_StatusCode $resp] != 200} then {
    puts "Response status code = [CkHttpResponse_get_StatusCode $resp]"
    set json [new_CkJsonObject]

    CkJsonObject_Load $json [CkHttpResponse_bodyStr $resp]
    CkJsonObject_put_EmitCompact $json 0
    puts [CkJsonObject_emit $json]
    puts "Failed"
    delete_CkHttpResponse $resp

    delete_CkHttp $http
    delete_CkHttpRequest $req
    delete_CkJsonObject $json
    exit
}

delete_CkHttpResponse $resp

puts "Success."

delete_CkHttp $http
delete_CkHttpRequest $req
delete_CkJsonObject $json