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

Author: dynabic-billing-team

CHANGELOG.md

@@ -1,3 +1,12 @@
+## [24.9.0] - Aspose Words Cloud for Dart 24.9 Release Notes
+
+- Added digital signature methds for DOC, DOCX, XPS, or ODT documents.
+- Added ReplaceBackslashWithYenSign property for XpsSaveOptions and HtmlSaveOptions.
+- Added DigitalSignature property for XpsSaveOptions.
+- Added UseSdtTagAsFormFieldName property for PdfSaveOptions.
+- Added MergeWholeDocument parameter to the MailMerge operations to update fields in whole document after executing of a mail merge with regions.
+
+
 ## [24.8.0] - Aspose Words Cloud for Dart 24.8 Release Notes
 
 - Added the support of OpenType standard. It is usefull for languages required advanced typography.

README.md

@@ -27,7 +27,7 @@ Add this dependency to your *pubspec.yaml*:
 
 ```yaml
 dependencies:
-  aspose_words_cloud: 24.8.0
+  aspose_words_cloud: 24.9.0
 ```
 
 ## Getting Started

lib/aspose_words_cloud.dart

@@ -68,6 +68,7 @@ export 'src/models/custom_xml_part_update.dart';
 export 'src/models/custom_xml_part.dart';
 export 'src/models/custom_xml_parts_collection.dart';
 export 'src/models/custom_xml_parts_response.dart';
+export 'src/models/digital_signature_details.dart';
 export 'src/models/doc_save_options_data.dart';
 export 'src/models/docm_save_options_data.dart';
 export 'src/models/document_entry_list.dart';
@@ -249,6 +250,9 @@ export 'src/models/section_page_setup_response.dart';
 export 'src/models/section_response.dart';
 export 'src/models/section.dart';
 export 'src/models/shading.dart';
+export 'src/models/sign_options.dart';
+export 'src/models/signature_collection_response.dart';
+export 'src/models/signature.dart';
 export 'src/models/split_document_response.dart';
 export 'src/models/split_document_result.dart';
 export 'src/models/stat_data_response.dart';
@@ -497,6 +501,8 @@ export 'src/requests/get_section_page_setup_request.dart';
 export 'src/requests/get_section_request.dart';
 export 'src/requests/get_sections_online_request.dart';
 export 'src/requests/get_sections_request.dart';
+export 'src/requests/get_signatures_online_request.dart';
+export 'src/requests/get_signatures_request.dart';
 export 'src/requests/get_structured_document_tag_online_request.dart';
 export 'src/requests/get_structured_document_tag_request.dart';
 export 'src/requests/get_structured_document_tags_online_request.dart';
@@ -577,6 +583,8 @@ export 'src/requests/protect_document_online_request.dart';
 export 'src/requests/protect_document_request.dart';
 export 'src/requests/reject_all_revisions_online_request.dart';
 export 'src/requests/reject_all_revisions_request.dart';
+export 'src/requests/remove_all_signatures_online_request.dart';
+export 'src/requests/remove_all_signatures_request.dart';
 export 'src/requests/remove_range_online_request.dart';
 export 'src/requests/remove_range_request.dart';
 export 'src/requests/render_drawing_object_online_request.dart';
@@ -603,6 +611,8 @@ export 'src/requests/save_as_tiff_online_request.dart';
 export 'src/requests/save_as_tiff_request.dart';
 export 'src/requests/search_online_request.dart';
 export 'src/requests/search_request.dart';
+export 'src/requests/sign_document_online_request.dart';
+export 'src/requests/sign_document_request.dart';
 export 'src/requests/split_document_online_request.dart';
 export 'src/requests/split_document_request.dart';
 export 'src/requests/translate_node_id_online_request.dart';
@@ -688,13 +698,15 @@ export 'src/responses/insert_watermark_online_response.dart';
 export 'src/responses/insert_watermark_text_online_response.dart';
 export 'src/responses/protect_document_online_response.dart';
 export 'src/responses/reject_all_revisions_online_response.dart';
