Global Resource Settings

Global Resource Settings

Global Resource Settings is a tool to set up global resource of common data resources that can be referenced from all projects and scripts.
Refer to "Global Resources" for more information.

Functions provided by Global Resource Settings

Global Resource Settings provides following functions.
Description of Functions
Name of function Description Remarks
List all available Global Resources Lists all available Global Resources. Shown when Global Resource Settings is launched.
  • Sorted by standard unicode character order.
Create new global resource Creates a new Global Resource.  
Change Global Resource Settings Modifies Global Resource settings.  
Copy Global Resource Copies the Global Resource.  
Create global resource of Different Type Creates Global Resource with a different Type.
  • See Type for details.
Delete Global Resource Deletes Global Resource.  
Reset Pool Reset the global resource of pool to "0".  
Search Global Resource Searches Global Resource  

List all available Global Resources

Studio

Description of items
Item name Description Remarks
Name The name of global resources.  
Type Global resource type.
Resource type The type of global resources.  
Owner Owner of Global Resources.  
Pooled size(Unused) Currently loaded pool number and the number of which is unused among that.
  • The relationship of "number of unused pool is no larger than number of pool" always consists.The number of unused decreases by 1 when resource is used and increases by 1 when the using of resource is done.
Max capacity Maximum value for pooling.
  • The default value is "unavailable" or "unlimited".(It changes depending on the adapter.)

Studio for Web

Description of items
Item name Description Remarks
Name The name of global resources.  
Type Global resource type.
Resource type The type of global resources.  
Owner Owner of the global resources.  
Enable/Disable pool The setting for the component pool usage is displayed.
  • The default value is "Disabled" or "Enabled". (The default value varies depending on the adapter.)
Max pool capacity Maximum value for pooling.
  • Nothing is displayed if the pool is "Disabled".
  • "0" is displayed if the max pool capacity is unlimited.
Pool size The number of pooled connections that are currently loaded.  
Unused pool size The unused number of pooled connections that are currently loaded.
  • The unused pool size is always less than or equal to the pool size. The unused size decreases by one when a resource is used and increases by one when use of a resource ends.

Create new global resource

Global Resource can be created as follows:
  1. Select the [File]-[New global resource] menu action.

  2. Select the global source type you want to create and click [Next] button.

  3. Connection Settings screen appears. Configure the properties in the [Required Settings] tab.
    Properties in the [Required Settings] tab varies depending on the Global Resource. For more information about the settings, refer to "Global Resource Properties" of each adapter.
    See "Global Resource name character limitations" for characters not allowed in the names of Global Resource

  4. Select [Component pool settings] and configure the settings for Component Pool
    [Component pool settings] tab is show only if it is applicable.
    See "Component Pool" for any details.
    Description of items
    Item name Description Remarks
    Use component pool Select whether to use Component Pool or not.
    • [Checked]:(default)
      Use the component pool.
    • [Not Checked]:
      Do not use the component pool.Generates the global resource at each time of the connection .
    • Some adapters may be set [Not checked] as default value.
      For details, refer to "Global Resource Properties" of each adapters.
    Reset pool Reset the global resource of pool to "0".
    • Enabled when [Use component pool] is checked.
    • When creating a new global resource, this button is not shown.
    Initial value and upper bound value of connected count Initial value Enter the number of pooled connections when DataSpiderServer starts.
    • Enabled when [Use component pool] is checked.
    • The default value is "0".
    Upper bound value Enter the maximum number of pooled connections.
    • [Limited]:
      Enter the maximum number of pooled connections.
    • [Unlimited]: (default)
      Do not set the maximum number of pooled connections.
    • Enabled when [Use component pool] is checked.
    • Default value is "0" when [Limited] is selected.
    • If "0" is specified, [Unlimited] is set after pressing [OK] button.
    Connection lifetime settings Connection lifetime Input time that pooled connections becomes the subject of Component pool GC (ms).
    • Enabled when [Use component pool] is checked.
    • The default value is "1800000" (30 minutes).
    Time out Input timeout time (ms) when requiring connection is exceeded upper bound value if selecting [Limited] in [Upper bound value].
    • Enabled when [Use component pool] is checked.
    • The default value is "30000" (30 seconds).
    • If connection is not generated even when timeout time is over, error occurs.

    If the timeout value and the lifetime of connection is changed, the pooled connection up to now is destroyed and new connection using new setting value will be generated.Therefore, the connection number right after changing will be reset to the value set in initial connection number.

  5. Select [Security] tab and configure any security related settings for Global Resource
    Description of items
    Item name Description Remarks
    Owner The owner of the Global Resource.
    • The user who created the Global Resource becomes the owner by default.
    Group The group to which the owner of the Global Resource belongs.
    • The primary group of the user who created the Global Resource is set by default.
    Access permissions Permissions on Global Resource.
    • [Use]
      The privilege to view and execute global resources.
    • [Edit]
      The privilege to delete or edit the setting of global resources.
    • Global resources you do not have privilege to use them are not listed.
    • For more details on default access permissions, refer to "Default access permissions".

  6. Click [OK] button to complete registration.

