Journal user fields

The journal user fields let you define supplementary information for a journal header or line. You define both the name and value of the journal user field.

Multiple journal user field sets can be created per type of input transactional business document that will be processed. A set contains the journal user field assignments that identifies that source of value for each additional field.

The type of values that can be assigned to a journal user field are:

  • Fixed value
  • Attribute of a transactional document
  • Expression

Names of the journal user fields are defined in the BOD and DSV Registration page. You must map UserArea properties (UserArea/Property/NameValue) with filter on the name attribute. This can be added in the JournalEntryHeader or JournalEntryLine component of the SourceSystemJournalEntry BOD Registration.

See Registering business object documents (BODs).

For example, assume that for an input PurchaseOrder transaction, the output SourceSystemJournalEntry business document must have three (3) additional fields for each journal entry line, namely, PO Item Number, PO Item Description and PO Unit Price. Each field must have a corresponding mapping in the JournalEntryLine component with Xpath as follows:

  • SourceSystemJournalEntry/JournalEntryLine/UserArea/Property/NameValue{'@name' == 'POItem Number'}
  • /SourceSystemJournalEntry/JournalEntryLine/UserArea/Property/NameValue{'@name' == 'POItem Description'}
  • /SourceSystemJournalEntry/JournalEntryLine/UserArea/Property/NameValue{'@name' == 'POUnit Price'}

Journal user fields search templates

There are two system-defined search templates available to retrieve the setup information from Journal User Fields.

Search template Description
getJournalHeaderUserField

Retrieves the header journal user fields that are assigned to a given transaction and journal user field set name.

getJournalLineUserField

Retrieves the line journal user fields that are assigned to a given transaction and journal user field set name.