Documentation

Wiki Spaces

Documentation
Projects
Resources

Get Help from Others

Q&A: Ask OpenMRS
Discussion: OpenMRS Talk
Real-Time: IRC Chat | Slack

Documentation

Page tree
Skip to end of metadata
Go to start of metadata

What this module does

This module exposes all changes to the openmrs system as an atom feed. When a patient/concept/encounter/obs is created/updated/deleted this is logged and added to the list.

Documentation / How-To

Relies on use of the Event Module and REST Module. The Atomfeed module hooks into events in openmrs via the Event module. The atomfeed module provides links back to the object changed as webservices.rest urls.

current source code: https://github.com/openmrs/openmrs-module-atomfeed

You can access the atom feed servlet using this suffix in your url: /moduleServlet/atomfeed/atomfeed
e.g.

http://localhost:8080/openmrs/moduleServlet/atomfeed/atomfeed

Or you can optionally supply an asOfDate to limit feed items to only those on or after the given date:

http://localhost:8080/openmrs/moduleServlet/atomfeed/atomfeed?asOfDate=2012-05-22

Example atom feed:

<?xml version="1.0" encoding="UTF-8"?>
<feed>
	<title>OpenMRS Updates</title>
	<link href="http://localhost:8080/openmrs/atomfeed" rel="self" />
	<link href="http://localhost:8080/openmrs/" />
	<id>urn:uuid:6091b958-88b8-11e1-956f-002713b61fda</id>
	<updated>2012-05-31T08:35:48-04:00</updated>
	<versionId>1338467748209</versionId>
	<entriesSize>1852</entriesSize>
	<entry>
		<title>create:org.openmrs.Patient</title>
		<link
			href="http://localhost:8080/openmrs/ws/rest/v1/patient/4961c2e4-130e-49d7-82af-2b02e3f38fc2" />
		<id>urn:uuid:4961c2e4-130e-49d7-82af-2b02e3f38fc2</id>
		<updated>2012-05-31T08:35:48-04:00</updated>
		<author>
			<name>Admin Admin (admin)</name>
		</author>
		<summary>Patient -- create</summary>
		<classname>org.openmrs.Patient</classname>
		<action>create</action>
	</entry>
	<entry>
		<title>update:org.openmrs.Concept</title>
		<link
			href="http://localhost:8080/openmrs/ws/rest/v1/concept/dd16c0d9-7abd-497f-9217-6f43fcb00550" />
		<id>urn:uuid:dd16c0d9-7abd-497f-9217-6f43fcb00550</id>
		<updated>2012-05-31T08:31:52-04:00</updated>
		<author>
			<name>Admin Admin (admin)</name>
		</author>
		<summary>Concept -- update</summary>
		<classname>org.openmrs.Concept</classname>
		<action>update</action>
	</entry>
	<entry>
		<title>update:org.openmrs.Concept</title>
		<link href="" />
		<id>urn:uuid:be491b08-1691-11df-97a5-7038c432aabf</id>
		<updated>2012-05-29T08:53:16-04:00</updated>
		<author>
			<name>Super User (admin)</name>
		</author>
		<summary>Concept -- update</summary>
		<classname>org.openmrs.Concept</classname>
		<action>update</action>
	</entry>
</feed>

Downloads

https://addons.openmrs.org/#/show/org.openmrs.module.atomfeed

Release Notes

TBD after the module release

About

This module was developer by Ben Wolfe for Andy Kanter. It is used by the MoTech app to be notified of changes

3 Comments

  1. user-112b6

    I have installed this module but I wasn't able view any of the updates, whenever I make a change I get this message on the console: "unable to create entry string for: Patient#3"

    The XML output is like this:

    <feed>
    <title>OpenMRS Updates</title>
    <link href="NEED-TO-CONFIGURE/atomfeed" rel="self"/>
    <link href="NEED-TO-CONFIGURE/"/>
    <id>urn:uuid:6091b958-88b8-11e1-956f-002713b61fda</id>
    <updated>2013-08-27T22:58:09+03:00</updated>
    <versionId>1377633489404</versionId>
    <entriesSize>10</entriesSize>
    </feed>

    I would appreciate it if you help me out on this.

  2. Vinay Venu

    Where can I find the sourcecode for this module? 

  3. Daniel Kayiwa

    Vinay Venu do you mean this? http://svn.openmrs.org/openmrs-modules/atomfeed/

Feedback on this page? Questions?

Visit OpenMRS Talk, our community discussion hub.

Copyright © 2004-2016 OpenMRS Inc. By using this site, you agree to the OpenMRS Privacy Policy.
Text is available under the Creative Commons 4.0 International Attribution License (CC BY 4.0).
Software is available under the Mozilla Public License 2.0 with Healthcare Disclaimer (MPL 2.0 HD).
"OpenMRS" is a registered trademark and the OpenMRS graphic logo is a trademark of OpenMRS Inc.