• Documentation
• Managing Asset Alter Submissions

Managing Asset Alter Submissions

EnOS Onboarding Tool supports secondary confirmation for specified asset changes. After the system administrator specifies the asset type and reviewer, the asset manager creates or updates the asset type in the access tool and needs to submit a change request. After the request is approved, the change takes effect.

Operation Process

The asset change process is as follows:

1. The submitter creates or updates the asset in the Site Onboarding. If it is not a specified type of asset, the change will take effect immediately. If it is a specified type of asset, a change request must be submitted.
2. After submitting the changes, the submission begins to be processed, and the asset status will be updated to Processing, which does not support editing.
3. The submitter can withdraw the submission in Asset Alter List > My submission. After withdrawal, the asset change will not take effect, and the asset status will be updated to Withdrawn. The process ends and the asset can be edited and submitted again.
4. The reviewer approves or rejects the submission in Asset Alter List > Review Submissions. If rejected, the asset status will be updated to Rejected, and can be edited and submitted again.
5. After the submission is approved, the change will be executed automatically. During the execution, the asset cannot be edited. The asset status will be updated to Processed.
6. After the change is successfully executed, the change will take effect and the submission will be automatically closed. The asset status will be updated to Closed, and the process will end.
7. If the change execution fails, the asset status will be updated to Error. The reviewer can choose Retry to re-execute the change. The submitter or reviewer can directly close the submission, and the asset status will be updated to Closed, and the process will end.

Prerequisites

• Ensure that the review restriction of the asset types have been enabled. Contact the system administrator if necessary.
• Ensure that the changes of the assets have been submitted in Site Onboarding page. For more information, see Onboarding Sites and Devices.

Note

When changing assets in the following ways, the changes will take effect directly, and submitting changes is not currently supported: - Off-site custom type assets changed, such as custom type assets created in the Topology menu page. - Sites created or updated through Single Import, Batch Import or Import by Grouping. - Devices and components created through import.

Managing My Submissions

After creating or updating a specified type site or its internal devices, components and custom type assets in the Site Onboarding, you can follow the steps below to view and manage the submissions.

1. Select Asset Alter List in the left navigation bar to enter the My Submissions tab.
2. View and manage the submissions of the current account in the My Submissions list. The list includes the following contents.

Content	Description
Submission ID	A unique number corresponding to each submission in the environment. When the submission is edited and submitted again, the ID will be updated.
Submission Type	New: The change is a new asset of a specified type. Update: The change is an update to an existing asset of a specified type.
Changed By	Single Operation: Create or update a site, device, component, or custom type asset on the page. Batch Operation: Batch update devices or components by importing files.
Changed Asset Type	What type of asset is created or updated.
Belonged Site	The site where the created or updated asset is located. Select the filter to filter the sites: Existing: Displayed as Site Name(asset ID). Created sites include two types, one of which is the current change occurring in an existing site, including site updates and asset creation and updates in the site. The other is that the current change is to create a site on the page, and the change has been completed, at which time the status is Closed. To be Created: When the change is to create a site on the page and the change is not completed, the site name will appear in the list of sites to be created. Note: If the belonged site is deleted after the change is submitted, the site name will be displayed as - - and cannot be filtered to the site.
Status	Processing: The change draft enters the processing process, but is not approved/rejected. You can select Withdraw to withdraw the submission. Withdrawn: The change draft is withdrawn by the submitter before approval/rejection, and the withdrawn submission will not appear in the Review Submissions list. Select Edit to edit the asset and submit the changes again. Rejected: The reviewer rejected the submission. Select the Rejection Reason in the status column to view the rejection reason returned by the reviewer. Select the corresponding Edit on the right side of the list to edit the asset and submit the changes again. Processed: The change draft has been approved and the change is being executed. Error: An error occurred during the execution of the change. Select Download Error Log to download and view the cause of the error. Select Close on the right side of the list to close the submission and end the process. Closed: The change has been completed and the submission is automatically closed. Or an error occurred during the execution process and was closed by the submitter or reviewer. After closing, the submission process ends.
Submitted On	The submission time of the current changes.
Last Updated On	The time of the last operation by the submitter or reviewer on the submission.
Reviewed By	The reviewer who has the authority to approve/reject the submission. If there are multiple reviewers, only one reviewer needs to approve the submission for it to be executed. If the submission status is Withdrawn, the asset has not been submitted and no reviewer has been assigned. If you need to change the reviewer for a certain type of asset, contact the system administrator.
Reviewed On	The time when the submission was approved/rejected. If the submission status is Processing or Withdrawn, there is no review time.

Select Download Change Record to download and view the change details of the submission.

