MCIX DataStage Import GitHub Action

Import DataStage NextGen assets into a target project using MCIX.

Namespace: datastage Action: import Usage: DataMigrators/mcix/datastage/import@v1

... where v1 is the version of the action you wish to use.

🚀 Usage

- uses: DataMigrators/mcix/datastage/import@v1
  with:
    api-key: ${{ secrets.MCIX_API_KEY }}
    url: https://your-mcix-server/api
    user: dm-automation
    assets: ./datastage/assets/MyFlow.json
    project: GitHub_CP4D_DevOps

🔧 Inputs

Name	Required	Description
api-key	Yes	MCIX API key
url	Yes	MCIX server URL
user	Yes	Logical MCIX user
assets	Yes	Asset file(s) to import
project	Conditional	Project name
project-id	Conditional	Project ID

📤 Outputs

Name	Description
return-code	Exit code

📚 More information

See https://nextgen.mettleci.io/mettleci-cli/datastage-namespace/#datastage-import

MCIX Datastage Import

Caution

This action is provided as a technology preview which may change, break, or disappear at any point and without warning.

Import assets into an IBM DataStage project on IBM Software Hub (Cloud Pak) using the MettleCI MCIX CLI

Namespace: datastage
Action: import
Usage: ${{ github.repository }}/datastage/import@v1

... where v1 is the version of the action you wish to use.

---

🚀 Usage

Minimal example:

jobs:
  datastage-import:
    runs-on: ubuntu-latest

    steps:
      - name: Checkout repository
        uses: actions/checkout@v6

      - name: Run MCIX Datastage Import
        id: datastage-import
        uses: ${{ github.repository }}/datastage/import@v1
        with:
          api-key: <required>
          url: <required>
          user: <required>
          # assets: <optional>
          # project: <optional>
          # project-id: <optional>
          # report: reports/import-report.xml
          # additional-args: <optional>

---

Project selection rules

• Provide exactly one of project or project-id.
• If both are supplied, the action should fail fast (ambiguous).

---

🔧 Inputs

Name	Required	Default	Description
api-key	✅		API key for authentication
url	✅		URL of the DataStage server
user	✅		Username for authentication
assets	❌		Path to the DataStage assets to import
project	❌		DataStage project name
project-id	❌		DataStage project id
report	❌	reports/import-report.xml	Path to output the import report
additional-args	❌		Additional raw arguments to append to the mcix command

---

📤 Outputs

Name	Description
return-code	The return code of the command

---

🧱 Implementation details

• runs.using: docker
• runs.image: Dockerfile

---

🧩 Notes

• The sections above are auto-generated from action.yml.
• To edit this documentation, update action.yml (name/description/inputs/outputs).