Builder

Overview

The Builder is a YaaS administration interface for the development, registration and management of modules and services that originate from subscriptions or your own development. It consists of a set of views that can expand the Builder navigation.

YaaS requires you to have an account to take advantage of its functionality. With this YaaS account, you can do the following in the Builder:

  • Create a project in the context of a YaaS organization.
  • View the projects in which you have a membership.
  • Manage the projects in which you have membership and the project's resources according to the user roles in the project.
  • Use third-party Builder modules in the name of the projects.

Regardless of whether you are a brand or a developer, the Builder offers a consistent experience for managing your business.

Benefits of the Builder

As a business owner, you can manage users and projects in your organization. You can add a project and subscribe to packages with different services in the YaaS Market. For each project, you can define user roles, invite staff members, and manage your subscriptions, products, and orders.

As a developer, you can earn money by offering your services and packages in the YaaS Market. You can create services, UI modules called Builder modules, and subscribe to packages.

Additionally, the Builder includes user interfaces to the Commerce services to which you have a subscription.

Go to the Builder SDK section to learn more about the benefits the Builder provides for developers.


Create an Organization

Create an organization with user guidance

The Builder features a step-by-step guide to assist users in creating an organization in one smooth process. A tutorial with these steps appears each time you create an organization:

  1. Click CREATE YOUR OWN ORGANIZATION to begin the process.
    User guidance - Create an Organization

  2. Enter the name of your organization, your YaaS URL, and country. The screen confirms whether your URL is available.
    User guidance - Create an Organization

  3. If commercial packages are available in your country, the GET STARTED button appears. Currently, commercial subscriptions are available to YaaS Market subscribers in the United States and Germany. Click GET STARTED to use YaaS for production purposes. Click TRY IT FREE to use beta packages only.

  4. Enter your contact details.
    User guidance - Create an Organization

  5. Enter the address of your organization along with its industry categorization.
    User guidance - Create an Organization

  6. Enter your payment details.
    User guidance - Create an Organization

  7. After you confirm a summary of your entries, your organization undergoes background checks that might take a few minutes to complete. As soon as your organization is approved, the system sends an email to the contact person. After approval, your YaaS organization is available. The approval is reflected in the Organization Details when you click the settings icon on the organization home page.

  8. You can now create a project. If you choose not to immediately create a project, the Builder redirects you to the organization home page. To learn how to create a project, see the section Create a Project.
    User guidance - Create an Organization

Create additional organizations

If you already have an organization in YaaS, you can follow these steps to create another one.

  1. Click the organization dropdown in the top menu.
  2. Click + New Organization in the left menu.

The organization creation wizard begins.

Organization menu

Join an organization by invitation

If you receive an invitation by email to join an existing project, click the link in the email instead.
Email invitation

Edit organization details

Click the settings icon on the organization home page to access organization details.

Invite members to your organization

To invite other members to your organization:

  1. Click the settings icon on the project home page.
  2. Click Organization Members in the left menu.
  3. Click + ORGANIZATION MEMBER.
  4. Enter the team member's email address and role.
  5. Click Invite.
    Invite a member
    You can only invite persons who already have a YaaS account. Inviting YaaS account holders grants immediate access to your organization.


Create Projects

It's possible for a user to receive an invitation to a project or to create one. If you haven't already been invited to a project, you can create one if your user role has the permission to do so.

To create a project:

  1. Click the button + PROJECT.
  2. Enter the Display Name, Identifier and the Description.
  3. Click the SAVE button:

Invite members and create user roles

After you finish creating the project, a dialog gives you the option to invite members to the newly-created project. Click INVITE PROJECT MEMBER.

Alternatively, you can invite members to your project from the project home page by clicking Staff Members in the left menu. Under the section User Roles, create user roles and assign them to different users.

User roles, scopes, and navigation node visibility

There are various default user roles in the Builder. These roles are:

  • Owner
  • Developer
  • Publisher
  • Viewer

Each role receives an assignment of scopes. Scopes determine the range of functionality available for that role as well as the visibility of nodes in the navigation.

Example:

The user role Developer has the scopes hybris.api_view, hybris.marketplace_submit, hybris.api_manage and hybris.account_view assigned to it:



