Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 13 Next »

Introduction

The Administration menu is where Perfion administrators manage the setup of Perfion.

Items

In Items you build the “structures” to be expose under Items in the main menu.

image-20240411-130600.png

Recommended best practice is to expose high volume data carrying items to be managed on a daily basis by “normal” Perfion users. This can be Products, Images, Files, Spareparts, etc. Other data carrying items with low volumes, lower update frequencies or more restricted access can be managed by super users in Feature Data.

image-20240411-131439.png

TECH NOTE: In web clients older than 5.4, you selected which sections from the windows client to expose as tiem structures in the web client. From version 5.4 and forward, item structures in web client must be built and managed separately from the windows client.

Create or edit an Item structure

Name

Click Add New to create a new item structure, or click the pencil icon to edit an existing item structure. Both open a dialogue where Name is preselected in the left menu. Here you type in the name of the item structure in all active languages:

image-20240411-132623.png

Feature & Icon

On the Feature & Icon tab, you select the base feature users can manage in the main grid. This is typically a feature called something similar to the name you gave the item structure on the first tab.

You can also add a logo file to be shown in the top menu of the application together with the name.

image-20240411-132948.png

Categorizers and Searches

On the Categorizers and Searches tab, you manage the options users will have to browse and search for items. You can:

  • Delete option (red X)

  • Translate name to all active languages (globe)

  • Sort options (drag-drop the 6-dot handle)

  • Specify name in main language (Name (XX))

  • Choose type (Categorizer or Search)

  • Choose categorizer feature or search panel (Feature / Search)

  • Add new option (Add New)

image-20240411-133406.png

Each row corresponds to en entry in the drop down users see at the top of the left pane of the item structure:

image-20240411-133804.png

User Access / Group Access

On these two tabs, you grant users and/or user groups access to the item structure:

image-20240411-134632.pngimage-20240411-135146.png

NOTE: In previous versions, administrators automatically had access to all items. From version 5.4 and forward, administrators must also be granted access to item structures to see them. This allows you to build item structures specifically for some user groups that administrators do not need to see in their daily work.

Channels

In Channels you build your output channels.

image-20240412-065639.png

Channels are exposed under Channels in the main menu and in the Publish work mode.

image-20240412-070047.png

Create or edit a channel

Channel Name

Click “New Channel” to create a new channel, or click the pencil icon to edit an existing channel. Both open a dialogue where Channel Name is preselected in the left menu. Here you type in the name of the channel in all active languages:

image-20240412-072458.png

Channel Feature & Icon

On the Channel Feature & Icon tab, you set up the structure of the channel:

  • In Channel Feature you select the feature holds the structure of the channel. This is typically a selectable feature called something similar to the name you gave the channel on the first tab.

  • In Related Item Feature you select the feature that holds the items you want to publish in the channel. This is typically your main product feature, but it can also be other selectable features like images, files, spareparts, etc.

You can also add a logo file to be shown in the top menu of the application together with the channel name.

image-20240412-072802.png

User Access / Group Access

On these two tabs, you grant users and/or user groups access to the channel:

image-20240412-073420.pngimage-20240412-073441.png

This completes the channel setup, and the channel is now available in relevant menus.

TECH NOTE: The trained Perfion administrator will recognize, that building a channel is mostly a UI concept. A channel allows users to publish items with the purpose-built channel concept and publish work mode in the web client. From a technical perspective, when an item is published into a channel, the item is simply assigned a value in the channel feature.

Global Search

In Global Search you can activate global search on individual base features.

image-20240412-073720.png

When Global Search is activated on a base feature, it becomes available for users in the top left corner of the relevant Item section:

Create or edit a global search

Features

Click “New Search” to create a new global search or click the pencil icon to edit an existing search. Both open a dialogue where Features is preselected in the left menu. Here you set up how the global search should work:

  • In Base Feature you select the feature the global search should work. This will typically be a feature you use in one of your Item structures.

  • In Search Feature you add additional configured features in which the global search should look for matches to users’ input. The global search will always search in the selected base feature, so you should not add that. You could add Item Name, Category and Color:

