FAQ

• What is the Stonebranch Marketplace?
• What are the different Task Types?
• How do I register and log in to Marketplace?
• How do I import the items into my environment?
• How do I contribute a script/task to the Marketplace?
• How do I rate and write reviews?

What is the Stonebranch Marketplace?

With Stonebranch Marketplace, we aim to provide an efficient open-source community for add-ons to Stonebranch products, such as specific Universal Tasks, Universal Data Mover jobs, various connectors, etc. These add-ons will enhance your experience while providing a forum for sharing best practices, open integration capabilities and product knowledge with other Stonebranch customers and partners.

What are the different Task Types?

• Universal Tasks (Non-Monetized)

These are generic scripts for Windows or Linux/Unix Universal Agent-based tasks. These can be imported via XML into Universal Controller.

• Scripts (Non-Monetized)

These are generic scripts used for the creation of basic Tasks within your Universal Controller.

• Connectors (Monetized)
• Universal Connector for Use with SAP® ERP is a command line application that controls background processing within an SAP system. Universal Connector provides functionality to integrate SAP systems into both local administrative tools and enterprise system management infrastructures.
• With the Universal Connector for PeopleSoft we are providing a certified interface that supports all available PeopleSoft process types. The connector uses the PeopleTools web service API to enable seamless integration with the PeopleSoft Process Scheduler.
• Solutions (Monetized)

SAP Automation - with Libelle LSC and Stonebranch UAC you can easily simplify your SAP system copy processes, reduce costs, and increase data and application quality

How do I register and log into Marketplace?

Select "Register" and fill in the form. The following fields are required:

• First Name
• Last Name
• Email Address
• Company Name
• Task Type (Universal Task, Script, Connector, Solution)
• Text Field for Description/Documentation
• File Upload for extension.xml (the exported xml extension)
• Upload for Media (screenshots/videos etc.)  
• Check the box to agree with the Terms and Conditions

How do I import the items into my environment?

Importing Universal Tasks

You can import record information from any valid XML file to a list using the Import action that is available for all lists.

• Any Universal Template XML found in the import directory will be processed prior to any other XML
• Universal Template XML will be processed only if the Universal Template does not exist by name or sys_id. You can create a Universal Template via List Import, but you cannot update a Universal Template via List Import; if the Universal Template exists, the Universal Template XML will be ignored
• Any Universal Task XML must be validated to ensure that it conforms to the currently defined Universal Template it is associated with

Note: Importing records from XML files requires either the ops_admin role or the ops_imex role.

Importing UDM Tasks

Step 1	From the Automation Center navigation pane, select Tasks > File Transfer Tasks. The File Transfer Tasks list displays a list of all currently defined File Transfer tasks.   Below the list, File Transfer Task Details for a new File Transfer task displays.
Step 2	Enter/select Details for a new File Transfer task, using the field descriptions below as a guide. Required fields are displayed in boldface. Default values for fields, if available, display automatically. To display more of the Details fields on the screen, you can either: Use the scroll bar. Temporarily hide the list above the Details. Click the New button above the list to display a pop-up version of the Details.
Step 3	Click the Save button. The task is added to the database, and all buttons and tabs in the Task Details are enabled.

How do I modify an existing script/task or submit a new one?

First, look for a project's contribution instructions. These files are usually listed in the top level of a repository:

• LICENSE: By definition, every open-source project must have an open-source license. If the project does not have a license, it is not open-source.
• README: The README is the instruction manual that welcomes new community members to the project. It explains why the project is useful and how to get started.
• CONTRIBUTING: Whereas READMEs help people use the project, contributing docs help people contribute to the project. It explains what types of contributions are needed and how the process works. 
• CODE_OF_CONDUCT: The code of conduct sets ground rules for participants’ behavior associated and helps to facilitate a friendly, welcoming environment.

Contribution Instructions:

• Fork the project on Github
• Clone the fork on your local machine. Your remote repo on Github is called origin
• Add the original repository as a remote called upstream
• If you created your fork a while ago be sure to pull upstream changes into your local repository
• Create a new branch to work on! Branch from develop if it exists, else from master
• Implement/fix your feature, comment your code
• Follow the code style of the project, including indentation
• Squash your commits into a single commit with git's interactive rebase. Create a new branch if necessary
• Push your branch to your fork on Github, the remote origin
• From your fork open a pull request in the correct branch. Target the project's develop branch if there is one, else go for master!
• Once the pull request is approved and merged you can pull the changes from upstream to your local repo and delete your extra branch(es)

And last but not least, always write your commit messages in the present tense. Your commit message should describe what the commit, when applied, does to the code – not what you did to the code.

How do I rate and write reviews?

You have to be logged in in order to review an item in Marketplace.

Once on the item's page, select the Evaluations tab and fill in your name, rating and output.