Getting Started

There are 3 main blocks/components of a viable XML File:

The upload process works in succession, i.e categories get imported first, followed by custom forms and custom form fields, and lastly, reports. 

Guidelines and How to Upload XML

General

Category import

Custom Forms import

Reports

 

<?xml version="1.0" encoding="UTF-8"?>
<UshahidiReports>
	<categories>
		<category color="9900CC" visible="1" trusted="0">
			<title>Category 1</title>
			<description>Category 1</description>
			<translations>
				<translation locale="ja_JP">
					<translation_title>カテゴリー1</translation_title>
					<translation_description>カテゴリー1</translation_description>
				</translation>
				<translation locale="zh_CN">
					<translation_title>第1类</translation_title>
					<translation_description>第1类</translation_description>
				</translation>
			</translations>
		</category>
		<category color="3300FF" visible="1" trusted="0">
			<title>Category 2</title>
			<description>Category 2</description>
		</category>
		<category color="663300" visible="1" trusted="0">
			<title>Category 3</title>
			<description>Category 3</description>
		</category>
		<category color="339900" visible="1" trusted="1">
			<title>Trusted Reports</title>
			<description>Reports from trusted reporters</description>
		</category>
		<category color="9900CC" visible="1" trusted="0">
			<title>Sample child</title>
			<description>Sample Child category</description>
			<parent>Category 1</parent>
		</category>
	</categories>
	<custom_forms>
		<form active="1">
			<title>Default Form</title>
			<description>Default form, for report entry</description>
			<field type="1" required="0" visible_by="0" submit_by="0" datatype="email" hidden="0">
				<name>Sample email field</name>
			</field>
		</form>
		<form active="1">
			<title>Sample Form</title>
			<description>A sample form</description>
			<field type="5" required="0" visible_by="0" submit_by="0">
				<name>Sample field 2</name>
				<default>a, b, c</default>
			</field>
		</form>
	</custom_forms>
	<reports>
		<report id="1" approved="1" verified="1" form_name="Sample Form" mode="1">
			<title>Sample report 2</title>
			<date>2012-04-04 12:54:00</date>
			<dateadd>2012-12-07 13:52:26</dateadd>
			<location>
				<name>Nairobi</name>
				<longitude>36.821451</longitude>
				<latitude>-1.2873</latitude>
			</location>
			<description>This is a second sample report on the form "sample form"</description>
			<report_categories>
				<category>Category 2</category>
			</report_categories>
			<custom_fields>
				<field name="Sample field 2">a</field>
			</custom_fields>
			<personal_info>
				<first_name>John</first_name>
				<last_name>John</last_name>
				<email>john@doe.com</email>
			</personal_info>
			<media>
				<item type="4" active="1" date="2012-12-07 14:39:33">http://ushahidi.com</item>
				<item type="2" active="1" date="2012-12-07 14:39:33">http://www.youtube.com/watch?v=EhT3co2qNAA</item>
			</media>
		</report>
		<report id="2" approved="1" verified="1" form_name="Default Form" mode="1">
			<title>Sample Report</title>
			<date>2012-12-07 13:26:00</date>
			<dateadd>2012-12-07 13:28:12</dateadd>
			<location>
				<name>sample location</name>
				<longitude>36.821451</longitude>
				<latitude>-1.2873</latitude>
			</location>
			<description>This is a sample report</description>
			<report_categories>
				<category>Sample child</category>
			</report_categories>
			<custom_fields>
				<field name="Sample email field">john@doe.com</field>
			</custom_fields>
			<personal_info>
				<first_name>Angela</first_name>
				<last_name>Angela</last_name>
				<email>angela@ushahidi.com</email>
			</personal_info>
			<media>
				<item type="4" active="1" date="2012-12-07 13:56:09">http://ushahidi.com</item>
				<item type="2" active="1" date="2012-12-07 13:56:09">http://www.youtube.com/watch?v=EhT3co2qNAA</item>
			</media>
		</report>
	</reports>
</UshahidiReports>