Technology Blogs by SAP
Learn how to extend and personalize SAP applications. Follow the SAP technology blog for insights into SAP BTP, ABAP, SAP Analytics Cloud, SAP HANA, and more.
cancel
Showing results for 
Search instead for 
Did you mean: 
fabianlehmann
Product and Topic Expert
Product and Topic Expert
15,729

Intro

We’re delighted to share the new BTP Solution Diagram repository and BTP Solution Diagram guideline (PDF) which is available now.

fabianl_0-1708598541266.png

This new repository serves as a central access point for SAP BTP Solution Diagrams.
It features:

  • an updated design guideline (online and as pdf) for creating BTP Solution Diagrams
  • multiple diagram examples from different domains to give context
  • editable diagrams for draw.io and PowerPoint as well as svgs
  • Several libraries for the necessary components needed to craft or recreate an SAP BTP Solution Diagram

The official new target design for SAP BTP Solution Diagrams is based on the SAP Fiori Design System and consuming the recently announced official SAP BTP service icons for BTP. You can find all information and details at the new GitHub page (link).

The new release continues the great work (blog) of Bertram dating back as far as 2018, when the 1st version of the “official” BTP (called SCP then 😉) Solution Diagram guideline had been announced.

We received a lot of feedback and questions from the community  and were encouraged to update and deliver a new version of the BTP guideline and icons to build BTP Solution Diagrams with the same look and feel across the SAP eco-system.

Based on feedback - also from the session XP286v held by Carsten at SAP TechEd 2023 last year - we took the opportunity to re-iterate and now provide a version which we offer to the community and the whole SAP eco-system. It is not a 100% finalized version but instead we’re counting on you to collaborate with us via GitHub discussion or issues. If you see things that are missing or would benefit from changes – please let us know!

As you may know, SAP actively contributes to open source. For more details take a look at the SAP Open Source report (2023 Year-In-Review Report). As we are also frequently using the open source draw.io diagramming tool, we decided to provide multiple draw.io libraries in addition to the already available PowerPoint (TBD link) templates. These stencils support you with standardized content, for example  the correct SAP product names and service icons / shapes.

Please also read the blogs on the SAP community explaining different ways to create appealing and easy to understand BTP Solution Diagrams:

The Repository and Tools

Diagrams can be created either with draw.io or Powerpoint. The assets are made available via SAP Open Source on a central GitHub repository. In addition we use the new public GitHub page as central entry point for updates on the topic and to bundle general information for internal and external audiences:

https://sap.github.io/btp-solution-diagrams/

Draw.io

The elements referred to in the guideline are available as draw.io library which can easily be integrated:

fabianl_0-1708607916781.png

Pre-Load libraries with web based draw.io

You can also use the web version of draw.io and directly load the BTP service icons using the clibs parameter. Please check the official draw.io documentation that describes this procedure here.

Bu using the clibs parameter the final URL look like this (with one pre-loaded library):

Update 07/2024

 
Beginning with version 24.7.x we get now also the "native" integration for the SAP BTP Service Icons and shapes for the web based draw.io editor and also for the desktop version:
fabianlehmann_0-1723447508822.png

Lucidchart

For Lucidchart we offer a marketplace integration to make use of the SAP BTP Service Icons:

fabianlehmann_1-1723447743678.png

With this integration you can easily use now also the offered SAP BTP Service Icons to create SAP BTP Solution Diagrams:

fabianlehmann_0-1723449033806.png

Powerpoint

We recommend to use draw.io because of its flexibility but you could still use ppt templates which are to be found in the repository as well.

Call to action

While using the libraries in the described way is fine for now, we believe it would be better to have a more intuitive draw.io integration with the assets offered out-of-the box. To make this happen, we ask you as the community to vote on this GitHub issue:

https://github.com/jgraph/drawio/issues/4199

 

Online Guideline and Examples

To help you get started we provide examples at different granularity levels tailored for your audience. As of now diagram detail levels range from Level 0 (L0 – audience with least technical knowledge) to Level 2 (L2 – Most technical knowledge):

L0 Diagrams

A representative L0 diagram example (as shown below) is a high-level solution diagram featuring BTP Services and simplified flows without complex technical details. In this type of diagram, connectors are not specifically annotated and the content is streamlined to essentials. Therefore, there is no need for a dedicated legend. However, a brief description is recommended.

fabianl_1-1708607974347.png

 

L1 Diagrams

L1 Diagrams offer greater detail, featuring elements such as connector annotations that provide a description of flows, and the differentiation of various paths within the diagram. The use of color helps to distinguish between different flows. Below is an example that describes a setup for SAP Task Center. A legend is advisable for easy comprehension.

fabianl_2-1708607974359.png

L2 Diagrams

Finally, L2 diagrams are rich with technical specifics, making them particularly insightful for architects and others with high technical proficiency. A legend is advisable for easy comprehension.

fabianlehmann_0-1723449215377.png

 

Layout and Style guidance

The SAP BTP Solution Diagram Design Guideline adheres to the atomic design system approach, using SAP Fiori UI Design System to ensure uniform user experience across all SAP interfaces. It offers comprehensive guidance on best practices, defining patterns and semantics rooted in industry standards and targeted expert feedback.

 

fabianl_4-1708608043776.png

 

Atoms characterise fundamental colors and lines; molecules comprise elements like shapes, connectors, or texts. Organisms embody grouped components, ranging from text-filled boxes and icons to complete diagrams.

The Atoms  (referred to as Foundation) guidance contains advice for colors, line styles and spacing:

        

Screenshot 2024-02-22 at 15.19.11.png

 

The Molecules (referred to as Diagram Components) guidance addresses diagram elements like area types, connectors and annotations and is available as draw.io and powerpoint library.

fabianl_7-1708608073784.png

Organisms (referred to as Component Groups) contain smaller or bigger groups of Molecules. In the repository we also provide some examples for organisms and they are constantly enhanced by additions from the community which are being reviewed and approved by both architects and designers and finally made available as editable diagrams for you to reuse.

 

Outlook

In the coming weeks we will start to create additional blogs to share some tips & tricks which will help you to build nice BTP Solution Diagrams. As we want to also get and incorporate your feedback, please feel free to comment on this blog! Maybe you even want to write a blog post about your experience creating a SAP BTP Solution Diagram based on this new repository and guideline!

Cheers,

@VisuaLiza & @fabianlehmann 

Update 26.02.2024:

Fo all of those, who want to have ready to use archive for the icons, svg's or examples.

We introduced now assets as part of any new release:

fabianl_0-1708927308747.png

https://github.com/SAP/btp-solution-diagrams/releases

Thx @lechnerc77 

 

15 Comments