{"id":1001,"date":"2011-06-08T12:17:05","date_gmt":"2011-06-08T12:17:05","guid":{"rendered":"https:\/\/copyright.lboro.ac.uk\/lorls\/?page_id=1001"},"modified":"2011-06-08T12:17:05","modified_gmt":"2011-06-08T12:17:05","slug":"editingallowedsutypes","status":"publish","type":"page","link":"https:\/\/blog.lboro.ac.uk\/lorls\/documentation\/integration\/lumps-apis\/editingallowedsutypes","title":{"rendered":"Editing\/AllowedSUTypes"},"content":{"rendered":"<pre>NAME\n    AllowedSUTypes - LUMP CGI XML API to find Structural Unit Types that are\n    valid children for a given Structural Unit Type *or* Structural Unit.\n\nDESCRIPTION\n    The AllowedSUTypes CGI script permits the valid range of Structural Unit\n    Types that can be children of a particular Structural Unit Type, or\n    children of a Structural Unit (which itself will be of some Structural\n    Unit Type obviously).\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    *suid* - The ID of a structural unit. Only used if a *sutid* is not\n    given.\n    *sutid* - The ID of a structural unit type.\n\nRESULTS\n    The script returns the usual LUMP XML format. For successful searches\n    the &lt;error_code&gt; in the &lt;error&gt; section is set to SUCCESS and the\n    &lt;returns&gt; section has a sequence of &lt;child_structural_unit_type&gt;\n    elements, each of which contains &lt;name&gt; and &lt;id&gt; elements that supply\n    the name and ID of a valid child Structural Unit Type. For example:\n\n     &lt;response&gt;\n      &lt;returns&gt;\n       &lt;child_structural_unit_type&gt;\n        &lt;name&gt;Book&lt;\/name&gt;\n        &lt;id&gt;1&lt;\/id&gt;\n       &lt;\/child_structural_unit_type&gt;\n       &lt;child_structural_unit_type&gt;\n        &lt;name&gt;Electronic Resource&lt;\/name&gt;\n        &lt;id&gt;3&lt;\/id&gt;\n       &lt;\/child_structural_unit_type&gt;\n       &lt;child_structural_unit_type&gt;\n        &lt;name&gt;Note&lt;\/name&gt;\n        &lt;id&gt;5&lt;\/id&gt;\n       &lt;\/child_structural_unit_type&gt;\n       &lt;child_structural_unit_type&gt;\n        &lt;name&gt;Journal Article&lt;\/name&gt;\n        &lt;id&gt;6&lt;\/id&gt;\n       &lt;\/child_structural_unit_type&gt;\n       &lt;child_structural_unit_type&gt;\n        &lt;name&gt;Book Chapter&lt;\/name&gt;\n        &lt;id&gt;9&lt;\/id&gt;\n       &lt;\/child_structural_unit_type&gt;\n       &lt;child_structural_unit_type&gt;\n        &lt;name&gt;Journal&lt;\/name&gt;\n        &lt;id&gt;11&lt;\/id&gt;\n       &lt;\/child_structural_unit_type&gt;\n       &lt;child_structural_unit_type&gt;\n        &lt;name&gt;Reading List&lt;\/name&gt;\n        &lt;id&gt;12&lt;\/id&gt;\n       &lt;\/child_structural_unit_type&gt;\n      &lt;\/returns&gt;\n      &lt;session&gt;\n       &lt;security_hash&gt;1248038577:3f79d0a006a8b1b8c7c105ff831981a2&lt;\/security_hash&gt;\n       &lt;lump_version&gt;1&lt;\/lump_version&gt;\n       &lt;acting_as&gt;&lt;\/acting_as&gt;\n      &lt;\/session&gt;\n      &lt;error&gt;\n       &lt;error_message&gt;Success&lt;\/error_message&gt;\n       &lt;error_code&gt;SUCCESS&lt;\/error_code&gt;\n      &lt;\/error&gt;\n     &lt;\/response&gt;\n\nSEE ALSO\n    GetStructuralUnit\n\n    FindSuid\n\n    LUMP-XML-Response\n\nCOPYRIGHT\n    Copyright 2009 Loughborough University Library &lt;library@lboro.ac.uk&gt;.\n\n    Permission is granted to copy, distribute and\/or modify this document\n    under the terms of the GNU Free Documentation License, Version 1.2 or\n    any later version published by the Free Software Foundation; with no\n    Invariant Sections, with no Front-Cover Texts, and with no Back-Cover\n    Texts.\n\n<\/pre>\n","protected":false},"excerpt":{"rendered":"<p>NAME AllowedSUTypes &#8211; LUMP CGI XML API to find Structural Unit Types that are valid children for a given Structural Unit Type *or* Structural Unit. DESCRIPTION The AllowedSUTypes CGI script permits the valid range of Structural Unit Types that can be children of a particular Structural Unit Type, or children of a Structural Unit (which [&hellip;]<\/p>\n","protected":false},"author":2,"featured_media":0,"parent":125,"menu_order":21,"comment_status":"closed","ping_status":"closed","template":"page-col-1.php","meta":{"footnotes":"","_links_to":"","_links_to_target":""},"class_list":["post-1001","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\/1001","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=1001"}],"version-history":[{"count":0,"href":"https:\/\/blog.lboro.ac.uk\/lorls\/wp-json\/wp\/v2\/pages\/1001\/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=1001"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}