--- a/artifacts-common/src/main/java/de/intevation/artifacts/common/utils/ClientProtocolUtils.java	Thu Apr 28 10:30:30 2011 +0000
+++ b/artifacts-common/src/main/java/de/intevation/artifacts/common/utils/ClientProtocolUtils.java	Thu May 12 09:06:34 2011 +0000
@@ -351,6 +351,26 @@
      * @return the request document.
      */
     public static Document newOutCollectionDocument(String uuid, String type) {
+        return newOutCollectionDocument(uuid, type, null);
+    }
+
+
+    /**
+     * This function builds a document that is used as request document of the
+     * out() operation of Collections. The document <i>attr</i> might be used to
+     * adjust some settings specific to the output.
+     *
+     * @param uuid The identifier of the collection.
+     * @param type The name of the desired output type.
+     * @param attr A document that contains settings specific to the output.
+     *
+     * @return the request document.
+     */
+    public static Document newOutCollectionDocument(
+        String   uuid,
+        String   type,
+        Document attr)
+    {
         Document doc = XMLUtils.newDocument();
 
         XMLUtils.ElementCreator cr = new XMLUtils.ElementCreator(
@@ -358,13 +378,23 @@
             ArtifactNamespaceContext.NAMESPACE_URI,
             ArtifactNamespaceContext.NAMESPACE_PREFIX);
 
-        Element action = cr.create("action");
+        Element action     = cr.create("action");
+        Element attributes = cr.create("attributes");
 
         cr.addAttr(action, "name", type, true);
         cr.addAttr(action, "type", type, true);
 
         doc.appendChild(action);
 
+        if (attr != null) {
+            Node root = attr.getFirstChild();
+
+            if (root != null) {
+                action.appendChild(attributes);
+                attributes.appendChild(doc.importNode(root, true));
+            }
+        }
+
         return doc;
     }