Core Library - How to Configure a Handle Positioning – Content Studio

This document serves as the official guide for using the library, providing all the necessary instructions, guidelines, and best practices to ensure proper and standardized use of the available resources. It was created to support a clear understanding and effective application of the library's components.

Handles

Key details about handles, such as attributes, positioning, insertion points, and other influencing parameters.

Attributes

There are two sets of attributes for the handle positioning service, based on their intended users.

For use in the manufacturer's library: these attributes must be used by the customer for non-standard positioning and to set handle sizes.

Attribute	Usage
COMMON_PULL_LOCX	Move the handle horizontally.
COMMON_PULL_LOCY	Move the handle vertically.
COMMON_PULL_LOCZ	Move the handle on the depth axis.
COMMON_HANDLE_WIDTH	Door handle width.
COMMON_HANDLE_HEIGHT	Door handle height.
COMMON_DRAWERHANDLE_WIDTH	Drawer handle width.
COMMON_DRAWERHANDLE_HEIGHT	Drawer handle height.

2. Only used by the Core Library team:

There are some internal attributes to assist in the handle positioning (only used by the Core team). Since the zero point of the handle design is in the middle of the holes, we use offsets to correct positioning when the handle differs from a knob.

Attribute	Usage
COMMON_PULL_OFFSET_WIDTH	Assist in positioning.
COMMON_PULL_OFFSET_HEIGHT	Assist in positioning.
COMMON_PULL_OFFSET_DEPTH	Assist in positioning.

Positioning service option

Determines if handle positioning should be sourced from Core, which already provides the UI for client use.

Attribute	Options
COMMON_POSITIONING_SERVICE	TRUE or FALSE (default is True)

Single definition on handle positioning service

To restrict a single option of placement. By default, the option ALL is used, then all options are exposed. If you only want one option, use the attribute with its respective value.

Base Door
Attribute	Options
COMMON_DEFINITION_HANDLES_POSITIONING_BASEDOOR	ALL
	TOP_SIDE_VERTICAL
	TOP_CENTER_HORIZONTAL
	MIDDLE_CENTER_VERTICAL
	MIDDLE_CENTER_HORIZONTAL
	TOP_CENTER_VERTICAL
	MIDDLE_SIDE_HORIZONTAL
	TOP_SIDE_HORIZONTAL
	MIDDLE_SIDE_VERTICAL

Wall Door
Attribute	Options
COMMON_DEFINITION_HANDLES_POSITIONING_WALLDOOR	ALL
	BOTTOM_SIDE_HORIZONTAL
	BOTTOM_SIDE_VERTICAL
	BOTTOM_CENTER_HORIZONTAL
	BOTTOM_CENTER_VERTICAL
	MIDDLE_CENTER_HORIZONTAL
	MIDDLE_CENTER_VERTICAL
	MIDDLE_SIDE_HORIZONTAL
	MIDDLE_SIDE_VERTICAL

Tall Door
Attribute	Options
COMMON_DEFINITION_HANDLES_POSITIONING_TALLDOOR	ALL
	TOP_SIDE_VERTICAL
	TOP_CENTER_HORIZONTAL
	MIDDLE_CENTER_VERTICAL
	TOP_CENTER_VERTICAL
	MIDDLE_SIDE_HORIZONTAL
	TOP_SIDE_HORIZONTAL
	MIDDLE_SIDE_VERTICAL

Pull Out Door
Attribute	Options
COMMON_DEFINITION_HANDLES_POSITIONING_PULLOUT	ALL
	TOP_CENTER_VERTICAL
	TOP_CENTER_HORIZONTAL
	MIDDLE_CENTER_VERTICAL
	MIDDLE_CENTER_HORIZONTAL

Base Drawer
Attribute	Options
COMMON_DEFINITION_HANDLES_POSITIONING_BASEDRAWER	ALL
	TOP_CENTER_VERTICAL
	TOP_CENTER_HORIZONTAL
	MIDDLE_CENTER_VERTICAL
	MIDDLE_CENTER_HORIZONTAL

Wall Drawer
Attribute	Options
COMMON_DEFINITION_HANDLES_POSITIONING_WALLDRAWER	ALL
	BOTTOM_CENTER_VERTICAL
	BOTTOM_CENTER_HORIZONTAL
	MIDDLE_CENTER_VERTICAL
	MIDDLE_CENTER_HORIZONTAL

