How to add xslt templates to the tool deployed in SAP BTP
Migration from PI/PO systems to CPI systems is one of the most important features of the Figaf tool.
Here you can find more details about it: https://help.figaf.com/portal/en/kb/configuration/pi-to-cpi
It requires XSLT templates placed on a server. Here you can read how to configure these templates. https://help.figaf.com/portal/en/kb/articles/how-to-create-xslt-to-map-pi-to-cpi-channels.
The problem we faced with deployment in SAP BTP is that you don't have stable transparent access to the file system of the container. More specifically, it's possible to connect to the server and work with files there but the file system got automatically renewed after each restart. So unlike standard on-premise installation, it's impossible just to put XSLT templates to the corresponding folder manually.
That's why we found another approach to support this feature.
You need to take our repository https://github.com/figaf/PItoCPIMigrationTemplates.git with a couple of default files. If you expect to add/modify the templates, you need to fork/copy this repository. If it's okay for you to use a public repository with your custom files, you can just fork it via GitHub UI. If you want to make this repository private (which is more likely), please follow the procedure below (unfortunately, Github doesn't allow making a forked repository private).
- Create your own repository on Github or somewhere else.
- Execute the following commands:
git clone --bare https://github.com/figaf/PItoCPIMigrationTemplates.git
cd PItoCPIMigrationTemplates.git
git push --mirror <your new private or public repository> - If necessary, change a default branch to "master":
Then open the vars.yml file in your BTP deployment directory and specify the property "GIT_REPOSITORY_LINK". If it's a private repository it should contain a token/password in the URL.
On Github, it can be configured here: https://github.com/settings/tokens.
So the value of 'GIT_REPOSITORY_LINK' can be something like: https://<your token>@github.com/<your repository>
If you want to add/update some XSLT files, you need to push them from your computer to the repository and then restart the SAP BTP applications.
Related Articles
Deploy to SAP BTP, Cloud Foundry
This article describes how to deploy the Figaf tool to CPI BTP, Cloud Foundry. Before you get started you need to have a Cloud Foundry subaccount with Postgresql and Cloud Foundry Runtime enabled. Read more here how to get Setting up SAP BTP Account ...Setting up SAP BTP Account to deploy Figaf in Cloud Foundry
BTP administration can be a bit complicated and contain difffrent setups. We have created a small guide for you to check before you install Figaf in BTP. It is likely that things will change there. We currently have a problem with running Figaf in ...Start here to install the Figaf Tool
If you are looking to run Figaf there is a number of ways. Where The Figaf Tool is a standalone Java application that makes it easy to run in several different locations. We support Java 8. You can use Oracle 8 if you have a corporate license; we ...How to download logs from Figaf app in SAP BTP
SAP BTP cockpit allows accessing only the last 1000 lines of logs. Sometimes it's enough for debugging but in most cases, it's not. So there is a way to download all needed logs directly from the app. First of all, you need to execute next two ...How to use PI/PO systems in SAP BTP
PI/PO systems are usually located in a private environment so you need to use special SAP services to organize the connection. First of all, configure a cloud connector on the system which has access to PI/PO. (Configuration of the cloud connector is ...