Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Version Control is a feature within MettleCI to allow MettleCI enables you to check in your dataStage assets into Git repository.changed DataStage Repository-based assets (e.g. Jobs, Parameter Sets...) to a Git repository. Git check-in can be performed either via a combination of the DataStage Classic Designer client and MettleCI Workbench or directly in MettleCI Workbench. The former option - while involving two pieces of software - is the quickest as it avoids manually filling out Job information (e.g. which Project it is part of) each time you commit a change.

Step-by-step guide

Table of Contents
minLevel1

...

Access Version Control by clicking on "Version Control" from the sidebar of MettleCI

...

maxLevel6
include
outlinefalse
indent
styledecimal
excludeStep|Related
typelist
class
printabletrue

Integrate MettleCI Workbench with DataStage Designer Client

Follow the instruction in Getting Started with MettleCI Workbench to Integrate MettleCI Workbench with DataStage Client

Commit DataStage assets from the Designer Client

Once MettleCI Workbench and DataStage Client are integrated. You can start DataStage Client, and open a job.

With your job open on the DataStage canvas select the Tools → Custom → MettleCI - Commit Asset menu option.

Alternatively, you can go directly to Workbench and select your project (at the top of the screen) and selecting the Version Control men item from the sidebar, then click the [+] button on the top right hand corner to start code check-in

Image Removed

2. Version Control code check in page

You are required to enter the Assets (i.e. Datastage Job Name), and Commit Message.

Info
titleOptional

You can set the Unit Tests flag to on if you wish to check in the Unit Test asset associate with Datastage Job

Image Removed

3. Adding Jobs for code check in

Version Control allows you to check in multiple jobs at the same time, so you must use the mouse to click on the job name for it to register

Image Removed

4. Enter Commit Message

Enter the commit comments, and click "Check in" when ready

 Image Removed

5. View Error Log (if Job Fail)

If check in fail, you can review the root cause by expanding the VIEW LOGS button

Image Removed

6. View Log (if Job Success)

You can also view the log, if code check in completed successfully

Image Removed

7. Commit History

Return to Commit History by clicking on "Version Control" from the sidebar, you can now see the success/failure history of last code check in)

Image Removed

...

to take you to the Git Commit page.

...

Select Work Item to associate with your commit

The form you’re presented with captures all the information necessary to perform your Commit to Git:

...

DataStage Project: This is a read-only value telling you which DataStage project you’re using (and consequently which Git repository you’re committing to)

Asset(s): This is where you specify the DataStage assets you’re committing. If you invoked this page from the MettleCi DataStage Designer menu item then this field will already include the Job canvas which had focus when you selected the menu item. You can add more assets by typing their name then selecting them from the 'New selection' box which appears below (Important: Don’t forget this second step!). Even though you may specify multiple assets we generally recomment making a single commit per asset, to make tracking changes to individual assets clearer.

...

Include Unit Tests: When selected, this checkbox will include (where available) the Unit Test Specifications and Unit Test Data for all specified DataStage Job assets in the commit.

Work Item(s): Select one or more Work Items to link associate with your commit.

Commit your work

Commit Message: Enter a short comment describing your changes.

When the form is complete click Check in.

...

Monitor the log 

When check-in completes, regardless of Pass or Fail, you can see the status using the VIEW LOGS link at the bottom of the page.

...

Commit History

You can also review the Commit History by clicking on Version Control from the Workbench sidebar. You can now see the success or failure history of each check in performed since the MettleCI Workbench service was started.

...

Related articles

Filter by label (Content by label)
showLabelsfalse
max5
spacescom.atlassian.confluence.content.render.xhtml.model.resource.identifiers.SpaceResourceIdentifier@873786c5
showSpacefalse
sortmodified
typepage
reversetrue

...

labelsworkbench versioncontrol code repository check-in
cqllabel in ( "code" , "workbench" , "versioncontrol" , "repository" , "check-in" , "SCM" , "Git" ) and type = "page" and space = "MCIDOC"

...

Page Properties
hiddentrue

Related issues