+export 'src/responses/remove_all_signatures_online_response.dart';
 export 'src/responses/remove_range_online_response.dart';
 export 'src/responses/replace_text_online_response.dart';
 export 'src/responses/replace_with_text_online_response.dart';
 export 'src/responses/response_base.dart';
 export 'src/responses/save_as_online_response.dart';
 export 'src/responses/save_as_range_online_response.dart';
 export 'src/responses/save_as_tiff_online_response.dart';
+export 'src/responses/sign_document_online_response.dart';
 export 'src/responses/split_document_online_response.dart';
 export 'src/responses/unprotect_document_online_response.dart';
 export 'src/responses/update_bookmark_online_response.dart';

lib/src/api_client.dart

@@ -518,7 +518,7 @@ class ApiClient {
     }
 
     httpRequest.headers['x-aspose-client'] = 'dart sdk';
-    httpRequest.headers['x-aspose-client-version'] = '24.8';
+    httpRequest.headers['x-aspose-client-version'] = '24.9';
     httpRequest.headers['Authorization'] = await _getAuthToken();
     httpRequest.headers.addAll(requestData.headers);
 

lib/src/models/azw3_save_options_data.dart

@@ -376,6 +376,12 @@ class Azw3SaveOptionsData extends HtmlSaveOptionsData {
       prettyFormat = null;
     }
 