Change Global Resource Settings

Global Resource can be edited from [File]-[Properties].
For any details regarding Global Resource settings, see Global Resource Property page available for each adapter component.

Notes on changing global resource name

Copy Global Resource

Global Resource can be copied using [Edit]-[Copy] and [Edit]-[Paste] menu actions.

Security settings of copied global resource

Create global resource of Different Type

Global resource with the same name and different type can be created.
See Type for details regarding Types

To create a duplicate of a Global Resource, use [Create global resource of same name] action in its right click context menu.

Delete Global Resource

Global Resource can be deleted by [Delete] action in its right-click context menu.
When the global resource with "Default" type is deleted, global resources with the same name and different types are also deleted.

Reset Pool

Component Pool can be reset by the following procedure:
See "Reset component pool" for details.

Search Global Resource

Global Resource can be searched using [Tool]-[Search global resource] menu actions.
The search scope is limited to global resources accessible from the global resources settings.
You can copy search results under the selected nodes to the clipboard.

Available Search Condition

You can mix and match the below conditions when searching a global resource. Results are matched to one of the conditions below.
Description of items
Search criteria Description Remarks
Containing global resource name
  • [Contains]
  • [Equals To]
  • [Starts With]
  • [Ends With]
 Search a global resource defining a name that matches to the specified condition.  
Containing type Search a global resource defining a type that matches to the specified condition.
  • If you search by the types already exist, please specify the below values.
    Type name Specified value
    Default default
    Test test
    Production production
Containing keyword Fuzzy search a global resource containing the keyword.
  • There are some objects such as a checkbox and a list in which searching is not well performed by the displayed contents.
  • Unrelated global resources matched to internal information may be included in search results.
Property action
Item name Description Remarks
Search Search a global resource by the specified condition.
  • Do not differentiate capital and small letters.
Clear Clear search conditions and results to get back to the initial condition.  
+ Add a search condition.  
- Delete a search condition.
  • Unable to delete if only one search condition is selected.

Default access permissions

Default access permissions can be set from "default.globalresource.permissions" in system properties.
For more details, refer to "Property Reference".

When it is not set or when an invalid value is set, the following access permissions are given.

  Use Edit
Owner Yes Yes
Group Yes No
Others Yes No

About setting value

Setting value is set with 3-digit octal number. Each digit represents a target to which access permission is to be given, also represents owner, group, others from left to right order.

The value that can be set to each digit, and the access permissions represented by each value are as follows.

Setting value Use Edit
0 No No
2 No Yes
4 Yes No
6 Yes Yes

Example: In case of "644"

  Setting value Use Edit
Owner 6 Yes Yes
Group 4 Yes No
Others 4 Yes No

Specification limit