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.

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/person/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. 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/"/>
    <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. Where can I find the sourcecode for this module?