Setup your XML to SharerPoint connection
With the Cloud Connector Connection
Manager (a MMC snap-in) you have to setup:
1. the connection (e.g. uni-directional with overwrite,
2. the data source (your XML file or web request) and
3. the data destination (in SharePoint on-premise,
SharePoint Online or Office 365. The list must be created manually before).
You can use auto mapping to connect the fields of both data entities by name
or map fields manually.
See here for sample connection settings:
Fig.: Sample XML to Office 365 one-way connection.
- Bi-directional connections are not supported for XML data sources at this
- If overwrite destination is enabled, non-matching entries in the destination
are removed with initial sync.
- Please enable scheduling later on, when all settings are verified and you
have an idea of replication duration. Duration time depends on bandwidth,
performance of source and destination, and number of entries in XML. Only
changes are transferred later on.
Before running the connection, you have to define the data source and
Fig.: The Layer2 XML Provider is used to connect to the data source, e.g. an XML
- Select the Layer2 XML Provider
- Enter the file path or URL to your XML data as connection string.
- The provider offers a XPath-based query language to select your data subset
from the XML data source after the FROM keyword in the select statement.
Please read more about XPath here.
- You can optionally select named attributes with the select statement, e.g.
"Select TITLE, COUNTRY, ...)
- Use the data preview to check out the result of your Xpath query. You can
use any 3rd party XPath tool to test.
- You have to enter a "primary key", some column with unique values in your
- Please verify all settings before save.
Next you have to define your data destination:
Fig.: Data destination sample, a list
"XML" in the Office 365 cloud.
- Use the Layer2 SharePoint CSOM Provider to connect to SharePoint on-premise,
SharePoint Online or Office 365.
- You have to create the destination list manually with all columns required
to host your query data.
- Read more about connection strings to connect to Office 365, SharePoint
Online or SharePoint on-premise here. Please note that you can connect to any
other data destination, e.g. to a SQL database.
- There is no need to enter a primary key, the provider automatically uses the
SharePoint item ID.
As a last step you have to setup the column / field mapping. You can use the
auto-mapping feature (by field / column names) or map manually.
Fig.: Sample field / column mapping
of data source and data destination.
If all settings are verified, please go to connection root and run the
connection manually first. Please note, that it could take some time to transfer
all nodes. You can take a look in your cloud list to see how it goes on.