This article was created with the assistance of AI tools for research and drafting. It was reviewed, edited, and fact-checked by our human editorial team before publication.

Service Item Attributes

This chapter contains all important information on service item attributes. You can map attribute values to service items, depending on Manufacturer, Category, and Subcategory. This allows you to map the complete configuration of the service item depending on the number of service item attributes and the corresponding categories and subcategories. This chapter is divided into the following sections:

Creating Service Item Attributes

Proceed as follows to create a service item attribute:

  • Use the quick search (ALT+Q) to find the Service Item Attributes page.
  • Click New in the menu bar. A new line is created in the Service Item Attributes table.
  • Fill in the columns of the line according to the following table:
Column Description
Code Enter a unique code for the attribute.
Name Enter a unique name for the attribute, e.g., drive or chainsaw.
Data Type Select the type of data for the attribute. You can select from the following options:

Text – Use this data type for attributes for which a text must be entered, e.g., tires.

Boolean – Use this data type for attributes for which two states may be possible, e.g., if an all-wheel drive is available or not.

Option – Use this data type for attributes for which you can select from multiple options, e.g., the engine type.

Integer – Use this data type for attributes for which an integer value must be used, e.g., the number of gears of a machine.

Decimal – Use this data type for attributes for which a decimal value must be used, e.g., the gross vehicle weight of a truck.

Date – Use this data type for attributes for which a date must be used.
Unit of Measure If you selected Integer or Decimal as data type, select the relevant unit of measure from the dropdown list.
Values For the Option data type, specify the possible options via the selection field, e.g., electric engine, gasoline engine, or diesel engine. For Integer or Decimal data types, this field is filled automatically by the system based on the selected Unit of Measure.

Your entries are saved automatically. You have successfully created a service item attribute.

Tip

You can also store a translation of the service item attribute. To do this, click Actions > Translation in the menu bar on the Service Item Attributes page, then select the desired language code and enter an appropriate description in that language. When you switch the display language to the stored language, the service item attribute is automatically displayed in the corresponding language.

Mapping Service Item Attributes to a Subcategory

This section describes how to map service item attributes to a service item subcategory. Once you have entered the Manufacturer, Category, and Subcategory during the creation of a service item, the service item attributes mapped to the subcategory are inserted automatically. You can then add them to a service item. To map service item attributes to a service item subcategory, proceed as follows:

  • Use the quick search (ALT+Q) to find the Service Items page.
  • Open an existing service item.
  • Navigate to the Attributes FastTab.
  • In the dropdown list of the Subcategory field, click Select from full list at the bottom of the window.
  • In the menu bar, click the selection field > Attributes.
  • The Attribute Mapping window opens, displaying all service item attributes which are mapped to the selected service item subcategory.
  • Click New in the menu bar.
  • In the Code column, select the code for the attribute you want to map to the subcategory from the dropdown list. The Name column is filled in automatically.
  • Optional Select the Promoted checkbox if the service item attribute should be highlighted in bold on the service item card.
  • Confirm the dialog window to retrospectively add the attribute to all service items in this subcategory.

You have successfully mapped a service item attribute to a subcategory. It is now displayed in the Attribute Mapping window.

Adding Service Item Attributes to a Service Item

Specifying service item attributes allows you to store additional information for service items and to filter by them. In order to add attributes to a service item, you must first specify a Category and a Subcategory in the Attributes FastTab on the service item card. You can then add the service item attributes mapped to the subcategory. To do so, proceed as follows:

Note

If the desired category or subcategory does not exist, it must be created. In this case, contact our Support (only available in German).

  • Use the quick search (ALT+Q) to find the Service Items page.
  • Open the service item to which you want to add attributes.
  • Navigate to the Attributes FastTab.
  • Select a category in the Category field.
  • Select a subcategory in the Subcategory field.
  • The service item attributes that have been mapped to the subcategory are displayed in the Attribute Values FastTab.
  • Complete the attribute data in the Value column of the Attribute Values FastTab according to the following table:
Data Type Description
Text For attributes of this data type, enter a text.
Boolean For attributes of this data type, select the Yes or No value via the selection field.
Option For attributes of this data type, select one of the available options via the selection field.
Integer For attributes of this data type, enter a number. You cannot use a decimal number.
Decimal For attributes of this data type, enter a number. You can use a decimal number.
Date For attributes of this data type, enter a date.

You have successfully entered the values of the service item attributes.

Filtering Service Items by Attribute

