|
|
(48 intermediate revisions by the same user not shown) |
Line 1: |
Line 1: |
|
|
|
|
|
==Introduction to AutoCount Accounting 2.1.0.1== |
|
==Introduction to AutoCount Accounting 2.1.5-2.1.8== |
|
First release of AutoCount Accounting 2.1.0.1 is the continuous update to previous version of 2.0.<br/>
|
|
AutoCount Accounting 2.1.5.x is the continuous update to previous version of 2.0.<br/> |
|
|
|
|
|
This release there are some new namespace and rearrangement of the namespace to better separation of UI and logic which it has been done for the GL, AR and AP. For instance, when programming for the GL, AR and AP without UI, programmer only need to download autocount.dll and autocount.accounting.dll without having to download the entire assemblies.<br/>
|
|
There are some rearrangement of the namespace to better separation of UI and logic which it has been done for the GL, AR and AP. For instance, when programming for the GL, AR and AP without UI, programmer only need to download autocount.dll and autocount.accounting.dll without having to download the entire assemblies.<br/> |
|
|
|
|
|
AutoCount Accounting 2.1 assemblies can be downloaded from the '''nuget'''. So that, programmer can download and manage the assemblies of different versions.<br/> |
|
AutoCount Accounting 2.1 assemblies can be downloaded from the '''nuget'''. So that, programmer can download and manage the assemblies of different versions.<br/> |
Line 9: |
Line 9: |
|
Furthermore, AutoCount Accounting 2.1 script template is published at '''Extensions for Visual Studio''', where programmer can find the extensions in Visual Studio 2019 and 2022. |
|
Furthermore, AutoCount Accounting 2.1 script template is published at '''Extensions for Visual Studio''', where programmer can find the extensions in Visual Studio 2019 and 2022. |
|
|
|
|
|
===Common Components versions=== |
|
===Major changed in 2.1.8=== |
|
|
AutoCount Accounting 2.1.8 is the extended version of 2.1.5, the significant changed of 2.1.8 is {{DevExpress}}.<br> |
|
|
{{DevExpress}} is upgraded from 19.2.10 to '''22.2.7'''. |
|
|
<br><br> |
|
|
{{Note|Plug-in that is built for '''2.1.8''' requires to include '''SetDevExpressComponentVersionRequired("22.2.7")''' at the constructor of the plug-in initiate.}} |
|
|
===Compatibility=== |
|
|
[[:Category:AutoCount Accounting 2.1:Release Note|AutoCount View Accounting 2.1 Release Note]] |
|
|
<tabber> |
|
|
2.1.8= |
|
|
====Common Components versions==== |
|
#Net Framework '''4.8''' |
|
#Net Framework '''4.8''' |
|
|
#:Please use only .Net Framework 4.8. |
|
#{{DevExpress}} WinForms '''19.2.10''' |
|
|
|
#{{DevExpress}} WinForms '''22.2.7''' |
|
#Newtonsoft Json.NET '''13.0.1''' |
|
#Newtonsoft Json.NET '''13.0.1''' |
|
|
|
|
|
===Setup AutoCount Accounting 2.1 Requirements=== |
|
====Setup AutoCount Accounting 2.1 Requirements==== |
|
#Net Framework '''4.8''' |
|
#Net Framework '''4.8''' |
|
#[https://www.microsoft.com/en-us/download/details.aspx?id=50003 SQL Server 2012 SP3] or higher |
|
#[https://www.microsoft.com/en-us/download/details.aspx?id=50003 SQL Server 2012 SP3] or higher |
|
#AutoCount Server 2.1.0.1 |
|
#AutoCount Server 2.1.0.7 or higher |
|
#AutoCount Accounting 2.1.0.1 Setup |
|
#AutoCount Accounting 2.1.8.23 Setup or higher |
|
|
|-| |
|
|
2.1.5= |
|
|
====Common Components versions==== |
|
|
#Net Framework '''4.8''' |
|
|
#:Please use only .Net Framework 4.8. |
|
|
#{{DevExpress}} WinForms '''19.2.10''' |
|
|
#Newtonsoft Json.NET '''13.0.1''' |
|
|
====Setup AutoCount Accounting 2.1 Requirements==== |
|
|
#Net Framework '''4.8''' |
|
|
#[https://www.microsoft.com/en-us/download/details.aspx?id=50003 SQL Server 2012 SP3] or higher |
|
|
#AutoCount Server 2.1.0.6 or higher |
|
|
#AutoCount Accounting 2.1.5.16 Setup or higher |
|
|
</tabber> |
|
|
<br/><br/> |
|
|
|
|
|
==GST Tax Code and '''Tax Rate''' ''(Updated on 20/12/2022)''== |
|
==Assemblies Filename Changed ''(Updated: 6/1/2023)''== |
|
|
{|class="wikitable" |
|
*AutoCount Accounting 2.1 API will auto update the tax rate according to the document date. |
|
|
|
|- |
|
*:However, it requires to initiate the GST Helper by calling the SubProjectStartup. |
|
|
|
!AutoCount Accounting 1.9, 2.0 |
|
*:In other words, if SubProjectStartup isn't called, obtain the TaxRate will fail. |
|
|
|
!AutoCount Accounting 2.1 |
|
|
!Namespace is changed ? |
|
|
!Namespace |
|
|
|- |
|
|
|AutoCount.Invoicing.Sales.dll |
|
|
|AutoCount.Sales.dll |
|
|
|align="center"|No |
|
|
|AutoCount.Invoicing.Sales |
|
|
|- |
|
|
|AutoCount.Invoicing.Purchase.dll |
|
|
|AutoCount.Purchase.dll |
|
|
|align="center"|No |
|
|
|AutoCount.Invoicing.Purchase |
|
|
|} |
|
|
|
|
|
The word "Invoicing" is removed from the filename of Sales and Purchase, but the namespace remains the same.<br/> |
|
|
''Although the project reference of 2.0 sales & purchase assemblies need to be removed, then add the 2.1 sales & purchase assemblies, the coding doesn't require to be changed.'' |
|
|
{{note|Make sure all AutoCount Accounting 2.0 assemblies are removed from reference before adding 2.1 assemblies.}} |
|
|
<br/> |
|
|
|
|
|
==Namespace Changed ''(Updated: 16/8/2023)''== |
|
|
|
|
|
===2.1.5 to 2.1.8 API Changed=== |
|
|
{|class="wikitable" |
|
|
|- |
|
|
!2.1.5 |
|
|
!2.1.8 |
|
|
|- |
|
|
|AutoCount.LicenseControl.ModuleControl.GetOrCreate(myUsrSession.DBSetting)<br>.ModuleController.'''SystemCurrency'''; |
|
|
|AutoCount.LicenseControl.ModuleControl.GetOrCreate(myUsrSession.DBSetting)<br>.ModuleController.'''Country'''; |
|
|
|} |
|
|
|
|
|
===2.0 to 2.1 API Changed=== |
|
|
{|class="wikitable" |
|
|
|- |
|
|
!colspan=3|AutoCount Accounting 2.0 |
|
|
!colspan=3|AutoCount Accounting 2.1 |
|
|
|- |
|
|
!Assembly |
|
|
!Namespace |
|
|
!class |
|
|
!Assembly |
|
|
!Namespace |
|
|
!class |
|
|
|- |
|
|
|AutoCount.Accounting.dll |
|
|
|AutoCount.Data.Linq |
|
|
| |
|
|
|AutoCount.Accounting.dll |
|
|
|AutoCount.Data.EntityFramework<br>AutoCount.Data.Sql |
|
|
| |
|
|
|- |
|
|
|colspan=6|'''Bonus Point''' |
|
|
|- |
|
|
|rowspan=6|AutoCount.GeneralMaint.dll |
|
|
|rowspan=2|AutoCount.GeneralMaint.MemberMaintenance |
|
|
|MemberCommand |
|
|
|rowspan=6|AutoCount.Invoicing.dll |
|
|
|rowspan=4|AutoCount.BonusPoint.Member |
|
|
|MemberCommand |
|
|
|- |
|
|
|MemberEntity |
|
|
|MemberEntity |
|
|
|- |
|
|
|rowspan=2|AutoCount.GeneralMaint.MemberTypeMaintenance |
|
|
|MemberTypeCommand |
|
|
|MemberTypeCommand |
|
|
|- |
|
|
|MemberTypeEntity |
|
|
|MemberTypeEntity |
|
|
|- |
|
|
|rowspan=2|AutoCount.GeneralMaint.RaceMaintenance |
|
|
|RaceCommand |
|
|
|rowspan=2|AutoCount.BonusPoint.Race |
|
|
|RaceCommand |
|
|
|- |
|
|
|RaceEntity |
|
|
|RaceEntity |
|
|
|} |
|
|
|
|
|
==GST Tax Code and '''Tax Rate''' ''(updated: 20/12/2022)''== |
|
|
*AutoCount Accounting 2.1 API auto updates the tax rate in Sales and Purchase documents according to the document date. |
|
|
*:When initiate the object of GSTHelper in a standalone or service, the application must have had called the SubProjectStartup at the beginning of the application. |
|
|
*:If SubProjectStartup isn't called, obtain the TaxRate will fail. |
|
|
*:Plug-in development does not require to call the SubProjectStartup, because it has been called by the host application. |
|
*Secondly, make sure the manually added TaxCode is linked or assigned with Government Tax Code. |
|
*Secondly, make sure the manually added TaxCode is linked or assigned with Government Tax Code. |
|
*:Prior to version 2.1, "GovernmentTaxCode" was known as "IRASTaxCode". |
|
*:Prior to version 2.1, "GovernmentTaxCode" was known as "IRASTaxCode". |
|
|
|
|
|
<br/> |
|
|
|
|
|
==3 MainEntry to start a subProject== |
|
==3 MainEntry to start a subProject== |
|
Calling the SubProjectStartup is to load the plug-in and also to activate the license. |
|
Calling the SubProjectStartup is to load the plug-in and also to activate the license. |
|
In 2.1, there are 3 classes that allow user to call the subprojectstartup. |
|
In 2.1, there are 3 classes the programmer can call the SubProjectStartup with different assembly and usage. |
|
|
You may find the document at [[Initiate UserSession and DBSetting]]. |
|
|
|
|
|
===MainEntry in AutoCount.Accounting.dll=== |
|
===MainEntry in AutoCount.Accounting.dll=== |
|
'''MainEntry.Startup'''<br/> |
|
'''MainEntry.Startup'''<br/> |
|
This MainEntry is suitable for integration use, or when no user interaction is required to access and initiate AutoCount Accounting. |
|
This MainEntry is commonly used for integration, or when no user login is required to access and initiate AutoCount Accounting, and it does not load UI components. |
|
<syntaxhighlight lang="csharp"> |
|
<syntaxhighlight lang="csharp"> |
|
AutoCount.MainEntry.Startup startup = new AutoCount.MainEntry.Startup(); |
|
AutoCount.MainEntry.Startup startup = new AutoCount.MainEntry.Startup(); |
Line 45: |
Line 157: |
|
</syntaxhighlight> |
|
</syntaxhighlight> |
|
|
|
|
|
===MainEntry in AutoCount.Accounting.UI.dll=== |
|
===MainEntry in AutoCount.MainEntry.dll=== |
|
'''MainEntry.MainStartup'''<br/> |
|
'''MainEntry.MainStartup'''<br/> |
|
This startup calls the AutoCount Accounting user login form, and successful login returns the object of UserSession.<br/> |
|
This MainEntry opens the AutoCount Accounting user login form, with successful login, it returns the object of UserSession.<br/> |
|
If user clicked [Cancel], the object of UserSession is null. |
|
If user clicked [Cancel], the object of UserSession is null. |
|
<syntaxhighlight lang="csharp"> |
|
<syntaxhighlight lang="csharp"> |
Line 61: |
Line 173: |
|
</syntaxhighlight> |
|
</syntaxhighlight> |
|
|
|
|
|
===MainEntry in AutoCount.MainEntry.dll=== |
|
===MainEntry in AutoCount.Accounting.UI.dll=== |
|
'''MainEntry.UIStartup'''<br/> |
|
'''MainEntry.UIStartup'''<br/> |
|
This MainEntry UIStartup is similar to the MainEntry.Startup, except that it loads UI components. |
|
This MainEntry.UIStartup is similar to the MainEntry.Startup, except that it loads UI components. |
|
<syntaxhighlight lang="csharp"> |
|
<syntaxhighlight lang="csharp"> |
|
AutoCount.MainEntry.UIStartup startup = new AutoCount.MainEntry.UIStartup(); |
|
AutoCount.MainEntry.UIStartup startup = new AutoCount.MainEntry.UIStartup(); |
Line 74: |
Line 186: |
|
} |
|
} |
|
</syntaxhighlight> |
|
</syntaxhighlight> |
|
{{Note|[https://wiki.autocountsoft.com/wiki/Programmer_Download_and_Links#Programmer_Tools Get latest plug-in builder 2.1.0.1 for AutoCount Accounting 2.1]}} |
|
{{Note|[[Programmer Download and Links#Programmer Tools (Plug-in Builder and others)|Get latest plug-in builder for AutoCount Accounting 2.1]]}} |
|
|
|
|
|
==NuGet== |
|
==NuGet== |
|
To download the assemblies to your project, start a new project or open a project, then go to Tools | NuGet Package Manager | Manage NuGet Packages for Solution... |
|
To download the assemblies to your project, start a new project or open a project, then go to Tools | NuGet Package Manager | Manage NuGet Packages for Solution... |
|
|
{{Note|If unsure of which NuGet package to install, select '''AutoCount2.MainEntry''' package is sufficient for most project.}} |
|
|
|
|
[[File:VSmenuNuget.png|link=]] |
|
[[File:VSmenuNuget.png|link=]] |
|
|
|
|
Line 92: |
Line 204: |
|
[[File:NugetAC21DependencyCharts.png|link=]] |
|
[[File:NugetAC21DependencyCharts.png|link=]] |
|
|
|
|
|
For example, when selected NuGet package is AutoCount2.Sales, below packages will be downloaded:- |
|
For example, when NuGet package '''AutoCount2.Sales''' is installed, below packages are installed simultaneously:-<br> |
|
#AutoCount2.Sales
|
|
'''AutoCount2.Sales''' |
|
#AutoCount2.ARAP
|
|
*AutoCount2.Stock |
|
#AutoCount2.Accounting.UI
|
|
**AutoCount2.Invoicing |
|
#AutoCount2.UI
|
|
***AutoCount2.Inquiry |
|
#AutoCount2.Accounting
|
|
*AutoCount2.ARAP |
|
#AutoCount2
|
|
**AutoCount2.Accounting.UI |
|
|
***AutoCount2.UI |
|
|
****AutoCount2.Accounting |
|
|
*****AutoCount2 |
|
|
|
|
|
|
Another example, when NuGet package '''AutoCount2.MainEntry''' is installed, below packages are installed simultaneously:-<br> |
|
==Visual Studio Extensions== |
|
|
|
'''AutoCount2.MainEntry''' |
|
|
*AutoCount2.FinancialReport |
|
|
**AutoCount2.Accounting.UI |
|
|
***AutoCount2.UI |
|
|
****AutoCount2.Accounting |
|
|
*****AutoCount2 |
|
|
*AutoCount2.Tools |
|
|
**AutoCount2.GL |
|
|
**AutoCount2.GeneralMaint |
|
|
**AutoCount2.GST |
|
|
***AutoCount2.Inquiry |
|
|
**AutoCount2.Purchase |
|
|
***AutoCount2.Sales |
|
|
****AutoCount2.Stock |
|
|
*****AutoCount2.Invoicing |
|
|
****AutoCount2.ARAP |
|
|
|
|
|
|
==AutoCount Script 2.1 Template in Visual Studio Extensions== |
|
|
AutoCount Script Template 2.1 can be downloaded from Visual Studio Market Place. |
|
|
To download the script template, start '''Visual Studio 2019 or 2022''' |
|
|
# On the main menu, click Extensions | Manage Extensions |
|
|
# In the Manage Extensions, search for "AutoCount" |
|
|
# Select the template according to the intended version. |
|
|
# Close all Visual Studio and it starts the setup |
|
|
# Once done, start Visual Studio and create new project |
|
|
#:"AutoCountScript 2.1.8" project is added to the project list. |
|
|
You may also visit Microsoft for how to use Visual Studio Extensions. |
|
|
[https://learn.microsoft.com/en-us/visualstudio/ide/finding-and-using-visual-studio-extensions?view=vs-2022 Find, install, and manage extensions for Visual Studio] |
|
|
|
|
|
|
*Supported Visual Studio version: 2019, 2022 |
|
{{NavigateDeveloper}} |
|
|
|
*Language in the project: C# |
|
|
|
|
|
|
|
|
|
{{NavigateDeveloper}} |
|
[[Category:Programmer]] |
|
[[Category:Programmer]] |
|
[[Category:API]] |
|
[[Category:API]] |