artifact management under scm in rtc(elms)mnmrvalm.mahindra.com/rational/artifact management...
TRANSCRIPT
1
Artifact Management under SCM in
RTC(eLMS)
For E&E and Relevant users only
Released on 27th Sep 2017
2
Strictly Confidential document. All Rights Reserved to Mahindra & Mahindra also regarding distribution, exploitation, editing,
and reproduction as well as in the event of application for Industrial Property Rights.
Document Release History
Revision Date Author Version Summary Approver
V1.0.0 27-Sep-2017 Pankaj Kumar Initial Version
3
Contents
1. INTRODUCTION ................................................................................................................................................................................................................................................................................................ 4
2. MAPPING RTC (ELMS) PROJECT WITH STREAM IN SCM .......................................................................................................................................................................................................................... 4
3. MAPPING SYSTEMS (ECU) WITH COMPONENT IN SCM........................................................................................................................................................................................................................... 5
4. ARTIFACT MANAGEMENT AT FOLDER LEVEL ............................................................................................................................................................................................................................................. 6
5. STEPS TO USE ELMS ARTIFACT MANAGEMENT (SCM) PROJECT............................................................................................................................................................................................................ 7
6. HOW TO CREATE FOLDER ............................................................................................................................................................................................................................................................................. 12
7. HOW TO CHECK-IN ......................................................................................................................................................................................................................................................................................... 13
8. HOW TO CHECK-OUT (DOWNLOAD) .......................................................................................................................................................................................................................................................... 16
9. HOW TO MODIFY EXISTING FILE. ................................................................................................................................................................................................................................................................ 17
10. REUSABILITY OF ARTIFACTS..................................................................................................................................................................................................................................................................... 20
11. ARTIFACT SHARING TO DIFFERENT PROJECT ....................................................................................................................................................................................................................................... 22
12. HOW TO CREATE BASELINE...................................................................................................................................................................................................................................................................... 27
13. ROLES AND PERMISSIONS........................................................................................................................................................................................................................................................................ 28
14. END USERS SCOPE - ROLE SPECIFIC TRAINING .................................................................................................................................................................................................................................... 29
15. NAMING CONVENTIONS .......................................................................................................................................................................................................................................................................... 29
4
`
1. Introduction
This document is created to train the end users for managing their artifacts in SCM under separate Project eLMS Artifact Management (SCM) on
RTC (eLMS).
2. Mapping RTC (eLMS) project with Stream in SCM
For each project, streams are created for managing the related artifact e.g. U321 stream will contain all the artifacts related to U321 project.
Separate Project Area for SCM in RTC (eLMS)
This Stream contains the related artifacts (Components) of particular
project e.g. U321
5
3. Mapping Systems (ECU) with Component in SCM For each System of project, individual components created e.g. U321_Airbag components will contain artifacts related to Airbag system of U321 project.
Component contains the related artifacts (Folder) of Airbag in U321.
6
4. Artifact Management at folder level External (Supplier): This folder is under U321_Airbag system so the member (internal and supplier) of Airbag system of U321 project can access the artifacts of this
Folder. M&M (Internal): This is accessible to only internal members of Airbag system of U321 project.
Artifacts can be accessed by Suppliers and internal member of particular system
Artifacts can be accessed only by internal members who are part of
particular System
7
5. Steps to use eLMS Artifact Management (SCM) project
1. Access the eLMS, once you will hit login page enter user id and password and click on Submit.
Enter User ID
Enter Password
Click on Submit Button
8
2. Select the eLMS Artifact Management (SCM) project area.
Click on Drop down button
Click on eLMS Artifact Management
Project Area
9
3. Now click on Source Control drop down option and then select Welcome to Source Control option.
4. Now click on Browse Stream.
Click on Browse
Stream Option
Click on Welcome to Source Control option
Click on Source Control Drop down
button
10
5. Now select the appropriate project area.
6. Select the appropriate System
Click on Appropriate Project area
Click on Appropriate System
11
7. Click on External(Supplier) Folder
8. Now Inside External (Supplier) folder user can create the folders and upload the files.
Click on External
(Supplier) Folder
12
6. How to Create Folder Note: Folders are allowed to create inside External (Supplier) or M&M (internal) only.
Follow below 3 steps for creating folder.
Type Folder name
Click on folder icon
1
2
3
Click On Save
13
Note: Before check-in file workitem (System Release Management or Defect) should be created on respective project area, so same workitem can be
Associate while checkin file.
7. How to Check-In Note: These Steps (1 to 10) needs to perform while uploading the file first time. If file already exist and you want to do some changes then follow heading 9(How to
Modify existing file). For Check-in (adding) files navigate to location where want to do checkin file and follow below steps from 1 to 10 sequentially.
Click on add file icon
Browse file from local
2
1
4 Click here to associate workitem
3 Type some description related to uploaded file if required
14
Select Project area e.g. U321
Select Workitem e.g. System Release management
Click on OK Workitem
Select Appropriate workitem
Enter Workitem ID
5
6
8
7
9
15
Click on Save 10
16
8. How to check-out (Download) For check-out navigate to file location and follow steps 1 to 3.
Click on download
icon
Select save File
Click On Ok 3
1
2
17
9. How to modify existing file. For Check-in (adding) files navigate to location where want to do checkin file and follow below steps from 1 to 9 sequentially.
Click on upload
file icon
1
Click on Ok
button 2
18
Browse file from local
3
5Click here to associate workitem
Type some description related to uploaded file if required 4
19
Select Project area e.g. U321
Select Workitem e.g. System Release management
Click on OK Workitem
Select Appropriate workitem
Enter Workitem ID
5
6
8
7
9
20
10. Reusability of artifacts Click on Links tab of workitem then click on link drop down and select Add Related Artifacts.
Paste URI Copied from eLMS Artifact management project area
Click on Links Drop Down
Click on Add Related Artifacts
21
Then copy the URI of the existing file in eLMS Artifact Management (SCM) Project Area. And Paste in URI section and Give level as file name.
Click on ok. So it will create a link once and when user will click on this link it will redirect to file location there user can download the file.
Paste URI Copied from eLMS Artifact management project area
Type Level name
Click On OK Button
22
Pre-requisites: RTC eclipse client must be installed. Note: Artifact (Component or Baseline) sharing can be performed only in eclipse client. So for sharing artifact steps are given bel ow.
11. Artifact sharing to different project Click on Start window icon and then type IBM on search bar and then follow below step from 1 to 28:
Click here
Select Workspace from local
Click Ok
1
2
3
23
Click here
+
Select Workitem Perspective Click OK
+
Click on Create
Repository Connection
4
6
5
7
24
+
+
+
+
Enter Following
Repository URL
Enter Userid
Enter
Password
Click Finish
+
+
Click here
Click Finish
Click for Expand
+
+
Select project area
Click finish
12
8
14
13
11
10
9
16
15
25
+
+
+
+
Click on Add
Click Open
Click on Expand icon
Select the project (Stream) Where artifact
want to share
Click on Expand
icon
19
18
20
17
21
26
Select component Baseline
Click Next
+
Put * for search all system
Select System which artifact want to share
Click Next
Select component Baseline
Click finish
25
24
23
22
26
28
27
27
Pre-requisites: RTC eclipse client must be installed.
Note: Baseline can be created on eclipse client, steps are given below.
12. How to Create Baseline
For creating the baseline select the particular System (component) which user need to baseline e.g. U321_ABS. follow steps 1 to 7.
+ +
+
Click on Baseline
Navigate cursor on new
Click on Expand icon
Right Click
Click on Expand
icon
+
+
Enter Baseline Name
Click ok
1
3
2
6
5
4
7
28
13. Roles and Permissions
Role Role description
admin Administrator
SL System Lead
SE System Engineer
TL Test Lead
TE Test Engineer
Role CREATE CREATE CREATE CHECKIN(Add) CHECKOUT(DOWNLOAD)
BASELINE STREAM COMPONENT FOLDER FILES FILES
Admin
SL
SE
TL
TE
SUPPLIER
29
14. End Users scope - Role Specific Training
SL, SE, TL, TE Login: Create Folder. Checkin and Checkout Files.
Associate workitem while checkin file. Create Baseline. Artifact sharing across project (Stream).
Access of both External(Supplier) and M&M (internal) folders.
Supplier: Create Folder. Checkin and Checkout Files.
Associate workitem while checkin file. Create Baseline. Artifact sharing across project (Stream).
Access of only External (Supplier) folder.
15. Naming Conventions
Activity Example Naming Convention
Folder Provide same name as in System Release management workitem e.g. Functional Specification (SRD/CRS)
Baselines Projectname_Systemname_datestamp e.g.: U321_Airbag_31th August