Getting an entity

Use this procedure to get an entity. To work with an existing entity, the source file must first be copied from the M3 Business Engine (BE) Server into the local environment in Eclipse.

Note:  The entities you can get depends on whether Extended Access Mode is enabled or not.

See Working with entities in M3 Adaptation Kit.

  1. In the MAK Navigator tab, right-click a project where you want to put the entity.
  2. Select Get > Entity. The Get Entity wizard is displayed.
  3. To get the new entity, specify this information:
    Project

    Select a project from the list.

    Action Number

    Allocate your entity to an action number by performing one of these options:

    • Select an action number from the Action Number list. The list is sorted in reverse alphabetical and descending numerical order.

    • Use Ctrl + Space for content-assisted text.

    • Click the browse icon to view all action numbers and their descriptions.

    • Click New to create a new action number for your entity. An action number can be created up to a length of 14 characters which can include a dash (-).

    Note:  A warning message is displayed if the selected Action Number is in use by another user. You can continue using the Action Number but the A/N user will be changed to your User ID.
    Show only action numbers that are unused or belonging to <User ID>

    Select this option to filter the Action Numbers that are unused or belonging to the particular MAK user.

    Create Lock

    Select this option to lock a source by default. If you do not lock a source, you cannot deploy it – only to a sandbox. If you do not lock it in this window, you will receive a message while deploying to lock the entity.

    You can lock the entity once it is available in the MAK Navigator tab using the Lock option in the context menu. However, you should be prepared to have this entity replaced by a version in HFix or VFix.

    Name

    Specify the first characters of the name of the entity that you want to get and press CTRL+space. All matching entities will be displayed in a list. When you double-click an entity in the list, it will automatically be added to the selection that lists all files ready for copying to a local workspace. You can add multiple entities to the selection by repeating the process.

    Note: You can get a description of a program entity by clicking it so that a tooltip will be displayed.

    Clicking the entity will display a tooltip that displays the MAK Status. If the entity is a Program, the description is also displayed in the tooltip along with the MAK Status.

    Note:  A warning message is displayed if the selected version is already locked by another user. You can still use the file by clearing the Create Lock check box. However, you cannot deploy the file to the Server. You can only deploy the file to a sandbox.

    See information about deploying an entity to a sandbox in Deploying an entity to the sandbox.

    Browse

    Click Browse to type a search text related to the entity. All matching entities will be listed. You can select multiple entities at the same time by pressing Shift or CTRL.

    Remove

    Click Remove to delete entities already in the selection.

    Details

    Click Details to see the information of Status column if it is not empty. The connected Action Number(s) to the entity will be displayed along with their statuses. The possible values of the Status Column are as follows:

    1. D - Development

    2. T - Test

    3. R - Rejected

    4. * - Multiple Action Numbers actively connected

    Entity Filter

    Select the entity that you want to get:

    If you are using M3 Adaptation Kit, you can get these entities:

    • Field Help

    • Language

    • Out interface

    • View Definition

    • Program (read-only mode)

    If you are using M3 Adaptation Kit with Extended Access Mode, in addition to the list above, you can also get these entities:

    • Database interface

    • Data structure

    • Program

    See Working with entities in M3 Adaptation Kit.

  4. Click Finish. These events happen simultaneously:

    • The entity is copied from the M3 BE Server to your local environment. It is placed in the corresponding folder under the component folder to which the source belongs.

    • The source code of the entity is displayed in the corresponding editor.

      For programs, the action number information in the source code is updated.

    • The entity is locked if Create Lock has been selected.

    • If MAK detects that the Program, Out interface, or View definition exists in both MVX and Market components, then the entity will be marked by an M icon in the MAK Navigator tab.