globe with meridians Language: Deutsch · English

hammer and wrench 4.8.1 Reference objects to be considered

4.8.1 Reference objects to be considered – part of the MT940 Nuclet documentation (reference objects considered during the MT940 import).

HOW-TO INTEGRATORS UPDATED: JUL 2026 APPLIES TO NUCLOS 4.2026.X

On this page

Machine-translated – under review

This page was machine-translated from German as a first draft and is currently under review. The authoritative source remains the German original (see the language switch above).

The method getReferences() of the abstract class AbstractMT940Logic is executed before the import process. It serves to read in all already existing objects that are to be used as possible reference objects when importing the bank transactions (e.g. customer invoices that are still open and have not already been assigned to a bank transaction).

The default behaviour of the Nuclet considers all reference objects that are in one of those statuses defined via the method getSourceStates() of the class ReferenceFacade (see section 4.7.3).

If the default behaviour is to be modified, supplemented or extended for your own application, your own method getReferences() must be created in the class MT940Logic or in your own implementation of AbstractMT940Logic.

org.nuclet.mt940.logic.MT90Logic
  
/**
  * Fetches all references that need to be considered during the MT940 import process, e.g.
  * all open client billings/invoices that have not yet been linked to other bank transactions
  * 
  * @note A dummy implementation of <code>org.nuclet.mt940.logic.AbstractMt940Logic</code> has 
  * been  provided with this class here, its methods are meant to be implemented with user 
  * specific behaviour.
  * 
  * @return all references that need to be considered during the MT940 import process; the return
  * value comes as as <code>Map</code> in which the <code>BusinessObject</code> represents the
  * map's key while the text, which is meant to be used to link the reference to a bank
  * transaction, represents the map's value
  * 
  * @throws BusinessException might be thrown in case of errors or other exceptions
  *
  */
 public Map<BusinessObject, String> getReferences() throws BusinessException
 {
     final HashMap<BusinessObject, String> mpReferences = new HashMap<BusinessObject, String>();
        
     final Query<ClientBilling> qryGetReferencesStateAB = QueryProvider.create(ClientBilling.class)                             
		.where(ClientBilling.NuclosState.eq(ProcessClientBillingSM.State_AB.getId()))
		.and(ClientBilling.Facturated.eq(Boolean.FALSE));

     final List<Rechnung> lstReferencesStateAB = QueryProvider.execute(qryGetReferencesStateAB);                
     
     for (final ClientBilling clientBilling : lstReferencesStateAB) {
         mpReferences.put(clientBilling, clientBilling.getBillingNumber());
     }
     
     final Query<ClientBilling> qryGetReferencesStateXY = QueryProvider.create(ClientBilling.class);                                
	     .where(ClientBilling.NuclosState.eq(ProcessClientBillingSM.State_XY.getId()))
		 .and(ClientBilling.Facturated.eq(Boolean.FALSE));

     final List<ClientBilling> lstReferencesStateXY = QueryProvider.execute(qryGetReferencesStateXY);                
      
     for (final ClientBilling clientBilling : lstReferencesStateXY) {
         mpReferences.put(clientBilling, clientBilling.getBillingNumber());
     }
     
     return mpReferences;     
  
}




Related pages

open book 4.8 MT940: Specific extensions


Back to 4.8 MT940: Specific extensions

Open →

open book Nuclet Wiki


Nuclet Wiki home

Open →

  • Keine Stichwörter