{"id":25257246,"url":"https://github.com/zowe/explorer-uss","last_synced_at":"2025-08-24T14:14:59.277Z","repository":{"id":37470679,"uuid":"144592740","full_name":"zowe/explorer-uss","owner":"zowe","description":null,"archived":false,"fork":false,"pushed_at":"2024-10-30T10:27:50.000Z","size":2955,"stargazers_count":0,"open_issues_count":6,"forks_count":5,"subscribers_count":13,"default_branch":"v2.x/master","last_synced_at":"2024-10-30T11:29:26.629Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"JavaScript","has_issues":false,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"epl-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/zowe.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2018-08-13T14:40:17.000Z","updated_at":"2024-09-03T20:07:33.000Z","dependencies_parsed_at":"2024-03-21T13:44:46.429Z","dependency_job_id":"3990fb7f-dbee-4c6d-b892-4a8d6a96ed9c","html_url":"https://github.com/zowe/explorer-uss","commit_stats":null,"previous_names":[],"tags_count":45,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zowe%2Fexplorer-uss","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zowe%2Fexplorer-uss/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zowe%2Fexplorer-uss/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zowe%2Fexplorer-uss/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/zowe","download_url":"https://codeload.github.com/zowe/explorer-uss/tar.gz/refs/heads/v2.x/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":238423795,"owners_count":19469901,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-02-12T06:38:27.178Z","updated_at":"2025-02-12T06:38:28.030Z","avatar_url":"https://github.com/zowe.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# explorer-uss\n\n[![Quality Gate Status](https://sonarcloud.io/api/project_badges/measure?project=zowe_explorer-uss\u0026metric=alert_status)](https://sonarcloud.io/dashboard?id=zowe_explorer-uss)\n\nThe issues for the USS explorer are tracked under the Zowe Zlux repository, https://github.com/zowe/zlux and tagged accordingly with the 'explorer-uss' label. Open issues tagged with 'explorer-uss' can be found [here](https://github.com/zowe/zlux/issues?q=is%3Aopen+is%3Aissue+label%3Aexplorer-uss).\n\n\n# App Development Workflow \n\n### Install Dependencies\n\nAs following modules \n `explorer-ui-server`, `orion-editor-component` and `explorer-fvt-utilities` are published on Zowe Artifactory.\n `.npmrc` file is pre-configured with registry value of `https://zowe.jfrog.io/zowe/api/npm/npm-release`\n```\nnpm install\n```\n\n### Build for Development\n\nModify the host variable in WebContent/js/utilities/urlUtils.js to a host and port that has the Zowe Jobs API server available\n\n```\nnpm run dev \n```\n\nThen you can visit http://localhost:8080 to test.\nWhen testing you may see errors with API calls do to CORS (Cross origin resource sharing), to work around this you may disable CORS checking in your browser for local development. \n\n### Run unit tests\n\n```\nnpm run test\n```\n\n### Run fvt/selenium tests\n\nSee [README](/tests/FVTTests/README.md)\n\n### Build for Production\n\n```\nnpm run prod\n```\n\n### Prepare for commit (Run linting, tests and production build)\n```\nnpm run preCommit\n```\n\n### Prepare PAX Packaging Workspace\n\n```\n./.pax/prepare-workspace.sh\n```\n\n## Start With explorer-ui-server\n\nAfter preparing PAX workspace, you can serve the explorer UI with explorer-ui-server:\n\n```\nnode .pax/ascii/server/src/index.js --config .pax/ascii/server/configs/config.json\n```\n\n## Run SonarQube Code Analysis\n\nInstall [SonarQube Scanner](https://docs.sonarqube.org/display/SCAN/Analyzing+with+SonarQube+Scanner).\n\nIf you are using Mac, try install with [HomeBrew sonar-scanner formula](https://formulae.brew.sh/formula/sonar-scanner), then update the configuration of SonarQube server at `/usr/local/Cellar/sonar-scanner/\u003cversion\u003e/libexec/conf/sonar-scanner.properties`.\n\nExample scanner configurations:\n\n```\nsonar.host.url=https://jayne.zowe.org:9000\nsonar.login=\u003chash\u003e\n```\n\nThen you can run `sonar-scanner` to start code analysis.\n\nBuild pipeline has embedded the SonarQube code analysis stage.\n\n\n## Build and install as plugin in local zlux development environment\n\nModify `explorer-uss/Webcontent/index.html`   \nChange relative path for `iframe-adapter.js` \u0026 `logger.js` to absolute path.   \nAppend with your `API Gateway` `Hostname` and `Port`\n\nFor example:\n```\n  \u003cscript type=\"text/javascript\" src=\"https://mymainframe.com:7554/zlux/ui/v1/lib/org.zowe.zlux.logger/0.9.0/logger.js\"\u003e\u003c/script\u003e\n  \u003cscript type=\"text/javascript\" src=\"https://mymainframe.com:7554/zlux/ui/v1/ZLUX/plugins/org.zowe.zlux.bootstrap/web/iframe-adapter.js\"\u003e\u003c/script\u003e\n```\n\nBuild web folder\n```\ncd explorer-uss\n# root folder\nnpm install\n# This will create web folder\nnpm run build\n```\n\nInstall as ZLUX App/Plugin\n```\n# install in zlux locally\ncd zlux/zlux-app-server/bin\n./install-app.sh \u003cpath-to-explorer-uss\u003e\n```\n`explorer-uss` root already have sample `pluginDefinition.json` \u0026 will have `web` folder after `build`.\n\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzowe%2Fexplorer-uss","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fzowe%2Fexplorer-uss","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzowe%2Fexplorer-uss/lists"}