SALTRS: Manage the specific/custom fields

This entry point concerns the management of sales entry transactions. It is common to all transactions - quotes, orders, contract orders, shipment, returns and invoices.

It is used to manage the added fields in specific/custom in the same way as the standard fields.

This entry point is located in the SUBSLX process.

Context and operating method

Transaction

During the running of the CREATION,  MODIF,  ANNULE, LIENS, INICRE and INIMOD actions, there is a transaction in process. The GOK variable is used and tested. It is equal to 1. It can be set to 0 if the transaction should be abandoned.

During the running of the APRES_MODIF action there is no transaction in process.

Log file

There is no open log file.

Different call cases

It is called in the actions CREATION,  MODIF,  ANNULE, LIENS, APRES_MODIF,  INICRE, INIMOD  by  Gosub PE_SALTRS From SUBSLX in the processes :

-          SUBSLQ : quote transactions

-          SUBSLC :order transactions

-          SUBSLO : open contract order transactions

-          SUBSLD : shipment transactions

-          SUBSLR : return transactions

-          SUBSLI : invoice transactions

Recall of the contents of the SALTRS table

The data contained in the SALTRS table concerning the storage of the sales module entry setups that are modifiable by transactions. A precise standardization must be respected.

Data added in a screen must correspond to the creation of the data in the SALTRS table.

The data added can be of 4 different types.

Data type

Data

screen

Define in

SALTRS

Menu

menu

Values

A- Header that cannot be entered

 AAAA

AAAACOD

1

 1 = no / 2 = yes  (Display)

B- Header that can be entered

 BBBB

 BBBBCOD

35

 1 = enter / 2 = display / 3 = hidden

C- Line that cannot be entered

 CCCC

CCCCCOD

 CCCCSCR

1

99

 1 = no / 2 = yes  (Display)

 1 = record+grid / 2 = record / 3 = grid

D- Line that can be entered

 DDDD

 DDDDCOD

 DDDDSCR

35

99

 1 = enter / 2 = display / 3 = hidden

 1 = record+grid / 2 = record / 3 = grid

Available masks

 

Transaction

Entry screens

 

Add

data

Screen for

setup

Type of

data

added

 

 

 

 

 

Quotation

SQH0 : Header screen

No

SLQ0 : Header screen

---

 

SQH1 : Management tab

Yes

SLQ1 : Parameters tab

A - B  - C

 

SQH3 : Invoicing tab

Yes

SLQ2 : Header tab

B

 

SQH2 : Lines tab

Yes

SLQ3 : Line 1 tab

D

 

 

 

SLX1 : Line 2 tab

---

 

 

 

 

 

Orders

SOH0 : Header screen

No

SLC0 : Header screen

---

 

SOH1 : Management tab

Yes

SLC1 : Parameters tab

A

 

SOH2 : Shipment tab

Yes

SLC2 : Header tab

B

 

 

 

SLC5 : Display tab

 A - C

 

SOH3 : Invoicing tab

Yes

SLC2 : Header tab

B

 

 

 

SLC5 : Display tab

 A - C

 

SOH4 : Lines tab

Yes

SLC3 : Line 1 tab

D

 

 

 

SLC4 : Line 2 tab

D

 

 

 

SLX1 : Line 3 tab

---

 

 

 

 

 

Contract orders

SOR1 : Contract screen

Yes

SLO0 : Header screen

---

 

SOI1  : Product screens

Yes

SLO1 : Parameters tab

A - B  - C

 

 

 

SLO2 : Header tab

B

 

 

 

SLO3 : Line 1 tab

 B - D

 

 

 

SLX1 : Line 2 tab

---

 

 

 

 

 

Deliveries

SDH0 : Header screen

No

SLD0 : Header screen

---

 

SDH1 : Lines tab

Yes

SLD1 : Parameters

 A - C

 

SDH2 : Management tab

Yes

SLD2 : Header

B

 

SDH3: Additions tab

 

SLD3 : Line 1

D

 

 

 

SLX1 : Line 2

---

 

 

 

 

 

Returns

SRH1 : Header lines screen

Yes

SLR0 : Header screen

---

 

 

 

SLR1 : Parameters tab

 A - C

 

 

 

SLR2 : Header/line tab

 B - D

 

 

 

 

 

Invoices

SIH0 : Header screen

No

SLI0 : Header screen

---

 

SIH1 : Management tab

Yes

SLI1 : Parameters tab

 A - C

 

SIH2 : Invoicing tab

Yes

SLI2 : Header tab

B

 

SIH4 : Valuation tab

No

SLI3 : Line 1 tab

D

 

 

 

SLX1 : Line 2 tab

---

 

 

 

 

 

Available variables

The following variables are available to define the process to be carried out :

PACTION                  Standard action GOBJET at the origin of the call

PVERSION                  Numeric variable for the contents of GVERSION

                   ( if GVERSION="1.2.4" to PVERSION=124 )

