{"type":"doc","content":[{"type":"panel","attrs":{"panelType":"warning"},"content":[{"type":"paragraph","content":[{"text":"This page is outdated and no longer receives updates!","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"paragraph","content":[{"text":"There are certain address layouts that come with OpenMRS right now, they are: general, kenya, lestho, malawi, rwanda, tanzania, usa . ","type":"text"}]},{"type":"paragraph","content":[{"text":"You can modify the ","type":"text"},{"text":"layout.address.format","type":"text","marks":[{"type":"strong"}]},{"text":" ","type":"text"},{"text":"setting ","type":"text","marks":[{"type":"link","attrs":{"href":"https://wiki.openmrs.org/h"}}]},{"text":"(formerly global property from platform 1.8 downwards) to one of those values or to the \"codeName\" of a new custom layout (instructions below) to see a different address/location layout on the new patient screen and location editor.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Adding a new address layout","type":"text"}]},{"type":"paragraph","content":[{"text":"Address layouts are stored in the openmrs-servlet.xml file. You can find this file in ","type":"text"},{"text":"tomcathome/webapps/openmrs/WEB-INF/lib/openmrs-web...jar/openmrs-servlet.xml","type":"text","marks":[{"type":"strong"}]},{"text":" .","type":"text"}]},{"type":"paragraph","content":[{"text":"In the ","type":"text"},{"text":"","type":"text","marks":[{"type":"strong"}]},{"text":" .","type":"text"}]},{"type":"paragraph","content":[{"text":"Now after the next ","type":"text"},{"text":"","type":"text","marks":[{"type":"em"}]},{"text":" tag, add:","type":"text"}]},{"type":"codeBlock","content":[{"text":"\n\t\tMy custom address layout format\n\t\tcustom\n\t\tMy Country Name\n\t\t\n\t\t\t\n\t\t\t\tLocation.postalCode\n\t\t\t\tLocation.stateProvince\n\t\t\t\tLocation.cityVillage\n\t\t\t\tLocation.address1\n\t\t\t\tLocation.address2\n\t\t\t\tLocation.longitude\n\t\t\t\tLocation.latitude\n\t\t\t\tLocation.country\n\t\t\t\tLocation.district\n\t\t\t\tLocation.cell\n\t\t\t\tLocation.sublocation\n\t\t\t\tLocation.location\n\t\t\t\n\t\t\n\t\t\n\t\t\t\n\t\t\t\t10\n\t\t\t\t10\n\t\t\t\t10\n\t\t\t\t40\n\t\t\t\t40\n\t\t\t\t10\n\t\t\t\t10\n\t\t\t\t10\n\t\t\t\n\t\t\n\t\t\n\t\t\t\n\t\t\t\taddress1\n\t\t\t\taddress2\n\t\t\t\tcityVillage stateProvince country postalCode\n\t\t\t\tlatitude longitude\n\t\t\t\n\t\t\n\t\n","type":"text"}]},{"type":"paragraph","content":[{"text":"Change the nameMappings, sizeMappings, and lineByLineFormat elements however you like. Restart Tomcat to use the new address.","type":"text"}]},{"type":"paragraph","content":[{"text":"e.g. if you want to rename the \"cityVillage\" field, you change ","type":"text"},{"text":"Location.cityVillage","type":"text","marks":[{"type":"strong"}]},{"text":" to ","type":"text"},{"text":"Location.city","type":"text","marks":[{"type":"strong"}]},{"text":" or even to ","type":"text"},{"text":"What's your city:","type":"text","marks":[{"type":"strong"}]},{"text":". (see ","type":"text"},{"text":"messages.properties","type":"text","marks":[{"type":"link","attrs":{"href":"http://source.openmrs.org/browse/OpenMRS/trunk/webapp/src/main/webapp/WEB-INF/messages.properties?r=HEAD#l848"}}]},{"text":" file for available translation elements)","type":"text"}]},{"type":"paragraph","content":[{"text":"e.g. if you want to not show latitude/longitude, you delete the lineByLineFormat line: ","type":"text"},{"text":"latitude longitude","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"e.g. if you want to have a longer address1 line, you modify ","type":"text"},{"text":"40","type":"text","marks":[{"type":"strong"}]},{"text":" to be ","type":"text"},{"text":"80","type":"text","marks":[{"type":"strong"}]}]},{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"paragraph","content":[{"text":"These changes will be persisted across restarts, but will NOT be persisted across upgrades. You will have to redo this every time you upgrade openmrs to a new version","type":"text"}]}]},{"type":"panel","attrs":{"panelType":"note"},"content":[{"type":"paragraph","content":[{"text":"Note: This functionality will change in OpenMRS 1.9+. Please see ","type":"text"},{"text":"the documentation on Address Templates","type":"text","marks":[{"type":"link","attrs":{"href":"https://openmrs.atlassian.net/wiki/spaces/docs/pages/25471961"}}]},{"text":".","type":"text"}]}]}],"version":1}

Browser not supported