Configuring the text dialog component

Configure the basic configuration of the text dialog component.

Adding a text dialog

  1. On the application canvas, click the Manage Dialogs icon.
  2. Click + Create Dialog and select Text.
  3. Specify a name in the Component ID field.
  4. In the General Settings tab, specify the value in the Component heading field or leave it blank.
  5. Click Save.

Configuring Table, Field and Transfer file

Configure the parameters that specify the text context in M3 for the dialog. The values for FILE, FLDI, and TFIL must match the type of text to open.

  1. Open the Text dialog configuration, and click the Text Parameters tab.
  2. Specify the required text parameters:
    Table (FILE)
    The M3 table or file reference that owns the text. Include the primary index suffix when needed. For example, MPHEAD00
    Field (FLDI)
    The text subtype that identifies whether the dialog handles regular text, pre-text, or post-text. For example, TXID, PRTX, or POTX
    Transfer file (TFIL)
    The text transfer file used by the text APIs for the selected text context. For example, MSYTXH, CSYTXH,OSYTXH, or FSYTXH
  3. Click Save.
    Note: To find transfer file values, search in M3 Metadata Publisher for *SYTXH or *SYTXL.

Configuring Key Values

Key values identify the specific M3 record whose text the transaction opens, that is, the input parameters for the GetTextID and SetTextID transactions.

  1. In the Text Parameters tab, navigate to the Key Values section.
  2. In the Key Values section, locate the KV01 or Key Value 1 row.
  3. In the Source column, select User Context. Then, in the Source field column, select CONO.
  4. Configure additional Key Values, for example, identifiers to the selected record, as needed.

Configuring Company and Division

Use the Company and Division setting to control whether CONO and/or DIVI are included in the API transactions for listing, updating, and deleting text blocks. The requirement varies for each underlying table or program (TFIL), which can require both CONO and DIVI, only CONO, or neither value.

  1. In the Text configuration, click the Text Parameters tab.
  2. In the Company and Division field, select an option:
    Include company and division
    The dialog sends both CONO and DIVI.
    Include company only
    The dialog sends CONO but not DIVI.
    Exclude company and division
    The dialog does not send CONO or DIVI for transactions where they are excluded.
  3. Click Save.
    Note: If you have access to Business Engine Data Management, you can navigate to the Update Database tab and check the CONO and DIVI values for existing text records.