Merge pull request #147 from damien-carcel/API-421

API-421: Add "Get product drafts" client resource

Author: damien-carcel

content/php-client/ce-resources/products.md

@@ -45,6 +45,8 @@ $product = $client->getProductApi()->get('top');
 
 You can get more information about the returned format of the product values [here](/documentation/resources.html#product-values).
 
+In the Enterprise Edition, the response contains one more field `metadata`. Look at the [product drafts](/php-client/ee-resources.html#product-draft) for an example.
+
 ### Get a list of products 
 
 There are two ways of getting products. Also, you have a search builder to ease the construction of a research.

content/php-client/ee-resources/product-drafts.md

@@ -0,0 +1,50 @@
+## Product draft
+
+### Get a product draft 
+
+```php
+$client = new \Akeneo\PimEnterprise\AkeneoPimEnterpriseClientBuilder('http://akeneo.com/')->buildAuthenticatedByPassword('client_id', 'secret', 'admin', 'admin');
+
+/*
+ * Returns an array like this:
+ * [
+ *     'identifier': 'top',
+ *     'enabled': true,
+ *     'family': 'tshirt',
+ *     'categories': ['summer_collection'],
+ *     'groups': [],
+ *     'values': [
+ *         'name': [
+ *              [
+ *                  'data': 'Top',
+ *                  'locale': 'en_US',
+ *                  'scope': null
+ *              ],
+ *              [
+ *                  'data': 'Débardeur',
+ *                  'locale': 'fr_FR',
+ *                  'scope': null
+ *              ],
+ *         ],
+ *     ],
+ *     'created': '2016-06-23T18:24:44+02:00',
+ *     'updated': '2016-06-25T17:56:12+02:00',
+ *     'associations': [
+ *         'PACK': [
+ *             'products': [
+ *                 'sunglass'
+ *             ],
+ *             'groups': []
+ *         ],
+ *     ],
+ *     'metadata' => [
+ *         'workflow_status' => 'draft_in_progress',
+ *     ],
+ * ]
+ */
+$publishedProduct = $client->getProductDraftApi()->get('top');
+```
+
+You can get more information about the returned format of the product values [here](/documentation/resources.html#product-values).
+
+The field `metadata` is specific to Akeneo PIM Enterprise Edition. The status of the draft is specified in this field.