FJL                  Transaction type ( SLQ= Quote, SLC= Orders, SLO=

                   Contract orders, SLD= Shipments, SLR= Returns,

                   SLI= Invoices).

MFROM                  Code for the entry screen

Open tables

Table

Process

Significant content

Table Title

SALTRS

SUBSLQ

SUBSLC

SUBSLO

SUBSLD

SUBSLR

SUBSLI

 

Sales entry transactions

 

The AWINDOW, AWINPAR, AREPORT, AMSK, AMSKZON, AMSKACT tables, as well as all the tables necessary for the management of the generation of the screens and process are open but must in no case be modified in the entry point process.

Example of the specific/custom process of the entry point

 #########################################################################

# Process for the entry point in the transactions

# Example : Add data to the order management

# - AAAA (not enterable) in Management screen   SOH1    

# - BBBB (enterable)     in Shipment tab SOH2 

# - CCCC (not enterable) in Lines tab    SOH4

# - DDDD (enterable)     in the Lines tab    SOH4

#########################################################################

ACTION example

  When "SALTRS"  : Gosub SALTRS

Endcase

Return

 

#########################################################################

$SALTRS

    Case FJL

  When "SLQ" : Gosub SALTRS_SLQ : # quote transaction

  When "SLC" : Gosub SALTRS_SLC : # order transaction

  When "SLO" : Gosub SALTRS_SLO : # contract order transaction

  When "SLD" : Gosub SALTRS_SLD : # shipment transaction

  When "SLR" : Gosub SALTRS_SLR : # return transaction

  When "SLI" : Gosub SALTRS_SLI : # invoice transaction

Endcase

Return

 

#------------------------------------------------------------------------

$SALTRS_SLQ

Return

 

#------------------------------------------------------------------------

$SALTRS_SLC

Case PACTION

  When "CREATION", "MODIF", "ANNULE","EXEBOUT","MASSE"

    If MFROM="SOH1"

      If [M:SLC5]AAAACOD = 1  TZONE(IZON)="AAAA"

                              TMOD (IZON)=3

                              IZON +=1

Endif

Endif

    If MFROM="SOH2"

      If [M:SLC2]BBBBCOD > 1  TZONE(IZON)="BBBB"

                              TMOD (IZON)=[M:SLC2]BBBBCOD

                              IZON +=1

Endif

Endif

    If MFROM="SOH4"

      If [M:SLC5]CCCCCOD = 1  TZONE(IZON)="CCCC"

                              TMOD (IZON)=3

                              IZON +=1

Else

        ZT="CCCCSCR" : ZM="CCCC" : Gosub TABLEAU_FICHE From SUBSLX

Endif

      If [M:SLC3]DDDDCOD > 1  TZONE(IZON)="DDDD"

                              TMOD (IZON)=[M:SLC3]DDDDCOD

                              IZON +=1

Endif

      If [M:SLC3]DDDDCOD = 1 | [M:SLC3]DDDDCOD = 2

        ZT="DDDDSCR" : ZM="DDDD" : Gosub TABLEAU_FICHE From SUBSLX

Endif

Endif

 

  When "APRES_MODIF"        : Gosub APRES_MODIF

 

  When "LIENS" Gosub LIENS

 

  When "INICRE" , "INIMOD"  : Gosub INICRE

 

When Default :

 

Endcase

Return

 

#------------------------------------------------------------------------

$SALTRS_SLO

Return

 

#------------------------------------------------------------------------

$SALTRS_SLD

Return

 

#------------------------------------------------------------------------

$SALTRS_SLR

Return

 

#------------------------------------------------------------------------

$SALTRS_SLI

Return

 

#------------------------------------------------------------------------

$APRES_MODIF 

# action common to the different transactions

# action only to be developed for the line data

Local Char PCOUZON : # to stock the compatible name V120 and V130

If PVERSION < 130  PCOUZON=zoncou

  Else             PCOUZON=COUZON

Endif

 

If PCOUZON = "CCCCCOD" : Gosub CCCCCOD : Endif

If PCOUZON = "DDDDCOD" : Gosub DDDDCOD : Endif

 

Return

 

#------------------------------------------------------------------------

$LIENS 

# action common to the different transactions

# action only to be developed for the line data

Gosub CCCCCOD

Gosub DDDDCOD

Return

 

#------------------------------------------------------------------------

$INICRE 

# action common to the different transactions

# action only to be developed for the line data

ZONECOD="CCCCCOD"  : Gosub INICRE_SCR From SUBSLX

ZONECOD="DDDDCOD"  : Gosub INICRE_SCR From SUBSLX

Return

 

#------------------------------------------------------------------------

$CCCCCOD

If dim([M]CCCCCOD)>0 & dim([M]CCCCSCR)>0

  If [M]CCCCCOD=1

     [M]CCCCSCR=1

     If !GIMPORT

       If FJL="SLC" : Affzo [M:SLC5]CCCCSCR : Grizo [M:SLC5]CCCCSCR : Endif

Endif

