Importing and Exporting Microflow® Stage Configurations

After editing a Microflow application, you can export the stage configurations to a file on your local filesystem, or to a GitHub repository. You can also import stage configurations from a file or GitHub.

Exporting Stages

  1. On the Apps page, click a running Microflow application; you are directed to Application Details page. By default, the Implementation tab is selected.

  2. Click Edit.

  3. Click More > Export Stages.

  4. Select Filesystem to export the stage configuration on the local filesystem, or GitHub to save the stage configuration on GitHub.

  5. Click Next.

  6. If you selected Filesystem, a JSON file will be downloaded locally by your web browser.

  7. If you selected GitHub, complete the following steps.

  8. If this is the first time you exported to GitHub, the GitHub login box is shown. TIBCO Cloud Integration uses the OAuth protocol for integration with GitHub, so you will input your user credentials to directly log in to GitHub, rather than providing user credentials to TIBCO Cloud Integration.

  9. Click Login to GitHub. The GitHub login box is shown:

  10. Enter your GitHub username and password and click Sign in. If you do not have a GitHub account, click Create an account. If you have forgotten your GitHub password, click Forgot password?.

  11. The first time you sign in to GitHub, you will be asked to authorize TIBCO® Cloud Integration to access your account, including your GitHub account user data, as well as accessing to the private and public repositories of this account. The account user data is used for integrating with GitHub. Click Authorize application.

    Note: It’s also possible that you will be asked to authorize TIBCO Cloud Integration to access organization’s data in repositories, if you are a member of any organization on GitHub, and TIBCO Cloud Integration has never been authorized for accessing this organization. Click the Request Access button next to an organization to send the request to the owner of this organization. You should send this request before clicking the Authorize application button.

  12. All the GitHub repositories that you can access will be displayed in the Export to GitHub window.

    The left side panel of the window is the list of all the repositories in which you have either read or write permissions, which includes organization repositories. For example, the CatChasing repository of the PetChasers organization is displayed there, which only happens when the access request you sent earlier has been approved by the owner of the PetChasers organization.

    TIBCO Cloud Integration only supports import/export with the master branch of the repositories on GitHub.

  13. Select a GitHub repository, and enter a File Name and Commit message.

    You can choose the repository from the left panel, navigate to the target folder and export the Microflow configuration into this folder.

    If you choose an organization repository to export your configuration, make sure you have the write permission to this repository. By default, you only have read permission if you are just a member of this organization; you will have to join a team that has write permission to a particular repository, or you are an outside collaborator that has the write permission to this repository, in order to export to this repository. Please refer to your GitHub organization owner for the details.

  14. Click Export.

Importing Stages

To import a stage, follow the same procedure as exporting, except select More > Import Stages on the edit page.