This section describes how to filter the service item list based on attributes. To do so, proceed as follows:

  • Use the quick search (ALT+Q) to find the Service Items page.
  • Click Related > Attributes > Apply Filter in the menu bar.
  • In the Attribute Code column, select the attribute by which you want to filter from the dropdown list. The Attribute Name and Data Type columns are filled automatically by the system.
  • Select the desired value in the Value column to refine the filtering.
  • Optional Repeat the two previous steps to expand the filter by further attributes and further narrow down the displayed service items.
  • Click OK to confirm your selection.

You have successfully filtered by service item attributes. The Service Items page is updated and only displays service items that match the filter. If no service items are displayed, this could be because either no attribute value has been specified or no service items with the specified attribute value exist.

Tip

To remove the filter, click Related > Attributes > Clear Filter in the menu bar. Alternatively, you can also search specifically for service items with certain attribute values using the Machine Finder page. Use the quick search (ALT+Q) to find the Machine Finder page. In the Options FastTab, select the desired filter criteria to narrow down the list of available service items. The corresponding attributes are then displayed in the Attributes FastTab. Enter the desired values there and click Find in the menu bar to filter the service items based on the entered attributes.

Creating Service Item Models

Service item models facilitate selecting service item attributes. If you enter the model name of the service item in the Model field, the Manufacturer, Category, and Subcategory fields are automatically filled in by the system and the service item attributes stored for the model are automatically entered in the Attribute Values FastTab. Proceed as follows to set up a service item model in the system:

  • Use the quick search (ALT+Q) to find the Service Item Models page.
  • Click New in the menu bar to create a new machine model.
  • Complete the information according to the following table:
Column Description
Manufacturer Code Enter the manufacturer code for the machine in this column.
Manufacturer Name The information of this column is added automatically by the system when you enter a value in the Manufacturer Code column.
Category Code Use this column to enter a code for the category that matches the machine.
Category Name This column is filled in automatically by the system once you select a Category Code.
Subcategory Code Use this column to enter a code for the subcategory that matches the machine.
Subcategory Name This column is filled in automatically by the system once you select a Subcategory Code.
Code Enter the code for the model in this column.
Name Enter the model name in this column.
Rent Class This field displays the rent class of the service item model, if a rent class has been stored. More information on rental can be found under Aptean Rental.
No. of Calc. Depreciation Months Use this column to enter the number of calculated depreciation months.

You have successfully set up a model for a service item. Your entries are saved automatically.

Tip

You can also store a translation of the service item model. To do this, click Related > Translation in the menu bar on the Service Item Models page, then select the desired language code and enter an appropriate description in that language. When you switch the display language to the stored language, the service item model is automatically displayed in the corresponding language.

Defining Default Attribute Values for the Service Item Model

You can define default values for attributes for a service item model. When creating a new service item, the attributes are automatically prefilled with the default values defined for the selected model. If the subcategory or model is changed later, the system also checks whether default values are available. These are then updated automatically. This function is especially useful when certain service item models are regularly sold with fixed attributes and attribute values. To define default attribute values for the service item model, proceed as follows:

  • Use the quick search (ALT+Q) to find the Service Item Models page.
  • Select the desired service item model.
  • Click Navigation > Default Attributes in the menu bar.
  • In the Attribute Code column, select the desired service item attribute.
  • In the Default Value column, select the desired default value for the attribute.
  • Optional Repeat the process to define additional default attribute values for the service item model.

You have successfully defined default attribute values for the service item model. When creating a new service item, the attributes are now automatically prefilled with the default values defined for the model.

Service Item Categories

The following sections contain all important information regarding service item categories and subcategories.

Creating Service Item Categories

To create service item categories, proceed as follows:

  • Use the quick search (ALT+Q) to find the Service Item Categories page.
  • Click New in the menu bar.
  • Complete the columns according to the following table:
