Release 23.11 (#77)

Denis-Averin · web-flow · commit 51eb18424b2b · 2023-11-28T14:09:40.000+07:00
* Update version to 23.11.0

* Update API

* Add net8.0

* .NET Core 3.1 and higher

* Change Maximum timeout value

* Update packages in Tests
diff --git a/.github/workflows/dotnet-core.yml b/.github/workflows/dotnet-core.yml
@@ -21,6 +21,8 @@ jobs:
             framework: net6.0
           - dotnet-version: 7.0.x
             framework: net7.0
+          - dotnet-version: 8.0.x
+            framework: net8.0
 
     continue-on-error: true
 
@@ -37,6 +39,6 @@ jobs:
         dotnet-version: ${{ matrix.dotnet-version }}
 
     - name: Test with ${{ matrix.dotnet-version }}
-      run: dotnet test --no-build --verbosity normal --framework ${{ matrix.framework }}
+      run: dotnet test --verbosity normal --framework ${{ matrix.framework }}
       env:
         TEST_CONFIGURATION_JWT_TOKEN: ${{ secrets.TEST_CONFIGURATION_ACCESS_TOKEN }}
diff --git a/README.md b/README.md
@@ -6,7 +6,7 @@
 [![Nuget](https://img.shields.io/nuget/v/Aspose.BarCode-Cloud)](https://www.nuget.org/packages/Aspose.BarCode-Cloud/)
 
 - API version: 3.0
-- SDK version: 23.10.0
+- SDK version: 23.11.0
 
 ## Demo applications
 
@@ -24,7 +24,7 @@ Aspose.BarCode Cloud SDK for .NET provides cross-platform bindings for:
 
 - .NET 5 and higher
 - .NET Standard 2.0 and higher
-- .NET Core 2.1 and higher
+- .NET Core 3.1 and higher
 - .NET Framework 4.6.2 and higher
 
 To use these SDKs, you will need Client Id and Client Secret which can be looked up at [Aspose Cloud Dashboard](https://dashboard.aspose.cloud/applications) (free registration in Aspose Cloud is required for this).
diff --git a/Tests/Aspose.BarCode.Cloud.Sdk.Tests.csproj b/Tests/Aspose.BarCode.Cloud.Sdk.Tests.csproj
@@ -1,7 +1,7 @@
 <?xml version="1.0" encoding="utf-8"?>
 <Project Sdk="Microsoft.NET.Sdk">
   <PropertyGroup>
-    <TargetFrameworks>netcoreapp3.1;net462;net480;net481;net6.0;net7.0</TargetFrameworks>
+    <TargetFrameworks>netcoreapp3.1;net462;net480;net481;net6.0;net7.0;net8.0</TargetFrameworks>
     <TreatWarningsAsErrors>true</TreatWarningsAsErrors>
     <IsTestProject>true</IsTestProject>
     <LangVersion>8.0</LangVersion>
@@ -13,9 +13,9 @@
   </ItemGroup>
   <ItemGroup>
     <PackageReference Include="Moq" Version="4.20.69" />
-    <PackageReference Include="NUnit" Version="3.13.3" />
+    <PackageReference Include="NUnit" Version="3.14.0" />
     <PackageReference Include="NUnit3TestAdapter" Version="4.5.0" />
-    <PackageReference Include="Microsoft.NET.Test.Sdk" Version="17.7.1" />
+    <PackageReference Include="Microsoft.NET.Test.Sdk" Version="17.8.0" />
     <PackageReference Include="System.Net.Http" Version="4.3.4" />
   </ItemGroup>
   <ItemGroup>
diff --git a/Tests/Configuration.template.json b/Tests/Configuration.template.json
@@ -1,4 +1,6 @@
 {
     "ClientId": "Client Id from https://dashboard.aspose.cloud/applications",
-    "ClientSecret": "Client Secret from https://dashboard.aspose.cloud/applications"
+    "ClientSecret": "Client Secret from https://dashboard.aspose.cloud/applications",
+    "ApiBaseUrl": "https://api.aspose.cloud",
+    "TokenUrl":"https://api.aspose.cloud/connect/token"
 }
diff --git a/Tests/JwtAuthTests.cs b/Tests/JwtAuthTests.cs
@@ -14,11 +14,6 @@ namespace Aspose.BarCode.Cloud.Sdk.Tests
     [TestFixture]
     public class JwtAuthTests : TestsBase
     {
-        [SetUp]
-        public void Init()
-        {
-        }
-
         private async Task<string> FetchToken()
         {
             var formParams = new Dictionary<string, string>
@@ -37,6 +32,7 @@ private async Task<string> FetchToken()
             return accessToken;
         }
 
+
         [Test]
         public async Task CanUseExternalToken()
         {
diff --git a/docs/BarcodeApi.md b/docs/BarcodeApi.md
@@ -94,7 +94,7 @@ Name | Type | Description  | Notes
  **rectWidth** | **int?**| Set Width of area for recognition. | [optional]
  **rectHeight** | **int?**| Set Height of area for recognition. | [optional]
  **stripFNC** | **bool?**| Value indicating whether FNC symbol strip must be done. | [optional]
- **timeout** | **int?**| Timeout of recognition process in milliseconds. Default value is 15_000 (15 seconds). Maximum value is 60_000 (1 minute). In case of a timeout RequestTimeout (408) status will be returned. Try reducing the image size to avoid timeout. | [optional]
+ **timeout** | **int?**| Timeout of recognition process in milliseconds. Default value is 15_000 (15 seconds). Maximum value is 30_000 (1/2 minute). In case of a timeout RequestTimeout (408) status will be returned. Try reducing the image size to avoid timeout. | [optional]
  **medianSmoothingWindowSize** | **int?**| Window size for median smoothing. Typical values are 3 or 4. Default value is 3. AllowMedianSmoothing must be set. | [optional]
  **allowMedianSmoothing** | **bool?**| Allows engine to enable median smoothing as additional scan. Mode helps to recognize noised barcodes. | [optional]
  **allowComplexBackground** | **bool?**| Allows engine to recognize color barcodes on color background as additional scan. Extremely slow mode. | [optional]
@@ -154,7 +154,7 @@ Name | Type | Description  | Notes
  **rectWidth** | **int?**| Set Width of area for recognition. | [optional]
  **rectHeight** | **int?**| Set Height of area for recognition. | [optional]
  **stripFNC** | **bool?**| Value indicating whether FNC symbol strip must be done. | [optional]
- **timeout** | **int?**| Timeout of recognition process in milliseconds. Default value is 15_000 (15 seconds). Maximum value is 60_000 (1 minute). In case of a timeout RequestTimeout (408) status will be returned. Try reducing the image size to avoid timeout. | [optional]
+ **timeout** | **int?**| Timeout of recognition process in milliseconds. Default value is 15_000 (15 seconds). Maximum value is 30_000 (1/2 minute). In case of a timeout RequestTimeout (408) status will be returned. Try reducing the image size to avoid timeout. | [optional]
  **medianSmoothingWindowSize** | **int?**| Window size for median smoothing. Typical values are 3 or 4. Default value is 3. AllowMedianSmoothing must be set. | [optional]
  **allowMedianSmoothing** | **bool?**| Allows engine to enable median smoothing as additional scan. Mode helps to recognize noised barcodes. | [optional]
  **allowComplexBackground** | **bool?**| Allows engine to recognize color barcodes on color background as additional scan. Extremely slow mode. | [optional]
diff --git a/docs/Code128Emulation.md b/docs/Code128Emulation.md
@@ -1,5 +1,7 @@
 # Aspose.BarCode.Cloud.Sdk.Model.Code128Emulation
 
+DEPRECATED. This enum will be removed in future releases Function codewords for Code 128 emulation. Applied for MicroPDF417 only. Ignored for PDF417 and MacroPDF417 barcodes.
+
 ## Allowable values
 
 * **None**
diff --git a/docs/DecodeBarcodeType.md b/docs/DecodeBarcodeType.md
@@ -87,3 +87,4 @@ See DecodeType
 * GS1HanXin
 * GS1Aztec
 * GS1CompositeBar
+* GS1MicroPdf417
diff --git a/docs/EncodeBarcodeType.md b/docs/EncodeBarcodeType.md
@@ -75,3 +75,4 @@ See EncodeTypes
 * HanXin
 * GS1HanXin
 * GS1Aztec
+* GS1MicroPdf417
diff --git a/docs/Pdf417Params.md b/docs/Pdf417Params.md
@@ -25,5 +25,8 @@ Name | Type | Description | Notes
 **MacroFileName** | **string** | Macro Pdf417 barcode file name | [optional]
 **MacroAddressee** | **string** | Macro Pdf417 barcode addressee name | [optional]
 **MacroECIEncoding** | **ECIEncodings** | Extended Channel Interpretation Identifiers. Applies for Macro PDF417 text fields. | [optional]
-**Code128Emulation** | **Code128Emulation** | Function codeword for Code 128 emulation. Applied for MicroPDF417 only. Ignored for PDF417 and MacroPDF417 barcodes. | [optional]
+**Code128Emulation** | **Code128Emulation** | DEPRECATED: This property is obsolete and will be removed in future releases. See samples of using new parameters on https://releases.aspose.com/barcode/net/release-notes/2023/aspose-barcode-for-net-23-10-release-notes/ Function codeword for Code 128 emulation. Applied for MicroPDF417 only. Ignored for PDF417 and MacroPDF417 barcodes. | [optional]
+**IsCode128Emulation** | **bool?** | Can be used only with MicroPdf417 and encodes Code 128 emulation modes. Can encode FNC1 in second position modes 908 and 909, also can encode 910 and 911 which just indicate that recognized MicroPdf417 can be interpret as Code 128. | [optional]
 **Pdf417MacroTerminator** | **Pdf417MacroTerminator** | Used to tell the encoder whether to add Macro PDF417 Terminator (codeword 922) to the segment. Applied only for Macro PDF417. | [optional]
+**IsLinked** | **bool?** | Defines linked modes with GS1MicroPdf417, MicroPdf417 and Pdf417 barcodes. With GS1MicroPdf417 symbology encodes 906, 907, 912, 913, 914, 915 “Linked” UCC/EAN-128 modes. With MicroPdf417 and Pdf417 symbologies encodes 918 linkage flag to associated linear component other than an EAN.UCC. | [optional]
+**MacroCharacters** | **MacroCharacter** | Macro Characters 05 and 06 values are used to obtain more compact encoding in special modes. Can be used only with MicroPdf417 and encodes 916 and 917 MicroPdf417 modes. Default value: MacroCharacters.None. | [optional]
diff --git a/docs/ReaderParams.md b/docs/ReaderParams.md
@@ -15,7 +15,7 @@ Name | Type | Description | Notes
 **RectWidth** | **int?** | Set Width of area for recognition. | [optional]
 **RectHeight** | **int?** | Set Height of area for recognition. | [optional]
 **StripFNC** | **bool?** | Value indicating whether FNC symbol strip must be done. | [optional]
-**Timeout** | **int?** | Timeout of recognition process in milliseconds. Default value is 15_000 (15 seconds). Maximum value is 60_000 (1 minute). In case of a timeout RequestTimeout (408) status will be returned. Try reducing the image size to avoid timeout. | [optional]
+**Timeout** | **int?** | Timeout of recognition process in milliseconds. Default value is 15_000 (15 seconds). Maximum value is 30_000 (1/2 minute). In case of a timeout RequestTimeout (408) status will be returned. Try reducing the image size to avoid timeout. | [optional]
 **MedianSmoothingWindowSize** | **int?** | Window size for median smoothing. Typical values are 3 or 4. Default value is 3. AllowMedianSmoothing must be set. | [optional]
 **AllowMedianSmoothing** | **bool?** | Allows engine to enable median smoothing as additional scan. Mode helps to recognize noised barcodes. | [optional]
 **AllowComplexBackground** | **bool?** | Allows engine to recognize color barcodes on color background as additional scan. Extremely slow mode. | [optional]
diff --git a/examples/GenerateQR/GenerateQR.csproj b/examples/GenerateQR/GenerateQR.csproj
@@ -2,11 +2,11 @@
 
   <PropertyGroup>
     <OutputType>Exe</OutputType>
-    <TargetFramework>netcoreapp3.1</TargetFramework>
+    <TargetFramework>net6.0</TargetFramework>
   </PropertyGroup>
 
   <ItemGroup>
-    <PackageReference Include="Aspose.BarCode-Cloud" Version="23.10.0" />
+    <PackageReference Include="Aspose.BarCode-Cloud" Version="23.11.0" />
   </ItemGroup>
 
 </Project>
diff --git a/examples/ReadQR/ReadQR.csproj b/examples/ReadQR/ReadQR.csproj
@@ -2,11 +2,11 @@
 
   <PropertyGroup>
     <OutputType>Exe</OutputType>
-    <TargetFramework>netcoreapp3.1</TargetFramework>
+    <TargetFramework>net6.0</TargetFramework>
   </PropertyGroup>
 
   <ItemGroup>
-    <PackageReference Include="Aspose.BarCode-Cloud" Version="23.10.0" />
+    <PackageReference Include="Aspose.BarCode-Cloud" Version="23.11.0" />
   </ItemGroup>
 
 </Project>
diff --git a/src/Aspose.BarCode.Cloud.Sdk.csproj b/src/Aspose.BarCode.Cloud.Sdk.csproj
@@ -21,11 +21,11 @@ Aspose.Barcode for Cloud allows you to control all aspects of the image and barc
     <PackageId>Aspose.BarCode-Cloud</PackageId>
     <Product>Aspose.BarCode Cloud SDK for .NET</Product>
     <PackageIcon>PackageIcon.png</PackageIcon>
-    <Version>23.10.0</Version>
+    <Version>23.11.0</Version>
     <Authors>Aspose</Authors>
-    <AssemblyVersion>23.10.0.0</AssemblyVersion>
+    <AssemblyVersion>23.11.0.0</AssemblyVersion>
     <PackageReadmeFile>README.md</PackageReadmeFile>
-    <PackageReleaseNotes>https://github.com/aspose-barcode-cloud/aspose-barcode-cloud-dotnet/releases/tag/v23.10.0</PackageReleaseNotes>
+    <PackageReleaseNotes>https://github.com/aspose-barcode-cloud/aspose-barcode-cloud-dotnet/releases/tag/v23.11.0</PackageReleaseNotes>
     <PackageRequireLicenseAcceptance>true</PackageRequireLicenseAcceptance>
     <PackageLicenseFile>LICENSE.txt</PackageLicenseFile>
     <GenerateDocumentationFile>true</GenerateDocumentationFile>
diff --git a/src/Model/Code128Emulation.cs b/src/Model/Code128Emulation.cs
@@ -34,7 +34,7 @@ namespace Aspose.BarCode.Cloud.Sdk.Model
 {
 
     /// <summary>
-    ///
+    ///     DEPRECATED. This enum will be removed in future releases Function codewords for Code 128 emulation. Applied for MicroPDF417 only. Ignored for PDF417 and MacroPDF417 barcodes.
     /// </summary>
     [JsonConverter(typeof(StringEnumConverter))]
     public enum Code128Emulation
diff --git a/src/Model/DecodeBarcodeType.cs b/src/Model/DecodeBarcodeType.cs
@@ -452,7 +452,12 @@ public enum DecodeBarcodeType
         /// <summary>
         ///     Enum value GS1CompositeBar
         /// </summary>
-        GS1CompositeBar
+        GS1CompositeBar,
+
+        /// <summary>
+        ///     Enum value GS1MicroPdf417
+        /// </summary>
+        GS1MicroPdf417
 
     }
 }
diff --git a/src/Model/EncodeBarcodeType.cs b/src/Model/EncodeBarcodeType.cs
@@ -392,7 +392,12 @@ public enum EncodeBarcodeType
         /// <summary>
         ///     Enum value GS1Aztec
         /// </summary>
-        GS1Aztec
+        GS1Aztec,
+
+        /// <summary>
+        ///     Enum value GS1MicroPdf417
+        /// </summary>
+        GS1MicroPdf417
 
     }
 }
diff --git a/src/Model/Pdf417Params.cs b/src/Model/Pdf417Params.cs
@@ -61,15 +61,21 @@ public class Pdf417Params : IToString
         public ECIEncodings? MacroECIEncoding { get; set; }
 
         /// <summary>
-        ///     Function codeword for Code 128 emulation. Applied for MicroPDF417 only. Ignored for PDF417 and MacroPDF417 barcodes.
+        ///     DEPRECATED: This property is obsolete and will be removed in future releases. See samples of using new parameters on https://releases.aspose.com/barcode/net/release-notes/2023/aspose-barcode-for-net-23-10-release-notes/ Function codeword for Code 128 emulation. Applied for MicroPDF417 only. Ignored for PDF417 and MacroPDF417 barcodes.
         /// </summary>
+        [System.Obsolete("This property is obsolete and will be removed in future releases. See samples of using new parameters on https://releases.aspose.com/barcode/net/release-notes/2023/aspose-barcode-for-net-23-10-release-notes/ Function codeword for Code 128 emulation. Applied for MicroPDF417 only. Ignored for PDF417 and MacroPDF417 barcodes.", false)]
         public Code128Emulation? Code128Emulation { get; set; }
 
         /// <summary>
         ///     Used to tell the encoder whether to add Macro PDF417 Terminator (codeword 922) to the segment. Applied only for Macro PDF417.
         /// </summary>
         public Pdf417MacroTerminator? Pdf417MacroTerminator { get; set; }
 
+        /// <summary>
+        ///     Macro Characters 05 and 06 values are used to obtain more compact encoding in special modes. Can be used only with MicroPdf417 and encodes 916 and 917 MicroPdf417 modes. Default value: MacroCharacters.None.
+        /// </summary>
+        public MacroCharacter? MacroCharacters { get; set; }
+
         /// <summary>
         ///     Height/Width ratio of 2D BarCode module.
         /// </summary>
@@ -146,6 +152,16 @@ public class Pdf417Params : IToString
         /// </summary>
         public string MacroAddressee { get; set; }
 
+        /// <summary>
+        ///     Can be used only with MicroPdf417 and encodes Code 128 emulation modes. Can encode FNC1 in second position modes 908 and 909, also can encode 910 and 911 which just indicate that recognized MicroPdf417 can be interpret as Code 128.
+        /// </summary>
+        public bool? IsCode128Emulation { get; set; }
+
+        /// <summary>
+        ///     Defines linked modes with GS1MicroPdf417, MicroPdf417 and Pdf417 barcodes. With GS1MicroPdf417 symbology encodes 906, 907, 912, 913, 914, 915 “Linked” UCC/EAN-128 modes. With MicroPdf417 and Pdf417 symbologies encodes 918 linkage flag to associated linear component other than an EAN.UCC.
+        /// </summary>
+        public bool? IsLinked { get; set; }
+
         /// <summary>
         ///     Get the string presentation of the object
         /// </summary>
diff --git a/src/Model/ReaderParams.cs b/src/Model/ReaderParams.cs
@@ -91,7 +91,7 @@ public class ReaderParams : IToString
         public bool? StripFNC { get; set; }
 
         /// <summary>
-        ///     Timeout of recognition process in milliseconds. Default value is 15_000 (15 seconds). Maximum value is 60_000 (1 minute). In case of a timeout RequestTimeout (408) status will be returned. Try reducing the image size to avoid timeout.
+        ///     Timeout of recognition process in milliseconds. Default value is 15_000 (15 seconds). Maximum value is 30_000 (1/2 minute). In case of a timeout RequestTimeout (408) status will be returned. Try reducing the image size to avoid timeout.
         /// </summary>
         public int? Timeout { get; set; }
 
diff --git a/src/Model/Requests/GetBarcodeRecognizeRequest.cs b/src/Model/Requests/GetBarcodeRecognizeRequest.cs
@@ -96,7 +96,7 @@ public GetBarcodeRecognizeRequest(string name)
         public bool? StripFNC { get; set; }
 
         /// <summary>
-        ///     Timeout of recognition process in milliseconds. Default value is 15_000 (15 seconds). Maximum value is 60_000 (1 minute). In case of a timeout RequestTimeout (408) status will be returned. Try reducing the image size to avoid timeout.
+        ///     Timeout of recognition process in milliseconds. Default value is 15_000 (15 seconds). Maximum value is 30_000 (1/2 minute). In case of a timeout RequestTimeout (408) status will be returned. Try reducing the image size to avoid timeout.
         /// </summary>
         public int? Timeout { get; set; }
 
diff --git a/src/Model/Requests/PostBarcodeRecognizeFromUrlOrContentRequest.cs b/src/Model/Requests/PostBarcodeRecognizeFromUrlOrContentRequest.cs
@@ -90,7 +90,7 @@ public PostBarcodeRecognizeFromUrlOrContentRequest(System.IO.Stream image = null
         public bool? StripFNC { get; set; }
 
         /// <summary>
-        ///     Timeout of recognition process in milliseconds. Default value is 15_000 (15 seconds). Maximum value is 60_000 (1 minute). In case of a timeout RequestTimeout (408) status will be returned. Try reducing the image size to avoid timeout.
+        ///     Timeout of recognition process in milliseconds. Default value is 15_000 (15 seconds). Maximum value is 30_000 (1/2 minute). In case of a timeout RequestTimeout (408) status will be returned. Try reducing the image size to avoid timeout.
         /// </summary>
         public int? Timeout { get; set; }
 

Original file line number	Diff line number	Diff line change
`@@ -1,4 +1,6 @@`
`1`	`1`	`{`
`2`	`2`	`"ClientId": "Client Id from https://dashboard.aspose.cloud/applications",`
`3`		`- "ClientSecret": "Client Secret from https://dashboard.aspose.cloud/applications"`
	`3`	`+ "ClientSecret": "Client Secret from https://dashboard.aspose.cloud/applications",`
	`4`	`+ "ApiBaseUrl": "https://api.aspose.cloud",`
	`5`	`+ "TokenUrl":"https://api.aspose.cloud/connect/token"`
`4`	`6`	`}`
Original file line number	Diff line number	Diff line change
`@@ -14,11 +14,6 @@ namespace Aspose.BarCode.Cloud.Sdk.Tests`
`14`	`14`	`[TestFixture]`
`15`	`15`	`public class JwtAuthTests : TestsBase`
`16`	`16`	`{`
`17`		`- [SetUp]`
`18`		`- public void Init()`
`19`		`- {`
`20`		`- }`
`21`		`-`
`22`	`17`	`private async Task<string> FetchToken()`
`23`	`18`	`{`
`24`	`19`	`var formParams = new Dictionary<string, string>`
`@@ -37,6 +32,7 @@ private async Task<string> FetchToken()`
`37`	`32`	`return accessToken;`
`38`	`33`	`}`
`39`	`34`
	`35`	`+`
`40`	`36`	`[Test]`
`41`	`37`	`public async Task CanUseExternalToken()`
`42`	`38`	`{`