Help Center>Journal Entry Solution Help

Customizing templates

Central permissions, policies, and roles

To author templates in Journal Entry, you must have the Transaction Developer role in Central.

Default templates

Winshuttle Journal Entry provides several default templates, organized under headings of General Ledger, Accounts Payable, Accounts Receivable, or Accrual/Deferral. Depending on the type of template that you selected, you can further customize the templates for Simple post, Multiple Company post, or COPA post and, depending on the template, by t-code.

In Journal Entry for Winshuttle Central, you must store the template in Central. For more information on configuring Central, see Installing Winshuttle Journal Entry in a Winshuttle Central Environment.

Journal Entry adds efficiency by allowing multiple templates or data sheets to be added to one workbook. The entire workbook is submitted to Central, which triggers one workflow for all templates.

Create a template

  1. Open a new workbook in Excel or select an existing workbook to upload. Click the Winshuttle for Journal Entry tab.
  2. Click Logon to Central and enter your credentials.
  3. Select the Developer role.
  4. Click Customize New Template, and then select one of the default templates under the headings General Entry, Accounts Payable, Accounts Receivable, or Accrual/Deferral.
  5. Depending on the type of template selected, select Simple Post, Multiple Company Post, or COPA Post.
  6. Select the desired t-code.
  7. Select to write to the default sheet or select a specific sheet write to.
  8. Under Mapping, choose Cell Based or Column Based.

    Note: Column-based mapping is not supported for BAPIs in Journal Entry 9.3. Column-based mapping is supported for BAPIs in Journal Entry 9.4.

  9. Click Load Default Template.
  10. If you want to, add headers and data to the template.
  11. Name and save the template.
  12. You can add different templates to the same book, but each must be written to a different sheet.
    1. To add multiple templates, select the template.
    2. Specify the sheet.
    3. Validate and simulate each sheet before you submit the workbook to Winshuttle Central for approval.
  13. Click Submit to Central.
  14. When prompted, you can add supporting documents.

    You are notified that your template and any supporting documents have been submitted to the Central site.

Customizing templates

Whether you are creating a sheet from a template or creating an original template, the Journal Entry customization capabilities give you control over the mapping and naming of cells (similar to the functionality in Transaction) and over the layout of objects in the workbook.

Customize a template: overview

  1. Click Logon to Central and enter your credentials.
  2. Click Customize New Template.
  3. Select the business process, the post mode, and the t-code. Specify which sheet the template should be saved to.
  4. Under Mapping, choose Cell Based or Column Based.
  5. Click Customize New Template.
  6. On each page of the Customize pane, specify fields to include, header and cell mapping, lists of values, or document splits, as described in the sections below.

    For debit and credit indicators, use the default "S" and "H" or click the List of Values button and type in the labels you want.

    Note: You can add tax information on the Basic tab or the Tax tab. However, fields on the tax tab cannot be included in a loop.

  7. To set a custom limit on line items for each document, in the Document Length box, enter a value between 0 and 998.
  8. Save the document. Click Publish.

    Notes:
    If your template is column-based, add the Company Code on the last screen before you click Publish. You can select the column that is mapped to the Company Code, or you can type a fixed value.

    You can choose to show the field's technical name instead of its description. Check the Show Technical Name box.

  9. Enter some test data in the finished document. Validate and simulate to ensure that the template behaves correctly.
  10. Submit the document to Central.
  11. When prompted, you can add supporting documents.

    You are notified that your template and any supporting documents have been submitted to the Central site.

Customize the fields

Select and map the fields for the header and the log fields, add any lists of values that you want people to use. If you want to use the same value for a field every time, change it to Fixed. See the sections below for more details.

Then click Next, and select and map the fields for the line items, add LOVs and set any values that need to be fixed.

Selecting fields

After you select the mode, t-code, sheet, and mapping and click Customize New Template, check the Selection box for each field that you want people to use.

If a field must contain data, check both Selection box and the Required Field box.

If a field is required by a default template, you cannot uncheck it in the Required Field column. If that field does not exist on the SAP system, runners can enter a skip field indicator (for example, / ). Or, as the script developer, you can use Transaction to remove that field from the script and then import the script into Journal Entry again.

Mapping fields manually or automatically

To map fields, you need to assign a column or cell to the headers on the first page of the Customization pane and the line-item fields on the second page of the Customization pane.

Tip: Take note of the row or column where your header and log fields end so that you can avoid overlapping when you map the line items.

Map fields manually

To manually map headers, enter a cell name or column name in the Mapping column.

JE manual cell map

Map fields automatically

To automatically map headers (if you have many cells to map), check the Auto map settings box, choose the settings that you want, and then click the AutoMap button JE Automap.

Auto map settings:

  • Arrange header items vertically or horizontally (this option is available for cell-based mapping only).

    JE stacking

  • Set the Excel start column and row for the header and log items.
  • Select to write headers for header items.
  • If blank lines of cells are needed, select the line above where you want the blank line and click the Add Blank Cell button JE add space.
  • If you want, assign a list of values to a field. Click the List of Values button JE list of values select icon.

Creating a list of values

You can assign a list of values (LOV) to a cell by selecting to display entire SAP windows, include a text file, include an Excel file, or to include select SAP fields from an F4 lookup. Where a list of values appears, the value selected by the user during data entry is validated when the sheet is validated.

JE LOVs Import

