Merge remote-tracking branch 'origin/master' into release

Author: dynabic-billing-team

README.md

@@ -16,6 +16,14 @@ Feel free to explore the [Developer's Guide](https://docs.aspose.cloud/display/w
 - Add & remove watermarks and protection.
 - Read & write access to Document Object Model.
 
+## Enhancements in Version 23.12
+
+- Properties Name, Text, StartRange, EndRange marked as required for InsertBookmark operation.
+- Implemented DeleteOfficeMathObjects operation to delete all office math objects from document.
+- Parameter ProtectionRequest was removed from the UnprotectDocument operation. Now removing protection from a document does not require a password.
+- Model ProtectionRequest marked as deprecated, please use ProtectionRequestV2 instead for perform ProtectDocument operation. To change the password or protection type of protected document, the old password is no required.
+
+
 ## Enhancements in Version 23.11
 
 - Support of required properties in models.

dev/api/api_client.go

@@ -65,7 +65,7 @@ var (
     xmlCheck = regexp.MustCompile("(?i:[application|text]/xml)")
 )
 
-// APIClient manages communication with the Aspose.Words for Cloud API Reference API v23.11
+// APIClient manages communication with the Aspose.Words for Cloud API Reference API v23.12
 // In most cases there should be only one, shared, APIClient.
 type APIClient struct {
     cfg     *models.Configuration

dev/api/models/bookmark_insert.go

@@ -67,9 +67,6 @@ func (BookmarkInsert) IsBookmarkInsert() bool {
     return true
 }
 
-func (BookmarkInsert) IsBookmarkData() bool {
-    return true
-}
 
 func (obj *BookmarkInsert) Initialize() {
     if (obj.StartRange != nil) {
@@ -150,6 +147,18 @@ func (obj *BookmarkInsert) Validate() error {
         return errors.New("Invalid object.")
     }
 
+    if obj.Name == nil {
+        return errors.New("Property Name in BookmarkInsert is required.")
+    }
+    if obj.Text == nil {
+        return errors.New("Property Text in BookmarkInsert is required.")
+    }
+    if obj.StartRange == nil {
+        return errors.New("Property StartRange in BookmarkInsert is required.")
+    }
+    if obj.EndRange == nil {
+        return errors.New("Property EndRange in BookmarkInsert is required.")
+    }
     if obj.StartRange != nil {
         if err := obj.StartRange.Validate(); err != nil {
             return err

dev/api/models/compare_data.go

@@ -47,6 +47,8 @@ type ICompareData interface {
     SetComparingWithDocument(value *string)
     GetDateTime() *Time
     SetDateTime(value *Time)
+    GetFileReference() IFileReference
+    SetFileReference(value IFileReference)
     GetResultDocumentFormat() *string
     SetResultDocumentFormat(value *string)
 }
@@ -64,6 +66,9 @@ type CompareData struct {
     // Container class for compare documents.
     DateTime *Time `json:"DateTime,omitempty"`
 
+    // Container class for compare documents.
+    FileReference IFileReference `json:"FileReference,omitempty"`
+
     // Container class for compare documents.
     ResultDocumentFormat *string `json:"ResultDocumentFormat,omitempty"`
 }
@@ -78,6 +83,10 @@ func (obj *CompareData) Initialize() {
         obj.CompareOptions.Initialize()
     }
 
+    if (obj.FileReference != nil) {
+        obj.FileReference.Initialize()
+    }
+
 
 }
 
@@ -136,6 +145,22 @@ func (obj *CompareData) Deserialize(json map[string]interface{}) {
 
     }
 
+    if jsonValue, exists := json["FileReference"]; exists {
+        if parsedValue, valid := jsonValue.(map[string]interface{}); valid {
+            var modelInstance IFileReference = new(FileReference)
+            modelInstance.Deserialize(parsedValue)
+            obj.FileReference = modelInstance
+        }
+
+    } else if jsonValue, exists := json["fileReference"]; exists {
+        if parsedValue, valid := jsonValue.(map[string]interface{}); valid {
+            var modelInstance IFileReference = new(FileReference)
+            modelInstance.Deserialize(parsedValue)
+            obj.FileReference = modelInstance
+        }
+
+    }
+
     if jsonValue, exists := json["ResultDocumentFormat"]; exists {
         if parsedValue, valid := jsonValue.(string); valid {
             obj.ResultDocumentFormat = &parsedValue
@@ -150,6 +175,11 @@ func (obj *CompareData) Deserialize(json map[string]interface{}) {
 }
 
 func (obj *CompareData) CollectFilesContent(resultFilesContent []FileReference) []FileReference {
+    if (obj.FileReference != nil) {
+        resultFilesContent = obj.FileReference.CollectFilesContent(resultFilesContent)
+    }
+
+
     return resultFilesContent
 }
 
@@ -161,14 +191,19 @@ func (obj *CompareData) Validate() error {
     if obj.Author == nil {
         return errors.New("Property Author in CompareData is required.")
     }
-    if obj.ComparingWithDocument == nil {
-        return errors.New("Property ComparingWithDocument in CompareData is required.")
+    if obj.FileReference == nil {
+        return errors.New("Property FileReference in CompareData is required.")
     }
     if obj.CompareOptions != nil {
         if err := obj.CompareOptions.Validate(); err != nil {
             return err
         }
     }
+    if obj.FileReference != nil {
+        if err := obj.FileReference.Validate(); err != nil {
+            return err
+        }
+    }
 
     return nil;
 }
@@ -205,6 +240,14 @@ func (obj *CompareData) SetDateTime(value *Time) {
     obj.DateTime = value
 }
 
+func (obj *CompareData) GetFileReference() IFileReference {
+    return obj.FileReference
+}
+
+func (obj *CompareData) SetFileReference(value IFileReference) {
+    obj.FileReference = value
+}
+
 func (obj *CompareData) GetResultDocumentFormat() *string {
     return obj.ResultDocumentFormat
 }

dev/api/models/compare_document_online_request.go

@@ -44,7 +44,6 @@ type CompareDocumentOnlineRequest struct {
         // Compare data.
         CompareData ICompareData
     /* optional (nil or map[string]interface{}) with one or more of key / value pairs:
-        key: "comparingDocument" value: (io.ReadCloser) The comparing document.
         key: "loadEncoding" value: (*string) Encoding that will be used to load an HTML (or TXT) document if the encoding is not specified in HTML.
         key: "password" value: (*string) Password of protected Word document. Use the parameter to pass a password via SDK. SDK encrypts it automatically. We don't recommend to use the parameter to pass a plain password for direct call of API.
         key: "encryptedPassword" value: (*string) Password of protected Word document. Use the parameter to pass an encrypted password for direct calls of API. See SDK code for encyption details.
@@ -142,17 +141,7 @@ func (data *CompareDocumentOnlineRequest) CreateRequestData() (RequestData, erro
     }
 
     result.FormParams = append(result.FormParams, NewJsonFormParamContainer("CompareData", parameterToString(data.CompareData, "")))
-
-    var comparingDocument (io.ReadCloser)
-    if localVarTempParam, localVarOk := data.Optionals["comparingDocument"].(io.ReadCloser); localVarOk {
-        comparingDocument = localVarTempParam
-    }
-    _comparingDocument := comparingDocument
-    if _comparingDocument != nil {
-        fbs, _ := ioutil.ReadAll(_comparingDocument)
-        _comparingDocument.Close()
-        result.FormParams = append(result.FormParams, NewFileFormParamContainer("comparingDocument", fbs))
-    }
+    filesContentData = data.CompareData.CollectFilesContent(filesContentData)
 
 
     for _, fileContentData := range filesContentData {

dev/api/models/compare_document_request.go

@@ -153,6 +153,7 @@ func (data *CompareDocumentRequest) CreateRequestData() (RequestData, error) {
 
 
     result.FormParams = append(result.FormParams, NewJsonFormParamContainer("CompareData", parameterToString(data.CompareData, "")))
+    filesContentData = data.CompareData.CollectFilesContent(filesContentData)
 
 
     for _, fileContentData := range filesContentData {

dev/api/models/configuration.go

@@ -99,7 +99,7 @@ func NewConfiguration(configFilePath string) (pConfig *Configuration, err error)
 	cfg := Configuration{
 		BaseUrl:       "https://api.aspose.cloud",
 		DebugMode:     false,
-		DefaultHeader: map[string]string{"x-aspose-client": "go sdk", "x-aspose-client-version": "23.11"},
+		DefaultHeader: map[string]string{"x-aspose-client": "go sdk", "x-aspose-client-version": "23.12"},
 	}
 	err = json.Unmarshal(data, &cfg)
 

dev/api/models/delete_office_math_objects_online_request.go

@@ -0,0 +1,149 @@
+/*
+ * --------------------------------------------------------------------------------
+ * <copyright company="Aspose" file="delete_office_math_objects_online_request.go">
+ *   Copyright (c) 2023 Aspose.Words for Cloud
+ * </copyright>
+ * <summary>
+ *   Permission is hereby granted, free of charge, to any person obtaining a copy
+ *  of this software and associated documentation files (the "Software"), to deal
+ *  in the Software without restriction, including without limitation the rights
+ *  to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ *  copies of the Software, and to permit persons to whom the Software is
+ *  furnished to do so, subject to the following conditions:
+ * 
+ *  The above copyright notice and this permission notice shall be included in all
+ *  copies or substantial portions of the Software.
+ * 
+ *  THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ *  IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ *  FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ *  AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ *  LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ *  OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ *  SOFTWARE.
+ * </summary>
+ * --------------------------------------------------------------------------------
+ */
+
+package models
+
+import (
+    "errors"
+    "io/ioutil"
+    "net/url"
+    "strings"
+    "io"
+)
+
+// DeleteOfficeMathObjectsOnlineRequest contains request data for WordsApiService.DeleteOfficeMathObjectsOnline method.
+type DeleteOfficeMathObjectsOnlineRequest struct {
+        // The document.
+        Document io.ReadCloser
+    /* optional (nil or map[string]interface{}) with one or more of key / value pairs:
+        key: "loadEncoding" value: (*string) Encoding that will be used to load an HTML (or TXT) document if the encoding is not specified in HTML.
+        key: "password" value: (*string) Password of protected Word document. Use the parameter to pass a password via SDK. SDK encrypts it automatically. We don't recommend to use the parameter to pass a plain password for direct call of API.
+        key: "encryptedPassword" value: (*string) Password of protected Word document. Use the parameter to pass an encrypted password for direct calls of API. See SDK code for encyption details.
+        key: "destFileName" value: (*string) Result path of the document after the operation. If this parameter is omitted then result of the operation will be saved as the source document.
+        key: "revisionAuthor" value: (*string) Initials of the author to use for revisions.If you set this parameter and then make some changes to the document programmatically, save the document and later open the document in MS Word you will see these changes as revisions.
+        key: "revisionDateTime" value: (*string) The date and time to use for revisions. */
+    Optionals map[string]interface{}
+}
+
+
+func (data *DeleteOfficeMathObjectsOnlineRequest) CreateRequestData() (RequestData, error) {
+    var result RequestData
+    var filesContentData = make([]FileReference, 0)
+    if data == nil {
+        return result, errors.New("Invalid object.")
+    }
+
+    result.Method = strings.ToUpper("put")
+
+    // create path and map variables
+    result.Path = "/words/online/delete/OfficeMathObjects"
+
+    result.Path = strings.Replace(result.Path, "/<nil>", "", -1)
+    result.Path = strings.Replace(result.Path, "//", "/", -1)
+
+    result.HeaderParams = make(map[string]string)
+    result.QueryParams = url.Values{}
+    result.FormParams = make([]FormParamContainer, 0)
+
+    if (data.Document == nil) {
+        return result, errors.New("Parameter Document is required.")
+    }
+
+
+    if err := typeCheckParameter(data.Optionals["loadEncoding"], "string", "data.Optionals[loadEncoding]"); err != nil {
+        return result, err
+    }
+    if err := typeCheckParameter(data.Optionals["password"], "string", "data.Optionals[password]"); err != nil {
+        return result, err
+    }
+    if err := typeCheckParameter(data.Optionals["encryptedPassword"], "string", "data.Optionals[encryptedPassword]"); err != nil {
+        return result, err
+    }
+    if err := typeCheckParameter(data.Optionals["destFileName"], "string", "data.Optionals[destFileName]"); err != nil {
+        return result, err
+    }
+    if err := typeCheckParameter(data.Optionals["revisionAuthor"], "string", "data.Optionals[revisionAuthor]"); err != nil {
+        return result, err
+    }
+    if err := typeCheckParameter(data.Optionals["revisionDateTime"], "string", "data.Optionals[revisionDateTime]"); err != nil {
+        return result, err
+    }
+
+
+
+    if localVarTempParam, localVarOk := data.Optionals["loadEncoding"].(string); localVarOk {
+        result.QueryParams.Add("LoadEncoding", parameterToString(localVarTempParam, ""))
+    }
+
+
+    if localVarTempParam, localVarOk := data.Optionals["password"].(string); localVarOk {
+        result.QueryParams.Add("Password", parameterToString(localVarTempParam, ""))
+    }
+
+
+    if localVarTempParam, localVarOk := data.Optionals["encryptedPassword"].(string); localVarOk {
+        result.QueryParams.Add("EncryptedPassword", parameterToString(localVarTempParam, ""))
+    }
+
+
+    if localVarTempParam, localVarOk := data.Optionals["destFileName"].(string); localVarOk {
+        result.QueryParams.Add("DestFileName", parameterToString(localVarTempParam, ""))
+    }
+
+
+    if localVarTempParam, localVarOk := data.Optionals["revisionAuthor"].(string); localVarOk {
+        result.QueryParams.Add("RevisionAuthor", parameterToString(localVarTempParam, ""))
+    }
+
+
+    if localVarTempParam, localVarOk := data.Optionals["revisionDateTime"].(string); localVarOk {
+        result.QueryParams.Add("RevisionDateTime", parameterToString(localVarTempParam, ""))
+    }
+
+
+
+    _document := data.Document
+    if _document != nil {
+        fbs, _ := ioutil.ReadAll(_document)
+        _document.Close()
+        result.FormParams = append(result.FormParams, NewFileFormParamContainer("document", fbs))
+    }
+
+
+    for _, fileContentData := range filesContentData {
+        fbs, _ := ioutil.ReadAll(fileContentData.Content)
+        result.FormParams = append(result.FormParams, NewFileFormParamContainer(fileContentData.Reference, fbs))
+    }
+
+    return result, nil
+}
+
+func (data *DeleteOfficeMathObjectsOnlineRequest) CreateResponse(reader io.Reader, boundary string) (response interface{}, err error) {
+            var successPayload map[string]io.Reader
+            successPayload, err = ParseReadCloserFilesCollection(reader, boundary)
+            return successPayload, err
+}