{"id":1362,"date":"2012-11-27T13:53:07","date_gmt":"2012-11-27T13:53:07","guid":{"rendered":"https:\/\/blog.lboro.ac.uk\/lorls\/?page_id=1362"},"modified":"2012-11-27T13:53:07","modified_gmt":"2012-11-27T13:53:07","slug":"editingconvertsu","status":"publish","type":"page","link":"https:\/\/blog.lboro.ac.uk\/lorls\/documentation\/integration\/lumps-apis\/editingconvertsu","title":{"rendered":"Editing\/ConvertSU"},"content":{"rendered":"<pre>NAME\n    ConvertSU - convert a structural unit from one structural unit type to\n    another.\n\nDESCRIPTION\n    The ConvertSU CGI script allows a LUMP Structural Unit to be converted\n    from its current Structural Unit Type to another one, assuming we have a\n    suitable set of conversion rules. Note that this conversion can be\n    \"lossy\" because some data types in the original Structural Unit Type may\n    not have equivalents in the new Structural Unit Type.\n\nPARAMETERS\n  Standard\n    *username* - Name of user running this CGI script. Required unless web\n    server authentication is in use (when it is, the web server\n    authenticated user is used instead).\n    *password* - Password for the user. This is only required if the web\n    server is not handling the user authentication and if no security hash\n    parameter is being given.\n    *security_hash* - An opaque value used to authenticate the user without\n    requiring the password to be sent. This value is generated by a previous\n    execution of a LUMP API script and may well be time limited. It is only\n    required if no password or webserver authentication is done.\n    *act_as* - Users in the SysAdmins group can elect to act on the behalf\n    of other users once they are themselves authenticated. If this parameter\n    is present it should contain the username of the user that should be\n    switched to if this option is available and the real user has been\n    authenticated successfully. Optional.\n    *session_id* - An opaque string as far as the server is concerned that\n    is intended solely to allow async clients to differentiate different\n    results more easily. Optional.\n\n  Specific for this script\n    *dump_rules* - If set to non-zero value, return a data structure\n    containing all the conversion rules in the system.\n    *su_id* - The ID of the structural unit that you are attempting to\n    convert. This parameter is mandatory if you wish to do a conversion.\n    Note that the user that has been authenticated must have edit rights to\n    this SU, otherwise an error will be returned.\n    *target_sut_id* - The ID of the Structural Unit Type that you want the\n    SU to be changed to. This parameter is mandatory if you wish to do a\n    conversion. =back\n\nRESULTS\n        The &lt;returns&gt; section of the XML result is empty and the\n        &lt;error_code&gt; is used to indicate success or failure of the\n        operation.\n\nSEE ALSO\n        GetStructuralUnit\n\n        FindSuid\n\n        LUMP-XML-Response\n\nCOPYRIGHT\n        Copyright 2009 Loughborough University Library\n        &lt;library@lboro.ac.uk&gt;.\n\n        Permission is granted to copy, distribute and\/or modify this\n        document under the terms of the GNU Free Documentation License,\n        Version 1.2 or any later version published by the Free Software\n        Foundation; with no Invariant Sections, with no Front-Cover Texts,\n        and with no Back-Cover Texts.\n\n<\/pre>\n","protected":false},"excerpt":{"rendered":"<p>NAME ConvertSU &#8211; convert a structural unit from one structural unit type to another. DESCRIPTION The ConvertSU CGI script allows a LUMP Structural Unit to be converted from its current Structural Unit Type to another one, assuming we have a suitable set of conversion rules. Note that this conversion can be &#8220;lossy&#8221; because some data [&hellip;]<\/p>\n","protected":false},"author":2,"featured_media":0,"parent":125,"menu_order":22,"comment_status":"closed","ping_status":"closed","template":"page-col-1.php","meta":{"footnotes":"","_links_to":"","_links_to_target":""},"class_list":["post-1362","page","type-page","status-publish","hentry","count-0","even alt","author-lbjlclboro-ac-uk","last"],"_links":{"self":[{"href":"https:\/\/blog.lboro.ac.uk\/lorls\/wp-json\/wp\/v2\/pages\/1362","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/blog.lboro.ac.uk\/lorls\/wp-json\/wp\/v2\/pages"}],"about":[{"href":"https:\/\/blog.lboro.ac.uk\/lorls\/wp-json\/wp\/v2\/types\/page"}],"author":[{"embeddable":true,"href":"https:\/\/blog.lboro.ac.uk\/lorls\/wp-json\/wp\/v2\/users\/2"}],"replies":[{"embeddable":true,"href":"https:\/\/blog.lboro.ac.uk\/lorls\/wp-json\/wp\/v2\/comments?post=1362"}],"version-history":[{"count":0,"href":"https:\/\/blog.lboro.ac.uk\/lorls\/wp-json\/wp\/v2\/pages\/1362\/revisions"}],"up":[{"embeddable":true,"href":"https:\/\/blog.lboro.ac.uk\/lorls\/wp-json\/wp\/v2\/pages\/125"}],"wp:attachment":[{"href":"https:\/\/blog.lboro.ac.uk\/lorls\/wp-json\/wp\/v2\/media?parent=1362"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}