Add a list of SAP values

  1. In the header or item Mapper, click the LOV button next to a field JE list of values select icon.
  2. Click SAP.
  3. Enter your SAP credentials in the SAP logon dialog box. Click OK.
  4. In the List of Values dialog box, click OK.

Create a custom LOV from a text or Excel file

  1. In the header or item Mapper, click the LOV button next to a field JE list of values select icon.
  2. Click Customize.
  3. Do one of the following:
    1. Click Text file. Browse to a local file.
    2. Set the delimiter for separating text. Click OK.

-or-

  1. Click Excel file.
  2. Browse to a local file.
  3. Specify the sheet to write to and the Excel cell range. Click OK.

Create a custom LOV from an SAP F4 lookup

  1. In the header or item Mapper, click the LOV button next to a field JE list of values select icon.
  2. Click Customize.
  3. Click SAP F4, and then click Import.
  4. If you are not already logged on, enter your SAP credentials.
  5. In the SAP list, select the items you want to add to your list. Click the green check mark.

    Although SAP descriptions are not loaded, you can customize your own descriptions. In addition, you can limit the values available. Click Delete to remove a value from the list.

    JE LOV

  6. When finished, click OK.

If you later want to change the LOV, click the LOV button in the Mapper to open the list.

Define the LOV for DOCUMENTHEADER-USERNAME

If you are using the BAPI template BAPI_ACC_DOCUMENT_POST, you can define the value for the DOCUMENTHEADER-USERNAME field by using a list of values that will scope the name to one of these three options:

  • The user's SAP ID for the SAP system (this is the default)
  • The user's Windows ID
  • A value that you enter.
  1. Click the LOV button next to the DOCUMENTHEADER-USERNAME field.
  2. In the Fixed Value box, click the option that you want.

    options for document header user name field

    If you click the third option, enter the text for the user name. For example, type Winshuttle.

Create a list of custom posting keys

  1. Click Re-Customize.
  2. Click the List of Values button for the Posting Key field.
  3. In the Debit row of the Custom Debit Credit Indicators box, click the Custom Values field, and do one of the following:
    • Type the value or values, separated by commas.
    • Click the List of Values button, check the boxes next to the values that you want to use for debit line items, and then click the Continue button.
  4. In the SAP list of possible values, check the boxes next to the values that you want to use for debit line items, and then click the Continue button.
  5. Repeat for the Credit row of the Custom Debit Credit Indicators box.
  6. To upload the custom values, check the Preserve Excel Posting Key Values box.

    If you do not check the box, SAP will convert the custom values to the default values that are listed in the Custom Debit Credit Indicators box.

    Note: In version 9.2, the Preserve Excel Posting Key Values box is checked by default.

Creating run-time and fixed values

For all header and line item fields, you can create a run-time value.

Create a run-time value for a header or line item field

  1. In the Customize pane, locate the header item or line item that people need to enter data for at run time.
  2. In the Selection Type list for that item, click Runtime.

    Note: If Journal Entry prompts you that line items will overlap with existing log and out cells, do one of the following: increase the Start Row, uncheck the Write headers for Journal Entry Header Items box, or change the mapping for header items or logs.

If you choose Runtime for a field, you can either give LOV values for that field or you can leave as it is. However, if you give the LOV values for that field, the runner will have to choose a value from the LOVs that you specified unless and until you select the Allow user to override Custom List of Values check box, which allows the runner to override the LOVs and enter a value that is not in the existing LOVs.

  • You can create a custom list of values for any of the line items listed. Click the List of Values icon JE list of values select icon next to the desired line item, select Customize, and enter the desired values in the Value List.
  • You can allow a user to override the Custom List of Values. Click the List of Values icon JE list of values select icon next to the desired line item, select Customize, select the Allow user to override Custom List of Values check box, and enter the desired values in the Value List.

Create a fixed value for a header or line item field

For all header and line item fields, you can create a fixed value—that is, a permanent value that cannot be changed. The runner will not be able to edit this value during execution.

Note: When you finish creating fixed values for headers or line item fields, the Data Review pane will show only the fields that are marked as Runtime. Fixed items will not appear in this list.

  1. In the Customize pane, locate the header item to which you want to assign a fixed value.
  2. In the Selection Type list for the item, click Fixed.

    The Fixed value for dialog box appears.

  3. In the Fixed value for dialog box, enter the value.

    Tip: If you need to find the value you want to use, click SAP F4, log on to SAP if necessary, click the value that you want to use, and then click the green check mark.

  4. Click OK.

    You will notice that the row containing the field name and description is now blue and that the cell in the Mapping column is now gray. This is because fixed values are not mapped to a particular cell in Excel.

    Note: To change a current fixed value, click the red pin in the List of Values column, enter the new value, and click OK.

Add loop information

After you map the line-item fields, click Next.

Note: If Journal Entry prompts you that line items will overlap with existing log and out cells, do one of the following: increase the Start Row, uncheck the Write headers for Journal Entry Header Items box, or change the mapping for header items or logs.

Enter the loop information:

  • If you are using cell-based mapping, type the Start Row and End Row of the line-item fields.
  • If you are using column-based mapping, you also specify an ID column and Header and Line identifiers (for example, H and D) that you will use to indicate whether a row is header data or line-item data.

Split documents

Template authors can define a custom length of between 0 and 998 line items for a document. If a runner tries to post a document that exceeds the maximum item length, a message prompts the runner to split the document. Document chunks from a split cannot be longer than the maximum length for that template.

The way that you split a document depends on the transaction code. For more information, see Split documents.