{"type":"doc","content":[{"type":"panel","attrs":{"panelType":"note"},"content":[{"type":"paragraph","content":[{"text":"This is a feature in OpenMRS 1.9+","type":"text"}]}]},{"type":"paragraph","content":[{"text":"It is possible to configure the fields that appear in the UI and their names, the text box sizes as well as the order they appear in. The configuration instructions on this page tell how to do it.","type":"text"}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Managing Address Templates","type":"text"}]},{"type":"paragraph","content":[{"text":"To get to the address configuration page in OpenMRS you can go to Administration (or System Administration --> Advanced Administration in the Reference Application) --> Manage Address Template.","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":65.0},"content":[{"type":"media","attrs":{"width":1256,"id":"09311f4e-793b-4e89-ad0f-3bc04bfd1d35","collection":"contentId-25471961","type":"file","height":684}}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Templates/Examples","type":"text"}]},{"type":"paragraph","content":[{"text":"Some example OpenMRS address templates are provided here. You can copy a preferred Address Template from this page and paste into the \"Manage Address Template\" text box. Feel free to customize to your liking as seen in the screenshot above.","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Administering Address Templates#General","type":"text","marks":[{"type":"link","attrs":{"href":"#AdministeringAddressTemplates-General"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Administering Address Templates#Kenya","type":"text","marks":[{"type":"link","attrs":{"href":"#AdministeringAddressTemplates-Kenya"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Administering Address Templates#Lesotho","type":"text","marks":[{"type":"link","attrs":{"href":"#AdministeringAddressTemplates-Lesotho"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Administering Address Templates#Malawi","type":"text","marks":[{"type":"link","attrs":{"href":"#AdministeringAddressTemplates-Malawi"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Administering Address Templates#Rwanda","type":"text","marks":[{"type":"link","attrs":{"href":"#AdministeringAddressTemplates-Rwanda"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Administering Address Templates#Spain","type":"text","marks":[{"type":"link","attrs":{"href":"#AdministeringAddressTemplates-Spain"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Administering Address Templates#Tanzania","type":"text","marks":[{"type":"link","attrs":{"href":"#AdministeringAddressTemplates-Tanzania"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Administering Address Templates#USA","type":"text","marks":[{"type":"link","attrs":{"href":"#AdministeringAddressTemplates-USA"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Administering Address Templates#Chile","type":"text","marks":[{"type":"link","attrs":{"href":"#AdministeringAddressTemplates-Chile"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Administering Address Templates#Nepal","type":"text","marks":[{"type":"link","attrs":{"href":"#AdministeringAddressTemplates-Nepal"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Administering Address Templates#Haiti","type":"text","marks":[{"type":"link","attrs":{"href":"#AdministeringAddressTemplates-Haiti"}}]}]}]}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Customizing Templates","type":"text"}]},{"type":"paragraph","content":[{"text":"You can also build your own templates.","type":"text"}]},{"type":"paragraph","content":[{"text":"First according to your need, select some address attribute from the table below,","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":1800.0,"localId":"5d2c5928-8e68-40e5-8f36-7b4fb0b977a7"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Attribute type","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"XML Snippet","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"address1","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"address2","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"address3","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"address4","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"address5","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"address6","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"cityVillage","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"countyDistrict","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"stateProvince","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"country","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"latitude","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"longitude","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"postalCode","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"startDate","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"endDate","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"","type":"text"}]}]}]}]},{"type":"paragraph","content":[{"text":"Add these attributes XML in the following format,","type":"text"}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"\n \n \n\t ... others\n \t\n","type":"text"}]},{"type":"paragraph","content":[{"text":"Now define the character size for each of the attribute you selected. ","type":"text"},{"text":"This is the","type":"text","marks":[{"type":"textColor","attrs":{"color":"#222222"}}]},{"text":" visible width, in characters, of the input element.","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]},{"type":"hardBreak"},{"text":"name = Attribute name","type":"text"},{"type":"hardBreak"},{"text":"value = Number of characters","type":"text"},{"type":"hardBreak"},{"text":"E.g.","type":"text"}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"\n \n \n\t ... others\n\t\n","type":"text"}]},{"type":"paragraph","content":[{"text":"Next, design the layout for your Address Template.","type":"text"},{"type":"hardBreak"},{"text":"This defines the relative positions of the address attributes to one another","type":"text"}]},{"type":"paragraph","content":[{"text":"E.g.","type":"text"}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"\n address1\n address2\n cityVillage stateProvince country postalCode\n latitude longitude\n startDate endDate\n\t\n","type":"text"}]},{"type":"paragraph","content":[{"text":"(Optional)","type":"text","marks":[{"type":"strong"},{"type":"em"}]},{"text":" You can add default values to the attributes as below,","type":"text"},{"type":"hardBreak"},{"text":"E.g.","type":"text"}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"\n \n ...\n \n","type":"text"}]},{"type":"paragraph","content":[{"text":"(Optional) ","type":"text","marks":[{"type":"strong"},{"type":"em"}]},{"text":"You can define which fields are required (since Platform 2.0)","type":"text","marks":[{"type":"em"}]}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"\n address1\n ...\n \n","type":"text"}]},{"type":"paragraph"},{"type":"paragraph","content":[{"text":"(Optional)","type":"text","marks":[{"type":"strong"},{"type":"em"}]},{"text":" You can define regular expressions to validate input, and also help the user by giving input suggestions","type":"text"}]},{"type":"paragraph","content":[{"text":"E.g.","type":"text"},{"type":"hardBreak"},{"text":" Regular expressions for validation;","type":"text"}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"\n \n \n ...\n \n","type":"text"}]},{"type":"paragraph","content":[{"text":"Input suggestions; These can be used to display an example format that an element should look like.","type":"text"}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"\n \n \n ...\n \n","type":"text"}]},{"type":"paragraph","content":[{"text":"Finally bundle all the above XMLs as shown below,","type":"text"}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"\n \n \n\t ...\n \n \n \n ...\n \n \n address1\n address2\n ...\n \n ...\n ...\n \n","type":"text"}]},{"type":"paragraph","content":[{"text":"For further clarification please go through the samples below,","type":"text"}]},{"type":"paragraph","content":[{"type":"inlineExtension","attrs":{"extensionType":"com.atlassian.confluence.macro.core","extensionKey":"anchor","parameters":{"macroParams":{"":{"value":"General"},"legacyAnchorId":{"value":"AdministeringAddressTemplates-General"}},"macroMetadata":{"macroId":{"value":"e4611c24-4fb6-42f2-871c-b88c7d863666"},"schemaVersion":{"value":"1"},"title":"Anchor"}},"localId":"82493f18-e632-4633-8737-67c2219a4d5a"}}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"General Address Template","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n address1\n address2\n cityVillage stateProvince country postalCode\n latitude longitude\n startDate endDate\n \n ","type":"text"}]},{"type":"paragraph","content":[{"type":"inlineExtension","attrs":{"extensionType":"com.atlassian.confluence.macro.core","extensionKey":"anchor","parameters":{"macroParams":{"":{"value":"Kenya"},"legacyAnchorId":{"value":"AdministeringAddressTemplates-Kenya"}},"macroMetadata":{"macroId":{"value":"7589d106-24aa-45f8-ae77-778b1af55d09"},"schemaVersion":{"value":"1"},"title":"Anchor"}},"localId":"efc4eb09-b155-4b0b-a3b6-402e2628dc25"}}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"Address Template for Kenya","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n address1\n address2\n address3 cityVillage\n address5 address6\n address4 countyDistrict\n stateProvince postalCode\n latitude longitude\n country\n \n ","type":"text"}]},{"type":"paragraph","content":[{"type":"inlineExtension","attrs":{"extensionType":"com.atlassian.confluence.macro.core","extensionKey":"anchor","parameters":{"macroParams":{"":{"value":"Lesotho"},"legacyAnchorId":{"value":"AdministeringAddressTemplates-Lesotho"}},"macroMetadata":{"macroId":{"value":"35e55a3b-ecd4-4ead-b8ce-d8021146b39e"},"schemaVersion":{"value":"1"},"title":"Anchor"}},"localId":"408308c2-f804-4f92-bc9f-c76a2bbfbc44"}}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"Address Template for Lesotho","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"\n \n \n \n \n \n \n \n \n \n \n \n \n countyDistrict\n cityVillage\n \n ","type":"text"}]},{"type":"paragraph","content":[{"type":"inlineExtension","attrs":{"extensionType":"com.atlassian.confluence.macro.core","extensionKey":"anchor","parameters":{"macroParams":{"":{"value":"Malawi"},"legacyAnchorId":{"value":"AdministeringAddressTemplates-Malawi"}},"macroMetadata":{"macroId":{"value":"3a8ffd2c-80ec-4e12-bd99-33532eeaec0a"},"schemaVersion":{"value":"1"},"title":"Anchor"}},"localId":"6b6adda4-b0c0-4131-a834-4c057f98758e"}}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"Address Template for Malawi","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n address1\n address3\n cityVillage\n countyDistrict\n stateProvince\n \n ","type":"text"}]},{"type":"paragraph","content":[{"type":"inlineExtension","attrs":{"extensionType":"com.atlassian.confluence.macro.core","extensionKey":"anchor","parameters":{"macroParams":{"":{"value":"Rwanda"},"legacyAnchorId":{"value":"AdministeringAddressTemplates-Rwanda"}},"macroMetadata":{"macroId":{"value":"4b7cf330-1297-480a-8706-2636a0fda40f"},"schemaVersion":{"value":"1"},"title":"Anchor"}},"localId":"5ebd0271-0193-4319-b497-63beb5002181"}}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"Address Template for Rwanda","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n stateProvince\n countyDistrict\n cityVillage\n address3\n address1\n \n ","type":"text"}]},{"type":"paragraph","content":[{"type":"inlineExtension","attrs":{"extensionType":"com.atlassian.confluence.macro.core","extensionKey":"anchor","parameters":{"macroParams":{"":{"value":"Spain"},"legacyAnchorId":{"value":"AdministeringAddressTemplates-Spain"}},"macroMetadata":{"macroId":{"value":"0aa74e97-bd60-444b-ba30-1097378c9ead"},"schemaVersion":{"value":"1"},"title":"Anchor"}},"localId":"407af08d-0e7c-441c-83bc-80b6fdc1236d"}}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"Address Template for Spain","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n address1\n address2\n cityVillage stateProvince country postalCode\n latitude longitude\n \n ","type":"text"}]},{"type":"paragraph","content":[{"type":"inlineExtension","attrs":{"extensionType":"com.atlassian.confluence.macro.core","extensionKey":"anchor","parameters":{"macroParams":{"":{"value":"Tanzania"},"legacyAnchorId":{"value":"AdministeringAddressTemplates-Tanzania"}},"macroMetadata":{"macroId":{"value":"649d48f7-724b-4b13-bdc4-7a06555b95eb"},"schemaVersion":{"value":"1"},"title":"Anchor"}},"localId":"5e38a747-23d9-44ac-87d9-ba128b54db93"}}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"Address Template for Tanzania","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"\n \n \n \n \n \n \n \n \n \n \n \n \n \n cityVillage\n address5\n countyDistrict\n address6\n \n ","type":"text"}]},{"type":"paragraph","content":[{"type":"inlineExtension","attrs":{"extensionType":"com.atlassian.confluence.macro.core","extensionKey":"anchor","parameters":{"macroParams":{"":{"value":"USA"},"legacyAnchorId":{"value":"AdministeringAddressTemplates-USA"}},"macroMetadata":{"macroId":{"value":"579c55f6-b98f-428a-a1b5-2a30facf673f"},"schemaVersion":{"value":"1"},"title":"Anchor"}},"localId":"20a8ce8c-3be9-4278-af64-cca73facd38c"}}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"Address Template for USA","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n address1\n address2\n cityVillage stateProvince postalCode\n \n ","type":"text"}]},{"type":"paragraph","content":[{"type":"inlineExtension","attrs":{"extensionType":"com.atlassian.confluence.macro.core","extensionKey":"anchor","parameters":{"macroParams":{"":{"value":"Chile"},"legacyAnchorId":{"value":"AdministeringAddressTemplates-Chile"}},"macroMetadata":{"macroId":{"value":"ee453ace-03c5-4982-adca-100d31780cec"},"schemaVersion":{"value":"1"},"title":"Anchor"}},"localId":"71cc3eb3-8985-40dd-8284-ba319621f55b"}}]},{"type":"paragraph"},{"type":"heading","attrs":{"level":5},"content":[{"text":"Address Template for Chile","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","attrs":{"language":"html/xml"},"content":[{"text":"\n \n \n \n \n \n \n \n\t\t\t\n\t \t\n \n \n \n \n \n \n \n \n \n \n \n \n \n\t\t\taddress1 address2 address3\n\t\t\tcityVillage countyDistrict stateProvince country postalCode\n \n ","type":"text"}]},{"type":"paragraph","content":[{"type":"inlineExtension","attrs":{"extensionType":"com.atlassian.confluence.macro.core","extensionKey":"anchor","parameters":{"macroParams":{"":{"value":"Nepal"},"legacyAnchorId":{"value":"AdministeringAddressTemplates-Nepal"}},"macroMetadata":{"macroId":{"value":"3b745652-e51b-4844-a12c-c5ebdb5ad04c"},"schemaVersion":{"value":"1"},"title":"Anchor"}},"localId":"7c066fc6-5692-4115-a1a6-9bc06e3a7523"}}]},{"type":"paragraph"},{"type":"heading","attrs":{"level":5},"content":[{"text":"Address Template for Nepal","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"\n \n \n \n\t \n \n \n \n \n \n \n \n \n \n \n\t \n \n \n \n \n \n \n \n\t\n \n\t\n \n stateProvince countyDistrict\n\t cityVillage address3\n\t address4 address5\n country\n \n ","type":"text"}]},{"type":"paragraph","content":[{"type":"inlineExtension","attrs":{"extensionType":"com.atlassian.confluence.macro.core","extensionKey":"anchor","parameters":{"macroParams":{"":{"value":"Haiti"},"legacyAnchorId":{"value":"AdministeringAddressTemplates-Haiti"}},"macroMetadata":{"macroId":{"value":"18204570-8314-4264-8686-a140cb557313"},"schemaVersion":{"value":"1"},"title":"Anchor"}},"localId":"309e184c-054c-408c-99a5-7aec39462639"}}]},{"type":"paragraph"},{"type":"heading","attrs":{"level":5},"content":[{"text":"Address Template for Haiti","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n country\n stateProvince\n cityVillage\n countyDistrict\n address1\n address2\n \n","type":"text"}]},{"type":"paragraph","content":[{"text":"Snippet","type":"text","marks":[{"type":"em"}]}]}],"version":1}

Browser not supported