Often times you will want to use third party tools to create files and related items in Portal rather than uploading, importing from storage, or using an auto-import folder.<\/p>\n
Here is the process I took which worked in registering both a new element available in a storage as well as adding different shapes to it. Hopefully it helps and is easy to replicate. I did it all with curl, but using anything else that can post should work fine.<\/p>\n
<\/p>\n
First, we create a placeholder. I DIDN’T apply a settings profile to the placeholder, which means that it takes on the properties of the user that is authed in the API:<\/p>\n
curl --data \"title<\/name>A Movie<\/value><\/field><\/timespan><\/MetadataDocument>\" -H \"Content-type: application\/xml\" -u admin:admin \"http:\/\/cantemo:8080\/API\/import\/placeholder?container=1&settings=VX-1\" \r\n<\/pre>\nThis gives me back the id of my new placeholder (assuming it all worked)<\/p>\n
\r\n\r\n<\/pre>\nNext, I figured out what the VS ID of the master file was. In this case, I have two files, Amovie.mov and Amovie_lowres.mp4.<\/p>\n
curl -H \"Content-type: application\/xml\" -u admin:admin \"http:\/\/cantemo:8080\/API\/storage\/VX-4\/file\/byURI;path=Amovie.mov\"<\/pre>\nThis returns the following XML:<\/p>\n
\r\n\tVX-1542<\/id>\r\n\tAmovie.mov<\/path>\r\n\tfile:\/\/\/media\/flowrage\/Space\/Cantemo\/Ingest\/Amovie.mov<\/uri>\r\n\tOPEN<\/state>\r\n\t151672745<\/size>\r\n\t2014-12-17T16:39:26.708-05:00<\/timestamp>\r\n\t1<\/refreshFlag>\r\n\tVX-4<\/storage>\r\n\t\r\n\t\r\n\tatime<\/key>\r\n\t1418852349000<\/value>\r\n\t<\/field>\r\n\t\r\n\tcreated<\/key>\r\n\t1416580881000<\/value>\r\n\t<\/field>\r\n\t\r\n\tmtime<\/key>\r\n\t1416580881000<\/value>\r\n\t<\/field>\r\n\t<\/metadata>\r\n<\/FileDocument>\r\n<\/pre>\nFrom this, I now know my file has an ID of VX-1542. I can now register it to my placeholder (VX-442). I’ve made an ingest profile called “API” for this case that does NOT have any automatic shapes created.<\/p>\n
curl --data \"\" -H \"Content-type: application\/xml\" -u admin:admin \"http:\/\/cantemo:8080\/API\/import\/placeholder\/VX-442\/container?jobmetadata=portal_groups:StringArray%3dAPI&fileId=VX-1542\" \r\n<\/pre>\nOn success I get back the job ID<\/p>\n
\r\n\r\n\tVX-829<\/jobId>\r\n\tadmin<\/user>\r\n\t2014-12-17T21:52:21.187Z<\/started>\r\n\tREADY<\/status>PLACEHOLDER_IMPORT<\/type>\r\n\tMEDIUM<\/priority>\r\n<\/JobDocument>\r\n<\/pre>\nNow I can register my lowres shape as well. Note that you have to have a shape name in Portal to register too, so you can’t just make up a shape name here. You can make a transcode profile that is “dummy” since you’ll never actually use it to transcode if you like. Repeat the first step to get my ID:<\/p>\n
curl -H \"Content-type: application\/xml\" -u admin:admin \"http:\/\/cantemo:8080\/API\/storage\/VX-4\/file\/byURI;path=Amovie_lowres.mp4\"<\/pre>\nWhich returns:<\/p>\n
\r\n\r\n\tVX-1543<\/id>\r\n\tAmovie_lowres.mp4<\/path>\r\n\tfile:\/\/\/media\/flowrage\/Space\/Cantemo\/Ingest\/Amovie_lowres.mp4<\/uri>CLOSED<\/state>\r\n\t11000050<\/size>\r\n\t7ec6c34713c630264946a6199726fd01407ab7af<\/hash>\r\n\t2014-12-17T16:45:28.266-05:00<\/timestamp>\r\n\t1<\/refreshFlag>\r\n\tVX-4<\/storage>\r\n\t\r\n\tatime<\/key>\r\n\t1418852678000<\/value>\r\n\t<\/field>\r\n\t\r\n\tcreated<\/key>\r\n\t1418852360000<\/value>\r\n\t<\/field>\r\n\t\r\n\tmtime<\/key>\r\n\t1418852360000<\/value>\r\n\t<\/field>\r\n\t<\/metadata>\r\n<\/FileDocument>\r\n<\/pre>\nSo now I have my lowres ID, I can register it:<\/p>\n
curl --data \"\" -H \"Content-type: application\/xml\" -u admin:admin \"http:\/\/cantemo:8080\/API\/item\/VX-442\/shape?tag=lowres&fileId=VX-1543\" \r\n<\/pre>\nWhich gives me the job doc again:<\/p>\n
\r\n\r\n\tVX-832<\/jobId>\r\n\tadmin<\/user>\r\n\t2014-12-17T22:00:22.491Z<\/started>\r\n\tREADY<\/status>\r\n\tSHAPE_IMPORT<\/type>\r\n\tMEDIUM<\/priority>\r\n<\/JobDocument>\r\n<\/pre>\nLast but not least, we trigger thumbnail creation<\/p>\n
curl --data \"\" -H \"Content-type: application\/xml\" -u admin:admin \"http:\/\/cantemo:8080\/API\/item\/VX-442\/thumbnail\/?createThumbnails=true&createPoster\" \r\n<\/pre>\nThis dumps out my final job ID:<\/p>\n
\r\n\r\n\tVX-834<\/jobId>\r\n\tadmin<\/user>\r\n\t2014-12-17T22:01:56.768Z<\/started>\r\n\tREADY<\/status>\r\n\tTHUMBNAIL<\/type>\r\n\tMEDIUM<\/priority>\r\n<\/JobDocument>\r\n<\/pre>\nNow I can hop to my Portal and make sure it all looks good in reality.<\/p>\n","protected":false},"excerpt":{"rendered":"
Often times you will want to use third party tools to create files and related items in Portal rather than uploading, importing from storage, or using an auto-import folder. Here is the process I took which worked in registering both a new element available in a storage as well as adding different shapes to it. … Continue reading “Importing placeholders, items, and files into Cantemo Portal”<\/span><\/a><\/p>\n","protected":false},"author":2,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"jetpack_post_was_ever_published":false,"_jetpack_newsletter_access":"","_jetpack_dont_email_post_to_subs":false,"_jetpack_newsletter_tier_id":0,"_jetpack_memberships_contains_paywalled_content":false,"_jetpack_memberships_contains_paid_content":false,"footnotes":"","jetpack_publicize_message":"","jetpack_publicize_feature_enabled":true,"jetpack_social_post_already_shared":true,"jetpack_social_options":{"image_generator_settings":{"template":"highway","default_image_id":0,"font":"","enabled":false},"version":2}},"categories":[13],"tags":[],"class_list":["post-162","post","type-post","status-publish","format-standard","hentry","category-cantemo-portal"],"jetpack_publicize_connections":[],"jetpack_featured_media_url":"","jetpack_sharing_enabled":true,"jetpack_shortlink":"https:\/\/wp.me\/p2bwLw-2C","_links":{"self":[{"href":"https:\/\/provideotech.org\/index.php?rest_route=\/wp\/v2\/posts\/162","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/provideotech.org\/index.php?rest_route=\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/provideotech.org\/index.php?rest_route=\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/provideotech.org\/index.php?rest_route=\/wp\/v2\/users\/2"}],"replies":[{"embeddable":true,"href":"https:\/\/provideotech.org\/index.php?rest_route=%2Fwp%2Fv2%2Fcomments&post=162"}],"version-history":[{"count":0,"href":"https:\/\/provideotech.org\/index.php?rest_route=\/wp\/v2\/posts\/162\/revisions"}],"wp:attachment":[{"href":"https:\/\/provideotech.org\/index.php?rest_route=%2Fwp%2Fv2%2Fmedia&parent=162"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/provideotech.org\/index.php?rest_route=%2Fwp%2Fv2%2Fcategories&post=162"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/provideotech.org\/index.php?rest_route=%2Fwp%2Fv2%2Ftags&post=162"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}