Retrieving Subaccount Segment Names

Overview

It is very common to design reports which show both accounts and subaccounts. It can definitely help to include the names of the accounts, so as to increase readability of the report.

Excel report showing account numbers with account names in an adjacent column

Likewise, it would be convenient to also display the names of one or more subaccount segments, as they are defined in the ERP:

Excel report with an additional column showing subaccount segment description names

With a little extra effort, up front, this can easily be accomplished.

Step-by-Step

  1. Import the custom Generic Inquiry

Import the attached Generic Inquiry to your ERP instance (it returns the contents of ERPs SegmentValue table):

Confluence attachment icon for the Velixo-SegmentValues Generic Inquiry XML file
  1. Configure the Generic Inquiry Keys
    The first time you add a reference to the new Generic Inquiry to your spreadsheet, you will receive an error message letting you know that the Generic Inquiry keys have not been configured:

    Error message indicating that GI key fields have not been configured for the Velixo-SegmentValues inquiry



    On the Velixo0 ribbon of the Excel toolbar, click the Options button:

    Velixo ribbon with Options button highlighted



    Next, double-click on the name of the Generic Inquiry:

    Velixo GI Options dialog with the Velixo-SegmentValues inquiry listed



    and then click on the button to edit the key fields for the inquiry:

    GI Options dialog showing the Key Fields configuration panel with available and selected fields



    Use the >> button to move (in order) SegmentedKeyID, SegmentID, and Value from the Available Fields to the Key Fields:

    GI Key Fields dialog with SegmentedKeyID, SegmentID, and Value moved to the selected fields list



    and then press the OK button.


    Press OK on the Velixo-SegementValues Options dialog:

    Velixo-SegmentValues Options dialog showing the configured key fields ready to save



    and press OK on the Options dialog.

Your report will refresh and your GILOOKUP function will now return a value.

  1. Enter the GILOOKUP function

    Let's assume that we want the description of the first segment "ELE" from the above example.

    That function would look like this:

    =GILOOKUP("Demo","Velixo-SegmentValues","Description","SUBACCOUNT",1,"ELE")
    


    • Demo - would be replaced by the name of your connection

    • 1 - indicates that we are interested in the first segment

    • ELE - indicates the specific subaccount first segment for which we want the description

    Since in our example the subaccount is listed in a cell, we can use Excel's text manipulation capabilities to extract it:

    =GILOOKUP("Demo","Velixo-SegmentValues","Description","SUBACCOUNT",1,LEFT(D27,3))
    


  2. Complete the Report
    We can now add the GILOOKUP functions to the rest of our report:

    Completed report with GILOOKUP functions populating subaccount segment description names for all rows