CustTrans::settleTransaction を使用したトランザクションの決済

[アーティクル]
06/27/2024

CustTrans::settleTransact が過去のものに

CustTransテーブルの settleTransact メソッドが刷新されます。

public static boolean settleTransact(
CustTable _custTable,
    LedgerVoucher _ledgerVoucher = null,
    boolean _balancePostingProfile = true,
    SettleDatePrinc _saveDatePrinciple = SettleDatePrinc::DateOfPayment,
    TransDate _saveDate = dateNull()
    ,DimSettlementType_RU _dimSettlementType = DimSettlementType_RU::None
    ,CustTrans _parentCustTrans = null)

廃止とはなにか?

メソッドが廃止としてマークされている場合、コードが不要になり、最終的に製品から削除される予定ということです。多くの場合、廃止メソッドは使用できる代替メソッドを推奨します。参照コードは、引き続き廃止メソッドと共に正常に動作します。直接的なアクションは必要ありません。ただし、置換メソッドを使用するには、参照コードをリファクタリングする必要があります。

廃止プロセスの詳細については、メソッドおよびメタデータ要素の廃止を参照してください。

なぜ刷新される必要があるのか。

同じ顧客に対して複数の決済が同時に行われると、データベースのブロックが発生します。データベースのブロックはパフォーマンスの低下につながります。

このメソッドによってできること

settleTransact メソッドでは、特定の顧客に対する一連の請求書と支払の決済を行います。決済処理では、SpecTrans テーブルの SpecCompany、 SpecTableId、 SpecRecId 列を使用して一連の請求書を識別します。同時に、これらの列によって決済コンテキストが定義されます。

settleTransact メソッドの _custTable パラメーターが、決済コンテキストを CustTable DataAreaId、 TableId、RecId の値として定義します。次の例は、2つのコンテキストを示しています。

SpecCompany	SpecTableId	SpecRecId	取引
USMF	7589	22565451428	1
USMF	7589	22565451428	2

メソッドの更新

CustTrans テーブル settleTransaction メソッドがメソッドの更新を行います。

public static boolean settleTransaction(
    SpecTransExecutionContext _specTransExecutionContext,
    CustTransSettleTransactionParameters _parameters)

ブロックがどのように回避されるか

それぞれの顧客の決済に固有の決済コンテキストが付与されます。決済にはそれぞれ固有のコンテキストが割り当てられるため、どのトランザクションもブロックを引き起こすことがなくなります。次の例は、2つのコンテキストを示しています。各コンテキストには一意の SpecRecId 値を持っています。

SpecCompany	SpecTableId	SpecRecId	取引
USMF	7599	68719604825	1
USMF	7599	68719604826	2

メソッドのパラメーターを更新する

SpecTransExecutionContext クラスは、一意となる決済の実行コンテキストを定義します。これは2つの部分で構成されています。一つ目の部分は、決済の顧客または仕入先を定義します。 2つ目の部分では、決済のソースを定義します。

newFromSource メソッドには、顧客、仕入先、およびソースが必要となります。顧客、仕入先、ソースは常に顧客となります。
```
public static SpecTransExecutionContext newFromSource(
    CustVendTable _custVendTable, 
    Common _source = _custVendTable)
```
parmSpecContext メソッドは、生成された決済コンテキストを公開します。
```
public Common parmSpecContext()
```

CustTransSettleTransactionParamters 他のメソッドパラメータを再確認します。これに含まれるコンストラクターメソッドは、既定値を使用してクラスの初期化を行います。その一例として LedgerVoucher が挙げられます。

settleTransaction メソッドの使用方法

決済は2つの部分で行われます。はじめに、決済処理に向けて請求書と支払を選び出します。次に、決済処理を行います。

古いコードの例

//Mark for settlement
SpecTransManager specTransManager = SpecTransManager::construct(custTable);

specTransManager.insert(…) //Invoice(s)
specTransManager.insert(…) //Payment(s)

//Settle
CustTrans::settleTransact(recipientCustVendTable);

新しいコードの例

//Mark for settlement
SpecTransExecutionContext specTransExecutionContext = SpecTransExecutionContext::newFromSource(custTable);
specTransManager = SpecTransManager::newFromSpec(specTransExecutionContext.parmSpecContext());

specTransManager.insert(…) //Invoice(s)
specTransManager.insert(…) //Payment(s)

//Settle
CustTrans::settleTransaction(
    specTransExecutionContext,
    CustTransSettleTransactionParameters::construct());

テスト

この機能はフライトを使用します。このテストを行うには、非運用環境にてフライトを有効にする必要があります。非運用環境でフライトをオンにする方法については、データ管理の概要を参照してください。

フライトの名称は EnableCustTransSettleTransactionです。

次の方法で共有