Recent changes to GLTags

GLTags modified by Tim Schofield

Tim Schofield — Tue, 15 Oct 2024 09:20:29 -0000

--- v9
+++ v10
@@ -36,16 +36,13 @@

     This would look something like:

-    ___________________________________
     |  counterindex   |  tagref        |
-    |_________________|________________
     |    12345        |     5          |
     |    12346        |     114        |
     |    12346        |     125        |
     |    12346        |     138        |
     |    12347        |     8          |
     |    12347        |     9          |
-    |_________________|________________|

     The counterindex field refers to the counterindex field in the gltrans table. So in the above table transaction 1235 only has the tag 5 attached to it, transaction 12346 has 3 tags associated with it: 114, 125 and 138, and transaction 12347 has two tags associated with it, 8 and 9.

@@ -58,17 +55,13 @@
     )

     which would look like:
-    ___________________________________
     |  pccashdetail   |  tag           |
-    |_________________|________________
     |    276          |     5          |
     |    277          |     114        |
     |    277          |     125        |
     |    277          |     138        |
     |    278          |     8          |
     |    278          |     9          |
-    |_________________|________________|
-    

     This allows for an almost unlimited number of tags to be created, and an almost unlimited number of tags to be associated with each transaction.

GLTags modified by Tim Schofield

Tim Schofield — Tue, 15 Oct 2024 09:20:29 -0000

--- v8
+++ v9
@@ -47,25 +47,28 @@
     |    12347        |     9          |
     |_________________|________________|

+    The counterindex field refers to the counterindex field in the gltrans table. So in the above table transaction 1235 only has the tag 5 attached to it, transaction 12346 has 3 tags associated with it: 114, 125 and 138, and transaction 12347 has two tags associated with it, 8 and 9.
+    
+    and..
+    
     CREATE TABLE `pctags` (
       `pccashdetail` int NOT NULL,
       `tag` int NOT NULL,
       PRIMARY KEY (`pccashdetail`,`tag`)
     )

+    which would look like:
     ___________________________________
     |  pccashdetail   |  tag           |
     |_________________|________________
-    |    12345        |     5          |
-    |    12346        |     114        |
-    |    12346        |     125        |
-    |    12346        |     138        |
-    |    12347        |     8          |
-    |    12347        |     9          |
+    |    276          |     5          |
+    |    277          |     114        |
+    |    277          |     125        |
+    |    277          |     138        |
+    |    278          |     8          |
+    |    278          |     9          |
     |_________________|________________|

-    
-    The counterindex field refers to the counterindex field in the gltrans table. So in the above table transaction 1235 only has the tag 5 attached to it, transaction 12346 has 3 tags associated with it: 114, 125 and 138, and transaction 12347 has two tags associated with it, 8 and 9.

     This allows for an almost unlimited number of tags to be created, and an almost unlimited number of tags to be associated with each transaction.

GLTags modified by Tim Schofield

Tim Schofield — Tue, 15 Oct 2024 09:20:29 -0000

--- v7
+++ v8
@@ -24,7 +24,7 @@

     ALTER TABLE tags CHANGE COLUMN tagref tagref INT(11) NOT Null;

