Skip to content

How do I import activities form a XML file ?

Kiran Shrestha edited this page Mar 10, 2017 · 6 revisions

Currently, AidStream supports XML for IATI version "1.03" , "1.05", "2.01" and "2.02". Please make sure your activities are any one of these mentioned version.

Uploading the XML file

  • Hover on 'Add Activity' and click on 'Import Activity XML'.
  • Choose the XML file and click on upload button.

import-xml-step1

Once the Xml file is uploaded, it will be sent to the queue and processed.

Status of Activities Being Imported

If the xml file is valid, then the status of activity being imported is displayed.

xml-import-status

While the activities are being imported, users can perform other tasks in AidStream. If the site is refreshed, then the list of the imported activities can be seen.

Failed Activities

The activities whose IATI identifier is already present in AidStream are not imported. It means that if you already have an activity with IATI Identifier (AA-AAA-123-ABC) in AidStream and if same IATI identifier is present in XML, then the activity with the identifier is not imported from xml.

Identifying Xml Imported Activities

The activities that are imported from the xml have red warning icon besides its title.

4

Xml Imported Activities

All the xml imported activities are mapped to the latest version of IATI standard (currently 2.02).The imported activities might not have fulfilled the standard of latest version so the imported activities cannot be taken into completed, verified or published state.

1

The data which has been deprecated or is invalid for the latest version are skipped. Most of the time, users have to enter the data which are required in the latest version but not present in the imported version. To help users enter those data, AidStream will display the list of the elements along the description messages(data that are missing or invalid). Clicking on the message will redirect them to the form where you can enter/correct the value.

2

Once the data is corrected then the activity can be taken to completed, verified and published state.

Malformed XML

If the uploaded xml file doesn't validate with xml schema, then the users are redirected to page where schema errors are displayed. The line where errors are present is highlighted.

3

Having Trouble Importing Activities from XML

If you have any queries or issues in importing activities from xml, then please shoot us an email at [email protected]. Also, please attach the xml file you were trying to upload.

Clone this wiki locally