How to add xslt templates to the tool deployed in SAP BTP

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).
  1. Create your own repository on Github or somewhere else.
  2. 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>
  3. 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. Install "cf" command on your computer https://github.com/cloudfoundry/cli/wiki/V7-CLI-Installation-Guide#installers-and-compressed-binaries. Log in to your SAP BTP account ...
    • 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 ...
    • Installation

      Here you can find an example of the structure that you need to have to run the Figaf IRT application. This is just an example and you need to put your own values if you have another jar version, DB credentials, etc. There are two ways of how to ...
    • Requirement before installation

      We recommend the following prerequisites Registration for a trial at figaf.com/devops so you will get a license key Download the Figaf runtime jar file at irt.figaf.com/download. Have a server/laptop with 8Gb of memory. Figaf can run on a laptop but ...