Default option on handle positioning service

Attributes to define a default option for handle placement. Refer to the first table for the attribute and the second table for the value.

Door Type	Attribute
Base Door	COMMON_DEFAULT_HANDLES_POSITIONING_BASEDOOR
Wall Door	COMMON_DEFAULT_HANDLES_POSITIONING_WALLDOOR
Tall Door	COMMON_DEFAULT_HANDLES_POSITIONING_TALLDOOR
Pull Out Door	COMMON_DEFAULT_HANDLES_POSITIONING_PULLOUTDOOR
Bifold Base Door	COMMON_DEFAULT_HANDLES_POSITIONING_BASEDOOR_BIFOLD
Bifold Wall Door	COMMON_DEFAULT_HANDLES_POSITIONING_WALLDOOR_BIFOLD
Bifold Tall Door	COMMON_DEFAULT_HANDLES_POSITIONING_TALLDOOR_BIFOLD
Base Drawer	COMMON_DEFAULT_HANDLES_POSITIONING_BASEDRAWER
Wall Drawer	COMMON_DEFAULT_HANDLES_POSITIONING_WALLDRAWER

Options
ALL
TOP_SIDE_VERTICAL
TOP_CENTER_HORIZONTAL
MIDDLE_CENTER_VERTICAL
MIDDLE_CENTER_HORIZONTAL
TOP_CENTER_VERTICAL
MIDDLE_SIDE_HORIZONTAL
TOP_SIDE_HORIZONTAL
MIDDLE_SIDE_VERTICAL
BOTTOM_SIDE_HORIZONTAL
BOTTOM_SIDE_VERTICAL
BOTTOM_CENTER_HORIZONTAL
BOTTOM_CENTER_VERTICAL

Restriction on handle positioning service

New attributes for handle positioning service visibility have been created for certain customers. These attributes default to TRUE and should be set to FALSE if restrictions are needed.

NOTE: Used only when restrictions are defined as ALL.

Refer to the tables below:

Base Door
Positioning	Attribute	Options
Top / Side / Vertical	COMMON_HANDLES_BASEDOOR_TOP_SIDE_VERTICAL	TRUE/FALSE
Top / Center / Vertical	COMMON_HANDLES_BASEDOOR_TOP_CENTER_VERTICAL	TRUE/FALSE
Top / Side / Horizontal	COMMON_HANDLES_BASEDOOR_TOP_SIDE_HORIZONTAL	TRUE/FALSE
Top / Center / Horizontal	COMMON_HANDLES_BASEDOOR_TOP_CENTER_HORIZONTAL	TRUE/FALSE
Middle / Side / Vertical	COMMON_HANDLES_BASEDOOR_MIDDLE_SIDE_VERTICAL	TRUE/FALSE
Middle / Side / Horizontal	COMMON_HANDLES_BASEDOOR_MIDDLE_SIDE_HORIZONTAL	TRUE/FALSE
Middle / Center / Vertical	COMMON_HANDLES_BASEDOOR_MIDDLE_CENTER_VERTICAL	TRUE/FALSE
Middle / Center / Horizontal	COMMON_HANDLES_BASEDOOR_MIDDLE_CENTER_HORIZONTAL	TRUE/FALSE

Wall Door
Positioning	Attribute	Options
Middle / Side / Vertical	COMMON_HANDLES_WALLDOOR_MIDDLE_SIDE_VERTICAL	TRUE/FALSE
Middle / Side / Horizontal	COMMON_HANDLES_WALLDOOR_MIDDLE_SIDE_HORIZONTAL	TRUE/FALSE
Middle / Center / Vertical	COMMON_HANDLES_WALLDOOR_MIDDLE_CENTER_VERTICAL	TRUE/FALSE
Middle / Center / Horizontal	COMMON_HANDLES_WALLDOOR_MIDDLE_CENTER_HORIZONTAL	TRUE/FALSE
Bottom / Side / Horizontal	COMMON_HANDLES_WALLDOOR_BOTTOM_SIDE_HORIZONTAL	TRUE/FALSE
Bottom / Side / Vertical	COMMON_HANDLES_WALLDOOR_BOTTOM_SIDE_VERTICAL	TRUE/FALSE
Bottom / Center / Horizontal	COMMON_HANDLES_WALLDOOR_BOTTOM_CENTER_HORIZONTAL	TRUE/FALSE
Bottom / Center / Vertical	COMMON_HANDLES_WALLDOOR_BOTTOM_CENTER_VERTICAL	TRUE/FALSE

