Page History

Local pack is a record in the VCS Local Pack (sys_vcs_local_pack) table compiling relevant records from the VCS Record (sys_vcs_record) table. It allows associating VCS records with a particular pack and exporting them as a complete set.Local packs allow developing application configurations on a separate instance, exporting it as a .SOP file, and implementing it to another instance.

See the Configuration Packs article to the main instance. This approach allows minimizing risks of mistakes, error and conflicts, which may affect the main instance during application development.

All system configuration activities should be performed within a separate local pack. Do not use a default local pack for these needs.

learn more.

For configuration pack export, the following elements are used:

• Local Pack – compiles all relevant VCS records so that they are linked as a complete set. Then these records can be implemented as one configuration pack in another instance. In other words, local pack collects references to records that will be changed, inserted, or deleted on the target instance.
• VCS Record – contains the version of a record.
• .SOP file – physical file in the .SOP format. It contains all record versions from the completed local pack. Implement it on any other SimpleOne instance.

Assembling a local pack

Local pack configuration and export includes the following important stages:

1. Configuring VCS records in a local pack:
   • restoring records (optional)
   • moving records (optional)
2. Merging several local packs (optional).
3. Exporting a .SOP file.

Local pack is a record in the VCS Local Pack (sys_vcs_local_pack) table containing versions of instance records from the VCS Record (sys_vcs_record) table. Every single version is an atomic state of versioned tables (those ones which have the Is VCS Enabled checkbox selected). All record versions in the local pack are displayed in the Related Lists area.

Image Removed

Team Development

In SimpleOne, developers can work on their task separately you can export separate local packs and upload them one by one. Another option is to work as a team on one task. For this, developers should do their part of work in separate local packs and then combine the results into team's final configuration pack. You can see the process in the scheme below:

Image Removed

Image Added

Briefly

, in order to facilitate the team development process, you need to perform the following steps:

1. Every team member creates a separate local pack and works within it collecting necessary records. The results go into

1. separate local

1. packs.
2. When

1. assembling is over, these local packs must be merged into the

1. final one.

Create a local pack 

Anchor
create a local pack create a local pack

To create a local pack, please complete the steps below:

1. Navigate to Configuration → Local Packs.
2. Click New and fill in the fields.
3. There are two ways to apply changes and continue assembling a local pack:
   • Click Save. Then click Set current to switch the local pack in the Admin Preferences menu and start working on it.
   • Click Set current and Save to switch the local pack in the Admin Preferences menu, apply changes and start working on it
   Click Save or Save and Exit to apply changes
   • .

VCS Local Pack form fields

Managing VCS records

Configure the set of record versions in the VCS Records related list to build the local pack you need. Restore and move records to collect only those you need.

Restoring a VCS record

If you need to restore one of previous record versions, you need to make it actual by clicking Restore Version. Actual records a are marked with the Is current checkbox selected. Thus, restoring is available only to the VCS records with the cleared Is Current checkbox.

To restore a record version, please complete the steps below:

1. Open the record you need.
2. Scroll down to the Related Lists area and open the VCS Records tab.
3. Open the record version you need to restore.
4. Click Restore Version.

Image Removed

After that, a new VCS record is created in the current local pack.

Removing a VCS record tip

Anchor

You can add a versions list to a versioned table form as a related list. After that, all previous versions of the current record are displayed on the record form.

remove a vcs record remove a vcs record

VCS records cannot be deleted; therefore, they are moved to the default local pack. If your local pack contains a VCS record that is created accidentally or belongs to another configuration pack, you can remove it from this local pack.

To move a VCS record

, perform the following steps:

1. Navigate to Configuration → Local Packs.
2. Open

1. the local pack containing the VCS record you need to

1. move.

Image Removed

1. Scroll down to the Related Lists area and open the VCS Record tab.
2. Select a record or records to be moved using the checkboxes and click Move to Default.
3. These records will be moved to the default local pack of the same application.

As a result:

• All selected record versions are moved to the default pack.
• All record versions with the same Record IDas the selected ones are moved to the default pack, too. That is, all previous and current versions of the same record are moved.

Changing local pack for a VCS record

Anchor
move a vcs record move a vcs record

If a version was

Moving a VCS record

If a version has been created in a wrong local pack by mistake (for example, in a default local the default local pack), then you can move it to the required local pack. For this, please complete the steps below:

1. Navigate to Configuration → VCS Records.
2. Find a record to recover. You can use list search or the Condition Builder.
3. Open the record you need.
4. Click the magnifier icon Image Removed Image Added by the Local Pack field and choose the desired local pack.
5. Click Save or Save and Exit to apply changes.

Local

const table = new SimpleRecord('sys_db_table');
table.addQuery('is_vcs_enabled', true);
table.addQuery('sys_id', '!=', '999999999999999998'); // exclude REM
table.selectAttributes('name');
table.query();
while (table.next()) {
  const vcs = new SimpleVcs();
  const versionCount = vcs.createTableSnapshot(table.name);
  if (versionCount > 0) {
    ss.info(`${table.name.padStart(80, " ")}: ${versionCount} versions created`);
  }
}