How to Post a documents using REST API with required category attributes

Loxha_Alban

I’m trying to post a document to Content Server, using REST API, to folders that have categories with required attributes on them.

We are currently on CS10 Update 2015-12, Service Pack 2, but I couldn’t find any specific documentation indicating how to populate the structure of the Categories with the required attributes when uploading a document; e.g. roles: {categories: categories}.

Included below is the code I use to upload documents using POST /nodes, but this only works on containers without the required category attributes applied.

---

function upload(files,i){

formData = new FormData();

formData.append( "type", 144 );

formData.append( "parent_id", 19051);

formData.append( "name", files[i].name );

formData.append( "file", files[i]);

if (typeof files[i] === 'undefined') { return false; }

$.ajax({
    type:'POST',
    url: "…/api/v1/nodes",
    data: formData,
    contentType: false,
    processData: false,
    headers: { otcsticket: otcsticket },
    dataType:'json',
}).done(function(){
    console.log(‘Success’);
}).fail(function(){
    console.log("failed, message:");
});     

};

---

Any help with this would be much appreciated.

Ferdinand Prantl

Category attributes are represented by a nested property structure, which looks like this in JSON:

{roles: { categories: ...}}

CS REST API supports neither JSON nor XML nor other hierarchical format in request bodies. You need to use a workaround: pass all parameters as stringified JSON in the form field called body. The raw request body creating a document should use multi-part MIME content type.

Your code should look like this:

function upload( files,i ) {
  var bodyData = {
        type: 144,
        parent_id: 19051,
        name: files[i].name,
        roles: {
          categories: {
            {
              "52271": { // category
                "52271_2": "test" // attribute
              }
            }
          }
        }
      },
      formData = new FormData();
  formData.append( "body", JSON.stringify( bodyData ) );
  formData.append( "file", files[i] );
  return $.ajax( {
    type: "POST",
    url: ".../api/v1/nodes",
    data: formData,
    headers: { otcsticket: otcsticket }
  } ).then( function ( response ) {
    ... succeeded
  }, function ( jqxhr ) {
    ... failed
  } );
}

Another post shows, how to request the form schema for a category assigned to a folder and and create a new document with the attribute values pre-filled from it. Once you see a couple of category form schemas, you will understand, how it is built.

If HTML decoding of the code excerpts here annoys you, vote for getting the bug in this form, which causes the code samples rendered HTML-encoded, fixed.