image-20240412-073841.png

With this setup, the global search now appears in sections where Product is base value in the main grid. The global search will return items with values matching the search word in the base value or in either of the defined search features.

image-20240412-075115.png

TECH NOTE 1: Global search use MATCH as default operator

TECH NOTE 2: Advanced Search appears as standard when Global Search is activated. Advanced Search allows users to search for any combination of data using all operators. Please see Perfion Web Client User Guide for details.

Searches

In Searches you build search panes.

image-20240412-101335.png

Search panes are used in Items allowing users to search for items via a specific set of features:

image-20240412-101721.png

Create or edit a search

Name

Click “Add New” to create a new search, or click the pencil icon to edit an existing search. Both open a dialogue where Name is preselected in the left menu. Here you type in the name of the search:

The name is not localized as it is not exposed to users. The name is only shown when you select a search in an item structure.

image-20240412-102047.png

Options

On the Options tab, you set up the structure of the search pane. Each row represent a searchable feature in the search pane. Rows can be added, deleted and sorted.

image-20240412-102334.png

This table explains each column.

Feature

Select the feature users can search for.

All feature types can be added to the search pane. Features cannot be updated in an existing row. If you want to from one feature to another, you must delete the row and and a new.

Filter Type

Select how users will search for values in the feature.

Options in this column depends on the selected feature. For some feature types, only a single option is available (preselected).

Search

A normal input field will appear where users can type in the value they want to search for.

Min / Max

Two normal input fields will appear where users can type in a minimum and a maximum value to search between.

Select

A selector will appear where users can pick a single value to search for

Select Multiple

A selector will appear where users can pick multiple values to search for

Scope

This is a legacy function.

None

Use None if suggested by system.

Exact

Use Exact if suggested by system.

Intervals

Do not change to Intervals even if this is possible. The search pane in web client will return incorrect selection of items if Intervals is selected.

Operator

Select which operator to use when users search for values. Available operators depend on selected feature and filter type.

=

Value on item must match exactly (no wildcards allowed)

!=

Value on item must be different from

Value on item must be larger than

>=

Value on item must be larger than or equal to

Value on item must be smaller than

<=

Value on item must be smaller than or equal to

LIKE

Value on item must match exactly (wildcard % allowed)

Notes:

LIKE works the same as “=” if no wildcard is applied.

If wildcard % is added after search value (e.g. ABC%), the value on item must begin with ABC

If wildcard % is added before search value (e.g. %ABC), the value on item must end with ABC

NOT LIKE

Opposite to LIKE

MATCH

Value on item must contain specified value (wildcard * allowed)

Notes:

If wildcard * is added after search value (e.g. ABC*), the value on item must begin with ABC

If wildcard % is added before search value (e.g. *ABC), the value on item must end with ABC

NOT MATCH

Opposite to MATCH

IN

Value on item must be any of specified values (no wildcards allowed)

Notes:

Use semicolon (;) as separator between values.

If you type 8;12;20 in the value column, filter will return items with 8 or 12 or 20 as value

NOT IN

Opposite to IN

BETWEEN

Value on item must be between two specified values

Notes:

Use BETWEEN on numeric features only.

Use semicolon (;) as separator between values.

If you type 8;12 in the value column, filter will return items with values between 8 and 12 (both end-values included)

IN HIERARCHY OF

Value on item must be identical to or a child/grand child of the specified value

Notes:

Use IN HIERARCHY OF on selectable features with a hierarchy.

If you type Cooking in the value column, filter will return items with value Cooking or any child/grand child of Cooking.

EXECUTE

Value on item must match the criteria of the selected search item

Notes:

This operator is only available for Search features with Select as Filter type.

In these cases, the EXECUTE operator will add the search criteria of the user-selected search item to the other search criteria defined by the user.

Top View Groups and View Groups

In Top View Groups and View Groups you can add, edit and delete the primary and secondary groups used to organize features in the Item Editor.

