cancel
Showing results for 
Search instead for 
Did you mean: 

Working with Blue Prism Repositories on GitHub

ewilson
Staff
Staff
When downloading an asset (VBO/Proces/BPRelease) from the Blue Prism organization page on GitHub, it's important that you get the raw asset file as opposed to the HTML representation of the file contents. Otherwise, when you try to import the asset in to your Blue Prism instance you may experience issues.

To download a Blue Prism asset from GitHub:

  1. Open your browser and navigate to the respository link for the specific asset you're interested in. For this example, we'll use the Process Information VBO (https://github.com/blue-prism/ProcessInfo).
  2. From the <> Code tab, click on the .xml or .bprelease file.
    6439.png

    Note: Most asset repositories will include the following files:
    • The asset .XML/.BPRelease file.
    • A user guide in either .DOCX or .PDF format.
    • A license file (typically the MIT License).
    • A README file.
  3. After you click on the asset file, you'll be presented with the contents of the file displayed in the default GitHub editor. DO NOT try to save the contents from this screen. This is where most issues start. If you try to save the contents from this screen you will likely get a file that contains HTML tags. This will not work when you try to import the file into Blue Prism.
  4. At the top right of the editor window, click the button titled "Raw". This will present the raw contents of the asset file without any HTML tags.
    6440.png
  5. Right-click on the page, select Save as..., and save the file.
    6441.png

    You should now have a clean asset file that can be imported into your Blue Prism environment.

    In some cases, the asset may be added to a GitHub Release. This is basically just a zip file that contains all of the file found in the repository. If the asset you're interested in has been built into a GitHub release you'll find it under the Releases heading on the right side of the screen.
    6442.png

    If you click the link for the specific release that will take you to another screen where you can choose to download the repository contents as either a .ZIP or a TAR.GZ file.

    Cheers,

    ------------------------------
    Eric Wilson
    Director, Partner Integrations for Digital Exchange
    Blue Prism
    ------------------------------
    3 REPLIES 3

    Thanks Eric for sharing valuable info

    ------------------------------
    Nilesh Jadhav
    Senior RPA Specialist
    ------------------------------
    Nilesh Jadhav.
    Consultant
    ADP,India

    AminPatel1
    Level 5
    Thank you for pointers, Is it applicable when we download C# repositories like microsoft-power-platform-connector from github/blue-prism.

    ------------------------------
    Amin Patel
    Intelligent Automation Developer
    Emerson
    Pune India
    ------------------------------
    Amin Patel Intelligent Automation Developer Emerson Pune India

    AndreyKudinov
    Level 10
    @ewilson, or you can just press Code > Download Zip

    ... ​unless repo is huge like chromium(>1Gb), but I dont think any of BP repos are bigger than a few Mb.

    ------------------------------
    Andrey Kudinov
    Project Manager
    MobileTelesystems PJSC
    Europe/Moscow
    ------------------------------