Else

     If !GIMPORT

       If FJL="SLC" : Actzo [M:SLC5]CCCCSCR : Endif

Endif

Endif

Endif

Return

 

#----

$DDDDCOD

If dim([M]DDDDCOD)>0 & dim([M]DDDDSCR)>0

  If [M]DDDDCOD=3

     [M]DDDDSCR=1

     If !GIMPORT

       If FJL="SLC" : Affzo [M:SLC3]DDDDSCR : Grizo [M:SLC3]DDDDSCR : Endif

Endif

Else

     If !GIMPORT

       If FJL="SLC" : Actzo [M:SLC3]DDDDSCR : Endif

Endif

Endif

Endif

Return

#########################################################################

 

SALTRSWIN: Modify the entry window

This entry point concerns the management of sales entry transactions. It is common to all transactions - quotes, orders, contract orders, shipment, returns and invoices.

It is used to modify the window generated by the transaction, notably to delete a specific/custom tab.

This entry point is located in the SUBSLX process.

Context and operating method

Transaction

There is one transaction in progress. The GOK variable is used and tested. It is equal to 1. It can be set to 0 if the transaction should be abandoned.

Log file

There is no open log file.

Different call cases

 It is called in the CREATION,  MODIF,  and ANNULE actions in the processes :

-          SUBSLQ : quote transactions

-          SUBSLC :order transactions

-          SUBSLO : open contract order transactions

-          SUBSLD : shipment transactions

-          SUBSLR : return transactions

-          SUBSLI : invoice transactions

Available masks

Transaction

Entry screens

 

Setup screens

 

 

 

Quotation

SQH0 : Header screen

SLQ0 : Header screen

 

SQH1 : Management tab

SLQ1 : Parameters tab

 

SQH3 : Invoicing tab

SLQ2 : Header tab

 

SQH2 : Lines tab

SLQ3 : Line 1 tab

 

 

SLX1 : Line 2 tab

 

 

 

Orders

SOH0 : Header screen

SLC0 : Header screen

 

SOH1 : Management tab

SLC1 : Parameters tab

 

SOH2 : Shipment tab

SLC5 : Display tab

 

SOH3 : Invoicing tab

SLC2 : Header tab

 

SOH4 : Lines tab

SLC3 : Line 1 tab

 

 

SLC4 : Line 2 tab

 

 

SLX1 : Line 3 tab

 

 

 

Contract orders

SOR1 : Contract screen

SLO0 : Header screen

 

SOI1  : Product screens

SLO1 : Parameters tab

 

 

SLO2 : Header tab

 

 

SLO3 : Line 1 tab

 

 

SLX1 : Line 2 tab

 

 

 

Deliveries

SDH0 : Header screen

SLD0 : Header screen

 

SDH1 : Lines tab

SLD1 : Parameters

 

SDH2 : Management tab

SLD2 : Header

 

SDH3: Additions tab

SLD3 : Line 1

 

 

SLX1 : Line 2

 

 

 

Returns

SRH1 : Header lines screen

SLR0 : Header screen

 

 

SLR1 : Parameters tab

 

 

SLR2 : Header/line tab

 

 

 

Invoices

SIH0 : Header screen

SLI0 : Header screen

 

SIH1 : Management tab

SLI1 : Parameters tab

 

SIH2 : Invoicing tab

SLI2 : Header tab

 

SIH4 : Valuation tab

SLI3 : Line 1 tab

 

 

SLX1 : Line 2 tab

 

 

 

Available variables

The following variables are available to define the process to be carried out :

[F:SLT]STRTYP            Transaction type

[F:SLT]STRNUM           Transaction code

FOBJ                             Name of the OBJect ( "SQH", "SOH", "SOR", "SDH", "SIH", "SRH" )

WINREF                        Name of the reference window

                            = "O"+Name of the OBJect ( "SQH", "SOH", "SOR", "SDH", "SIH", "SRH" )

NOMWIN                       Name of the window generated for this transaction

                                       ="WO"+Name of the OBJect+Transaction code

Transaction type

Description

FOBJ

WINREF

NOMWIN

1

Quotation

SQH

OSQH

"WOSQH" + [F:SLT]STRNUM

2

Orders

SOH

OSOH

"WOSOH" + [F:SLT]STRNUM

3

Contract orders

SOR

OSOR

"WOSOR" + [F:SLT]STRNUM

4

Deliveries

SDH

OSDH

"WOSDH" + [F:SLT]STRNUM

5

Invoices

SIH

OSIH

"WOSIH" + [F:SLT]STRNUM

6

Returns

SRH

OSRH

"WOSRH" + [F:SLT]STRNUM

Open tables

 Table

Process

Significant content

Table Title

SALTRS

SUBSLQ

SUBSLC

SUBSLO

SUBSLD

SUBSLR

SUBSLI

 

Sales entry transactions

The AWINDOW, AWINPAR, AREPORT, AMSK, AMSKZON, AMSKACT tables, as well as all the tables required for the management of the screen generation and processes are open.