Skip to Content

If your goal is to set up a proof of concept of the EMR Unwired solution (App & Mobile Server for Healthcare) this blog is meant for you. We provide a VM image which you can download and install & configure quickly.

In this blog post I would like to give you a step by step guide on how to set up the Mobile Server for Healthcare, connect your mobile device to the server and how to configure webservice calls so you can connect them to the backend of your choice.

All resources mentioned in this blog are tagged with “getting_started” so you can easily find them when walking through this blog / tutorial. You can find it by clicking on the tab “overview” and then “getting_started” in the tag cloud on the right side.

1) VM vs. full Mobile Server for Healthcare

There are two options of server installations you can chose from. One is to download a pre-packaged VM (virtual machine) which is described in this blog. The other is to install your own server. While the VM option is quick and easy to deploy it does not allow you to install new support packages (new functionality and fixes) or implement notes (single fixes). Additionally the VM has a limited time for usage as it is delivered with a test license which is only active for 90 days. Therefore we recommend you to install your own server for mid and longterm usage so you can benefit of fixes and new functionality as soon as we release them on the SAP Service Marketplace. For simplicity reasons this blog explains the setup with the VM with screenshots from an internal test run. For setting up a full server please see the EMR Administration Guide.

2) Download and installation of the VM

Open this link: https://store.sap.com/sap/cp/ui/resources/store/html/SolutionDetails.html?pid=0000000243&catID=&pcntry=DE&sap-language=E…

Download the three artifacts which you need in order to do the installation by clicking the three links:

– one for the .iso file: click the “Trial Version” button, fill out the form and download the iso.

– one for the operating system: open the section “Technical requirements” wherein you find the download for the SLES Linux version.

– one for the guide which will walk you through the installation step-by-step (“How to Guide”): see section “Technical requirements”.

Here is a screenshot what you should see:

ScreenShot_TestTrialDownload.png

Please note: For good performance please consider the system requirements on the above download site.

After you walked through the documentation provided with the VM image you can proceed with step 3 to 9 which covers the EMR specific configurations.


3) Retrieval of host and port information (important for further configuration steps)

– Logon to the VM (Mobile Server for Healthcare)

– in the transaction field enter transaction “/nsicf”

– click on the execute icon (clock with green checkmark) or hit F8

– click on the grey icon to retrieve protocol, host & port –information

ScreenShot_SICF_Entry.png

– write down this information of protocol, host and port where port is equal to the column “Service”

ScreenShot_Port_Information.png

4) Test the connection from a browser to the Mobile Server

For a first test that the server is reachable via OData enter the following URL into the browser of you choice after replacing the host with your IP address.

http://<your_ip_or_host_name>:8042/sap/opu/odata/MEMR/MOBILE_EMR/$metadata

Example: http://10.55.148.206:8042/sap/opu/odata/MEMR/MOBILE_EMR/$metadata

An XML like metadata model of the EMR Objects should be returned

If this succeeds also check if demo data is retrievable via a REST client. To do so enter the following links into the REST client again after replacing the host with your IP.

http://<your_ip_or_host_name>:8042/sap/opu/odata/MEMR/MOBILE_EMR/PatientCollection(‘1’)/Allergies?sap-client=001

Example: http://10.55.148.206:8042/sap/opu/odata/MEMR/MOBILE_EMR/PatientCollection(‘1’)/Allergies?sap-client=001

Here is a screenshot as a reference with the result displayed with a REST client (here the firefox browser was used):

ScreenShot_REST_Client.png

Hints:

– After you send the request a popup will appear. Enter your user and password, e.g. developer / ch4ngeme.

– should you encounter the error “RFC error when sending logon data” go to transaction secstore, delete all entries and try again.

5) Test the connection from a mobile device to the Mobile Server

– Download and install the EMR mobile app on the device

– go to the app settings and make the following entries:

–> Backend URL = http://<your_ip_or_host_name>:8042/sap/opu/odata/MEMR/MOBILE_EMR

–> Client = 001

–> Sample Data Mode = disabled

6) Webservice Connectivity

The webservice definitions are provided with file “Webservice WSDLs.zip” which can be downloaded from our EMRU partner page: https://service.sap.com/~sapidb/011000358700001249782012E/. Please note: You can access this area only if you have become a SAP Partner, e.g. via http://scn.sap.com/community/mobile/blog/2013/03/26/getting-started-for-implementation-partners

You can use these to develop a backend adapter to expose this data to the Mobile Server.

Presuming the development is done the next step is configure the Mobile Server to connect to the webservices of the backend.

For the actual configuration please see section “Web Service based Service Interfaces” in the EMR Implementation Guide which can be downloaded from the EMRU partner page.

Note: If you launch the transaction “SOAMANAGER” from the VM, the browser-link will be generated with host “nplhost”. If the host is not resolved, change it to “localhost” and the SOAManager should be launched properly.

After configuring the webservices you have to register the webservices to be called by the Mobile Server for data retrievel from the backend. To do so:

– from the “getting_started” section download the file “EMR WebService Configuration XML”

– logon to the Mobile Server

– enter the configuration UI by entering transaction “/n/MEMR/CONFIG_UI”

– go to change mode

– click the button “Import from local file”

– select the downloaded file (emrConfigWebServiceImplementation.xml)

– click the save icon to save your changes

Now the webservices should be called.

To report this post you need to login first.

19 Comments