image-20240412-081938.png

Create or edit a group

Name

Click Add New to create a new group, or click the pencil icon to edit an existing group. Both open a dialogue where you manage the name of the group in all relevant languages:

image-20240412-082050.png

Security Groups

In Security Groups you can add, edit and delete security groups. Security Groups control the permissions users and groups have to features assigned to the security group.

image-20240412-082523.png

Create or edit a security group

Name

Click Add New to create a new security group, or click the pencil icon to edit an existing group. Both open a dialogue with the Name tab preselected. Here you manage the name of the group in all active languages.

image-20240412-082623.png

User Permissions / Group Permissions

In User Permissions and Group Permissions you manage permissions for users and groups.

image-20240412-082714.png

Permissions are grouped under Items and Feature Values. To understand this destinction, think of a selectable feature like Color. This feature consists of a list of Items (Red, Blue, Green, etc) that users can choose between when setting a Color value on a product:

  • Permissions set under Item control users rights to add, edit and delete colors from the list of items. These permissions are only used for selectable features.

  • Permissions set under Feature Values control users rights to set color values on products.

Permissions, Items

Meaning (examplified by the Color feature mentioned above)

Read

This is the minimum - and mandatory - permission you can grant. With this permission users can see the list of color items in Feature Data.

Edit

With this permission users can edit the names of existing color items in Feature Data (e.g. change Reed to Red).

Move

With this permission users can move existing color items from one parent to another. This is only relevant if the list of items is organized in hierarchies.

Create

With this permission users can add new color items to the list (e.g. add Maroon to the list)

Delete

With this permission users can delete existing color items from the list (e.g. delete Maroon).

NOTE: Deleting a color item will remove the color from all products where it is used as value.

Permissions, Feature Values

Read

With this permission users can see color values on products but not edit them.

Edit

With this permission users can add, change and remove color values on products.

Edit+

With this permission users can add, change and remove color values on products EVEN if product is locked for editing in general by Feature Item Security.

NOTE: Feature Item Security allows you to remove all permission to manage data on a product when the product has a specific value in a specific selectable feature. A typical example would be to remove all permissions to manage data on a product when its Status is set to Discontinued. Feature Item Security can not be managed in the web client yet.

Users

In User you can add, edit and delete Perfion users.

Maximum number of active users is controlled by license file

image-20240416-095339.png

Create or edit a user

General

Click Add New to create a new user, or click the pencil icon to edit an existing user. Both open a dialogue with the General tab preselected. Here you manage the basic user settings.

image-20240416-095641.png

ID

Unique ID of the user.

The ID is used for login, and it is used as identifer for all changes the user does to data in Perfion. The ID cannot be changed when user has been created.

Name

User’s full name.

Description

For internal information only. Not used by the application.

Windows Domain User

Adding a Windows Domain User (DOMAIN\userid) will enable the user to bypass the login screen of the Perfion Window client.

NOTE: Windows Domain User has no effect in the Perfion web client. User must always login.

Email

User’s email address.

Default Feature Group

The selected Top View Group will be preselected when user opens an item editor.

Active

Only Active users can log into Perfion. Inactive users are not included when number of users is calculated against limitations in license file.

From AD

This option is only available if AD integration is enabled.

When option is checked, the basic user administration…

Language Permissions

In Language Permissions you manage the user’s general permissions to read or edit data in different languages.

Language Permisssion work hand-in-hand with Security Groups to determine users' permissions to specific features. Users must have permissions from both structures to read or edit data in grid and item editor.

Specific languages

When a specific language is added to the user’s profile, the user is granted general permisssions to Read or Edit data for localized features in that language. In the example below, the user can edit English data and read German data.

NOTE: Spcific languages can be sorted using the 6-dot handle (drag-drop). The language at the top of the list is the user’s primary language which is shown by default in grids and item editors.

Non-localized features

This option controls the user’s general permissions to read or edit non-localized features.

image-20240416-105302.png

Member of

In Member of you manage the user’s memberships of User Groups.

