LN 10.8.X Lnstudioag En-Us
LN 10.8.X Lnstudioag En-Us
LN 10.8.X Lnstudioag En-Us
Release 10.8.x
Copyright © 2022 Infor
Important Notices
The material contained in this publication (including any supplementary information) constitutes and contains
confidential and proprietary information of Infor.
By gaining access to the attached, you acknowledge and agree that the material (including any modification,
translation or adaptation of the material) and all copyright, trade secrets and all other right, title and interest
therein, are the sole property of Infor and that you shall not gain right, title or interest in the material (including
any modification, translation or adaptation of the material) by virtue of your review thereof other than the
non-exclusive right to use the material solely in connection with and the furtherance of your license and use
of software made available to your company from Infor pursuant to a separate agreement, the terms of which
separate agreement shall govern your use of this material and all supplemental related materials ("Purpose").
In addition, by accessing the enclosed material, you acknowledge and agree that you are required to maintain
such material in strict confidence and that your use of such material is limited to the Purpose described above.
Although Infor has taken due care to ensure that the material included in this publication is accurate and
complete, Infor cannot warrant that the information contained in this publication is complete, does not
contain typographical or other errors, or will meet your specific requirements. As such, Infor does not assume
and hereby disclaims all liability, consequential or otherwise, for any loss or damage to any person or entity
which is caused by or relates to errors or omissions in this publication (including any supplementary
information), whether such errors or omissions result from negligence, accident or any other cause.
Without limitation, U.S. export control laws and other applicable export and import laws govern your use of
this material and you will neither export or re-export, directly or indirectly, this material nor any related
materials or supplemental information in violation of such laws, or use such materials for any purpose
prohibited by such laws.
Trademark Acknowledgements
The word and design marks set forth herein are trademarks and/or registered trademarks of Infor and/or
related affiliates and subsidiaries. All rights reserved. All other company, product, trade or service names
referenced may be registered trademarks or trademarks of their respective owners.
Publication Information
Release: Infor LN 10.8.x
Publication Date: September 1, 2022
Document code: ln_10.8.x_lnstudioag__en-us
Contents
Contents
Preferences - Templates..............................................................................................................................31
Preferences - Launching..................................................................................................................................32
Preferences - Multipage...................................................................................................................................33
Preferences - Workbench.................................................................................................................................33
Preferences - Infor LN Configuration Management........................................................................................34
Chapter 5: Integration preferences..............................................................................................36
Configuration...................................................................................................................................................36
General preferences.........................................................................................................................................37
Business Interface Test Tool preferences.......................................................................................................37
Color preferences.............................................................................................................................................37
Defining a set of default libraries.....................................................................................................................38
Defining a default set of related software projects........................................................................................38
Preferences of Infor LN Studio Implementation Generator...........................................................................39
Chapter 6: Connectivity preferences............................................................................................40
Connection Points Configuration....................................................................................................................40
Log Configuration.............................................................................................................................................40
Chapter 7: Infor LN Project Server...............................................................................................42
Infor LN Project Server.....................................................................................................................................42
Procedures........................................................................................................................................................42
Defining a software project..........................................................................................................................42
Dialogs..............................................................................................................................................................43
New Development Environment.................................................................................................................43
Create a new Application.............................................................................................................................43
Create a Software Project............................................................................................................................47
Create a new Activity....................................................................................................................................48
Compile activity overview............................................................................................................................49
Project Server View Filter.............................................................................................................................49
Perspectives.....................................................................................................................................................50
Project Server perspective...........................................................................................................................50
Views.................................................................................................................................................................50
Application Explorer view............................................................................................................................50
Software Project Explorer view...................................................................................................................52
Glossary....................................................................................................................................55
Document Summary
This document describes how administrators can install and configure Infor LN Studio and Infor LN Project
Server.
Related documents
You can find the documents in the product documentation section of the Infor Support Portal, as described
in "Contacting Infor".
• Infor LN Studio Application Development Guide
Contacting Infor
If you have questions about Infor products, go to Infor Concierge at https://concierge.infor.com/ and create
a support incident.
The latest documentation is available from docs.infor.com or from the Infor Support Portal. To access
documentation on the Infor Support Portal, select Search > Browse Documentation. We recommend that
you check this portal periodically for updated documentation.
If you have comments about Infor documentation, contact [email protected].
First installation
Prerequisites
This section describes the prerequisites to run LN Studio.
Licenses
To use LN Studio, you need these licenses:
• A license for the Adapter for LN. Take care of the following:
• If you already have an Adapter for LN license for product ID 7013, you do not need a new license.
• If you do not have a license yet, obtain a license for product ID 7056.
• An LN Development license, product ID 10146. This is required if you want to create or modify tables,
domains, UI scripts, functions, or libraries. This license is also required if you want to modify and generate
Business Interface implementations.
To obtain a license, add the corresponding product ID in the Infor Solution License Manager (SLM) and request
a license for it.
2 Ensure users can access the zip file. For example, put the file on a network share.
Installing LN Studio
This section describes how you can install LN Studio.
Note:
• For information on the prerequisites for the installation of LN Studio, see Prerequisites on page 7.
• Before you can install LN Studio, the system administrator must give you access to the zip file with the
LN Studio software.
To install LN Studio:
1 Create an installation folder.
b In the left pane of the Preferences window, select Infor LN Studio Integration. For details about
the preferences, see the "Integration Preferences" section in this guide or the preference page's
online help.
3 Click OK.
4 Allow installation of BW and Dynamic Form Editor.
LN Studio requires Infor BW activation for the development and runtime addresses. LN Studio also
requires the Infor LN Dynamic Form Editor (DFE) to develop session forms.
If BW and DFE are not installed on your computer, or older versions are installed, an automatic installation
of these components is performed when you start LN Studio for the first time.
If User Account Control (UAC) is enabled, confirmation dialog boxes are displayed during the BW and DFE
installations: you are prompted to allow the BW and DFE setup programs to make changes to your
computer.
Click Yes in both dialog boxes.
This table shows the static connection points you must configure to define the connectivity settings:
The Configure Connection point wizard is part of the connectivity plug-in. For details, see the wizard's
online help and the online help of the Infor Connectivity plug-in.
Note:
• You can use the Preferences dialog box to set various other user preferences for the LN Studio workbench.
See "Application preferences", "Integration preferences", and "Connectivity preferences" in the Infor
LN Studio Administration Guide.
• To run or debug sessions after creating or modifying the Debug connection point, you must restart LN
Studio.
• In a multi-tenant environment you cannot debug with LN Studio. You can use the Debug Workbench, see
the Debug and Profile 4GL (ttadv1123m000) session.
• In a multi-tenant environment you cannot run or debug BFlows with LN Studio. You can run BFlows in
the LN UI to see the result.
b Specify the file name. Use a .jks extension for the file name. For example, specify
LNStudioTrustStore.jks.
c To complete the browse dialog box, click Open or press Enter.
4 Optionally, specify a password for the trust store. If you leave the field blank, a default password is used.
5 Click Apply. If the trust store did not yet exist, you are prompted whether you want to create a new one.
Click Yes.
6 The certificates in the chosen trust store are listed in the Certificates table, and the Add button is enabled
now. If you have a copy of the certificate in a file, you can click Add to add that certificate. Usually, this
is not the case, so you must use another way.
7 In the Check Trusted URL field, specify the HTTPS URL of the LN UI server you want to use. You can go
back to the Cloud Environments preference page, select the configured cloud environment, click Edit,
and copy the Gateway URL. The Gateway URL is the first part of the URL to the LN UI server.
8 Click Check. Usually, a "Check failed" dialog, which suggests to import the certificate presented by the
server, is displayed. Click Yes. The Import Certificate dialog box is displayed.
9 In the Import Certificate dialog box, the Server Certificates drop-down list may contain more than one
certificate.
The HTTPS server presents a chain of certificates, starting with its own certificate. Next is the certificate
of the Certification Authority (CA) that issued the server certificate, followed by the issuer of the CA
certificate, and so on. The last certificate in the chain is usually a "root CA certificate", issued by itself.
You must import the last certificate. This certificate is already selected in the drop-down list. Details of
the selected certificate are displayed in the dialog box.
10 In the Alias field, specify a short name for the certificate. This alias is stored in lower case in the trust
store. Click Finish. The certificate is now present in the Certificates table.
11 Click Check again. A "Check succeeded" dialog box is displayed.
12 Click OK. The Preferences dialog box is closed.
2 Extract all contents of the file to your existing LN Studio installation folder, such as C:\Infor\LN\LNStudio
. Ensure the Overwrite existing files check box is selected!
2 Verify that the settings in the .ionapi file are correct. To do that, configure your Project Server connection
point.
See Specifying additional settings for multi-tenant cloud development on page 13.
a Create a cloud environment using the .ionapi file.
b Start the Configuration wizard for the Project Server connection point.
c On the second page, specify the correct LN UI environment name.
d Verify that the wizard specified the correct Service Endpoint URL. If not, you must instruct the LN
Studio users to specify a correct value here.
e Finish the wizard and verify that the ping succeeds.
3 If the .ionapi settings are correct, distribute this file to all LN Studio users. You can distribute the file
through email, or you can publish the file on a network share or on a local HTTP server. The .ionapi file
contains sensitive information, so ensure it is not visible to unauthorized persons.
4 Supply the LN Studio users with the information they require to configure a cloud connection. As a
minimum, they must know the location of the .ionapi file and the name of the LN UI environment.
Defining an application
This topic describes how to define an Application. For each application, you can define a project in which the
software engineers can develop their software components.
Note: Before you can define an application, you must define one or more development environments and
the corresponding Administrator Connection Points.
See Defining a development environment on page 18.
To define an LN application:
1 Start LN Studio
2 Open the Project Server perspective.
Select Window > Open Perspective > Other. A list of perspectives is displayed. Select Project Server
and click OK.
The Application Explorer is displayed.
3 Specify the application properties
Complete these steps:
a In the view, right-click the development environment for which you want to define an application.
b On the shortcut menu, select New Application. The New Application dialog is displayed.
c Specify the application properties, such as application name, description, and release.
For details, see the dialog's online help.
Note: You can now define one or more projects for the new application. See Defining a software project on
page 42.
Example
This diagram shows a VRC structure before an intermediate code freeze. SCM is active.
This diagram shows the VRC structure after an intermediate code freeze.
b Select the project VRC. On the appropriate menu, select Activate SCM (and CM). The Activate SCM
and Component Management by Package VRC (ttscm0110s000) session starts.
c Select the new SCM VRC and click OK.
See "To use the Software Configuration Management system (SCM)" in the LN Web Help.
3 Define new base VRC.
Start the Base VRCs (ttpmc0110m000) session and create a new Base VRC. In the Export VRC field, select
the new project VRC.
4 Start LN Studio and define a new application.
Note: Take care of the following when you specify the properties of the new application in the New
Application dialog box:
• In the Release field, select the new base VRC created in the previous step.
• If SCM is active for the new project VRC, select the Use SCM check box. If SCM is not active, clear the
check box.
• In the lower part of the dialog box, specify the appropriate packages and languages.
See Defining an application on page 19.
5 Start LN Studio and define a new software project.
Note: In the Application field in the Create a Software Project dialog box, select the new application
created in the previous step.
See Defining a software project on page 42.
6 Move activities to the new project.
a Log on to the project server and start the Final Code Freeze (tlprj1220m000) session.
b In the Source Project field, select the old project.
c In the Target Project field, select the new project.
d Select the full range of activities.
e Click Move. The session moves the activities to the new project.
7 Generate new VRCs for the involved activities.
a Start the Code Freeze (ttadv1222m000) session.
b Select the Final Code Freeze check box.
c In the Source VRC field, select the old project VRC.
d In the Target VRC field, select the new project VRC.
e Select the full range of activities.
f Click Move. The session performs these actions:
• Creates new activity VRCs derived from the new project VRC.
• Creates, if SCM is active, new private VRCs derived from the new activity VRCs.
• Moves components from the old activity and private VRCs to these new VRCs.
• Removes the old activity and private VRCs.
Under Infor LN Studio Application in the preference pages, you can specify preferences related to application
development. To open the preference pages, in Eclipse, select Windows > Preferences.
Preferences - BFlow
Use this dialog window to specify your BFlow preferences.
Clear console before launch
If this check box is selected, the LN Studio Console is cleared before a BFlow run or debug configuration is
launched.
Note: In a multi-tenant environment you cannot run or debug BFlows with LN Studio. You can run BFlows
in the LN UI to see the result.
Log Levels
Minimal Medium Full Debug
Log Messages
ENVIRONMENT ✔ ✔ ✔ ✔
STATE ✔ ✔ ✔ ✔
NOTICE ✔ ✔ ✔ ✔
WARNING ✔ ✔ ✔ ✔
ERROR ✔ ✔ ✔ ✔
SESSION ✔ ✔ ✔
CONNECTION ✔ ✔
STEP ✔ ✔
Log Levels
Minimal Medium Full Debug
Log Messages
INFO ✔ ✔
Preferences - Templates
Use this dialog window to create, edit, and remove BFlow templates.
Overview window
Use the check boxes to enable and disable templates. If a check box is selected, you can select the
corresponding template when you create a BFlow step in the Create a New Infor LN Software Component
wizard.
Use these buttons to manipulate and configure templates:
Button Description
New Opens a dialog box to create a new template.
Edit Opens a dialog box to edit the currently selected template.
Remove Removes all selected templates.
Restore Re- Restores any predefined templates that have been removed.
moved
Revert to De- Restores any predefined templates to their default configuration.
fault This action does not modify user-created templates.
Import Imports templates from an XML file in the file system.
Export Exports all selected templates to an XML file in the file system.
Context
Indicates the type of template. For BFlow templates, the context is always BFlowTest.
Automatically insert
Has no meaning for BFlow templates.
Description
The description of the template.
Pattern
The pattern of the template. This is the text inserted in the Create a New Infor LN Software Component
wizard when you select the template.
In the template pattern, you can use predefined template variables. Variables are resolved to their concrete
value when the template is evaluated in its context. You can specify variables using simple or full syntax. If
there are multiple possible matches for a variable, they are presented as proposals to the user.
To add a variable to the template pattern, click Insert Variable and select the desired variable from the list.
You can select general and LN-specific template variables.
Preferences - Editor
Use this dialog window to specify your script editor preferences.
These settings only apply to the LN Studio Script Editor.
Marker Identifier
Determines the text that is added in the source code, when you add maintenance comments.
Allowed values
Example
Marker Identifier = "Activity Name", and your current activity is "myactivity".
In the Script Editor, you mark lines as new. The following maintenance comments are added:
• Behind the first new line: " |#myactivity.sn ".
• Behind the last new line: " |#myactivity.en ".
See "Comments" in the Infor LN Studio Application Development Guide.
Background Color
Use this field to set the background color for your editor.
Choose one of the following options:
Custom Choose the color from a basic color schema or define custom colors.
Note:
The editor only uses this color for source code of checked out components. If a component is not checked
out, the source code is read-only and the editor uses the ReadOnly color.
ReadOnly
Use this field to set the background color for read-only source code, such as source code of components that
are not checked out.
Choose the color from a basic color schema or define custom colors.
Automatically insert
If this check box is selected, and if there is only one completion proposal for the string you entered in the
Script Editor, code assist will automatically insert the proposal at the cursor position.
Example
In the Script Editor, you type " she " and press CTRL+SPACE. Code assist automatically inserts the following
text, because this is the only completion proposal available: " shell(command,mode) ".
Auto Activation
Enable auto activation
If this check box is selected, Code Assist starts automatically when you type the auto activation trigger
character.
Preferences - Folding
Use this dialog window to specify your Folding preferences.
These settings only apply to the LN Studio Script Editor.
See "Folding" in the Infor LN Studio Application Development Guide.
Enable folding
If this check box is selected, you can fold and unfold the selected region types when you open a new editor.
If this check box is cleared, you cannot fold and unfold any region type in the script editor.
Header
If this check box is selected, folding is enabled for header comments.
Macro's
If this check box is selected, folding is enabled for macros.
Section
If this check box is selected, folding is enabled for script sections, such as the declaration section, the
before.program section, and field sections in a UI script.
Preferences - Syntax
Use this dialog window to specify syntax coloring preferences.
These settings only apply to the LN Studio Script Editor.
Limitations
The script editor does not recognize syntax patterns because no syntax parser is available in this release.
Therefore, if a variable has a name identical to a keyword such as "domain", "function", or "case", the variable
is colored as a keyword. For example:
• You add the following code to the declaration section of a UI script: long case.
• case is colored as a keyword, because the editor does not recognize it as a variable.
Syntax Coloring
Specify the syntax coloring settings for various elements in the program text.
To specify the syntax coloring settings for an element:
1 Select the element from the list.
2 Specify whether the element must be bold and/or italic.
3 Click the color button.
4 Select the color from a basic color schema or define custom colors.
Preview
Shows a preview of your syntax coloring settings.
Preferences - Templates
Use this dialog window to create, edit, and remove templates.
These settings only apply to the LN Studio Script Editor.
To insert a template in the script editor, use the Code Assist feature.
Overview window
Use the check boxes to enable and disable templates. If a check box is selected, you can use Code Assist to
insert the corresponding template in your source code.
Use these buttons to manipulate and configure templates:
Button Description
New Opens a dialog box to create a new template.
Edit Opens a dialog box to edit the currently selected template.
Remove Removes all selected templates.
Restore Re- Restores any predefined templates that have been removed.
moved
Revert to De- Restores any predefined templates to their default configuration.
fault This action does not modify user-created templates.
Import Imports templates from an XML file in the file system.
Export Exports all selected templates to an XML file in the file system.
Context
This is a standard Eclipse option that is not used by LN Studio.
Automatically insert
If this check box is selected, code assist automatically inserts the template at the cursor position, if the
template is the only completion proposal for the string you entered in the Script Editor.
Description
The description of the template.
Pattern
The pattern of the template. This is the text inserted in the editor when you select the template.
In the template pattern, you can use predefined template variables. Variables are resolved to their concrete
value when the template is evaluated in its context. You can specify variables using simple or full syntax. If
there are multiple possible matches for a variable, they are presented as proposals to the user.
To add a variable to the template pattern, click Insert Variable and select the desired variable from the list.
You can select general and LN-specific template variables.
This table shows the general template variables:
Variable Description
${cursor} Specifies the cursor position when you leave the template edit mode. This
is useful if the cursor must jump to another place than to the end of the
template, on leaving template edit mode.
${date} The current date.
${dollar} The dollar symbol '$'. Alternatively, you can use two dollar signs: '$$'.
${line_selection} The content of all currently selected lines.
${time} The current time.
${user} The user name.
${word_selection} The content of the current text selection.
${year} The current year.
Variable Description
${name} The name of the function which is used above this variable
${input_arg} The arguments of the function which is used above this variable.
${returnType} The return type of the function which is used above this variable.
${output_arg} Place holder
Preferences - Launching
Use this dialog window to specify your launching preferences.
When you launch a software component, the LN Studio checks whether the release of the corresponding
application matches the package combination in which the component is executed. If they do not match,
you may encounter problems during debugging.
In this dialog, you can specify whether/how the launch should continue if release and package combination
do not match.
Note:
• The application release is specified in the Create a new Application dialog. The release is identical to
the Base VRC on which the software development is based.
• The package combination depends on the runtime address connection points of the application's software
projects. A runtime address connection point is linked to a .bwc file. You can find the package combination
in the user data of the user account specified in this .bwc file. To view the user data, run the User Data
(ttaad2500m000) session. Alternatively, look in the Command field of the BW Configuration Properties
dialog.
Default Launch Mode
Specify how sessions are started by default.
Select an option. In the Configurations dialog, the corresponding launch mode is selected automatically.
Allowed values
• Launch in BW
• Attach to running Web UI
Preferences - Multipage
Use this dialog window to specify preferences for the Multipage Editors.
Display the TDE overview page for all editors
If this check box is selected, a TDE Documentation tab is displayed in all multipage editors. This tab shows
an XML tree with the technical information on the software component's Technical Data Entity.
The information displayed in the TDE Documentation tab is primarily intended for support and
troubleshooting purposes. Therefore it is recommended to display the tab only in case of problems.
Preferences - Workbench
Use this dialog window to specify whether the editor is opened automatically each time you add a new
resource to your workspace.
Al- The editor starts automatically each time you add a component to your workspace.
ways
Nev- The editor does not start automatically when you add a component to your workspace.
er
Prompt When you add a component to your workspace, the following question is displayed:
"Open editor for the new software component?"
Click Yes or No to answer the question.
Optionally, click the Remember my decision check box in the question window. Depending on
your answer to the question, this will change the Automatically open the editor for a new resource
preference setting to "Always" or "Never".
Nev- You cannot check out a component while editing. To change a component, you must first check
er out the component and then start the corresponding editor.
Decorations
Append version information to resource name
If this check box is selected, LN Studio appends the version and release information of the application to the
resource names displayed in the Activity Explorer view.
For example: 7.6_a4
Configuration
This section describes the configuration of Infor LN Studio related to the development of Business Interfaces.
These preference pages are available:
• Infor LN Studio Integration
This page contains some general preferences.
• Business Interface Test Tool
On this page you can set the configuration for testing Business Interface Implementations.
• Colors
With the Colors preferences of LN Studio Integration, you can set the colors of the graphical modelers
and textual editors that you use for Business Interface modeling.
• Default Libraries
On this page you can specify some libraries that will automatically be included in new Interface projects.
• Default Related Software Projects
On this page you can specify a set of related software projects.
• Generators - Infor LN Implementation
With the Infor LN Implementation preferences of the Generators, you can set the VRC of the LN server
for which you generate the Business Interface Implementation.
To navigate to the preference pages of LN Studio, select Windows > Preferences. In the Preferences window,
expand the Infor LN Studio Integration folder and select one of the preference options.
Note: To generate proxies for old BDEs (version 6.1 only!)
The Business Interfaces you develop with LN Studio do not use proxies. However, to remain backwards
compatible, LN Studio still contains functionality to generate BDE Proxies for the business interface definitions
(BIDs) that you created with Integration Studio 6.1.
You can configure the involved Proxy Generators using the .NET Proxy and Java Proxy preferences of the LN
Studio Generators. For detailed information, see the online Help of LN Studio.
General preferences
Use this page to specify the location of the "output" and "model" folder in the Integration project. The default
values should suffice for most users.
The page contains these additional settings:
Automatically save dirty editors before refactoring
If this check box is selected, editors with unsaved changes are saved automatically when performing a
refactoring action. If this check box is cleared, a warning window is displayed when you try to perform a
refactoring action.
Validate on differences between base and specialized Interface Definitions and generate warnings
If this check box is selected, an automatic check is performed when you save a specialized interface definition.
This reduces the performance. Optionally, to improve performance, clear this check box.
Color preferences
Use this page to customize the colors that are used in the graphical modelers and text editors used for Business
Interface modeling. Select the Graphical Modelers tab to define the colors of the graphical elements in the
modelers. Select the Editors tab to define the colors of the text-based editors. You can change any color by
clicking on the colored button. A Color dialog box, in which you can select the desired color, is displayed.
Is Integrated
If this check box is selected, you can use components of the software project when you are editing hooks
in a business interface definition. For example, in the hook editor, you can use the Open Declaration
command to open components of the related software project.
5 Click OK.
To remove a software project from the list, right-click the entry in the list and select Delete.
Under Infor LN JCA Connectivity in the preference pages, you can specify preferences related to JCA
connectivity. To open the preference pages, in Eclipse, select Windows > Preferences. The main preference
page contains the configuration of the connection points. There is a sub-page for configuring the logging
preferences.
Log Configuration
Use this page to specify the settings for logging the connection-related information to a log file. In case of
problems, a support engineer may ask for this information.
Location
Specify the complete path of the log file. The file name must end in ".log". Use the browse button to select
the folder in which the log file must be stored.
On size
If this check box is selected, the log file does not grow beyond a maximum size. If the maximum size is reached,
the existing log file is renamed by appending ".1" to the name, and a new log file is opened. Existing log files
that have previously been renamed are renamed to the next higher number: the ".1" file is renamed to ".2",
the ".2" file is renamed to ".3", etc. If the maximum number of log files is reached, the oldest one is deleted.
• Maximum size
Specify the maximum size of the log in MB.
• Maximum number
Specify the maximum number of log files that must be preserved. Example: if you specify "2" in this field,
at most 3 log files will be present in the log file location: the current log file and two older log files with
the extensions ".1" and ".2".
On time
If this check box is selected, the log file is renewed periodically. If the specified interval has elapsed, the
existing log file is renamed by appending a timestamp to the name, and a new log file is opened. Select one
of these intervals:
• Daily
• Half-daily
• Hourly
Procedures
a In the Software Project Explorer view, right-click the new project and select New Activity. The
Create a new Activity dialog box is displayed.
b Specify the activity properties. See the online help of the dialog box.
c Save the activity and close the dialog box.
The users, to which the activities are assigned, can now start developing software in the new project. They
can select the assigned activities in the Application perspective in the LN Studio workbench.
Dialogs
Hostname
The TCP/IP hostname or IP address of the LN server.
BSE path
The directory on the application server where the LN Software Environment resides.
Bshell
The logical name of the bshell, as specified in the ${BSE}/lib/ipc_info configuration file.
Note: To view or modify the properties of an existing application, use the Application Properties dialog box.
This dialog box is identical to the window described here, except for the Application name field. When you
create a new application, specify an application name. When you modify an existing application, you cannot
change the application name (read-only field).
Application
Use the upper part of the dialog to specify basic application properties.
Application name
The name of the application.
When you create a new application, it is mandatory to specify an application name.
Allowed values
The application name identifies the application. Therefore, the application name must be unique in the
context of the connected LN server. The name can be any ASCII text with a maximum length of 30 characters.
Description
The description of the application.
Specifying an application description is optional.
Allowed values
The description is a (multi byte) text with a maximum length of 50 characters.
Release
The release of the application.
For LN applications, the release is identical to the Base VRC on which the software development is based.
See Applications.
Specifying a release is mandatory.
Note: An LN Studio application is linked to the Base VRC of a PMC module. Within the PMC module, the
package VRCs are linked to the export VRC of the PMC Base VRC.
Allowed values
To specify a value for this field, select a release from the drop-down list.
Base
This field is not yet implemented.
Note: You can access the field and select a value from the list. However, this value is ignored by the LN Studio.
Therefore, you are recommended to leave this field empty.
Use SCM
If this check box is selected, the software components developed or modified in LN Studio are managed with
the Software Configuration Management (SCM) tool of the connected LN environment.
Use SCM to perform version management for packages linked to the application, or for the individual activities
of the application. To use SCM for the version management of the packages, SCM must be enabled for the
associated Project VRC on the LN server. If SCM is not enabled, you cannot add a package from this VRC to
the application.
See "Activity based development" in the Infor LN Studio Application Development Guide.
Packages
Use this tab to link packages to the application.
Package
A package linked to the application.
In LN Studio, you can link packages to an application. These packages must have a VRC that corresponds
with the Export VRC of the Base VRC of the PMC module. This must also match the Base VRC of the application.
This Export VRC contains the application data with the linked packages. LN Studio will automatically create
such an Export VRC, if no such VRC is available.
The Packages field displays a table with the packages that have been linked to the application. These
packages have the same Base VRC as the application. The table shows the name of the packages and the
package description. An additional field indicates whether the package is used.
To link packages to the application:
1 Click Add. An empty package record is added to the Packages grid. Then, in the Package field, select a
package from the drop-down list. This list contains all the packages linked to the application's Base VRC.
After you select a package, the package name and description are displayed in the grid.
Note: To add all packages at the same time, click Add All.
2 To indicate whether a package is used in the application, select or clear the corresponding Active check
box in the grid.
Note: You require special authorization to create or modify applications linked to a Base VRC of a standard
LN release. To make a customization for a particular customer, copy the application to the customer's
application.
Description
The description of the package.
This field is read-only. The specified description is derived from the selected package.
Active
If this check box is selected, the package of the application is changed or modified in LN Studio.
Allowed values
The check box is cleared.
Languages
Use this tab to link software languages to the application.
Language
A software language linked to the application during development time.
Important
If you use the Language Translation Support functionality, to translate labels or other user interface
components, do not add secondary software languages to an application. Only use secondary software
languages for small translations performed by a software developer, outside the framework of the LTS
export/import mechanism.
The term "software language" refers to a language used by the application to communicate with the
application user. Therefore, when you run the application, the text on the buttons, commands, menus,
messages and so on, are expressed in one of the software languages linked to the application.
You can link multiple languages to an application, depending on the language packs installed on the
application's LN environment.
An LN Studio application can have two types of languages: primary and secondary. Each application must
have only one primary language. This is the development language and used to display the editable
components throughout the user interface of LN Studio. If any references are made to another component,
this reference is expressed in the primary language. By default, the primary language is 2. If you do not specify
a primary language, English is used.
Apart from the primary language, an application can possess multiple secondary languages. These can be
considered as translations of the expressions in the primary language. You can view and modify these
translations in the editor of the concerned software component. The translations are used when running
the application in a mode for a particular secondary language, determined by the language of the user.
The Languages field displays a table with all languages linked to the application. These languages must be
installed on the LN server connected to LN Studio through the Administrator connection point. The table
shows the name of the languages and the language descriptions. An additional field indicates whether the
language is a primary or secondary language.
To link a new language to the application, complete the following steps:
1 Click Add. An empty language record is added to the Languages grid.
2 In the Language field, select a language from the drop-down list. This list contains all the packages
installed on the connected LN server. After you select a language, the language code and language
description are entered in the grid.
3 To indicate whether the language acts as primary language, select or clear the Primary check box.
Description
The description of the language.
This field is read-only. The specified description is derived from the selected language.
Primary
If this check box is selected, the current language will act as the primary language of the application. If this
check box is cleared, the current language is a secondary language.
Note:
If you set the primary language of the application, any language that was previously the primary language
will automatically be marked as a secondary language.
Allowed values
The check box is cleared.
Documentation
Documentation
Use this field to specify additional information.
Description
The project description.
Requirement ID
The ID of the business requirement to which the project belongs (requirements are usually stored in a
requirement management or defect tracking system).
Repository
Development Environment
The LN environment in which the software for the project is developed. Select the environment from a
drop-down list.
Application
The application to which the project belongs. Select the application from a drop-down list.
Documentation
Use this field to enter additional documentation about the project.
Description
The description of the selected project.
Activity
Name
Specify an activity name.
Description
Specify an activity description.
Type
Select an activity type from the drop-down list.
If the activity is intended for software development, select one of the following types:
• Enhancement
• Change request
• Miscellaneous
• Defect (intern)
• Defect (extern)
If the activity is intended for software delivery through PMC, select the "Delivery" type.
Note: You can only select the "Delivery" type if the Integration With PMC check box is selected in the
properties of the project to which the activity belongs.
Requirement ID
The ID of the business requirement to which the activity belongs (requirements are usually stored in a
requirement management or defect tracking system).
Owner
The software engineer who owns the activity. Select a software engineer from the drop-down list.
The owner can open the activity, develop components in the activity, reassign the activity, and end the
activity.
Assignees
Assignee
The software engineers to which the activity is assigned. The assignees can open the activity and develop
components in the activity. However, only the owner can end the activity.
To add an assignee, click Add and select a software engineer from the drop-down list.
The Assignees grid is only available if the Sharing Activities Allowed check box in the software project's
properties is selected.
If sharing activities is not allowed, the Add button is disabled, and the system automatically adds the owner
of the activity as assignee. This change is displayed only after you re-open the dialog box.
Documentation
Specify documentation about the activity.
Finish
Saves the new activity and closes the dialog box.
Perspectives
Software Project Explorer Project managers use this view to maintain software projects and activities
view on the Project Server.
For details on the procedure to define projects and activities, see Defining a
software project on page 42.
Application Explorer view Administrators use this view to create and maintain the applications for
which the software projects are defined.
For more information on the administrator's tasks, see the Infor LN Studio
Administration Guide.
Views
A development environment is a BSE environment on an Infor LN server, in which the software engineers
develop software components.
The Application Explorer view is part of the Infor Project Server perspective.
Toolbar
The toolbar of the Application Explorer view includes the following buttons:
Properties Starts a dialog box where you can view or modify the properties of the
selected item.
Create a new development en- Starts the New Development Environment dialog box. Here, you must
vironment enter the properties for a new development environment.
New Application Starts the Create a new Application dialog box. Here, you must enter
the name, release, and other properties for a new application.
Menu Contains the New Application command.
Note: The remaining buttons are standard Eclipse commands. For details on these buttons, see "User interface
information" in the Workbench User Guide.
Shortcut menu
To open the shortcut menu, right-click on a resource in the view:
This menu provides the following LN Studio-specific commands:
New Development Environ- Starts the New Development Environment dialog box. Here, you must
ment enter the properties for a new development environment.
New Application Starts the Create a new Application dialog box. Here, you must enter the
name, release, and other properties for a new application.
Properties Starts a dialog box where you can view or modify the properties of the
selected item.
Delete Removes the selected item.
For details on the remaining commands, see "User interface information" in the Workbench User Guide.
Icons
The following icons are displayed in the Application Explorer view:
Toolbar
The toolbar of the Software Project Explorer view contains the following buttons:
Note: The remaining buttons are standard Eclipse commands. For details on these buttons, see "User interface
information" in the Workbench User Guide.
Shortcut menu
To open the shortcut menu, right-click on a resource in the view.
This menu contains most of the toolbar commands.
Icons
The following icons are displayed in the Software Project Explorer view:
Glossary
Activity VRC
A VRC that contains software components for an activity. The
activity VRC is generated automatically when you open the
activity for the first time.
By default, the components in this VRC are only accessible for
the software engineer to which the activity is assigned.
Optionally other software engineers can access these
components if they put this activity in the activity context of
their own activity.
Additional file
A generic component, such as an XML schema file, a GIF image,
and so on. From LN 6.0a onwards, additional files are stored
in a specific package, module, and package VRC.
Code assist
Code assist provides a list of suggested completions for partial
character strings in the LN Studio Script Editor.
Debugging Domain
The process of identifying and addressing the cause for A domain describes the properties of table fields. The main
defective behavior of a system. property of a field is the data type, such as string, long, double,
These debugging techniques are available: date, UTC. Other properties are the length of a string, the
alignment of a string, and the date and time format.
• Definition of conditions that suspend a running process,
so you can inspect it more closely Domains indicate the valid values for an attribute and are used
to define the scale division of the axes or to verify data.
• Navigation through a suspended process, to discover the
flow and identify any problems
• Inspection, to validate the state of the process and Dynamic form
identify any problems A form with a dynamic form definition.
The developer does not need to determine exactly where fields
Debug target must be placed, or what they must look like. Instead, the
An execution context, such as a process or virtual machine, developer defines the following:
that can be debugged. In Infor 4GL, a debug target represents • The form contents.
a session started in debug mode. • The form structure.
• The sequence of the objects on the form.
Dependency
At runtime, the dynamic form displays only those fields for
In PMC, the relation between solutions. Dependencies are which the user is authorized.
defined at the PMC distributor side and are part of the meta
data of a PMC solution and guarantee that PMC solutions are
installed in the correct configuration and sequence at the PMC Dynamic Link Library
recipient side. A way to share common functions between programs. This
library contains functions for common use. The library can be
The following values indicate the dependency type between
linked to the object as a function call at run time. Implementing
solutions.
a dynamic link library reduces the size of objects to a minimum,
These dependency types are available: because dynamic link libraries are not included in a program's
• Pre-requisites object.
• Co-requisites
• Post-requisites Dynamic session
A session with a dynamic form definition.
You can only install solutions that are dependent on other
solutions if the other solutions are already present, or are also Depending on settings, a dynamic session can start as one of
installed. the following:
The same dependency types exist between Patches. However, • A details session.
to keep the descriptions readable, only solutions are • An overview session.
mentioned, but patches are meant as well. One exception
In the dynamic form definition, the developer does not need
applies: the post-requisite type is not applicable to patches.
to determine exactly where fields must be placed, or what they
must look like. Instead, the developer specifies this
Details session information:
A dialog box that shows all the details (fields) of the line • The form contents.
(record) selected in the associated overview session. Use a
• The form structure.
details session to view, enter, or change the data of one record.
• The sequence of the objects on the form.
A details session can contain a number of tabs to group related
fields. At runtime, the dynamic form shows fields for which the user
is authorized.
Development VRC
In PMC a physical VRC, derived from the Export VRC, in which Eclipse
checked-out software components are temporarily stored Eclipse is an open platform for tool integration built by an open
during a change process. community of tool providers. Operating under an open source
paradigm, with a common public license that provides royalty
free source code and world wide redistribution rights, the
Eclipse platform provides tool developers with ultimate
flexibility and control over their software technology. Eclipse
is used as a platform for LN Studio.
Editor Group
An editor is a visual component within the LN Studio
A set of form objects grouped together, such as form fields and
workbench used to edit or browse a resource, such as a
child groups.
Program script or a library. Modifications made in an editor
follow an open-save-close life cycle model. Multiple instances
of an editor type may exist within a LN Studio workbench Group-by field
window. A field on an overview form positioned above the grid. The
Group-by field determines what is shown in the grid of an
Export VRC overview form. Only the records that belong to the Group-by
fields are shown in the grid, such as all orders that belong to
The physical VRC from which components that belong to a
a specific customer. The name of the customer is shown in the
PMC solution must be exported at the PMC distributor side.
Group-by field, the records are shown in the grid.
Each base VRC has an export VRC linked, so components for
different products are exported from different physical VRCs.
Index
Feature Pack One or more table fields used to sort and search records in a
table. A table must have at least one index. The first index is
See Service Pack.
always the primary key.
Infor 4GL
Float
A fourth-generation programming language designed for
A data type name used to declare variables that can store
interacting with the programmer used with relational
floating-point numbers. A floating-point number is a number
databases. 4GLs are event-driven.
containing a decimal point, with a maximum of 15 significant
digits (8 bytes).
Installation run
Folding In PMC, a group of solutions that were installed together. This
can be a range of solutions, a solution with pre-requisites, or
The LN Studio script editor supports folding of code regions.
a combination of both.
If you hover over a folded element, the hidden code is
displayed.
Integrated session
Form The session and the session's form are integrated into one
object. The form is a subcomponent of the session.
A screen that appears when a session is started. A form
interacts with the database, and provides the user interface When you perform an operation, such as copy, delete, check
used to manipulate the data on the form. in, or check out, on an integrated session, you also perform
the operation on the integrated session's form.
Form command A non-integrated session's form is a separate object.
A form command starts a session, function or (sub)menu by
means of which a user can carry out a particular task.
A form command, as opposed to standard menu commands
such as the Exit command, must be especially defined for a
session tab.
Label Message
A code that is used instead of language-dependent text in A notification that informs you about something. A message
forms, reports, and menus. A label consists of a name and a attends you to an event, error, warning, and so on. Messages
content description. The content of a label can differ by usually appear in a message window or are logged in a file. If
language, but the label name remains the same for all displayed in a window, a message requires a confirmation:
languages. Click OK. Messages are different from questions, as questions
always require a choice response.
Language number
A conversion of the language code to a number between 0 and Module
61. The language number eliminates problems caused by the A part of a package consisting of a number of related software
use of uppercase and lowercase language codes. components, such as sessions, tables, program scripts, reports,
This table shows how the language code corresponds to the forms and menus. For example, the General Ledger module in
language number: Financials.
A module code consists of three characters. For example, the
Corresponding language General Ledger has the code "gld".
Language code range number range
0 to 9 0 to 9 Obsolete solution
Obsolete solutions are an administrative aid to manage the
a to z 10 to 35 synchronization of updates at the PMC recipient side when
A to Z 36 to 61 you install a Service Pack. An obsolete solution does not contain
software components.
For example:
Original VRC
• Language code b = Language number 11 The VRC that contains the software components that have to
• Language code B = Language number 37 be modified. If SCM is active, these components are changed
in the Private VRC. If SCM is not active, these components are
Library changed in the Activity VRC.
A collection of files, computer programs, or subroutines.
Overview session
LN Studio A session that lists the available elements or records of one
A platform for activity based development of LN software. LN type, and some of their details (fields). Use an overview session
Studio is implemented in the Eclipse framework and makes to view, sort, add, change, copy, and remove records.
use of the Software Configuration Management functionality When you add or change a record a details session usually
on the LN server. The LN Studio workbench contains various starts. Sometimes, you can add and change records directly
powerful features, such as an advanced script editor, various using the overview session.
multipage editors, an outline view, a task list, and commands
to debug and run software components.
Package
A set of related modules that implements a complete part of
Long the functionality, such as Enterprise Planning, Financials, or
A data type specified in LN as any whole number from Warehouse Management. Packages are designed to function
-2147483648 to 2147483647. as independent as possible, to enable a customer to implement
only particular packages.
Menu A package code consists of two characters. For example, tt is
A list of options from which a user can perform a desired action, the code of the Tools package.
such as starting sessions, other menus, and queries. A start-up Each package has a unique VRC version structure.
menu is defined for each user. Using this start-up menu, the
user can access all sub-menus attached to the start-up menu
tree.
Patch
In PMC, a patch is a collection of Solutions. In general a patch
contains solutions created in a larger time period. The patch
entity is both known at the PMC distributor and PMC recipient
side. Patches are an indivisible set of solutions. You cannot
install or uninstall individual solutions that belong to a patch
at the PMC recipient. You can only install or uninstall patches
as a whole. Yo can define dependencies between patches.
Patches leave the Base VRC that is linked to the update VRC at
the PMC recipient unchanged. The existing PMC registry
remains and is extended with data of the newly installed patch.
Patches only permit the most recent version of software
components to be maintained. Patches in general mainly
contain corrective solutions.
Note:
In PMC versions earlier than LN 6.1, the synonym Service Packs
was often used for patches.
Primary key
The unique identification for a record in a table.
SCM group
A Software Configuration Management group in LN that
identifies a development group with a separate development
environment.