You are viewing an old version of this page. View the current version.
Compare with Current View Page History
« Previous Version 31 Next »
This server-side class is necessary for using SimpleOne version control system (VCS).
SimpleVcs()
Instantiates a new empty SimpleVcs class object.
Example:
const vcs = new SimpleVcs();
createTableSnapshot(tableName)
This method creates initial versions of all the records of the specified table.
Parameter(s):
| Name | Type | Mandatory | Default Value |
|---|---|---|---|
| tableName | String | Y | N |
Return:
| Type | Description |
|---|---|
| Boolean | This method returns TRUE if the snapshot was successful; otherwise, it returns FALSE. |
Example:
const tableName = 'sys_script'; const vcs = new SimpleVcs(); const versionCount = vcs.createTableSnapshot(tableName); ss.info(versionCount);
exportLocalPackVcsRecords(sysVcsLocalPackId)
This method performs VCS records export that were bound to the configuration pack with the unique ID as a .SOP file. This pack must be in the Completed state.
Parameter(s):
| Name | Type | Mandatory | Default Value |
|---|---|---|---|
| sysVcsLocalPackId | Integer | Y | N |
Return:
| Type | Description |
|---|---|
| Object | Returns a .SOP file for downloading. |
Example:
const vcsLocalPackId = '156144163704236641'; const vcs = new SimpleVcs(); vcs.exportLocalPackVcsRecords(vcsRetrievedPackId);
importRetrievedPack(retrievedPackId)
This method imports the last containing in the VCS preview log (sys_vcs_preview_log)table previewed retrieved pack to the VCS Record (sys_vcs_record) table.
Parameter(s):
| Name | Type | Mandatory | Default Value |
|---|---|---|---|
| retrievedPackId | Integer | Y | N |
Return:
| Type | Description |
|---|---|
| String | Returns string containing the import results. |
Example:
const vcsRetrievedPackId = '156144163704236641'; const vcs = new SimpleVcs(); const result = vcs.importRetrievedPack(vcsRetrievedPackId); ss.addInfoMessage(result);
isLocalPackHasReferences(localPackId)
This method checks the record from the sys_vcs_local_pack table if it has referenced current* records from the sys_vcs_record table.
*the current records have the is_current attribute equal to TRUE.
Parameter(s):
| Name | Type | Mandatory | Default Value |
|---|---|---|---|
| localPackId | Integer | Y | N |
Return:
| Type | Description |
|---|---|
| Boolean | The method returns TRUE if it finds records of such kind; otherwise, it returns FALSE. |
Example:
const vcsLocalPackId = '156144163704236641';
const vcs = new SimpleVcs();
if (vcs.isLocalPackHasReferences(vcsLocalPackId)) {
ss.addInfoMessage('Local Pack has current VCS records');
}
isRetrievedPackHasReferences(retrievedPackId)
This method checks the record from the sys_vcs_retrieved_pack table if it has referenced records from the sys_vcs_record table.
Parameter(s):
| Name | Type | Mandatory | Default Value |
|---|---|---|---|
| retrievedPackId | Integer | Y | N |
Return:
| Type | Description |
|---|---|
| Boolean | This method returns TRUE if there are any referenced records; otherwise, it returns FALSE. |
Example:
const vcsRetrievedPackId = '156144163704236641';
const vcs = new SimpleVcs();
if (vcs.isRetrievedPackHasReferences(vcsRetrievedPackId)) {
ss.addInfoMessage('Retrieved Pack has current VCS records');
}
isRetrievedPackHasAttache(vcsRetrievedPackId)
This method has been deprecated since version 1.2 and no longer supported. Please use the hasAttachment() method instead.
loadDataFromAttachment(sysVcsRetrievedPackId)
This method loads configuration pack data from attachment provided to the Retrieved Records (sys_vcs_retrieved_record) table for the preview purposes.
| Name | Type | Parameter | Default Value |
|---|---|---|---|
| sysVcsRetrievedPackId | Integer | Y | N |
Return:
| Type | Description |
|---|---|
| Boolean | This method returns TRUE if data loading was successful; otherwise, it returns FALSE. |
Example:
const vcs = new SimpleVcs();
const message = new SimpleMessage();
if (!vcs.loadDataFromAttachment(current.sys_id)) {
ss.addErrorMessage('Error loading data');
return;
}
ss.setRedirect();
mergeLocalPacks(rowIds, name, description)
This method implements merging multiple localpacks into one. Herewith, initial localpack are being removed irrevocably.
Parameter(s):
| Name | Type | Mandatory | Default Value |
|---|---|---|---|
| rowIds | Array | Y | N |
| name | String | N | 'merged pack' |
| description | String | N | N |
Return:
| Type | Description |
|---|---|
| String | Returns ID of the resulting merged localpack if successful; otherwise, returns NULL. |
Example:
const vcsLocalPackId = [
'157666651911972694',
'157665759017038346',
'157665742419415102'
];
const mergedName = 'Merged Pack 1';
const mergedDesc = 'Merged Pack description 1';
const vcs = new SimpleVcs();
const mergedId = vcs.mergeLocalPacks(vcsLocalPackId, mergedName, mergedDesc);
if (mergedId != null) {
ss.info('Merged Local Pack has Id ' + mergedId);
} else {
ss.info('Houston we have a problem with merging Packs');
}
moveVcsRecordsToDefault(versionIds)
This method allows bulk moving VCS records to the default local pack.
Parameter(s):
Name | Type | Mandatory | Default Value |
|---|---|---|---|
| versionIds | Array | Y | N |
Return:
Type | Description |
|---|---|
| Boolean | This method returns 'true' if moving was successful; otherwise, it returns 'false'. |
const vcs = new SimpleVcs(); const result = vcs.moveVcsRecordsToDefault([current.sys_id]); ss.info(result);
preview(sysVcsRetrievedPackId)
This method extracts records related to the configuration from the Retrieved Records (sys_vcs_retrieved_record) table and performs a pack preview.
Parameter(s):
| Name | Type | Mandatory | Default Value |
|---|---|---|---|
| retrievedPackId | Integer | Y | N |
Return:
| Type | Description |
|---|---|
| Boolean | This method returns TRUE if preview was successful; otherwise, it returns FALSE. |
Example:
const vcs = new SimpleVcs();
const message = new SimpleMessage();
if (!vcs.preview(current.sys_id)) {
const localizedMessage = message.getMessage('Error previewing data');
ss.addErrorMessage(localizedMessage);
return;
}
ss.setRedirect();
rollback(packId)
This method rollbacks a localpack. The localpack can be rollbacked only when it in the RollBack-Previewed state.
Parameter(s):
| Name | Type | Mandatory | Default Value |
|---|---|---|---|
| packId | Integer | Y | N |
Return:
| Type | Description |
|---|---|
| String | Returns TRUE if rollback was successful; otherwise; throws an exception. |
Example:
const vcsLocalPackId = '156144163704236641';
const vcs = new SimpleVcs();
if (vcs.rollBack(vcsLocalPackId)) {
ss.addInfoMessage('RollBack of Local Pack was successful');
}
rollBackPreview(packId)
Parameter(s):
| Name | Type | Mandatory | Default Value |
|---|---|---|---|
| packId | Integer | Y | N |
Return:
| Type | Description |
|---|---|
| Boolean | Returns TRUE if the rollback preview was successful; otherwise, returns FALSE. |
Example:
const vcsLocalPackId = '156144163704236641';
const vcs = new SimpleVcs();
if (vcs.rollBackPreview(vcsLocalPackId)) {
ss.addInfoMessage('RollBack preview of Local Pack was successful');
}
- No labels