image-20240416-111031.png

Roles

In Roles you control what the user can do in the Perfion client in addition to reading/editing data.

  • Has role directly - role is assigned directly to the user

  • Has role from group - role is assigned via membership of a user group (hover the ?-icon to see which groups)

image-20240416-111648.png

Reporting

Can execure reports

Controls if user is allowed to create reports via the “New Report” option in right-click menus.

image-20240416-112924.png

Can design reports

Controls if user is allowed to design report template.

Template design tool is only available in windows client.

Can export via reports

Controls if user is allowed to export report data via the “Export Report Data” option in right-click menus.

image-20240416-113151.png

Feature Data - Import/Export

Can export data from grid

Controls if user is allowed to export data, images and files from grid via the three options in 3-dot menu in main grids.

image-20240416-113614.png

Can import data

Controls if user is allowed to import data and view import logs via the two options in the Tools menu.

image-20240416-114345.png

Can import data without validator

Controls if user is allowed to import data without validation of selectable values.

  • If allowed, user can create new selectable values (e.g. new colors on the color list) from data in the import file.

  • If not allowed, “Selectable feature validation” will be locked to “Validate all features” in the import dialogue. Import will stop if import file contains unknown selectable values.

image-20240416-114518.png

Related Sort Order - Import/Export

Can import related sort orders

Controls if user is allowed to import related sort orders. This could be the order of which products are shown in a catalog.

Import of related sort orders is only available in windows client.

Can export related sort orders

Export of related sort orders is only available in windows client.

Actions - Import/Export

Can import actions

Controls if user is allowed to import actions via 3-dot menus and right-click menus in Action.

image-20240416-115348.png

Can export actions

Controls if user is allowed to export actions via 3-dot menus and right-click menus in Action.

image-20240416-115348.png

Scheduling

Can edit schedules

Controls if user is allowed to edit schedules in the scheduler.

The Scheduler is only available in windows client.

Log

Can access Log

Controls if user is can access the master log and search through all data changes.

The master log is only available in windows client.

This role does not control access to Previous Values. All users have access to Previous Values on features they can edit.

Can access Recycle Bin

Controls if user can restore deleted items via “Recycle Bin” option in the 3-dot menu in main grids.

image-20240416-122834.png

Developer

Can access API Tool

Controls if user can execute API queries via the API Tool.

The API Tool is only available in windows client.

Actions

Can execute actions

Controls if user is allowed to execute actions via the option in the Tools menu and via right-click menu on items.

image-20240416-123414.pngimage-20240416-123613.png

Can manage actions in Web Client

Controls if user is allowed to manage actions via the Actions option in main menu.

image-20240416-123715.png

Feature Data

Can access Feature Data

Controls is user is allowed to manage feature data via the Feaure Data option in main menu.

image-20240416-123926.png

Even with access to Feature Data, user can only manage items and data as determined by user’s permisssions.

Filtered Values

Can manage filtered values

Controls if user can manage filtered values configurations.

Filtered values configuration is only available in windows client.

Supplier Portal

Can access supplier portal and accept/reject supplier items

Controls if user can log into the Perfion supplier portal and accept/reject supplier items.

This option is only relevant when supplier portal is included in license.

Can accept/reject supplier data

Controls if user can accept/reject supplier data updates in the Perfion web client.

This option is only relevant when supplier portal is included in license.

User Groups

In User Groups you can add, edit and delete user groups.

User Groups are generally used to manage permissions for groups of users in stead of individually for each user. See section above about Security Groups.

image-20240416-125540.png

Create or edit a user group

General

Click Add New to create a new user group, or click the pencil icon to edit an existing user group. Both open a dialogue with the General tab preselected. Here you manage the basic user group settings.

image-20240416-125736.png

Members

In Members you can add and remove users from user groups.

image-20240416-125915.png

Roles

In Roles you control what members of the user group can do in the Perfion client in addition to reading/editing data.

Please refer to Users - Roles for explanation about each role.

image-20240416-130016.png

  • No labels