Change Requests
Change requests are used to track change within a standard or study through a predefined workflow. You can define as many change request templates as you want, each with their own properties and lifecycle states. For example, change requests can be used to request that a standard or study is created, updated or approved by another ryze user. Your workflow can be as simple or as complex as required.
All users can be given Change Request user permissions. However, a user with a "Reader" subscription will not have access to the change management process.
Creating a Change Request
To create a change request:
- Do one of the following:
- Select Repository and select Change requests.
- Select Repository and open the standard or study that should contain the change request.
- Select Repository and open the standard or study that should contain the change request. Then select an asset to create the change request against and select the Change Requests tab.
- Select Create change request.
- Select the change request template from the drop down list then select Next.
- (Optional) You can enter a Title, Description and Due date.
- If the title is left empty, a unique title is automatically assigned.
- (Optional) You can select one or more of studies/standards/assets
- (Optional for asset change requests) You can enter an asset name or select Unknown asset if you do not know its name.
- Enter any mandatory fields that are set in the change request template.
- Select Create
- Once the change request is created, you can add an Assignee, edit properties, attach files, transition workflow states, and add comments.
- Assignees receive an email informing them of the request.
- For change requests with a due date, Assignees receive another reminder email on the due date.
Active Change Requests
Change requests that apply to a Standard or Study are displayed on the Standard/Study details page under Change requests.
Filtering change requests
You can select search criteria that narrows search results by adding filters. For example, that you could carry out a search for particular change request states that have been assigned to a particular user.
Available filters:
- ID - Enter the change request ID
- Description - Enter the description
- Due date - Select the due date range, to and from
- Custom property name - Enter the custom property name
- Custom property value - Enter the custom property value
- Created - Select the created date range, to and from
- Owner - Enter owner name
- Assignee - Enter assignee name
- State - Enter the workflow state . For example "accepted" or "rejected"
- Standard / study - Enter the standard / study name
- Standard / study asset - Enter the standard / study asset name
- Asset - Enter asset name
- Template context - Enter template context.
- Template - Enter name of change request template
- Comment - Enter comment or question
- Files - Enter file name
- Watchers - Enter watcher's name. You can enter more than one
- Completed versions - Enter the name of the standard or study, the asset name and the version number of the standard or study
Downloading summary
You can download a change requests summary in CSV format.
- Select columns to include and deselect columns to exclude.
- Select a Sort by option from the dropdown list to choose how you want results displayed on the summary CSV file.
- Select Download.
Changing request owner
Any user with access to change requests can change the owner of a change request.
To update the owner:
- Select Repository from the Navigation bar and select Change requests.
- Select the ID of the change request you want to edit.
- Select
- next to Owner and select a new owner for the change request.
- Select Assign.
You will receive an notification email if you become the owner of a change request.
Viewing and editing properties
You can view the history of change request and edit the properties.
To view the change request log:
- Select Repository from the Navigation bar and select Change requests.
- Select the ID of the change request you want to view the history of properties for.
- Select the plus icon next to Properties.
- Select the history icon to view the history. You can filter results, download a CSV report and change the table headings.
To edit properties:
- Select Repository from the Navigation bar and select Change requests.
- Select the ID of the change request you want to view the history of properties for.
- Select the plus icon next to Properties to expand the property area if needed.
- Select the properties icon to edit properties.
- (Optional) You can add or edit the Title, Description, Due date and Standard and/or Study. You can enter more than one container (standard / study) here.
- (optional) You can specify a version label for the container within the change request.
- Click Save.
If you set version labels for assets within change requests, you can search Change requests under Complete versions by Standard / Study, Asset and / or Version and select Apply.
Transitioning the workflow
You can transition the state of a change request to another state. Optionally, you can set approvers to approve transitions between states. Examples of states are draft, in progress, accepted and rejected. States and approvers are set during creation of a change request template, see Change requests for more information.
To transition a workflow:
- Select Repository from the Navigation bar and select Change requests.
- Select the ID of the change request you want to transition.
Select the plus icon next to Workflow.
- Select the State to transition to from the drop down list.
- Select Transition. If there are approvers see To set an approver for a transition:
To set an approver for a transition:
- Select Repository from the Navigation bar and select Change requests.
- Select the ID of the change request you want to transition.
- Select the plus icon next to Workflow.
- Select the down arrow to select an approvers name from the drop down list.
- Select Assign.
To approve a change request for transition:
- Select the plus icon to approve the change request.
You can only approve change request transitions that you are set as an approver for.
To remove a user as an approver from the workflow:
- Select the cross icon to remove a user as an approver.
Deleting change requests
To delete change requests:
- Select Repository from the Navigation bar and select Change requests.
- Select the ID of the change request you want to edit.
- Select the trash icon to delete the change request. You can see the delete icon at the top left hand side of the change request window.
- Select Ok.