MAPI Manual

NAME

ADD_CONTACTGROUP_LOAD_CONTACTS

FUNCTION

Add contact group and load contacts

SYNOPSIS

contactbook_id, contactgroup_name, contactgroup_type, description, field_map, delimiter, firstlineistitle, contact_file

DESCRIPTION

This function allows users to add a contact group and load contacts into this group.

Required Parameters

* action: ADD_CONTACTGROUP_LOAD_CONTACTS.
* contactbook_id: ID of the contact book.
* contactgroup_name: name of the contact group.
* field_map: the mapping of the columns between the contacts file and the contact group. An example value is '1_2,2_1,3_3'. Within this value, '1_2' means the second column within the contacts file maps to the first column within the contact group.
* delimiter: the delimiter of the columns within the contacts file, e.g., " , " (comma), " ; " (semicolon).
* firstlineistitle: value is '1' or '0'. '1' means the first line within the contacts file contains the titles of the columns; otherwise, the value is '0'.
* contact_file: the path of the contacts file.

Optional Parameters

* contactgroup_type: the type of the contact group, e.g., "org_level".
* description: description of the contact group.

RETURN DATA

The response contains the following attribute:
* msg: specifies the contact group has been created successfully and the contacts file has been loaded to the contact group.

ROLE PERMITTED

Manager

EXAMPLES

Below is the sample HTML code:

<html>
    <body>
        <form method="POST" enctype="multipart/form-data"
              action="http://app02.yvntech.com/MapIHttpS/MapIS?action=ADD_CONTACTGROUP_LOAD_CONTACTS">
           
            <p>Login name:<input type="text" name="login_name" value="your_login_name" /></p>
           
            <p>Password:<input type="password" name="login_passwd" value="your_password" /></p>

            <p>Contact book ID:<input type="text" name="contactbook_id" value="1" /></p>
                      
            <p>Contact group name:<input type="text" name="contactgroup_name" value="Demo group" /></p>          
                    
            <p>Contact group type:<input type="text" name="contactgroup_type" value="org_level" /></p>
            
            <p>Group description:<input type="text" name="description" value="Group for demo" /></p>
             
            <p>Field map:<input type="text" name="field_map" value="1_1,2_2,3_3" /></p>
           
            <p>Delimiter:<input type="text" name="delimiter" value="," /></p>
           
            <p>Is first line the title?<input type="text" name="firstlineistitle" value="1" /><p>
           
            <p>Choose file:<input type="file" name="contact_file"/></p>

            <input type="submit" value="Submit" />

        </form>
    </body>
</html>

TIPS

ENVIRONMENT

AUTHOR

YVN Tech

SEE ALSO

ADD_CONTACTGROUP, LOAD_CONTACT_TOCONTACTGROUP

Mweb v2.0 YVNTECH 2014