This scope assignment allows the developer user role to view and manage services, clients, and builder modules. The navigation that appears in the Builder for the signed-in developer corresponds with these rights.

By contrast, the user role Publisher does not have these same scopes granted to it. Clients with the Publisher user role are not allowed to manage services, clients, or builder modules. These navigation nodes are hidden for the Publisher user role.

Add a package to your project

If you choose to add a package to your project:

  1. Click on the button + SUBSCRIPTION. Your browser then automatically forwards you to the YaaS Market within the context of your organization and project.

  2. Choose from several packages on the YaaS Market. The packages on the YaaS Market are divided into two categories that are based on your company location:
    • Standard – Available only to companies located in the United States and Germany
    • Worldwide (Beta) – Available only to worldwide companies
  3. Click on a package to see its details
  4. Subscribe to the package by clicking on the button SUBSCRIBE NOW. Your project information will be preset in the window. Confirm that the subscription is for the project listed.
  5. Click on the button SUBSCRIBE NOW.
  6. You can subscribe to more packages by clicking GET MORE or click the button CONFIGURE IT to configure the package in the Builder.



Your project in the Builder

Once the browser directs you back to your project in the Builder, the navigation tree on the left has changed based on the UI included in the package. For example, the PRODUCT CONTENT package offers the possibility of creating products and publishing them to an online shop.

Go to the Products node in the Builder after you subscribe to the package.

  1. Click the button + PRODUCT.
  2. Enter the product information. Set the product to active so that it will appear immediately online.
  3. Click on the SAVE button.

All of your created products are located on the Products page. You can sort by the newest or alphabetically from A-Z or Z-A. When you subscribe to the Product Content package, an online shop is automatically created at the URL: http://shops.yaas.io/Your-Project-Identifier. (The project identifier is located on the project details page.)


Create Packages

A developer's ultimate goal is to create packages and sell them on the YaaS Market. You can test your packages internally before publishing them.

  1. Go to {Your Project} > Packages > + PACKAGE, enter the name of the package in the languages in which you would like to make it available. Click the SAVE button.

  2. On the package detail page, provide your package with an icon. Also, you can edit the display name and short description on this page. Enrich your package with more services and Builder modules under the CONFIGURATION tab.

    Under the tab ACCESS CONTROL, you can list projects that can access your package. You can also specify the email address of a contact person.
    If your organization has been approved for publishing you can click on the PUBLISHING tab on the package details page to enter all of the details required for publishing such as publisher details, marketing content, screenshots as well as metrics and markets.

    The following items are mandatory for publishing:
    • an icon
    • a short description
    • the publisher website
    • metrics
    • markets
    Before you can create a market, you have to first define at least one metric under the section Metrics. Click on SAVE

    Once you have saved the metrics, you'll see that the button + MARKET is enabled. Select a market. Define the metric usage. Enter additional terms and conditions here if your package requires them. Click on SAVE


  3. After entering all of the mandatory package information, click on the PUBLISH button. The market operator has to first approve your package before it can be listed on the YaaS marketplace.

    After your package is available on the YaaS Market, the button STATISTICS appears. As soon as your package has subscribers, the graph provides details on how subscribers use your package.


Create Showcases

The YaaS Community is a place to showcase your projects and business applications to a broader audience.

Click on SHOWCASE on the package details page to enter information about your package that you would like to make visible to the YaaS Community for feedback. You can also upload an icon. Click on the SHARE & SAVE button. Your package is then visible on https://community.yaas.io/.


Glossary

TermDescription
authorization ruleThe access rights for different endpoints of a service, as defined in the scopes.
client authorizationAuthorization that defines what a client can access.
Client IDA unique identifier to access an application or service.
Client SecretA password that matches the Client ID.
identifierA unique sequence of alphanumeric characters, which uniquely identifies an item.
localesThe set of languages used in YaaS.
module locationThe URL where the Builder module's JSON descriptor is deployed, such as `/builder/module.json`.


  • Send feedback

    If you find any information that is unclear or incorrect, please let us know so that we can improve the Dev Portal content.

  • Get Help

    Use our private help channel. Receive updates over email and contact our specialists directly.

  • hybris Experts

    If you need more information about this topic, visit hybris Experts to post your own question and interact with our community and experts.