|
Functionality
Using this method you can write operand values to the installationfacts.
This is possible for operands of the following operand categories:
QUANT; DEMAND; TQUANT; AMOUNT; FACTOR; FLAG; INTEGER; RATETYPE; QPRICE;USERDEF; TPRICE; SPRICE; LPRICE.
In most cases you will want to update only ONE installation fact viathe BAPI, such as an amount. In this case, you must make one entry onlyin the AMOUNTTABLE table, which is used for updating operands of theAMOUNT category.
If you wish to update several entries at once, note that if an updateerror does occur, all entries already processed will also be lost inthe case of a rollback. Example
The following example illustrates updating based on transferred timeslices.
Case 1: UPDFORCE parameter is set (= 'X')
Old installation facts:
01/01/1997 to 01/31/1997 operand value 1
02/01/1997 to 02/28/1997 operand value 2
03/01/1997 to 12/31/9999 operand value 3
If the following time slice is transferred by the user program -
01/15/1997 to 03/15/1997 operand value 4
then this results in the following new installation facts:
01/01/1997 to 01/14/1997 operand value 1
01/15/1997 to 03/15/1997 operand value 4
03/16/1997 to 12/31/9999 operand value 3
This case illustrates that existing time slices can be prorated oroverwritten.
Case 2: UPDFORCE parameter is not set (= ' ')
In this case the function module returns the error message AH 878 inthe RETURN parameter. Overwriting of the installation facts isrejected.
In both cases the OVERWRITE export parameter is set for informationpurposes. Notes
Messages are returned in the RETURN parameter.
Messages AH 875 and AH 876 indicate errors by the calling user programduring parameter transfer.
Message AH 878 indicates that the installation facts cannot beoverwritten because UPDFORCE = ' '.
All other error messages result from the internal function moduleISU_S_INSTLN_CHANGE specific to IS-U and cannot be listed hereindividually. These messages indicate that the update could not becarried out due to inconsistencies. Description
If the OVERWRITE indicator is returned by the BAPI, an operand overlapsat least once with existing installation facts.
If the import parameter UPDFORCE = 'X', then existing installationfacts are overwritten.
If the import parameter UPDFORCE = ' ', then existing installationfacts are NOT overwritten. Termination occurs with the error AH 878. Value range
'X': Overlapping has occurred with existing installation facts.
' ': No overlapping has occurred with existing installation facts. Description
Standard structure for returning error messages in BAPIs. Description
The key for the installation for which the installation facts are to bechanged must be entered in this parameter. Description
Using the UPDFORCE indicator you can control whether existinginstallation facts are to be overwritten in the case of overlapping. Value range
'X': Existing values are overwritten if necessary.
' ': Existing values are NOT overwritten; if necessary, error message
AH 878 is returned in the RETURN parameter. Default
' ': In most cases, you wish to insert new installation facts and
therefore prevent existing facts from being overwritten. Description
You have to enter data in table ADISCABSTABLE if operand values foroperands belonging to category ADISCABS need to be updated in theinstallation facts. Description
You have to enter data in table ADISCPERTABLE if operand values foroperands belonging to category ADISCPER need to be updated in theinstallation facts. Description
Entries must be made in the AMOUNTTABLE if operand values for operandsof the AMOUNT category are to be updated to the installation facts. Description
You have to enter data in table DDISCNTTABLE if operand values foroperands belonging to category DDISCNT need to be updated in theinstallation facts. Description
Entries must be made in the DEMANDTABLE table if operand values foroperands of the DEMAND category are to be updated to the installationfacts. Description
Entries must be made in the FACTORTABLE table if operand values foroperands of the FACTOR category are to be updated to the installationfacts. Description
Table FLAGTABLE has to be filled when you want to update operand valuesfor category FLAG in the installation facts. Description
Entries must be made in the INTEGERTABLE table if operand values foroperands of the INTEGER category are to be updated to the installationfacts. Description
Table LPRICETABLE has to be filled when you want to update operandvalues for category LPRICE in the installation facts. Description
You have to enter data in table PDISCNTTABLE if operand values foroperands belonging to category PDISCNT need to be updated in theinstallation facts. Description
You have to enter data in table QDISCNTTABLE if operand values foroperands belonging to category QDISCNT need to be updated in theinstallation facts. Description
Table QPRICETABLE has to be filled when you want to update operandvalues for category QPRICE in the installation facts. Description
Entries must be made in the QUANTTABLE table if operand values foroperands of the QUANT category are to be updated to the installationfacts. Description
Entries must be made in the RATETYPETABLE table if operand values foroperands of the RATETYPE category are to be updated to the installationfacts. Description
You should only make entries in the SEASONTABLE table if operand valuesof the category SEASON are to be updated in the installation facts. Description
Table SPRICETABLE has to be filled when you want to update operandvalues for category SPRICE in the installation facts. Description
Table TPRICETABLE has to be filled when you want to update operandvalues for category TPRICE in the installation facts. Description
Entries must be made in the TQUANTTABLE table if operand values foroperands from the TQUANT category are to be updated to the installationfacts. Description
Table USERDEFTABLE has to be filled when you want to update operandvalues for category USERDEF in the installation facts. |