Version 8.2.7
 —  Business Services  —

Downloading Business Services from the Server

This section describes how to download business services data from a Natural Business Services installation on the server to the local environment. This procedure is performed in two parts: first the Natural Server view is mapped to an existing business service installation on the server and then the services are downloaded from Natural Server to the Navigator view.

This section covers the following topics:

Note:
All business service resources are stored in a local NaturalONE project. If you do not want to use an existing project to store the downloaded resources, you can create a new project. For information, see the NaturalONE documentation.


Map to an Existing Natural Business Services Installation

Start of instruction setTo map to an existing Natural Business Services installation:

  1. Select graphics/map-environment-icon.pngon the toolbar in the Natural Server view.

    The Map Environment panel is displayed. For example:

    graphics/map-environment.png

  2. Type the name of the host in Host name.

  3. Type the port number in Port number.

    The name of the environment is derived from the host and port values and displayed in Environment name when you select the field.

  4. Type a Natural profile name in Session parameters.

  5. Type the user credentials for the server in User ID and Password.

    Note:
    These credentials must be defined to Natural Business Services security and have the correct permissions.

  6. Select Finish.

    The connection is displayed in the Natural Server view. For example:

    graphics/new-connection-in-natural-server-view.png

Note:
For more information about the Natural Server view, see the NaturalONE documentation.

Top of page

Download Business Services Resources to a Local Project

Start of instruction setTo download business services to your local project:

  1. Open the context menu for the Business-Services root node.

    Or:
    Expand the root node and select one or more steplib and/or domain nodes or files using standard selection techniques.

    Note:
    Children of the selected nodes are automatically included in the download (for example, selecting the Domains node will download all domains from the server).

  2. Select Add to existing Project.

    For example:

    graphics/add-existing-business-service-data-context-menu.png

    A list of available projects is displayed.

  3. Select the project into which you want to download the business service data.

    For example:

    graphics/add-from-server.png

  4. Select OK.

    A progress window is displayed as the business service data is downloaded from the Natural Server view to the local project in the Navigator view.

The definitions for all selected services, domains, and steplibs are added to the specified project. Any supporting business service resource that was not selected will be automatically downloaded depending on the user preference value (for example, the supporting steplib for a selected domain will be downloaded if the user preference value is set to true). To view the downloaded resources, expand the Project name > Business-Services node in the Navigator view. For example:

graphics/add-existing-business-service-data-in-navigator.png

Top of page

Download Additional Libraries (Optional)

This section describes how to determine whether any libraries are missing and then download the additional libraries from the server.

Start of instruction setTo download additional libraries from the server:

  1. Open the _steplibs > SteplibName.steplib file in the Navigator view.

    The steplib editor is displayed. For example:

    graphics/overview-steplib-library-list.png

    Note:
    For more information about the steplib editor, see Define the Steplib Chain Information.

  2. Review the Library List for any step libraries that are not available locally (i.e., not listed in the Navigator view).

    In this example, the DEMOTEST step library is not available.

  3. Open the context menu for the missing library in the Natural Server view.

  4. Select Add to existing Project.

    For example:

    graphics/natural-server-add-to-existing-project.png

    Note:
    You can also select Add to new Project to create a new NaturalONE project into which you can download the library. For information about creating a project, see the NaturalONE documentation.

    The selected library is downloaded from the server to the specified NaturalONE project and is now available in the Navigator view. For example:

    graphics/navigator-new-library.png

Top of page

Perform Standard Actions on Business Service Resources

You can use the Natural Server view to copy/paste, delete, or move business service resources on the server. The action will be performed in the mapped environment for the selected node(s).

Note:
Although you can select resources from more than one Business-Services node, you cannot select nodes from different mapped environments.

This section covers the following topics:

Perform Actions on a Business Service

Start of instruction setTo perform actions on one or more business services:

  1. Open the context menu for the business service(s) in the Natural Server view.

    For example:

    graphics/bs-context-menu-in-natural-server.png

  2. Select one of the actions listed.

    The available actions are:

    Action Description
    Move Removes the selected business service(s) from the current domain and adds the service(s) to a target domain in the mapped environment for the selected node. For information, see Move a Business Service.
    Copy Copies the selected business service(s) to the clipboard in anticipation of a Paste action. For information, see Copy a Business Service.
    Delete Removes the selected business service(s) from the current domain. For information, see Delete a Business Service.

Move a Business Service

This section describes how to move one or more business services from the current domain to a target domain in the mapped environment for a selected node(s).

Start of instruction setTo move one or more business services:

  1. Open the context menu for the business service(s) in the Natural Server view.

  2. Select Move.

    The Move Objects window is displayed. For example:

    graphics/move-objects-window.png

    This window lists the connection nodes for the available mapped environments.

  3. Expand the connection node for the environment into which you want to move the service(s).

  4. Select the Domains root node into which you want to move the service(s).

  5. Select OK.

    A progress window is displayed while the service(s) is removed from the previous Domains node and copied to the selected Domains node.

Copy a Business Service

This section describes how to copy one or more business services to the clipboard and then paste the service(s) into a target domain.

Start of instruction setTo copy one or more business services:

  1. Open the context menu for the business service(s) in the Natural Server view.

  2. Select Copy.

  3. Open the context menu for the Domains root node into which you want to copy the service(s).

  4. Select Paste.

    The service(s) is copied to the selected Domains root node.

Delete a Business Service

This section describes how to remove one or more business services from the current domain.

Start of instruction setTo delete one or more business services:

  1. Open the context menu for the business service(s) in the Natural Server view.

  2. Select Delete.

    A confirmation window is displayed to confirm the action.

  3. Select Yes.

    The service(s) is removed from the Domains root node in the current mapped environment.

Perform Actions on a Domain

Typically, the only action available for a domain is Delete, which removes one or more domains from the current mapped environment.

Start of instruction setTo remove one or more domains from the server:

  1. Open the context menu for the domain in the Natural Server view.

    For example:

    graphics/domain-context-menu-in-natural-server-view.png

    Note:
    The Paste action is only available when the clipboard contains one or more business services. For information, see Copy a Business Service.

  2. Select Delete.

    A confirmation window is displayed to confirm the action.

  3. Select Yes.

    The selected domain(s) is removed from the Domains root node in the current mapped environment.

Perform Actions on a Steplib

The only action available for a steplib is Delete, which removes one or more steplibs from the current mapped environment.

Start of instruction setTo remove one or more steplibs from the server:

  1. Open the context menu for the steplib in the Natural Server view.

    For example:

    graphics/steplib-context-menu-in-natural-server-view.png

  2. Select Delete.

    A confirmation window is displayed to confirm the action.

  3. Select Yes.

    The steplib(s) is removed from the Steplibs root node in the current mapped environment.

Top of page