Column Description
Code Enter a code for the service item category. The code can be freely selected.
Name Enter a name for the service item category, e.g., Tractor or Crane.
Counted Rent Income (%) This field displays the amount of the counted rent income in percent. More information on rental can be found under Aptean Rental.
Rent Class This field displays the default rent class for the service item category, if a rent class has been stored. More information on rental can be found under Aptean Rental.
Approve Calc. Review Before Sale Select this checkbox if the user must always approve the calculation review before the service item is posted in a sales document. More information on calculation reviews can be found under Calculation Review.
Show Calc. Review on Calc. Review List Select this checkbox if calculation reviews for service items of the selected service item category should be shown in the calculation review list. More information on calculation reviews can be found under Calculation Review.
Item Template Select the item template you want to link to the service item category. This allows you, among other things, to create an item based on the linked item template when using the Add Service Item function in documents. The item template is automatically used if no item with the matching combination of Manufacturer, Category, Subcategory, and Model exists in the system.
Has Meter Select this checkbox if the service item category has a meter. If a service item category has a meter, the user is prompted to enter the meter reading in service orders.
Meter 1 Type Enter the meter type. Service items in this category are assigned this meter type as meter 1 by default.
Meter 2 Type Enter the meter type. Service items in this category are assigned this meter type as meter 2 by default.
Serial No. Type 1 Enter a Serial Number Type. Once added, it is displayed in the header of the service item card, allowing you to enter a serial number.
Serial No. Type 2 Optional Enter another Serial Number Type, if needed. Once added, it is displayed in the header of the service item card, allowing you to enter a serial number.
Checklist for Sales Enter the checklist template that should be used for this service item category. When a service item from this category is added to a sales order, a checklist is automatically created. It must be fully completed before the shipment can be posted. More information on creating checklist templates can be found under Creating Checklist Templates. More information on creating and completing checklists in sales and transfer orders can be found under Checklists for Service Items.
Checklist for Transfer Enter the checklist template that should be used for this service item category. When a service item from this category is added to a transfer order, a checklist is automatically created. It must be fully completed before the shipment can be posted. More information on creating checklist templates can be found under Creating Checklist Templates. More information on creating and completing checklists in sales and transfer orders can be found under Checklists for Service Items.

You have successfully created a service item category. The next section explains how to add service item data per category as a comment line to documents.

Tip

You can also store a translation of the service item category. To do this, click Actions > Translation in the menu bar on the Service Item Categories page, then select the desired language code and enter an appropriate description in that language. When you switch the display language to the stored language, the service item category is automatically displayed in the corresponding language.

Adding Service Item Category Data as Comments

This section describes how to define which service item data should be displayed as a comment line on sales, service, and transfer documents based on the service item category. To do so, proceed as follows:

  • Use the quick search (ALT+Q) to find the Service Item Categories page.
  • Select a service item category.
  • In the menu bar, click the selection field > Actions > Service Item Document Data.
  • Fill in the table on the Service Item Doc. Data page according to the following information:
Column Description
Table Relation Code Optional You can create a relation between a service item and another table, e.g., the customer or item table. This is helpful if you want to print information as a comment line on sales documents that is not available on the service item card, but is found in a related table. Alternatively, you can leave this column blank.
Table Name If you have not set up a table relation, this column is automatically filled with the Service Item value.
Field ID Select the field that you want to transfer as a comment line to sales documents.
Field Name This column is automatically filled with the value of the field ID.
Sales Select this checkbox so that the document data is correctly transferred to the sales document as a comment line.
Service Select this checkbox so that the document data is correctly transferred to the service document as a comment line.
Transfer Select this checkbox so that the document data is correctly transferred to the transfer document as a comment line.
Sequence Enter a number to define the order in which the lines are added to the document.
Description Optional You can enter a description for the comment line.
  • Repeat this process for any information you want to add as a comment line to a sales, service, or transfer document.

Your entries are saved automatically. You have successfully specified which service item category data should be displayed as a comment line in sales, service, or transfer documents. Once you add a service item of the respective service item category to a document, this information is also automatically added.

Tip

To update information, click Functions > Update Service Item Document Data in the menu bar of the Lines FastTab in the respective document, then confirm the dialog window with Yes.

Creating Service Item Subcategories

To create service item subcategories, proceed as follows:

  • Use the quick search (ALT+Q) to find the Service Items page.
  • Open an existing service item.
  • Navigate to the Attributes FastTab.
  • In the dropdown list of the Subcategory field, click Select from full list.
  • In the following window, click New in the menu bar.
  • Complete the columns according to the following table:
Column Description
Code Enter a code for the service item subcategory. The code can be freely selected.
Name Enter a name for the service item subcategory, e.g., Crawler Tractor.
Rent Class Select the default rent class for the service item subcategory. More information on rental can be found under Aptean Rental.
No. of Calc. Depreciation Months Enter the number of calculated depreciation months.
Tariff No. Enter the tariff number that is automatically assigned when service items are created using this subcategory.
  • Confirm your entries with OK.

You have successfully created a service item subcategory.