Develop > Tailoring > Links > Link maintenance > Fill functionality

Fill functionality

Using information in the link file, Fill (us.link) locates information in another record and copies it into the current record.

Fill does the following:

  • Starts on a source record.
  • Accesses a record in a secondary (target) file based on data in the source record (usually the contents of the input field selected by the cursor).
  • Copies (fills) data from that target record back to the source record.

The link record for the probsummary file is used in Incident Management.

In the following example, Fill populates fields in an incident document based on the value of the field labeled CI Name.

Rather than selecting the device record for display, fields in the device (TARGET) file that have the same name as the fields in the problem (SOURCE) file project into the source record.

Fields on the source form populate automatically with data directly from the applicable device record. For example, CI Name (logical.name) on the incident record fills with the value of Configuration Item (logical.name) from the device record. The Type field on the incident form fills with the value of Type from the device record, and the value for the Category field copies from the device record to the incident record.

Through this transfer, the TARGET record is unchanged but the SOURCE record modifies to reflect the values of fields in the TARGET record.

The resulting modified SOURCE record is not written to the database until some action instructs the system to do so. For example, open or update the incident.

The Fill option uses the value in the field where the cursor is positioned to determine which link relationship to use. This example assumes that the cursor is in the CI Name (logical.name) input field when you select the Fill option.

Use Fill when it is necessary to store information in the source record so that it can be changed or used as a link to other information. If you simply need to display the information in a form, use Virtual Join.

Related concepts

Link maintenance
Types of links
Find functionality
Virtual joining functionality
Us.link
Variables used in links
Calling us.link
Find from and Fill to a $ variable
Find from and Fill to an array structure