Hi Tony- Great question.
Here's a wiki page that addresses using the API: https://wiki.openmrs.org/display/docs/How+To+Use+the+OpenMRS+API As Daniel mentioned, you can set up an OpenMRS server and call web services. The section called "In an External Application using web services" links to that documentation. If you prefer to use the libraries in your own app, look at the section "In an External Application using the API Jar" . You can jump-start your application in Eclipse with the Maven module archetype. This will make a mavenized skeleton for an OpenMRS module. It makes an Eclipse project with a Maven pom.xml for you, which will take care of downloading all the OpenMRS jars that you need. You can delete the "web" folder entirely, and rename the "api" folder to something more suited to your project. There are directions at: https://wiki.openmrs.org/display/docs/Step+by+Step+Installation+for+Developers The maven archetype directions are at: https://wiki.openmrs.org/display/docs/Using+the+Module+Maven+Archetype You can find API documentation at https://wiki.openmrs.org/display/archive/Developer+Resources . There's no separate documentation for 1.8.x, the current stable release. I believe all the differences between 1.7 and 1.8 were behind the scenes performance improvements, so download the 1.7 . Version 1.9 is in development now. You can see the documentation for it at http://resources.openmrs.org/doc . The API docs often have some helpful examples at the beginning of class descriptions. You might also take a look at org.openmrs.api.context.Context . Browse all the services called getXYZService() . These services have the "big picture" methods that show you what kinds of things you can save or search for. Finally, the unit tests are an excellent way to see how to call the API. The OpenMRS source code is at https://source.openmrs.org/changelog/~br=trunk/OpenMRS . For your own unit tests, if you need to test things with API calls or have a database populated with OpenMRS objects, make your JUnit classes extend the BaseContextSensitive class. Details at https://wiki.openmrs.org/display/docs/Unit+Tests . Cheers- Janet -- View this message in context: http://openmrs-mailing-list-archives.1560443.n2.nabble.com/OpenMRS-Dev-Forum-tp6882651p6884428.html Sent from the Developers mailing list archive at Nabble.com. _________________________________________ To unsubscribe from OpenMRS Developers' mailing list, send an e-mail to [email protected] with "SIGNOFF openmrs-devel-l" in the body (not the subject) of your e-mail. [mailto:[email protected]?body=SIGNOFF%20openmrs-devel-l]
