Chilkat HOME .NET Core C# Android™ AutoIt C C# C++ Chilkat2-Python CkPython Classic ASP DataFlex Delphi ActiveX Delphi DLL Go Java Lianja Mono C# Node.js Objective-C PHP ActiveX PHP Extension Perl PowerBuilder PowerShell PureBasic Ruby SQL Server Swift 2 Swift 3,4,5... Tcl Unicode C Unicode C++ VB.NET VBScript Visual Basic 6.0 Visual FoxPro Xojo Plugin
(PHP ActiveX) SharePoint -- Rename FolderThis example shows how to rename SharePoint folder. Renaming a folder is not straightforward. Apparently, the information published by Microsoft is incorrect and simply doesn't work (the information about how to update a folder by using the MERGE method is incorrect). To rename a folder requires two steps, as demonstrated by this example.
<?php // This requires the Chilkat API to have been previously unlocked. // See Global Unlock Sample for sample code. // For versions of Chilkat < 10.0.0, use new COM('Chilkat_9_5_0.Chilkat.Http') $http = new COM("Chilkat.Http"); // If SharePoint Windows classic authentication is used, then set the // Login, Password, LoginDomain, and NtlmAuth properties. $http->Login = 'SHAREPOINT_USERNAME'; $http->Password = 'SHAREPOINT_PASSWORD'; $http->LoginDomain = 'SHAREPOINT_NTLM_DOMAIN'; $http->NtlmAuth = 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 // The first step in renaming a file is send a GET to the /ListItemAllFields endpoint: // Indicate we want a JSON response. $http->SetRequestHeader('Accept','application/json;odata=verbose'); // In this example, we want to rename the folder "/Documents/ChilkatTest" to "/Documents/ChilkatTest2" // If your Sharepoint site is within a site collection, then use "https://SHAREPOINT_HTTPS_DOMAIN/sites/teamA/_api/web/GetFolderByServerRelativeUrl('/sites/teamA/Documents/ChilkatTest')/ListItemAllFields" where "teamA" is the name of the site. $sAllFields = $http->quickGetStr('https://SHAREPOINT_HTTPS_DOMAIN/_api/web/GetFolderByServerRelativeUrl('/Documents/ChilkatTest')/ListItemAllFields'); if ($http->LastMethodSuccess != 1) { print $http->LastErrorText . "\n"; exit; } // For versions of Chilkat < 10.0.0, use new COM('Chilkat_9_5_0.Chilkat.JsonObject') $json = new COM("Chilkat.JsonObject"); $json->Load($sAllFields); $json->EmitCompact = 0; print $json->emit() . "\n"; // The JSON response will look like this: // We'll need to get the "id", "etag", and "type" for the next step. The "id" for the // sample below is "Web/Lists(guid'b0d92cec-4be1-4e52-943d-ebcb432e1c3b')/Items(62)" // // { // "d": { // "__metadata": { // "id": "Web/Lists(guid'b0d92cec-4be1-4e52-943d-ebcb432e1c3b')/Items(62)", // "uri": "https://SHAREPOINT_HTTPS_DOMAIN/_api/Web/Lists(guid'b0d92cec-4be1-4e52-943d-ebcb432e1c3b')/Items(62)", // "etag": "\"4\"", // "type": "SP.Data.DocumentsItem" // }, // ... // ... // "FileSystemObjectType": 1, // "Id": 62, // "ContentTypeId": "0x012000FA905915D7D8F7458C1A0AF1E981BFF5", // "Title": "ChilkatTest", // "OData__dlc_DocId": null, // "OData__dlc_DocIdUrl": null, // "URL": null, // "DocumentSetDescription": null, // "EditorId": 25, // "ID": 62, // "Created": "2017-04-12T19:18:29", // "AuthorId": 25, // "Modified": "2017-04-12T19:49:15", // "OData__CopySource": null, // "CheckoutUserId": null, // "OData__UIVersionString": "1.0", // "GUID": "71f30f44-e33a-48e7-b4d8-9d619ba1ad69" // } // } // ------------------------------------------------------------------------------- // Step 2... // To rename a folder, we're going to POST to // https://SHAREPOINT_HTTPS_DOMAIN/_api/Web/Lists(guid'b0d92cec-4be1-4e52-943d-ebcb432e1c3b')/Items(62) // with a request body containing the following JSON: // // { "__metadata": { "type": "THE_TYPE_FROM_ABOVE" }, "Title": "New title", "FileLeafRef": "New title"} // // Build the Path, which is "/_api/" + the id from above. // For versions of Chilkat < 10.0.0, use new COM('Chilkat_9_5_0.Chilkat.StringBuilder') $sbPath = new COM("Chilkat.StringBuilder"); $sbPath->Append('/_api/'); $sbPath->Append($json->stringOf('d.__metadata.id')); // For versions of Chilkat < 10.0.0, use new COM('Chilkat_9_5_0.Chilkat.HttpRequest') $req = new COM("Chilkat.HttpRequest"); $req->HttpVerb = 'POST'; $req->Path = $sbPath->getAsString(); // 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 $req->AddHeader('X-RequestDigest','SHAREPOINT_FORM_DIGEST'); // Set the Content-Type, and indicate that a JSON response is desired. $req->ContentType = 'application/json;odata=verbose'; $req->AddHeader('Accept','application/json;odata=verbose'); // We need a few more headers... $req->AddHeader('IF-MATCH',$json->stringOf('d.__metadata.etag')); $req->AddHeader('X-HTTP-Method','MERGE'); // Create and add the JSON body. // For versions of Chilkat < 10.0.0, use new COM('Chilkat_9_5_0.Chilkat.JsonObject') $jsonBody = new COM("Chilkat.JsonObject"); $jsonBody->UpdateString('__metadata.type',$json->stringOf('d.__metadata.type')); $jsonBody->UpdateString('Title','ChilkatTest2'); $jsonBody->UpdateString('FileLeafRef','ChilkatTest2'); $req->LoadBodyFromString($jsonBody->emit(),'utf-8'); // Send the POST using HTTPS. $bUseTls = 1; // resp is a Chilkat.HttpResponse $resp = $http->SynchronousRequest('SHAREPOINT_HTTPS_DOMAIN',443,$bUseTls,$req); if ($http->LastMethodSuccess != 1) { print $http->LastErrorText . "\n"; exit; } // The response body contains JSON. // When successful, it will be empty. $json->Load($resp->BodyStr); $json->EmitCompact = 0; print 'Response status code = ' . $resp->StatusCode . "\n"; // The expected success response code is 204. if ($resp->StatusCode != 204) { print 'Response status code = ' . $resp->StatusCode . "\n"; print $json->emit() . "\n"; print 'Failed' . "\n"; exit; } // The response body is empty for a 204 (success) response... print 'Success.' . "\n"; ?> |
© 2000-2024 Chilkat Software, Inc. All Rights Reserved.