Pull Out Door
Positioning	Attribute	Options
Top / Center / Horizontal	COMMON_HANDLES_PULLOUTDOOR_TOP_CENTER_HORIZONTAL	TRUE/FALSE
Top / Center / Vertical	COMMON_HANDLES_PULLOUTDOOR_TOP_CENTER_VERTICAL	TRUE/FALSE
Middle / Center / Vertical	COMMON_HANDLES_PULLOUT_DOOR_MIDDLE_CENTER_VERTICAL	TRUE/FALSE
Middle / Center / Horizontal	COMMON_HANDLES_PULLOUT_DOOR_MIDDLE_CENTER_HORIZONTAL	TRUE/FALSE

Tall Door
Positioning	Attribute	Options
Middle / Side / Vertical	COMMON_HANDLES_TALLDOOR_MIDDLE_SIDE_VERTICAL	TRUE/FALSE
Middle / Side / Horizontal	COMMON_HANDLES_TALLDOOR_MIDDLE_SIDE_HORIZONTAL	TRUE/FALSE
Top / Side / Horizontal	COMMON_HANDLES_TALLDOOR_TOP_SIDE_HORIZONTAL	TRUE/FALSE
Top / Side / Vertical	COMMON_HANDLES_TALLDOOR_TOP_SIDE_VERTICAL	TRUE/FALSE
Top / Center / Horizontal	COMMON_HANDLES_TALLDOOR_TOP_CENTER_HORIZONTAL	TRUE/FALSE
Top / Center / Vertical	COMMON_HANDLES_TALLDOOR_TOP_CENTER_VERTICAL	TRUE/FALSE
Middle / Center / Vertical	COMMON_HANDLES_TALLDOOR_MIDDLE_CENTER_VERTICAL	TRUE/FALSE

Base Drawer
Positioning	Attribute	Options
Middle / Center / Horizontal	COMMON_HANDLES_BASEDRAWER_MIDDLE_CENTER_HORIZONTAL	TRUE/FALSE
Middle / Center / Vertical	COMMON_HANDLES_BASEDRAWER_MIDDLE_CENTER_VERTICAL	TRUE/FALSE
Top / Center / Vertical	COMMON_HANDLES_BASEDRAWER_TOP_CENTER_VERTICAL	TRUE/FALSE
Top / Center / Horizontal	COMMON_HANDLES_BASEDRAWER_TOP_CENTER_HORIZONTAL	TRUE/FALSE

Wall Drawer
Positioning	Attribute	Options
Bottom / Center / Horizontal	COMMON_HANDLES_WALLDRAWER_BOTTOM_CENTER_HORIZONTAL	TRUE/FALSE
Bottom / Center / Vertical	COMMON_HANDLES_WALLDRAWER_BOTTOM_CENTER_VERTICAL	TRUE/FALSE
Middle / Center / Vertical	COMMON_HANDLES_WALLDRAWER_MIDDLE_CENTER_VERTICAL	TRUE/FALSE
Middle / Center / Horizontal	COMMON_HANDLES_WALLDRAWER_MIDDLE_CENTER_HORIZONTAL	TRUE/FALSE

SpaceHolders for handles

Here you will find the attributes to activate the Handlestyles:

Attribute	Utility	Default Value	Options
COMMON_DECORATIVE_TYPE_INTEGRATION_DOOR_HANDLESTYLE	For handle's doors	Static	Static
			Manufacturer
			Cross
COMMON_DECORATIVE_TYPE_INTEGRATION_DRAWER_HANDLESTYLE	For handle's drawers	Static	Static
			Manufacturer
			Cross

Existing values:

Static - which uses models from Core (default value).
Manufacturer - If you want to use the ID coming from a specific catalogue. If selected, you must assign the desired ID to the attributes below: