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
- Mapping Service Item Attributes to a Subcategory
- Adding Service Item Attributes to a Service Item
- Filtering Service Items by Attribute
- Creating Service Item Models
- Defining Default Attribute Values for the Service Item Model
- Service Item Categories
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.