Hello !

First of all, you need to configure your PHP client with your ID, password, and server url like this:

//your nuxeo automation url 
// $nuxeoAutomationUrl contains the url of your nuxeo automation API
$client = new PhpAutomationClient($nuxeoAutomationUrl);

//your nuxeo ids
// $Username contains your username
// $Password contains your password
$session = $client->getSession($Username, $Password);

Then, you may need to create remotly a new Nuxeo Document, setting a new request like this:

//We create the document that will hold the file
// $filePath contains the nuxeo's document path
// $name contains the name of the future document
// $type contains the nuxeo type of the document
$answer = $session->newRequest("Document.Create")
->set('input', 'doc:' . $filePath)
->set('params', 'type', $type)
->set('params', 'name', $name)
->sendRequest();

When you create a document, you may need his path in order to execute some actions on this newly-created document. Nuxeo will send back a document object which will be store in the field $answer, which will be a list of documents. To retreive the path of the document, use this:

$path = $answer->getDocument(0)->getPath();

Then, you may need to update some properties in this document, such as the document title:

//We create the document that will hold the file
// $filePath contains the nuxeo's document path
// $value contains the value of the field
// $type contains the xpath of the field
$answer = $session->newRequest("Document.SetProperty")
->set('input', 'doc:' . $path)
->set('params', 'value', $value)
->set('params', 'xpath', $xpath)
->sendRequest();

Now, if you need to upload a blob (a xls file for example) as an attachment to this document, use this:

//We upload the file
// $blob contains the path of the document you are trying to attach to the file
// $blobtype contains the mime type of the document
// $path contains the path (or id) of the nuxeo document
$answer = $session->newRequest("Blob.Attach")
->set('params', 'document', $path)
->loadBlob($blob, $blobtype)
->sendRequest();

You need some versionning ? No problem. Just change the document version. It will save the current state of the document and store it into Document=>History tab=>Versions in Nuxeo. In ored to change the document version, use this:

//$upgrade is a string which contains :
// "Minor" if you upgrade to a minor version
// "Major" if you upgrade to a major version
// $path contains the path (or id) of the nuxeo document
$answer = $session->newRequest("Document.CreateVersion")
->set('input', 'doc:' . $path)
->set('params', 'increment', 'Major')
->sendRequest();

At last, if you need some examples for the different variables, check here:

//variables used for a default Nuxeo Server
$nuxeoAutomationUrl='http://localhost:8080/nuxeo/site/automation';
$Username='Administrator';
$Password=$Username;
$filePath='/default-domain/workspaces/test';
$type='File';
$name='TestFile';
$blob='/test1.rtf';
$blobtype='text/rtf';
$upgrade='Major';
$nextBlob='/test2.rtf';
$nextBlobtype='text/rtf';
$value='testTitle';
$xpath='dc:title';

Enjoy !

Arthur Gallouin

Hi Arthur Gallouin.

I'm trying to use the nuxeo-automation-php-client (https://github.com/nuxeo/nuxeo-automation-php-client) API to upload a document from PHP to Nuxeo 5.6.

I don't know how relate the file with the document I create with “Document.Create” operation, could you give me an example please?

Any help will be appreciated.

Raul Chavarria