Asset Configuration Note: Difference between revisions

From RangerMSP Wiki - PSA software for MSPs and IT services providers
Jump to navigation Jump to search
Line 15: Line 15:
[[File:Asset_config_note_overview.gif]]
[[File:Asset_config_note_overview.gif]]


=When to use Asset Configuration Note?=
=When to use the Asset Configuration Note?=
Use Configuration Note when you want to keep data in predefined separate fields without creating custom fields for each one.
Use Configuration Note when you want to keep data in predefined separate fields without creating custom fields for each one.


Line 39: Line 39:


On the other hand, when using Custom Fields, you can use various field types, including numeric fields, and use them later on in reports, in report calculations, etc. Each Custom field is new field in the database, as opposed to the Configuration Note which is a single field for all the data stored in it.
On the other hand, when using Custom Fields, you can use various field types, including numeric fields, and use them later on in reports, in report calculations, etc. Each Custom field is new field in the database, as opposed to the Configuration Note which is a single field for all the data stored in it.


=Using Asset Configuration Note=
=Using Asset Configuration Note=

Revision as of 11:37, 9 June 2011

<under construction for CommitCRM version 5.6 BETA>

Introduction

The Asset Configuration Note provides an easy way to define a customized data entry for an Asset. The Configuration Note is a structured field, which provides an easy way to enter data which is displayed as separate fields and gives a convenient view of the details.

The purpose of the Configuration Note is to keep Asset configuration details, depending on the Asset type. You can define various templates which hold different data according to the Asset type, and use the templates to conveniently enter the configuration details.

Each Asset can hold multiple notes, allowing you to enter various types of data for the Asset.

What is the Asset Configuration Note?

A Configuration Note is a set of separate data entries (fields), with a label and a value per entry, and the content of all entries is stored as a single Memo database field.

Each Configuration Note can hold several sections, and each section can contain a set of predefined entries, which can be loaded from a template. This way, you can define various note types (e.g. a different note per Asset Type), and easily enter the data via a friendly data-entry window.

When to use the Asset Configuration Note?

Use Configuration Note when you want to keep data in predefined separate fields without creating custom fields for each one.

For example, for a PC Asset you may want to keep the following information:

  • CPU
  • OS
  • MEMORY
  • HD
  • CHIPSET
  • GRAPHIC-ADAPTER
  • NETWORK-ADAPTER
  • And more…

Users have several options for keeping this kind of information:

  1. Simple Note: you can simply write all these details in the Asset's simple Note field; however, this requires you to remember what to write each time.
  2. Custom Fields: your other option is defining custom tabs and fields; however, this information varies between different asset types (PC, Server, Printer, etc.) which may result in multiple Tabs and Custom fields per type. This can work great, however it requires advanced implementation and a lot of work.. . See more details in Custom Fields.
  3. Structured Notes: you can use this easy-to-use structured data to keep your information arranged in separate fields. Using the Configuration Note field, you can easily insert predefined structured data, whether you load it from templates or define it on-the-fly, and update the data values as needed.


A word about Configuration Note vs. Custom Fields
The Configuration Note is textual by nature. It allows you to organize the data as separate “fields” in the display and to easily enter the data, however, the information is kept in the database as a single text field.

On the other hand, when using Custom Fields, you can use various field types, including numeric fields, and use them later on in reports, in report calculations, etc. Each Custom field is new field in the database, as opposed to the Configuration Note which is a single field for all the data stored in it.

Using Asset Configuration Note

The Configuration Note is added and modified via the Preview Tab of an entity or via the Asset's Configuration Note tab.

Each Note can contain multiple sections, each section with its own set of data entries. The sections can be moved up or down within the note, allowing you to arrange the data to your convenience.

Sections can be added manually, or from a template.

Add New Section

To add a new section to the Note, click Add Configuration Note Section.

The following window opens:

<SCREENSHOT>

In this window you can add section header, new field entries (manually or from a template) and edit the values. See Add Entries.

Add Entries

Adding new entries to a section is done from the Configuration Note Section window.

Note: To add from a template, click the arrow near the menu option and choose the template you want to use. See more details in Configuration Note Templates.

To add new entries, click Add New Data Entries, or Switch to Setup Mode.

<SCREENSHOT> - Setup window

Each data entry can be of type:

  • Text
  • Memo (Multi-line Text)
  • Values Selection List

Text The Text field contains text in a single line.

Memo To enter multiple lines text, use the Memo field. This allows you to enter any length of data and cut it into lines.

Values List The Values Selection List allows you to use any existing values list from CommitCRM, or add a new list of values for your convenience. The list values can be edited at any time by selecting [Edit List...] from the list pull-down menu.

Note: Entries can contain characters or numbers; however, numbers entered into Structured Notes entries are saved as text, and cannot be used for calculations in the application or in reports. To use numeric fields for future calculations, see Custom Fields.

After adding the entries, click Ok to close the window. Save the Asset to keep changes done to the Configuration Note.

Change Sections Order

To change sections order, click the arrows at the Preview or Configuration Note tab. SCREENSHOT.

Save the Asset to keep changes done to the Configuration Note.

Remove Section

To remove a section from the Configuration Note, click Edit to enter the Configuration Note Section Window, and click Delete.

Save the Asset to keep changes done to the Configuration Note.

Configuration Note Templates

Configuration Note Templates allow you to define a set of predefined entries, with labels and values, which can be easily added as a section to the asset. For example, you can define a template holding configuration fields per Asset Type, and use the template for each asset you create, according to its type.

Create Template

Creating templates can be done from several places:

  1. From the Settings menu > Assets > Configuration Note Templates > New.
  2. From the entity’s Preview Tab or Configuration Note Tab, click the arrow next to the “Add Configration Note Section” option and choose Edit Template.
  3. While adding a new section, click Save As Template.

Editing the template is the same as adding a new Configuration Note Section, and the entries and values are saved and loaded later on when loading the template. The template can be edited at any time from the main Settings menu or from preview tab.

Using Templates

Entries and their values can be loaded from a template and added to a section either from the main Preview tab, or while editing the Configuration Note Section.

<SCREENSHOT> - from Preview.

Entries which are added from a Template are always appended to the section at its end. The entries order can be changed by editing the section and going to Setup mode using arrows “move up/down”.

<SCREENSHOT> - from edit window.

Searching Within Configuration Note

The values entered in the entries can be searched using a powerful text search.

You can search both for the entry labels and the values. For example, you can search for the label “CPU” and value “i3".

Learn more about the powerful free-text search capabilities here.

Web interface

Configuration Note is available in read-only mode when using the Web interface. All details can be viewed, however, updates can be made only when using the Client application.

Customer Web Users Customer Web Users who are allowed to view their Asset details, can also be allowed to view the configuration note. To allow customers to see the configuration note, make sure the customer’s group privileges include the relevant privilege:


<SCREENSHOT>

See more details in Customer Web User Privileges.