• Single Operation: Select Download Change Record to download the detail file.
• Batch Operation: Select Generate Change Record to generate the detail file. After the file is successfully generated, a small red dot will appear next to the button, and the file can be downloaded by selecting again.

Approving or Rejecting Submissions

After the submitter submits the changes, the reviewer has the right to approve or reject the site within the asset authority range.

Note

The scope of change that the reviewer can process includes: - Sites pending creation, i.e. the submission type is New and the asset change type belongs to any site type asset change.

• If the current OU has NOT enabled the Asset Permissions restriction in EnOS Application Portal for asset changes, the scope of reviewing by the reviewer will be determined by the site type assigned to his User Groups, and the reviewer can review all sites of this type and the asset changes within it. If you need to update the site type corresponding to your user groups, contact the system administrator.
• If the current OU has enabled the Asset Permissions restriction in EnOS Application Portal for asset changes, the reviewer can only review the asset changes of the site and its internal assets within the asset permission scope. If you need to update the asset permission scope of the current account, contact the application administrator.

Follow the steps below to view and manage the submissions within the permission scope:

1. Select Asset Alter List from the left navigation bar and select Review Submissions tab.
2. View and manage the submissions of the current account in the Review Submissions list. The list includes the following contents.

Content	Description
Records	Select Details to download and view the details of the submission.
Submission ID	A unique number corresponding to each submission in the environment. When the submission is edited and submitted again, the ID will be updated.
Submission Type	New: The change is a new asset of a specified type. Update: The change is an update to an existing asset of a specified type.
Changed By	Single Operation: Create or update a site, device, component, or custom type asset on the page. Batch Operation: Batch update devices or components by importing files.
Changed Asset Type	What type of asset is created or updated.
Belonged Site	The site where the created or updated asset is located. Select the filter to filter the sites: Existing: Displayed as Site Name(asset ID). Created sites include two types, one of which is the current change occurring in an existing site, including site updates and asset creation and updates in the site. The other is that the current change is to create a site on the page, and the change has been completed, at which time the status is Closed. To be Created: When the change is to create a site on the page and the change is not completed, the site name will appear in the list of sites to be created. Note: If the belonged site is deleted, the site name will be displayed as - - and cannot be filtered to the site. The submission status will be updated to Error if you Approve or Reject a submission with - - in its belonged site.
Status	Processing: The change draft enters the processing flow, and the corresponding Approve or Reject can be selected on the right side of the list to process the submission. Or after selecting the checkboxes in the leftmost column, select Approve or Reject in the upper left corner of the list for batch operations. Rejected: The change submission has been rejected by the reviewer. Select Reject Reason to view the reject reason returned by the reviewer. Processed: The change draft has been approved and the change has been executed. Error: An error occurred during the execution of the change draft. Select Download Error Log to download and view the error cause. In the right side of the list, select the corresponding Retry or Close to re-execute the change or end the process. Closed: The change has been executed and the submission is automatically closed. Or an error occurs during the execution, and the submitter or reviewer closes the submission. After closing, the submission process ends.
Submitted By	The submitter who submits the changes.
Submitted On	The submission time of the current changes.
Last Updated On	The time of the last operation by the submitter or reviewer on the submission.
Reviewed On	The time when the submission was approved/rejected. If the submission status is Processing, there is no review time.

Viewing All Submissions

Users with the permission to view all submissions can enter the All Submissions tab to view all asset change submissions within the current OU in the past 3 months. To get this permission, please contact the system administrator.

1. Select Asset Alter List in the left navigation bar and enter the All Submissions tab.
2. In the list, view all submissions of the current OU, including Processing, Processed, Closed, Withdrawn, Rejected and Error submissions.
3. Select Download Change Record to download and view the detailed record of the corresponding submission.
   • Page Operation: Select Download Change Record to directly download the file.
   • Batch Operation: After selecting Generate Change Record , the file will start to generate. After the file is successfully generated, a small red dot will appear next to the button. Select again to download the file.

Exporting Submissions

You can export all or part of the submissions in Review Permissions or All Submissions tab by one click.

Note

• Users with asset change reviewing permissions can enter the Review Permissions tab. Contact the system administrator to get this permission.
• Users with permission to view all submissions can enter the All Submissions tab to export all submissions within the current OU in the past 3 months. Contact the system administrator to get this permission.

1. Select Asset Change List from the left navigation bar.
2. Enter the Review Permissions or All Submissions tab.
3. Select Export in the upper right corner of the list to export submissions in the list. If you need to export some part of the list, you can query or filter and then select Export.
4. After the export is successful, select Download File to download the exported file to local.

If failed, you can select Download Error Log to check the cause of the error.