You must be Logged on to comment or reply to a post.

  1. b28 guest

    Hello Jan – this is just what we were looking for!

    Unfortunately your picture links are broken – can you repair them.

    I have a question – the “old” app used SUP 2.1.2 – the new app needs the SAP EMR Unwired – Mobile Server for Healthcare – does this mean the app works fully without SUP?

    Or is this somehow integrated in the SAP EMR Unwired Mobile Server for Healthcare?

    Best regards,

    Denise

    (0) 
    1. Jan Ruessel Post author

      Hello Denise,

      Great! I am glad you found this blog useful. I updated the screenshots and they should be visible for you now.

      SAP EMR Unwired works without SUP as it directly consumes OData services from the SAP EMR Unwired Mobile Server for Healthcare which is based on SAP NetWeaver Gateway.

      Best regards,

      Jan

      (0) 
      1. Srinivas Divakarla

        Hi Jan,

        I have been going through your blog since last quite few weeks and its just amazing it covers all the basic steps to start with and also it helped me a lot to understand how EMRU works, sadly I got struck with the implementation guide, where it talks about MEMR_TEST_DATA a zip file which contains xml and images which has to be uploaded (optional) to the test database, unfortunately I am not able to locate the .zip file 🙁

        Just checking to see you have any clue about where can I find the test data which is being mentioned in the implementation guide.

        Looking forward to hear from you 🙂

        Regards,

        Srinivas Divakarla

        (0) 
  2. Srinivas Divakarla

    Thank you so much Jan, It’s an amazing post which has all the required information to start with EMR Unwired App

    I am going through the implementation as we have access to the same through partner connect, in which on page 101, it talks about uploading MEMR_TEST_DATA.zip file, but sadly that zip file is not available neither in the installer nor in the service market place.

    Just checking to see if you can you help us in anyways,  and also it would be helpful if I can contact through email (how?). 🙂

    (0) 
  3. Shrikant Naidu

    Excellent Blog!!

    It helped me alot for setting it up.

    However i am stuck at step 4 while calling metadata & the response says “In the context of Data Services an unknown internal server error occured”.

    However i have already imported the demo data as mentioned by you.

    Can help me out here.

    Regards,

    Shrikant N.

    (0) 
    1. Srinivas Divakarla

      Hi Shrikant,

      500 internal server error is a very generic error, alternatively what you can do is, in netweaver gateway you can monitor the error logs by using /IWFND/ERROR_LOG it will provide you the basic insight of what causing the error, and also you can go through the call stack

      Regards,

      Srinivas Divakarla

      (0) 
      1. Shrikant Naidu

        Thanks Srinivas. I checked the ERROR_LOG & i found out that i am getting following exception: –

        “GET_BUSINESS_SYSTEM_ERROR An error occurred when determining the business system (SLD_API_EXCEPTION)”

        Regards,

        Shrikant

        (0) 
        1. Jan Ruessel Post author

          Are you using the test-trial VM or a freshly installed system? On the trial VM the right configurations are already preconfigured.

          If you are using a freshly installed system you need to configure the services to read the data from the local testdata.

          For each service you have to define the configuration value to access the testdata.

          So service /MEMR/FUNCTION_MODULE/<service_name> has to have the configuration value /MEMR/TEST_<service_name>

          An example: for service /MEMR/FUNCTION_MODULE/GET_ALLERGIES the configuration value needs to be /MEMR/TEST_GET_ALLERGIES

          (0) 
          1. Shrikant Naidu

            Thanks Russel for the clarification.

            I am using fresh system setup at my office.

            Where do I need to define this services?

            Is it needs to be defined using SOAMANAGER?

            (0) 
              1. Shrikant Naidu

                Hi Srinivas & Jan,

                As i have already imported the Test Demo Data downloaded which Jan mentioned in the Blog & i imported in the /MEMR/CONFIG_UI. So all the config values are already maintained which i guess are correct.

                For ex, /MEMR/FUNCTION_MODULE/GET_ALLERGIES has the config value /MEMR/WSA_GET_ALLERGIES.

                But still i am getting this error: –

                “GET_BUSINESS_SYSTEM_ERROR An error occurred when determining the business system (SLD_API_EXCEPTION)

                Please suggest.

                Thanks,

                Shrikant



                (0) 
                1. Shrikant Naidu

                  Finally, i have resolved it now. The consumer proxy URL configuration in SOAMANAGER was maintained wrong way.

                  I appreciate Jan & Srinivas for the support.

                  Its a nice blog to start with implementation.

                  Thanks,

                  Shrikant

                  (0) 
  4. Patrick Leydolph

    Hello, thanks for this awesome post!

    Unfortunately the link for the “EMR Unwired with SAP NetWeaver Gateway 2.0 ABAP and Java Trail Version on Linux” (2. Download and installation of the VM -> one for the .iso file (“Click here for download”) is not working. Could you fix it?

    Best regards

    Patrick

    (0) 
    1. Kay Loehmann

      Hi Patrick,

      I have tried to download all necessary assets and it works perfectly for me. Could you please try again? Sometimes servers are just down.

      Thanks. Kay.

      (0) 
    1. Christoph Hoehn

      Hello,

      I tried to download the trial version several times, yesterday and today. I fill in all data in the form and it keeps telling me, I will receive an email with DL-Link.

      However, I did never receive a corresponding email with any link. Any workaround available?

      Thanks in advance

      -c

      (0) 
  5. Abdelrahman Rahmo

    Dear Russel,

    I’m stuck in the configuration level, I did the connection between Backend,Mobile Server (Gateway) and EMR Application.

    After login to the EMR application, the page is empty and nothing is appeared except at the up-right “Lists” and it’s empty and at the up-Left “Logout”.

    Please I need how to configure it or if you have configuration guide or contact me on abdulrahman.rahmo@gmail

    (0) 

Leave a Reply