SOAP Action updateCollection

The updateCollection action creates and updates collections for your source account. Resources can then be uploaded as parts of those collections. The main purpose of collections is to assist in having unique names among your resources as well as providing template URLs for your resource links.

updateCollection Parameters
name	The name of the resource. Most characters are allowed. Some HTML tags are allowed but we recommend that you only use <sub> and <sup>. For updates this is used as the identifying field.
displayname	The name displayed for the collection
urltemplate	The template for generating URLs for the resources contained within this collection. All characters will be taken literally except {, }, and values within them. Generally you will have {internal_id} which will be replaced by the internal id of the resource. This field is optional.

updateCollection Result Fields
action	The action taken on the collection.
name	The of the collection effected by the action.

It is recommended for now that you do not cache the WSDL locally as it can change often in while we are developing and we have had issues with the new WSDL not replacing the cached version. Also compression should be enabled. For more detailed information you can find the action in the WSDL and the dkcoin.xsd Below are code samples you can view in PHP, C#, Java, or All

// The dkCOIN class is automatically created by Visual Studio to
// represent the dkCOIN SOAP Service.
// The webservice object is an instance of the dkCOIN class.

/// 

/// Updates a Collection
/// 
/// string object
/// string object
/// string object
/// string object
/// string object - action result
public virtual string UpdateCollection(string source_id, string name, string displayname, string urltemplate)
{
    dkCOIN.typeCollection[] collections = new dkCOIN.typeCollection[1];
    dkCOIN.typeCollection collection = new dkCOIN.typeCollection();

    collection.displayname = displayname;
    collection.name = name;
    collection.urltemplate = urltemplate;
    collections[0] = collection;

    try
    {
        dkCOIN.typeCollectionResult[] results = new dkCOIN.typeCollectionResult[1];
        StartSession();
        results = webservice.updateCollection(collections);
        EndSession();
        string action = results[0].action;
        bool inserted = action.ToLower().StartsWith("inserted");
        return action + ": " + name + (!inserted ? " updated " : " inserted ") + "successfully.";
    }
    catch (Exception e)
    {
        EndSession();
        throw new UserErrorException("Error Inserting/Updating DKCoin Collection: " + e.Message);
    }
}

Java Code coming soon.

The SOAP request will look similar to the following.

The SOAP response will look similar to the following.

If an error occurs a SOAP Fault should be generated and returned to you. The fault will likely throw a similar error that you can catch. Most errors should be handled gracefully but will result in a PHP error dump being returned as the SOAP Fault message. Currently all errors are of code 'Sender'. The actor, detail, name, and header values of the error are currently set as their field names until we decide what to populate in those values.