We’re delighted to share the new BTP Solution Diagram repository and BTP Solution Diagram guideline (PDF) which is available now.
This new repository serves as a central access point for SAP BTP Solution Diagrams.
It features:
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:
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/
The elements referred to in the guideline are available as draw.io library which can easily be integrated:
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):
For Lucidchart we offer a marketplace integration to make use of the SAP BTP Service Icons:
With this integration you can easily use now also the offered SAP BTP Service Icons to create SAP BTP Solution Diagrams:
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.
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
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.
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.
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.
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.
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:
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.
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.
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,
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:
https://github.com/SAP/btp-solution-diagrams/releases
Thx @lechnerc77
You must be a registered user to add a comment. If you've already registered, sign in. Otherwise, register and sign in.
User | Count |
---|---|
15 | |
10 | |
9 | |
9 | |
9 | |
8 | |
8 | |
8 | |
6 | |
6 |