{"id":127,"date":"2018-08-04T14:47:08","date_gmt":"2018-08-04T14:47:08","guid":{"rendered":"http:\/\/moresuccessgroup.co.uk\/?p=127"},"modified":"2018-08-04T15:55:03","modified_gmt":"2018-08-04T15:55:03","slug":"using-postman-for-large-successfactor-updates-with-csv","status":"publish","type":"post","link":"https:\/\/moresuccessgroup.co.uk\/?p=127","title":{"rendered":"Using Postman for large Successfactor updates with CSV"},"content":{"rendered":"<p>We recently had an issue with Successfactors Recruitment where applicants in a particular status were not picked up by the candidate purge process leaving client liable for breaching data privacy. To correct the issue, we tried a few things such as using the SFAPI to update status(the behaviour inconsistent), and also the Integration Center which worked to a degree. Ultimately , we opted to use Postman and thought we&#8217;d document the process if it helps someone else. Some of the instructions here are pretty basic, so if you&#8217;re familiar with the concepts, please skip ahead.<\/p>\n<p><strong>1.<\/strong> You&#8217;ll need to download postman.<br \/>\n<a href=\"https:\/\/www.getpostman.com\/\">https:\/\/www.getpostman.com\/<\/a><\/p>\n<p><strong>2.<\/strong> Ensure the login ID has sufficient ODATA privileges<\/p>\n<p><strong>3.<\/strong> Create a new collection.<br \/>\nWhen you start postman you should be presented with a wizard. A collection is just a set of requests you&#8217;ll be sending to the server.<\/p>\n<p><img data-attachment-id=\"128\" data-permalink=\"https:\/\/moresuccessgroup.co.uk\/?attachment_id=128\" data-orig-file=\"https:\/\/i1.wp.com\/moresuccessgroup.co.uk\/wp-content\/uploads\/2018\/08\/Screen-Shot-2018-08-04-at-14.21.46.png?fit=2226%2C1240&amp;ssl=1\" data-orig-size=\"2226,1240\" data-comments-opened=\"1\" data-image-meta=\"{&quot;aperture&quot;:&quot;0&quot;,&quot;credit&quot;:&quot;&quot;,&quot;camera&quot;:&quot;&quot;,&quot;caption&quot;:&quot;&quot;,&quot;created_timestamp&quot;:&quot;0&quot;,&quot;copyright&quot;:&quot;&quot;,&quot;focal_length&quot;:&quot;0&quot;,&quot;iso&quot;:&quot;0&quot;,&quot;shutter_speed&quot;:&quot;0&quot;,&quot;title&quot;:&quot;&quot;,&quot;orientation&quot;:&quot;0&quot;}\" data-image-title=\"Postman\" data-image-description=\"\" data-medium-file=\"https:\/\/i1.wp.com\/moresuccessgroup.co.uk\/wp-content\/uploads\/2018\/08\/Screen-Shot-2018-08-04-at-14.21.46.png?fit=300%2C167&amp;ssl=1\" data-large-file=\"https:\/\/i1.wp.com\/moresuccessgroup.co.uk\/wp-content\/uploads\/2018\/08\/Screen-Shot-2018-08-04-at-14.21.46.png?fit=525%2C292&amp;ssl=1\" loading=\"lazy\" class=\"alignnone wp-image-128\" src=\"https:\/\/i0.wp.com\/moresuccessgroup.co.uk\/wp-content\/uploads\/2018\/08\/Screen-Shot-2018-08-04-at-14.21.46-1024x570.png?resize=525%2C292\" alt=\"\" width=\"525\" height=\"292\" srcset=\"https:\/\/i1.wp.com\/moresuccessgroup.co.uk\/wp-content\/uploads\/2018\/08\/Screen-Shot-2018-08-04-at-14.21.46.png?resize=1024%2C570&amp;ssl=1 1024w, https:\/\/i1.wp.com\/moresuccessgroup.co.uk\/wp-content\/uploads\/2018\/08\/Screen-Shot-2018-08-04-at-14.21.46.png?resize=300%2C167&amp;ssl=1 300w, https:\/\/i1.wp.com\/moresuccessgroup.co.uk\/wp-content\/uploads\/2018\/08\/Screen-Shot-2018-08-04-at-14.21.46.png?resize=768%2C428&amp;ssl=1 768w, https:\/\/i1.wp.com\/moresuccessgroup.co.uk\/wp-content\/uploads\/2018\/08\/Screen-Shot-2018-08-04-at-14.21.46.png?w=1575&amp;ssl=1 1575w\" sizes=\"(max-width: 525px) 100vw, 525px\" data-recalc-dims=\"1\" \/><\/p>\n<p><strong>4.<\/strong> Give your new collection a name and set the authorisation<br \/>\nUnder the authorisation section, Select type &#8220;Basic Auth&#8221;. Set your username and password. Your username should be your ODATA login name and Instance ID. Please be aware, the login IDs are case-sensitive.<\/p>\n<p><img data-attachment-id=\"131\" data-permalink=\"https:\/\/moresuccessgroup.co.uk\/?attachment_id=131\" data-orig-file=\"https:\/\/i1.wp.com\/moresuccessgroup.co.uk\/wp-content\/uploads\/2018\/08\/Screen-Shot-2018-08-04-at-14.35.49.png?fit=1504%2C688&amp;ssl=1\" data-orig-size=\"1504,688\" data-comments-opened=\"1\" data-image-meta=\"{&quot;aperture&quot;:&quot;0&quot;,&quot;credit&quot;:&quot;&quot;,&quot;camera&quot;:&quot;&quot;,&quot;caption&quot;:&quot;&quot;,&quot;created_timestamp&quot;:&quot;0&quot;,&quot;copyright&quot;:&quot;&quot;,&quot;focal_length&quot;:&quot;0&quot;,&quot;iso&quot;:&quot;0&quot;,&quot;shutter_speed&quot;:&quot;0&quot;,&quot;title&quot;:&quot;&quot;,&quot;orientation&quot;:&quot;0&quot;}\" data-image-title=\"Screen Shot 2018-08-04 at 14.35.49\" data-image-description=\"\" data-medium-file=\"https:\/\/i1.wp.com\/moresuccessgroup.co.uk\/wp-content\/uploads\/2018\/08\/Screen-Shot-2018-08-04-at-14.35.49.png?fit=300%2C137&amp;ssl=1\" data-large-file=\"https:\/\/i1.wp.com\/moresuccessgroup.co.uk\/wp-content\/uploads\/2018\/08\/Screen-Shot-2018-08-04-at-14.35.49.png?fit=525%2C240&amp;ssl=1\" loading=\"lazy\" class=\"alignnone size-large wp-image-131\" src=\"https:\/\/i2.wp.com\/moresuccessgroup.co.uk\/wp-content\/uploads\/2018\/08\/Screen-Shot-2018-08-04-at-14.35.49-1024x468.png?resize=525%2C240\" alt=\"\" width=\"525\" height=\"240\" srcset=\"https:\/\/i1.wp.com\/moresuccessgroup.co.uk\/wp-content\/uploads\/2018\/08\/Screen-Shot-2018-08-04-at-14.35.49.png?resize=1024%2C468&amp;ssl=1 1024w, https:\/\/i1.wp.com\/moresuccessgroup.co.uk\/wp-content\/uploads\/2018\/08\/Screen-Shot-2018-08-04-at-14.35.49.png?resize=300%2C137&amp;ssl=1 300w, https:\/\/i1.wp.com\/moresuccessgroup.co.uk\/wp-content\/uploads\/2018\/08\/Screen-Shot-2018-08-04-at-14.35.49.png?resize=768%2C351&amp;ssl=1 768w, https:\/\/i1.wp.com\/moresuccessgroup.co.uk\/wp-content\/uploads\/2018\/08\/Screen-Shot-2018-08-04-at-14.35.49.png?w=1504&amp;ssl=1 1504w\" sizes=\"(max-width: 525px) 100vw, 525px\" data-recalc-dims=\"1\" \/><\/p>\n<p><strong>5. <\/strong>Create a new Post request<br \/>\nClick the little plus button and create the details of your ODATA Upsert. You&#8217;ll need to know which data entity you&#8217;re inserting into also the URL for your data center. To learn more about the data entity, you can use the &#8220;ODATA API Data dictionary&#8221; from your BizX instance. To obtain your data center details, use the sap note <a href=\"https:\/\/launchpad.support.sap.com\/#\/notes\/2215682\">2215682<\/a>\u00a0. We&#8217;re using the UPSERT call below which also tells the system we&#8217;d like the response in JSON format :-<br \/>\n<em>https:\/\/&lt;&lt;YOUR DATA CENTER&gt;.successfactors.eu\/odata\/v2\/upsert?$format=json<br \/>\n<\/em>At this point, the calls are set up but does nothing. We should save. Remember to select the collection you created when saving.<\/p>\n<p><strong>5.1<\/strong> Testing your connection details without Inserting.<strong>(Optional)<\/strong><br \/>\nCreate a new request, but this type a &#8220;Get&#8221; request. Use the URL below :-https:\/\/&lt;&lt;YOUR DATA CENTER&gt;&gt;.successfactors.com\/odata\/v2\/$metadata<\/p>\n<p><strong>6.\u00a0<\/strong> Adding Header and Body Details<br \/>\nSelect your request and choose the Header option. The REST header can contain some control information which we&#8217;ll pass to the system.<\/p>\n<ul>\n<li>Accept &#8211; application\/json<\/li>\n<li>Content &#8211; Type-application\/json; charset=utf-8<\/li>\n<\/ul>\n<p><img data-attachment-id=\"132\" data-permalink=\"https:\/\/moresuccessgroup.co.uk\/?attachment_id=132\" data-orig-file=\"https:\/\/i2.wp.com\/moresuccessgroup.co.uk\/wp-content\/uploads\/2018\/08\/Screen-Shot-2018-08-04-at-15.24.08.png?fit=1326%2C398&amp;ssl=1\" data-orig-size=\"1326,398\" data-comments-opened=\"1\" data-image-meta=\"{&quot;aperture&quot;:&quot;0&quot;,&quot;credit&quot;:&quot;&quot;,&quot;camera&quot;:&quot;&quot;,&quot;caption&quot;:&quot;&quot;,&quot;created_timestamp&quot;:&quot;0&quot;,&quot;copyright&quot;:&quot;&quot;,&quot;focal_length&quot;:&quot;0&quot;,&quot;iso&quot;:&quot;0&quot;,&quot;shutter_speed&quot;:&quot;0&quot;,&quot;title&quot;:&quot;&quot;,&quot;orientation&quot;:&quot;0&quot;}\" data-image-title=\"Screen Shot 2018-08-04 at 15.24.08\" data-image-description=\"\" data-medium-file=\"https:\/\/i2.wp.com\/moresuccessgroup.co.uk\/wp-content\/uploads\/2018\/08\/Screen-Shot-2018-08-04-at-15.24.08.png?fit=300%2C90&amp;ssl=1\" data-large-file=\"https:\/\/i2.wp.com\/moresuccessgroup.co.uk\/wp-content\/uploads\/2018\/08\/Screen-Shot-2018-08-04-at-15.24.08.png?fit=525%2C157&amp;ssl=1\" loading=\"lazy\" class=\"alignnone size-large wp-image-132\" src=\"https:\/\/i1.wp.com\/moresuccessgroup.co.uk\/wp-content\/uploads\/2018\/08\/Screen-Shot-2018-08-04-at-15.24.08-1024x307.png?resize=525%2C157\" alt=\"\" width=\"525\" height=\"157\" srcset=\"https:\/\/i2.wp.com\/moresuccessgroup.co.uk\/wp-content\/uploads\/2018\/08\/Screen-Shot-2018-08-04-at-15.24.08.png?resize=1024%2C307&amp;ssl=1 1024w, https:\/\/i2.wp.com\/moresuccessgroup.co.uk\/wp-content\/uploads\/2018\/08\/Screen-Shot-2018-08-04-at-15.24.08.png?resize=300%2C90&amp;ssl=1 300w, https:\/\/i2.wp.com\/moresuccessgroup.co.uk\/wp-content\/uploads\/2018\/08\/Screen-Shot-2018-08-04-at-15.24.08.png?resize=768%2C231&amp;ssl=1 768w, https:\/\/i2.wp.com\/moresuccessgroup.co.uk\/wp-content\/uploads\/2018\/08\/Screen-Shot-2018-08-04-at-15.24.08.png?w=1326&amp;ssl=1 1326w\" sizes=\"(max-width: 525px) 100vw, 525px\" data-recalc-dims=\"1\" \/><\/p>\n<p>Now Select the Body option and ensure the raw radio button has been checked, the below is JSON formatted data which we&#8217;ll be sending to the system. This becomes a lot easier to understand when you first try to make a &#8220;GET&#8221; call to the entity you&#8217;re attempting to insert into. Please note the fields in the double brackets. These are your variables which come from the CSV you&#8217;re attempting to upload into.<\/p>\n<pre><em>{ \"__metadata\": <\/em>\r\n<em>\u00a0 \u00a0 { \"uri\": \"JobApplication('{{AppliID}}L')\" <\/em>\r\n<em>\u00a0 \u00a0 }, <\/em>\r\n<em>\u00a0 \u00a0 \"applicationId\":\"{{AppliID}}\", <\/em>\r\n<em>\u00a0 \u00a0 \"appStatusSetItemId\": \"202\" , <\/em>\r\n<em>\u00a0 \u00a0 }<\/em>\r\n<em>}<\/em><\/pre>\n<p><strong>7.<\/strong> Adding Validation<br \/>\nPostman has the option of using Scripts the provide validation from. There are some pre made code snippets but these do not suit our needs. We used an existing code snippet and modified it to our expected return code.<\/p>\n<pre><em>pm.test(\"Update code\", function () {<\/em>\r\n<em>var jsonData = pm.response.json();<\/em>\r\n<em>pm.expect(jsonData.d[0].httpCode).to.eql(204);<\/em>\r\n<em>});<\/em><\/pre>\n<p><strong>8.<\/strong> We execute our script<br \/>\nWe&#8217;ve tested our connectivity, we have the data we want to UPSERT and we have our validation. We should now be able to run a script to insert data using a CSV file. Select your collection and click the run option. <img data-attachment-id=\"133\" data-permalink=\"https:\/\/moresuccessgroup.co.uk\/?attachment_id=133\" data-orig-file=\"https:\/\/i2.wp.com\/moresuccessgroup.co.uk\/wp-content\/uploads\/2018\/08\/Screen-Shot-2018-08-04-at-15.39.59.png?fit=1196%2C730&amp;ssl=1\" data-orig-size=\"1196,730\" data-comments-opened=\"1\" data-image-meta=\"{&quot;aperture&quot;:&quot;0&quot;,&quot;credit&quot;:&quot;&quot;,&quot;camera&quot;:&quot;&quot;,&quot;caption&quot;:&quot;&quot;,&quot;created_timestamp&quot;:&quot;0&quot;,&quot;copyright&quot;:&quot;&quot;,&quot;focal_length&quot;:&quot;0&quot;,&quot;iso&quot;:&quot;0&quot;,&quot;shutter_speed&quot;:&quot;0&quot;,&quot;title&quot;:&quot;&quot;,&quot;orientation&quot;:&quot;0&quot;}\" data-image-title=\"Screen Shot 2018-08-04 at 15.39.59\" data-image-description=\"\" data-medium-file=\"https:\/\/i2.wp.com\/moresuccessgroup.co.uk\/wp-content\/uploads\/2018\/08\/Screen-Shot-2018-08-04-at-15.39.59.png?fit=300%2C183&amp;ssl=1\" data-large-file=\"https:\/\/i2.wp.com\/moresuccessgroup.co.uk\/wp-content\/uploads\/2018\/08\/Screen-Shot-2018-08-04-at-15.39.59.png?fit=525%2C320&amp;ssl=1\" loading=\"lazy\" class=\"alignnone size-large wp-image-133\" src=\"https:\/\/i1.wp.com\/moresuccessgroup.co.uk\/wp-content\/uploads\/2018\/08\/Screen-Shot-2018-08-04-at-15.39.59-1024x625.png?resize=525%2C320\" alt=\"\" width=\"525\" height=\"320\" srcset=\"https:\/\/i2.wp.com\/moresuccessgroup.co.uk\/wp-content\/uploads\/2018\/08\/Screen-Shot-2018-08-04-at-15.39.59.png?resize=1024%2C625&amp;ssl=1 1024w, https:\/\/i2.wp.com\/moresuccessgroup.co.uk\/wp-content\/uploads\/2018\/08\/Screen-Shot-2018-08-04-at-15.39.59.png?resize=300%2C183&amp;ssl=1 300w, https:\/\/i2.wp.com\/moresuccessgroup.co.uk\/wp-content\/uploads\/2018\/08\/Screen-Shot-2018-08-04-at-15.39.59.png?resize=768%2C469&amp;ssl=1 768w, https:\/\/i2.wp.com\/moresuccessgroup.co.uk\/wp-content\/uploads\/2018\/08\/Screen-Shot-2018-08-04-at-15.39.59.png?w=1196&amp;ssl=1 1196w\" sizes=\"(max-width: 525px) 100vw, 525px\" data-recalc-dims=\"1\" \/><\/p>\n<p>Select your CSV file, ensuring the Headers match up with the variables you&#8217;ve created in the Body as those are the values that are going to be replaced. Click run, and you should be presented with the results.<img data-attachment-id=\"134\" data-permalink=\"https:\/\/moresuccessgroup.co.uk\/?attachment_id=134\" data-orig-file=\"https:\/\/i1.wp.com\/moresuccessgroup.co.uk\/wp-content\/uploads\/2018\/08\/Screen-Shot-2018-08-04-at-15.42.30.png?fit=1992%2C1408&amp;ssl=1\" data-orig-size=\"1992,1408\" data-comments-opened=\"1\" data-image-meta=\"{&quot;aperture&quot;:&quot;0&quot;,&quot;credit&quot;:&quot;&quot;,&quot;camera&quot;:&quot;&quot;,&quot;caption&quot;:&quot;&quot;,&quot;created_timestamp&quot;:&quot;0&quot;,&quot;copyright&quot;:&quot;&quot;,&quot;focal_length&quot;:&quot;0&quot;,&quot;iso&quot;:&quot;0&quot;,&quot;shutter_speed&quot;:&quot;0&quot;,&quot;title&quot;:&quot;&quot;,&quot;orientation&quot;:&quot;0&quot;}\" data-image-title=\"Screen Shot 2018-08-04 at 15.42.30\" data-image-description=\"\" data-medium-file=\"https:\/\/i1.wp.com\/moresuccessgroup.co.uk\/wp-content\/uploads\/2018\/08\/Screen-Shot-2018-08-04-at-15.42.30.png?fit=300%2C212&amp;ssl=1\" data-large-file=\"https:\/\/i1.wp.com\/moresuccessgroup.co.uk\/wp-content\/uploads\/2018\/08\/Screen-Shot-2018-08-04-at-15.42.30.png?fit=525%2C371&amp;ssl=1\" loading=\"lazy\" class=\"alignnone size-large wp-image-134\" src=\"https:\/\/i0.wp.com\/moresuccessgroup.co.uk\/wp-content\/uploads\/2018\/08\/Screen-Shot-2018-08-04-at-15.42.30-1024x724.png?resize=525%2C371\" alt=\"\" width=\"525\" height=\"371\" srcset=\"https:\/\/i1.wp.com\/moresuccessgroup.co.uk\/wp-content\/uploads\/2018\/08\/Screen-Shot-2018-08-04-at-15.42.30.png?resize=1024%2C724&amp;ssl=1 1024w, https:\/\/i1.wp.com\/moresuccessgroup.co.uk\/wp-content\/uploads\/2018\/08\/Screen-Shot-2018-08-04-at-15.42.30.png?resize=300%2C212&amp;ssl=1 300w, https:\/\/i1.wp.com\/moresuccessgroup.co.uk\/wp-content\/uploads\/2018\/08\/Screen-Shot-2018-08-04-at-15.42.30.png?resize=768%2C543&amp;ssl=1 768w, https:\/\/i1.wp.com\/moresuccessgroup.co.uk\/wp-content\/uploads\/2018\/08\/Screen-Shot-2018-08-04-at-15.42.30.png?w=1992&amp;ssl=1 1992w, https:\/\/i1.wp.com\/moresuccessgroup.co.uk\/wp-content\/uploads\/2018\/08\/Screen-Shot-2018-08-04-at-15.42.30.png?w=1575&amp;ssl=1 1575w\" sizes=\"(max-width: 525px) 100vw, 525px\" data-recalc-dims=\"1\" \/><\/p>\n<p>We hoped this was easy to understand as Successfactors has provided a lot of tools to enable your business to operate without outside expertise. If you have any queries, we&#8217;d love to hear from you, as they say<\/p>\n<p><strong><em>&#8211;\u00a0 &#8220;To teach is to learn twice&#8221;<\/em><\/strong><\/p>\n","protected":false},"excerpt":{"rendered":"<p>We recently had an issue with Successfactors Recruitment where applicants in a particular status were not picked up by the candidate purge process leaving client liable for breaching data privacy. To correct the issue, we tried a few things such as using the SFAPI to update status(the behaviour inconsistent), and also the Integration Center which &hellip; <\/p>\n<p class=\"link-more\"><a href=\"https:\/\/moresuccessgroup.co.uk\/?p=127\" class=\"more-link\">Continue reading<span class=\"screen-reader-text\"> &#8220;Using Postman for large Successfactor updates with CSV&#8221;<\/span><\/a><\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"spay_email":"","jetpack_publicize_message":"","jetpack_is_tweetstorm":false},"categories":[4],"tags":[5,6,7],"jetpack_featured_media_url":"","jetpack_publicize_connections":[],"jetpack_sharing_enabled":true,"jetpack_shortlink":"https:\/\/wp.me\/p9A5mS-23","jetpack_likes_enabled":true,"jetpack-related-posts":[{"id":114,"url":"https:\/\/moresuccessgroup.co.uk\/?p=114","url_meta":{"origin":127,"position":0},"title":"SAP HR software can be the primary factor in the success of your business","date":"July 28, 2018","format":false,"excerpt":"There have been many changes in SAP HR development over the past decade, from HR administration transactions PA30\/PA40 (they will always be loved), to the beautiful Dynamic Actions and how Self Service went from ITS to Java to ABAP to UI5 \u2013 but we all knew how everything hung together.\u2026","rel":"","context":"Similar post","img":{"alt_text":"","src":"","width":0,"height":0},"classes":[]}],"_links":{"self":[{"href":"https:\/\/moresuccessgroup.co.uk\/index.php?rest_route=\/wp\/v2\/posts\/127"}],"collection":[{"href":"https:\/\/moresuccessgroup.co.uk\/index.php?rest_route=\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/moresuccessgroup.co.uk\/index.php?rest_route=\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/moresuccessgroup.co.uk\/index.php?rest_route=\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/moresuccessgroup.co.uk\/index.php?rest_route=%2Fwp%2Fv2%2Fcomments&post=127"}],"version-history":[{"count":5,"href":"https:\/\/moresuccessgroup.co.uk\/index.php?rest_route=\/wp\/v2\/posts\/127\/revisions"}],"predecessor-version":[{"id":138,"href":"https:\/\/moresuccessgroup.co.uk\/index.php?rest_route=\/wp\/v2\/posts\/127\/revisions\/138"}],"wp:attachment":[{"href":"https:\/\/moresuccessgroup.co.uk\/index.php?rest_route=%2Fwp%2Fv2%2Fmedia&parent=127"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/moresuccessgroup.co.uk\/index.php?rest_route=%2Fwp%2Fv2%2Fcategories&post=127"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/moresuccessgroup.co.uk\/index.php?rest_route=%2Fwp%2Fv2%2Ftags&post=127"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}