-    The second issue will be solved by creating a new table:
+    The second issue will be solved by creating two new tables:

     CREATE TABLE `gltags` (
       `counterindex` INT(11) NOT NULL DEFAULT '0',
@@ -46,6 +46,24 @@
     |    12347        |     8          |
     |    12347        |     9          |
     |_________________|________________|
+    
+    CREATE TABLE `pctags` (
+      `pccashdetail` int NOT NULL,
+      `tag` int NOT NULL,
+      PRIMARY KEY (`pccashdetail`,`tag`)
+    )
+    
+    ___________________________________
+    |  pccashdetail   |  tag           |
+    |_________________|________________
+    |    12345        |     5          |
+    |    12346        |     114        |
+    |    12346        |     125        |
+    |    12346        |     138        |
+    |    12347        |     8          |
+    |    12347        |     9          |
+    |_________________|________________|
+    

     The counterindex field refers to the counterindex field in the gltrans table. So in the above table transaction 1235 only has the tag 5 attached to it, transaction 12346 has 3 tags associated with it: 114, 125 and 138, and transaction 12347 has two tags associated with it, 8 and 9.

GLTags modified by Tim Schofield

Tim Schofield — Tue, 15 Oct 2024 09:20:29 -0000

--- v6
+++ v7
@@ -63,26 +63,24 @@

     * Scripts to change

-    CustomerReceipt.php
-    GLAccountCSV.php
-    GLAccountInquiry.php
-    GLAccountReport.php
-    GLJournal.php
-    GLTagProfit_Loss.php
-    GLTags.php
-    ImportBankTransAnalysis.php
-    includes/DefineReceiptClass.php
-    InternalStockRequestFulfill.php
-    Payments.php
-    PcAuthorizeExpenses.php
-    PcClaimExpensesFromTab.php
-    PcExpenses.php
-    PcReportExpense.php
-    PcReportTab.php
-    PcTabExpensesList.php
-    PcTabs.php
-    StockAdjustments.php
-    SuppTransGLAnalysis.php
-    Z_ImportGLTransactions.php
+    1. CustomerReceipt.php
+    1. GLAccountCSV.php
+    1. GLAccountInquiry.php
+    1. GLAccountReport.php
+    1. GLJournal.php
+    1. GLJournalInquiry.php
+    1. GLTagProfit_Loss.php
+    1. GLTags.php
+    1. InternalStockRequestFulfill.php
+    1. Payments.php
+    1. PcAuthorizeExpenses.php
+    1. PcClaimExpensesFromTab.php
+    1. PcExpenses.php
+    1. StockAdjustments.php
+    1. SuppTransGLAnalysis.php
+    1. SupplierCredit.php
+    1. SupplierInvoice.php
+    1. includes/DefineSuppTransClass.php
+

GLTags modified by Tim Schofield

Tim Schofield — Tue, 15 Oct 2024 09:20:29 -0000

--- v5
+++ v6
@@ -67,19 +67,22 @@
     GLAccountCSV.php
     GLAccountInquiry.php
     GLAccountReport.php
-    GLJournalInquiry.php
     GLJournal.php
     GLTagProfit_Loss.php
     GLTags.php
+    ImportBankTransAnalysis.php
+    includes/DefineReceiptClass.php
     InternalStockRequestFulfill.php
     Payments.php
-    PcAuthorizeCheque.php
     PcAuthorizeExpenses.php
-    PDFGLJournal.php
-    RegularPaymentsProcess.php
+    PcClaimExpensesFromTab.php
+    PcExpenses.php
+    PcReportExpense.php
+    PcReportTab.php
+    PcTabExpensesList.php
+    PcTabs.php
     StockAdjustments.php
-    StockTransfers.php
-    SupplierCredit.php
+    SuppTransGLAnalysis.php
     Z_ImportGLTransactions.php

GLTags modified by Tim Schofield

Tim Schofield — Tue, 15 Oct 2024 09:20:29 -0000

--- v4
+++ v5
@@ -64,43 +64,22 @@
     * Scripts to change

     CustomerReceipt.php
-    
     GLAccountCSV.php
-    
     GLAccountInquiry.php
-    
     GLAccountReport.php
-    
+    GLJournalInquiry.php
     GLJournal.php
-    
     GLTagProfit_Loss.php
-    
     GLTags.php
-    
-    includes/DefineReceiptClass.php
-    
     InternalStockRequestFulfill.php
-    
     Payments.php
-    
+    PcAuthorizeCheque.php
     PcAuthorizeExpenses.php
-    
-    PcClaimExpensesFromTab.php
-    
-    PcExpenses.php
-    
-    PcReportExpense.php
-    
-    PcReportTab.php
-    
-    PcTabExpensesList.php
-    
-    PcTabs.php
-    
+    PDFGLJournal.php
+    RegularPaymentsProcess.php
     StockAdjustments.php
-    
-    SuppTransGLAnalysis.php
-    
+    StockTransfers.php
+    SupplierCredit.php
     Z_ImportGLTransactions.php

GLTags modified by Tim Schofield

Tim Schofield — Tue, 15 Oct 2024 09:20:29 -0000

--- v3
+++ v4
@@ -77,8 +77,6 @@

     GLTags.php

-    ImportBankTransAnalysis.php
-    
     includes/DefineReceiptClass.php

     InternalStockRequestFulfill.php

GLTags modified by Tim Schofield

Tim Schofield — Tue, 15 Oct 2024 09:20:29 -0000

--- v2
+++ v3
@@ -1,5 +1,5 @@

-    # Synopsis
+    * Synopsis

     The GL tag system is an innovative system in webERP that allows individual GL transactions with a tag, and then reports can be generated based on that tag. For example, an organisation may operate several motor vehicles, and incur expenses for those vehicles. GL accounts could be set up for those expenses, such as:

@@ -10,7 +10,7 @@

     Expenses for each vehicle would be posted to these accounts, but to report on individual vehicles would be hard. To get around this problem, we would set up a tag for each vehicle. Then, when an expense is posted to the GL it would be tagged with the appropriate vehicle. At any time we would be able to report on the ongoing costs for each vehicle.

-    # Limitations of this system
+    * Limitations of this system

     The current tag system as outlined above has 2 limitations.

@@ -18,7 +18,7 @@

     Secondly only one tag can be applied to each GL transaction. For example, to extend the above example, the organisation may be engaged in different projects, and vehicles can temporarily be assigned to those projects. It would be helpful to be able to tag an expense transaction with both the vehicle tag, and the project tag, and so be able to produce two reports, one for the vehicle and one for the project.

-    # Solutions
+    * Solutions

     Getting around the first problem is simply a matter of changing the type of the tagref field in the tags table from TINYINT to INT(11). This would allow for a huge number of tags to be created. The required SQL would be 

@@ -51,7 +51,7 @@

     This allows for an almost unlimited number of tags to be created, and an almost unlimited number of tags to be associated with each transaction.

-    # Updating current system
+    * Updating current system

     We need to transfer the old tags to the current system. As there could only be one tag pre GL transactions it is simply a matter of copying over the counterindex/tagref pair from gltrans to the new gl tags table by:

@@ -60,4 +60,49 @@
     and then removing the tag column from the gltrans table

     ALTER TABLE gltrans DROP COLUMN tagref; 
+    
+    * Scripts to change
+    
+    CustomerReceipt.php
+    
+    GLAccountCSV.php
+    
+    GLAccountInquiry.php
+    
+    GLAccountReport.php
+    
+    GLJournal.php
+    
+    GLTagProfit_Loss.php
+    
+    GLTags.php
+    
+    ImportBankTransAnalysis.php
+    
+    includes/DefineReceiptClass.php
+    
+    InternalStockRequestFulfill.php
+    
+    Payments.php
+    
+    PcAuthorizeExpenses.php
+    
+    PcClaimExpensesFromTab.php
+    
+    PcExpenses.php
+    
+    PcReportExpense.php
+    
+    PcReportTab.php
+    
+    PcTabExpensesList.php
+    
+    PcTabs.php
+    
+    StockAdjustments.php
+    
+    SuppTransGLAnalysis.php
+    
+    Z_ImportGLTransactions.php
+

GLTags modified by Tim Schofield

Tim Schofield — Tue, 15 Oct 2024 09:20:29 -0000

--- v1
+++ v2
@@ -50,4 +50,14 @@
     The counterindex field refers to the counterindex field in the gltrans table. So in the above table transaction 1235 only has the tag 5 attached to it, transaction 12346 has 3 tags associated with it: 114, 125 and 138, and transaction 12347 has two tags associated with it, 8 and 9.

     This allows for an almost unlimited number of tags to be created, and an almost unlimited number of tags to be associated with each transaction.
+    
+    # Updating current system
+    
+    We need to transfer the old tags to the current system. As there could only be one tag pre GL transactions it is simply a matter of copying over the counterindex/tagref pair from gltrans to the new gl tags table by:
+    
+    INSERT INTO gltags (SELECT counterindex, tag  FROM gltrans);
+    
+    and then removing the tag column from the gltrans table
+    
+    ALTER TABLE gltrans DROP COLUMN tagref;

GLTags modified by Tim Schofield

Tim Schofield — Tue, 15 Oct 2024 09:20:29 -0000

# Synopsis

The GL tag system is an innovative system in webERP that allows individual GL transactions with a tag, and then reports can be generated based on that tag. For example, an organisation may operate several motor vehicles, and incur expenses for those vehicles. GL accounts could be set up for those expenses, such as:

1. Motor Vehicle Fuel
2. Motor Vehicle Insurance
3. Motor Vehicle Maintenance
4. MOT testing

Expenses for each vehicle would be posted to these accounts, but to report on individual vehicles would be hard. To get around this problem, we would set up a tag for each vehicle. Then, when an expense is posted to the GL it would be tagged with the appropriate vehicle. At any time we would be able to report on the ongoing costs for each vehicle.

# Limitations of this system

The current tag system as outlined above has 2 limitations.

Firstly the number of tags that can be created is limited to 256 by the data type use in the tags table.

Secondly only one tag can be applied to each GL transaction. For example, to extend the above example, the organisation may be engaged in different projects, and vehicles can temporarily be assigned to those projects. It would be helpful to be able to tag an expense transaction with both the vehicle tag, and the project tag, and so be able to produce two reports, one for the vehicle and one for the project.

# Solutions

Getting around the first problem is simply a matter of changing the type of the tagref field in the tags table from TINYINT to INT(11). This would allow for a huge number of tags to be created. The required SQL would be

ALTER TABLE tags CHANGE COLUMN tagref tagref INT(11) NOT Null;

The second issue will be solved by creating a new table:

CREATE TABLE `gltags` (
  `counterindex` INT(11) NOT NULL DEFAULT '0',
  `tagref` INT(11) NOT NULL DEFAULT '0',
  PRIMARY KEY (`counterindex`, `tagref`),
  FOREIGN KEY (counterindex) REFERENCES gltrans(counterindex),
  FOREIGN KEY (tagref) REFERENCES tags(tagref)
);

This would look something like:

___________________________________
|  counterindex   |  tagref        |
|_________________|________________
|    12345        |     5          |
|    12346        |     114        |
|    12346        |     125        |
|    12346        |     138        |
|    12347        |     8          |
|    12347        |     9          |
|_________________|________________|

The counterindex field refers to the counterindex field in the gltrans table. So in the above table transaction 1235 only has the tag 5 attached to it, transaction 12346 has 3 tags associated with it: 114, 125 and 138, and transaction 12347 has two tags associated with it, 8 and 9.

This allows for an almost unlimited number of tags to be created, and an almost unlimited number of tags to be associated with each transaction.