+    if (json.containsKey('ReplaceBackslashWithYenSign')) {
+      replaceBackslashWithYenSign = json['ReplaceBackslashWithYenSign'] as bool;
+    } else {
+      replaceBackslashWithYenSign = null;
+    }
+
     if (json.containsKey('ResolveFontNames')) {
       resolveFontNames = json['ResolveFontNames'] as bool;
     } else {

lib/src/models/digital_signature_details.dart

@@ -0,0 +1,92 @@
+/*
+ * --------------------------------------------------------------------------------
+ * <copyright company="Aspose" file="digital_signature_details.dart">
+ *   Copyright (c) 2024 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>
+ * --------------------------------------------------------------------------------
+ */
+
+library aspose_words_cloud;
+
+import '../../aspose_words_cloud.dart';
+
+/// Container class for details of digital signature.
+class DigitalSignatureDetails implements ModelBase {
+  /// Gets or sets the certificate's filename using for signing.
+  String? _certificateFilename;
+
+  String? get certificateFilename => _certificateFilename;
+  set certificateFilename(String? val) => _certificateFilename = val;
+
+
+  /// Gets or sets signing options.
+  SignOptions? _signOptions;
+
+  SignOptions? get signOptions => _signOptions;
+  set signOptions(SignOptions? val) => _signOptions = val;
+
+
+  @override
+  void deserialize(Map<String, dynamic>? json) {
+    if (json == null) {
+      throw ApiException(400, 'Failed to deserialize DigitalSignatureDetails data model.');
+    }
+
+    if (json.containsKey('CertificateFilename')) {
+      certificateFilename = json['CertificateFilename'] as String;
+    } else {
+      certificateFilename = null;
+    }
+
+    if (json.containsKey('SignOptions')) {
+      signOptions = ModelBase.createInstance< SignOptions >(json['SignOptions'] as Map<String, dynamic>);
+    } else {
+      signOptions = null;
+    }
+  }
+
+  @override
+  Map<String, dynamic> serialize() {
+    var _result = <String, dynamic>{};
+    if (certificateFilename != null) {
+      _result['CertificateFilename'] = certificateFilename!;
+    }
+
+    if (signOptions != null) {
+      _result['SignOptions'] = signOptions!.serialize();
+    }
+    return _result;
+  }
+
+  @override
+  void getFilesContent(List<FileReference> resultFilesContent) {
+  }
+
+  @override
+  void validate() {
+
+    signOptions?.validate();
+
+  }
+}
+
+

lib/src/models/epub_save_options_data.dart

@@ -376,6 +376,12 @@ class EpubSaveOptionsData extends HtmlSaveOptionsData {
       prettyFormat = null;
     }
 
+    if (json.containsKey('ReplaceBackslashWithYenSign')) {
+      replaceBackslashWithYenSign = json['ReplaceBackslashWithYenSign'] as bool;
+    } else {
+      replaceBackslashWithYenSign = null;
+    }
+
     if (json.containsKey('ResolveFontNames')) {
       resolveFontNames = json['ResolveFontNames'] as bool;
     } else {

lib/src/models/html_save_options_data.dart

@@ -276,6 +276,17 @@ class HtmlSaveOptionsData extends SaveOptionsData {
   set prettyFormat(bool? val) => _prettyFormat = val;
 
 
+  /// Gets or sets the flag that indicates whether backslash characters should be replaced with yen signs.
+  /// Default value is false.
+  /// By default, Aspose.Words mimics MS Word's behavior and doesn't replace backslash characters with yen signs in
+  /// generated HTML documents. However, previous versions of Aspose.Words performed such replacements in certain
+  /// scenarios. This flag enables backward compatibility with previous versions of Aspose.Words.
+  bool? _replaceBackslashWithYenSign;
+
+  bool? get replaceBackslashWithYenSign => _replaceBackslashWithYenSign;
+  set replaceBackslashWithYenSign(bool? val) => _replaceBackslashWithYenSign = val;
+
+
   /// Gets or sets a value indicating whether font family names used in the document are resolved and substituted according to FontSettings when being written into HTML-based formats.
   /// The default value is false.
   bool? _resolveFontNames;
@@ -650,6 +661,12 @@ class HtmlSaveOptionsData extends SaveOptionsData {
       prettyFormat = null;
     }
 
+    if (json.containsKey('ReplaceBackslashWithYenSign')) {
+      replaceBackslashWithYenSign = json['ReplaceBackslashWithYenSign'] as bool;
+    } else {
+      replaceBackslashWithYenSign = null;
+    }
+
     if (json.containsKey('ResolveFontNames')) {
       resolveFontNames = json['ResolveFontNames'] as bool;
     } else {
@@ -859,6 +876,10 @@ class HtmlSaveOptionsData extends SaveOptionsData {
       _result['PrettyFormat'] = prettyFormat!;
     }
 
+    if (replaceBackslashWithYenSign != null) {
+      _result['ReplaceBackslashWithYenSign'] = replaceBackslashWithYenSign!;
+    }
+
     if (resolveFontNames != null) {
       _result['ResolveFontNames'] = resolveFontNames!;
     }

lib/src/models/mhtml_save_options_data.dart

@@ -377,6 +377,12 @@ class MhtmlSaveOptionsData extends HtmlSaveOptionsData {
       prettyFormat = null;
     }
 
+    if (json.containsKey('ReplaceBackslashWithYenSign')) {
+      replaceBackslashWithYenSign = json['ReplaceBackslashWithYenSign'] as bool;
+    } else {
+      replaceBackslashWithYenSign = null;
+    }
+
     if (json.containsKey('ResolveFontNames')) {
       resolveFontNames = json['ResolveFontNames'] as bool;
     } else {

lib/src/models/model_base.dart

@@ -72,6 +72,7 @@ abstract class ModelBase {
     'CustomXmlPartsCollection, _': () => CustomXmlPartsCollection(),
     'CustomXmlPartsResponse, _': () => CustomXmlPartsResponse(),
     'CustomXmlPartUpdate, _': () => CustomXmlPartUpdate(),
+    'DigitalSignatureDetails, _': () => DigitalSignatureDetails(),
     'DocmSaveOptionsData, _': () => DocmSaveOptionsData(),
     'DocSaveOptionsData, _': () => DocSaveOptionsData(),
     'Document, _': () => Document(),
@@ -240,6 +241,9 @@ abstract class ModelBase {
     'SectionPageSetupResponse, _': () => SectionPageSetupResponse(),
     'SectionResponse, _': () => SectionResponse(),
     'Shading, _': () => Shading(),
+    'Signature, _': () => Signature(),
+    'SignatureCollectionResponse, _': () => SignatureCollectionResponse(),
+    'SignOptions, _': () => SignOptions(),
     'SplitDocumentResponse, _': () => SplitDocumentResponse(),
     'SplitDocumentResult, _': () => SplitDocumentResult(),
     'StatDataResponse, _': () => StatDataResponse(),