A group attribute stores one value for all members of a group. The value is identical for all group members.


It is not possible to import group attributes in an XML file that is used for contact data import. Group attributes must be imported in a separate XML file.

The files should not contain more than 1000 attributes. The attribute files can only have the data type string. Each attribute has a limit of 2000 characters per value. The file cannot include null (empty) values.

Element and attribute names are normally case-sensitive in XML files. Mapp Engage performs a case-insensitive comparison of attribute names in the XML file to the existing attributes in your system during import. This comparison prevents the creation of new attributes with different capitalization.

Basic File Structure​

Use the following guidelines when you format your XML file.

Component

Description

XML Declaration and Encoding​

The first line of your file specifies the XML version and character encoding in the file.

​Tags​

The elements in an XML file are marked with a start tag (<elementname>) and an end tag (</elementname>).

XML Elements​

Group attributes are enclosed in elements that tell Mapp Engage where to store the information. These elements are:

  • groupattributes: Contains all of the group attribute data in the import file. This element includes space for the XML namespace attribute. In this attribute, you refer to the Mapp web services URI, which contains definitions for all the elements in the file.
    The XML namespace attribute is xmlns="http://webservices.ecircle-ag.com/ecm".

  • groupattribute: Contains the definitions for a single group attribute.

  • name: Defines the name of the group attribute.

  • value: Defines the value to store in the group attribute.

Replace the encoding in the sample code with the encoding that matches the characters in your input file. Select the correct character encoding on the interface when you import the file.


Element and attribute names are normally case-sensitive in XML files. Mapp Engage performs a case-insensitive comparison of attribute names in the XML file to the existing attributes in your system during import. This comparison prevents the creation of new attributes with different capitalization.

The following sample shows the correct nesting for all elements in an XML file for group attribute import.

Sample XML Structure

<groupattributes xmlns="http://webservices.ecircle-ag.com/ecm"> 
    <groupattribute> 
        <name>Flight</name>
        <value>Frankfurt - Paris €299</value> 
    </groupattribute> 
    <groupattribute> 
        <name>Hotel</name>
        <value>SuperFrenchLuxuryHotelChain</value>
    </groupattribute>
    <groupattribute> 
        <name>Destination</name> 
        <value>Explore Paris!</value>
    </groupattribute> 
</groupattributes>
XML
  • If a group attribute with that name exists in the group, Mapp Engage updates the value of the existing attribute.
  • If a group attribute with that name does not exist in the group, Mapp Engage creates a group attribute.

Group Attribute Imports​

You can import your XML file into Mapp Engage in the ​Group Attribute Import​ window. For instructions, see ​Import Group Attributes​.