sap-archive / cloud-realspend-expenses-uploader

Allows posting budgets and expenses to HCP RealSpend API through SAP ERP JCO connection.

Important Notice

We have decided to stop the maintenance of this public GitHub repository.

cloud-realspend-expenses-uploader

Allows posting budgets and expenses to HCP RealSpend API through SAP ERP JCO connection.

Prerequisites

• Java 1.6 or higher
• Maven 3
• sapjco3: https://websmp108.sap-ag.de/~sapidb/011000358700007415502002E/#2

Build

• Clone the repository.
• Edit the file system.jcoDestination and insert the correct credentials for the SAP ERP system.
• Edit the pom.xml file and insert the correct path to JCO.
• Run the following command:

mvn clean package -DskipTests

• Now you see the generated "target" folder, which contains the executable jar file "expense-uploader-0.1-jar-with-dependencies.jar".
• Create a new folder somewhere (e.g. your home directory) and copy this jar into it. Also copy the files system.jcoDestination and src/test/resources/config/config.xlsx there. You should now have a folder with just these three files.

Run

• Open a command line prompt in the folder you just created.
• The hcp_proxy parameter is optional.
• The hcp_user must have the roles "Governance", "Manager" and "API-User". It is advised to have only one user with the Governance role, as multiple may lead to conflicts.
• Run the jar like this (after replacing the parts inside angled brackets):

java -cp <path-to-jco>/sapjco3.jar:expense-uploader-0.1-jar-with-dependencies.jar com.sap.expenseuploader.ExpenseUploader --from=<starting-date> --to=<end-date> --controlling-area=<ca-code> --input_erp=system --output_hcp --hcp_url="https://<Realspend-HCP-URL>/core/basic/api/v1" --hcp_user=<your_hcp_username> --hcp_proxy=<proxy-url> --budgets

Notes

• You can find the Realspend-HCP-URL by navigating to the "RealSpend Launchpad" inside your HCP trial account. It's the part before "/core/".
• You can place the "sapjco3" wherever suits you the best.
• If you can't connect using JCO, you might have to add 127.0.0.1 as IP to your hostname in your hosts file.

Configuration files

• The configuration is done using the Excel file "config.xlsx".
• On the first sheet you specify which user will receive actuals for which cost center.
• On the subsequent sheets you specify budgets for master data and tags.

License

See the License file for license rights and limitations (ASL 2.0).

cloud-realspend-expenses-uploader's Issues

Internal URL found in project

The file run.sh has a proxy server element in it that references our internal SAP proxy server. This might be an artifact from your internal work.

--hcp_proxy=proxy.wdf.sap.corp:8080

The Open Source policy from SAP is to remove any internal references from work that has been contributed to the public domain. If you would, please, remove this reference from the file, I would appreciate it. This will prevent the project from coming up in our scans in the future.

Thank you,
Jonathan Baker

SAP artifact in a Java code file

The file IntegrationTest.java contains a reference to an internal SAP server:

 {

        String[] args = {
            "--from",               "20150301",
            "--to",                 "20150501",
            "--controlling-area",   "0001",
            "--input_erp",          "system",
            "--output_hcp",
            "--output_cli",
            "--hcp_url",            "https://bmsfin-<your account here>.hanatrial.ondemand.com/core/basic/api/v1",
            "--hcp_user",           "your username here",
            "--hcp_password",       new String(Base64.decodeBase64("your password in base64 here".getBytes())),
            "--hcp_proxy",          "proxy.wdf.sap.corp:8080",
            "--budgets",
            "--resume"
        };

Specifically, the server:

proxy.wdf.sap.corp

This artifact won't work outside the SAP firewall.

SAP Open Source runs regular scans looking for artifacts in the code which might indicate our internal code has accidentally released in to the Open Source stream. This file continues to show up in our scans. Can you please fix it, or remove it, so that it no longer shows up as an error?

Thank you.