€cdocutils.nodes document q)q}q(U nametypesq}q(Xuc32qˆX'use case 32 - transfer object ownershipqNXhistoryqˆuUsubstitution_defsq }q Uparse_messagesq ]q Ucurrent_sourceq NU decorationqNUautofootnote_startqKUnameidsq}q(hUuc32qhU%use-case-32-transfer-object-ownershipqhUhistoryquUchildrenq]q(cdocutils.nodes target q)q}q(U rawsourceqX .. _UC32:UparentqhUsourceqXj/var/lib/jenkins/jobs/API_Documentation_trunk/workspace/api-documentation/source/design/UseCases/32_uc.txtqUtagnameqUtargetqU attributesq }q!(Uidsq"]Ubackrefsq#]Udupnamesq$]Uclassesq%]Unamesq&]Urefidq'huUlineq(KUdocumentq)hh]ubcdocutils.nodes section q*)q+}q,(hUhhhhUexpect_referenced_by_nameq-}q.hhshUsectionq/h }q0(h$]h%]h#]h"]q1(hheh&]q2(hheuh(Kh)hUexpect_referenced_by_idq3}q4hhsh]q5(cdocutils.nodes title q6)q7}q8(hX'Use Case 32 - Transfer Object Ownershipq9hh+hhhUtitleq:h }q;(h$]h%]h#]h"]h&]uh(Kh)hh]q…q?}q@(hh9hh7ubaubcsphinx.addnodes index qA)qB}qC(hUhh+hhhUindexqDh }qE(h"]h#]h$]h%]h&]UentriesqF]qG((UsingleqHX Use Case 32Uindex-0qIUNtqJ(hHXUC32hIUNtqK(hHXownership changehIUNtqLeUinlineqM‰uh(Kh)hh]ubh)qN}qO(hUhh+hhhhh }qP(h"]h#]h$]h%]h&]h'hIuh(Kh)hh]ubcdocutils.nodes definition_list qQ)qR}qS(hUhh+hhh-}hUdefinition_listqTh }qU(h$]h%]h#]h"]qVhIah&]uh(Nh)hh3}qWhIhNsh]qX(cdocutils.nodes definition_list_item qY)qZ}q[(hX+Revisions View document revision history_. hhRhhhUdefinition_list_itemq\h }q](h$]h%]h#]h"]h&]uh(K h]q^(cdocutils.nodes term q_)q`}qa(hX RevisionsqbhhZhhhUtermqch }qd(h$]h%]h#]h"]h&]uh(K h]qeh=X Revisionsqf…qg}qh(hhbhh`ubaubcdocutils.nodes definition qi)qj}qk(hUh }ql(h$]h%]h#]h"]h&]uhhZh]qmcdocutils.nodes paragraph qn)qo}qp(hX View document revision history_.hhjhhhU paragraphqqh }qr(h$]h%]h#]h"]h&]uh(K h]qs(h=XView document revision qt…qu}qv(hXView document revision hhoubcdocutils.nodes reference qw)qx}qy(hXhistory_UresolvedqzKhhohU referenceq{h }q|(UnameXhistoryq}Urefuriq~X”https://redmine.dataone.org/projects/d1/repository/changes/documents/Projects/cicore/architecture/api-documentation/source/design/UseCases/32_uc.txtqh"]h#]h$]h%]h&]uh]q€h=Xhistoryq…q‚}qƒ(hUhhxubaubh=X.…q„}q…(hX.hhoubeubahU definitionq†ubeubhY)q‡}qˆ(hXÄGoal User or organization takes over 'ownership' of a set of objects (write access for orphaned records), or the existing owner of an object would like to transfer ownership to another principal. hhRhhhh\h }q‰(h$]h%]h#]h"]h&]uh(Kh)hh]qŠ(h_)q‹}qŒ(hXGoalqhh‡hhhhch }qŽ(h$]h%]h#]h"]h&]uh(Kh]qh=XGoalq…q‘}q’(hhhh‹ubaubhi)q“}q”(hUh }q•(h$]h%]h#]h"]h&]uhh‡h]q–hn)q—}q˜(hX¾User or organization takes over 'ownership' of a set of objects (write access for orphaned records), or the existing owner of an object would like to transfer ownership to another principal.q™hh“hhhhqh }qš(h$]h%]h#]h"]h&]uh(K h]q›h=X¾User or organization takes over 'ownership' of a set of objects (write access for orphaned records), or the existing owner of an object would like to transfer ownership to another principal.qœ…q}qž(hh™hh—ubaubahh†ubeubhY)qŸ}q (hX!Summary Ownership transfer needs to be supported so that all there is always someone that has the ability to manage the object. There are many circumstances w where such changes are required, and the DataONE infrastructure should support this operation both technically and operationally. hhRhhhh\h }q¡(h$]h%]h#]h"]h&]uh(Kh)hh]q¢(h_)q£}q¤(hXSummaryq¥hhŸhhhhch }q¦(h$]h%]h#]h"]h&]uh(Kh]q§h=XSummaryq¨…q©}qª(hh¥hh£ubaubhi)q«}q¬(hUh }q­(h$]h%]h#]h"]h&]uhhŸh]q®hn)q¯}q°(hXOwnership transfer needs to be supported so that all there is always someone that has the ability to manage the object. There are many circumstances w where such changes are required, and the DataONE infrastructure should support this operation both technically and operationally.q±hh«hhhhqh }q²(h$]h%]h#]h"]h&]uh(Kh]q³h=XOwnership transfer needs to be supported so that all there is always someone that has the ability to manage the object. There are many circumstances w where such changes are required, and the DataONE infrastructure should support this operation both technically and operationally.q´…qµ}q¶(hh±hh¯ubaubahh†ubeubhY)q·}q¸(hX4Actors - Current and new data owner - Data managers hhRhhhh\h }q¹(h$]h%]h#]h"]h&]uh(Kh)hh]qº(h_)q»}q¼(hXActorsq½hh·hhhhch }q¾(h$]h%]h#]h"]h&]uh(Kh]q¿h=XActorsqÀ…qÁ}qÂ(hh½hh»ubaubhi)qÃ}qÄ(hUh }qÅ(h$]h%]h#]h"]h&]uhh·h]qÆcdocutils.nodes bullet_list qÇ)qÈ}qÉ(hUh }qÊ(UbulletqËX-h"]h#]h$]h%]h&]uhhÃh]qÌ(cdocutils.nodes list_item qÍ)qÎ}qÏ(hXCurrent and new data ownerqÐh }qÑ(h$]h%]h#]h"]h&]uhhÈh]qÒhn)qÓ}qÔ(hhÐhhÎhhhhqh }qÕ(h$]h%]h#]h"]h&]uh(Kh]qÖh=XCurrent and new data ownerq×…qØ}qÙ(hhÐhhÓubaubahU list_itemqÚubhÍ)qÛ}qÜ(hXData managers h }qÝ(h$]h%]h#]h"]h&]uhhÈh]qÞhn)qß}qà(hX Data managersqáhhÛhhhhqh }qâ(h$]h%]h#]h"]h&]uh(Kh]qãh=X Data managersqä…qå}qæ(hháhhßubaubahhÚubehU bullet_listqçubahh†ubeubhY)qè}qé(hX´Preconditions - Content exists in the DataONE system - Owner wants to transfer ownership role - Organization needs to take control of objects (owner no longer filling that role) hhRhhhh\h }qê(h$]h%]h#]h"]h&]uh(Kh)hh]që(h_)qì}qí(hX Preconditionsqîhhèhhhhch }qï(h$]h%]h#]h"]h&]uh(Kh]qðh=X Preconditionsqñ…qò}qó(hhîhhìubaubhi)qô}qõ(hUh }qö(h$]h%]h#]h"]h&]uhhèh]q÷hÇ)qø}qù(hUh }qú(hËX-h"]h#]h$]h%]h&]uhhôh]qû(hÍ)qü}qý(hX$Content exists in the DataONE systemqþh }qÿ(h$]h%]h#]h"]h&]uhhøh]rhn)r}r(hhþhhühhhhqh }r(h$]h%]h#]h"]h&]uh(Kh]rh=X$Content exists in the DataONE systemr…r}r(hhþhjubaubahhÚubhÍ)r}r (hX&Owner wants to transfer ownership roler h }r (h$]h%]h#]h"]h&]uhhøh]r hn)r }r(hj hjhhhhqh }r(h$]h%]h#]h"]h&]uh(Kh]rh=X&Owner wants to transfer ownership roler…r}r(hj hj ubaubahhÚubhÍ)r}r(hXROrganization needs to take control of objects (owner no longer filling that role) h }r(h$]h%]h#]h"]h&]uhhøh]rhn)r}r(hXQOrganization needs to take control of objects (owner no longer filling that role)rhjhhhhqh }r(h$]h%]h#]h"]h&]uh(Kh]rh=XQOrganization needs to take control of objects (owner no longer filling that role)r…r}r(hjhjubaubahhÚubehhçubahh†ubeubhY)r }r!(hX:Triggers - Current owner no longer able to fill that role hhRhhhh\h }r"(h$]h%]h#]h"]h&]uh(K!h)hh]r#(h_)r$}r%(hXTriggersr&hj hhhhch }r'(h$]h%]h#]h"]h&]uh(K!h]r(h=XTriggersr)…r*}r+(hj&hj$ubaubhi)r,}r-(hUh }r.(h$]h%]h#]h"]h&]uhj h]r/hÇ)r0}r1(hUh }r2(hËX-h"]h#]h$]h%]h&]uhj,h]r3hÍ)r4}r5(hX/Current owner no longer able to fill that role h }r6(h$]h%]h#]h"]h&]uhj0h]r7hn)r8}r9(hX.Current owner no longer able to fill that roler:hj4hhhhqh }r;(h$]h%]h#]h"]h&]uh(K!h]r<h=X.Current owner no longer able to fill that roler=…r>}r?(hj:hj8ubaubahhÚubahhçubahh†ubeubhY)r@}rA(hXfPost Conditions - Object ownership has been changed - Updated to roles updated through the federation hhRhhhh\h }rB(h$]h%]h#]h"]h&]uh(K%h)hh]rC(h_)rD}rE(hXPost ConditionsrFhj@hhhhch }rG(h$]h%]h#]h"]h&]uh(K%h]rHh=XPost ConditionsrI…rJ}rK(hjFhjDubaubhi)rL}rM(hUh }rN(h$]h%]h#]h"]h&]uhj@h]rOhÇ)rP}rQ(hUh }rR(hËX-h"]h#]h$]h%]h&]uhjLh]rS(hÍ)rT}rU(hX!Object ownership has been changedrVh }rW(h$]h%]h#]h"]h&]uhjPh]rXhn)rY}rZ(hjVhjThhhhqh }r[(h$]h%]h#]h"]h&]uh(K$h]r\h=X!Object ownership has been changedr]…r^}r_(hjVhjYubaubahhÚubhÍ)r`}ra(hX0Updated to roles updated through the federation h }rb(h$]h%]h#]h"]h&]uhjPh]rchn)rd}re(hX/Updated to roles updated through the federationrfhj`hhhhqh }rg(h$]h%]h#]h"]h&]uh(K%h]rhh=X/Updated to roles updated through the federationri…rj}rk(hjfhjdubaubahhÚubehhçubahh†ubeubeubcdocutils.nodes comment rl)rm}rn(hXÒ@startuml images/32_seq.png actor "User (User or Organization)" as user participant "Client" as app_client << Application >> user -> app_client note right Assume user authority for specifying restrictions end note participant "Authorization API" as c_authorize << Coordinating Node >> app_client -> c_authorize: takeOwnership (objectList) app_client <-- c_authorize: ack or fail note right Is there an authority for any given data / metadata object? end note @endumlhh+hhhUcommentroh }rp(U xml:spacerqUpreserverrh"]h#]h$]h%]h&]uh(K8h)hh]rsh=XÒ@startuml images/32_seq.png actor "User (User or Organization)" as user participant "Client" as app_client << Application >> user -> app_client note right Assume user authority for specifying restrictions end note participant "Authorization API" as c_authorize << Coordinating Node >> app_client -> c_authorize: takeOwnership (objectList) app_client <-- c_authorize: ack or fail note right Is there an authority for any given data / metadata object? end note @endumlrt…ru}rv(hUhjmubaubcdocutils.nodes image rw)rx}ry(hX.. image:: images/32_seq.png hh+hhhUimagerzh }r{(UuriX!design/UseCases/images/32_seq.pngr|h"]h#]h$]h%]U candidatesr}}r~U*j|sh&]uh(K:h)hh]ubhn)r}r€(hX*Figure 1.* Interactions for use case 32. User or organization takes over 'ownership' of a set of objects\n(write access for orphaned records).hh+hhhhqh }r(h$]h%]h#]h"]h&]uh(K;h)hh]r‚(cdocutils.nodes emphasis rƒ)r„}r…(hX *Figure 1.*h }r†(h$]h%]h#]h"]h&]uhjh]r‡h=X Figure 1.rˆ…r‰}rŠ(hUhj„ubahUemphasisr‹ubh=Xƒ Interactions for use case 32. User or organization takes over 'ownership' of a set of objectsn(write access for orphaned records).rŒ…r}rŽ(hX„ Interactions for use case 32. User or organization takes over 'ownership' of a set of objects\n(write access for orphaned records).hjubeubhn)r}r(hX **Notes**r‘hh+hhhhqh }r’(h$]h%]h#]h"]h&]uh(K>h)hh]r“cdocutils.nodes strong r”)r•}r–(hj‘h }r—(h$]h%]h#]h"]h&]uhjh]r˜h=XNotesr™…rš}r›(hUhj•ubahUstrongrœubaubhÇ)r}rž(hUhh+hhhhçh }rŸ(hËX-h"]h#]h$]h%]h&]uh(K@h)hh]r hÍ)r¡}r¢(hX®Q. Is there an authority for any given data/metadata object? A. The authority for any object is expressed in the system metadata element :attr:`SystemMetadata.rightsHolder`. hjhhhhÚh }r£(h$]h%]h#]h"]h&]uh(Nh)hh]r¤hn)r¥}r¦(hX­Q. Is there an authority for any given data/metadata object? A. The authority for any object is expressed in the system metadata element :attr:`SystemMetadata.rightsHolder`.hj¡hhhhqh }r§(h$]h%]h#]h"]h&]uh(K@h]r¨(h=X‰Q. Is there an authority for any given data/metadata object? A. The authority for any object is expressed in the system metadata element r©…rª}r«(hX‰Q. Is there an authority for any given data/metadata object? A. The authority for any object is expressed in the system metadata element hj¥ubcsphinx.addnodes pending_xref r¬)r­}r®(hX#:attr:`SystemMetadata.rightsHolder`r¯hj¥hhhU pending_xrefr°h }r±(UreftypeXattrUrefwarnr²‰U reftargetr³XSystemMetadata.rightsHolderU refdomainXpyr´h"]h#]U refexplicit‰h$]h%]h&]UrefdocrµXdesign/UseCases/32_ucr¶Upy:classr·NU py:moduler¸Nuh(K@h]r¹cdocutils.nodes literal rº)r»}r¼(hj¯h }r½(h$]h%]r¾(Uxrefr¿j´Xpy-attrrÀeh#]h"]h&]uhj­h]rÁh=XSystemMetadata.rightsHolderrÂ…rÃ}rÄ(hUhj»ubahUliteralrÅubaubh=X.…rÆ}rÇ(hX.hj¥ubeubaubaubh)rÈ}rÉ(hX¡.. _history: https://redmine.dataone.org/projects/d1/repository/changes/documents/Projects/cicore/architecture/api-documentation/source/design/UseCases/32_uc.txtU referencedrÊKhh+hhhhh }rË(h~hh"]rÌhah#]h$]h%]h&]rÍhauh(KDh)hh]ubeubehUU transformerrÎNU footnote_refsrÏ}rÐUrefnamesrÑ}rÒh}]rÓhxasUsymbol_footnotesrÔ]rÕUautofootnote_refsrÖ]r×Usymbol_footnote_refsrØ]rÙU citationsrÚ]rÛh)hU current_linerÜNUtransform_messagesrÝ]rÞ(cdocutils.nodes system_message rß)rà}rá(hUh }râ(h$]UlevelKh"]h#]Usourcehh%]h&]UlineKUtypeUINFOrãuh]rähn)rå}ræ(hUh }rç(h$]h%]h#]h"]h&]uhjàh]rèh=X*Hyperlink target "uc32" is not referenced.ré…rê}rë(hUhjåubahhqubahUsystem_messagerìubjß)rí}rî(hUh }rï(h$]UlevelKh"]h#]Usourcehh%]h&]UlineKUtypejãuh]rðhn)rñ}rò(hUh }ró(h$]h%]h#]h"]h&]uhjíh]rôh=X-Hyperlink target "index-0" is not referenced.rõ…rö}r÷(hUhjñubahhqubahjìubeUreporterrøNUid_startrùKU autofootnotesrú]rûU citation_refsrü}rýUindirect_targetsrþ]rÿUsettingsr(cdocutils.frontend Values ror}r(Ufootnote_backlinksrKUrecord_dependenciesrNU rfc_base_urlrUhttps://tools.ietf.org/html/rU tracebackrˆUpep_referencesr NUstrip_commentsr NU toc_backlinksr Uentryr U language_coder UenrU datestamprNU report_levelrKU _destinationrNU halt_levelrKU strip_classesrNh:NUerror_encoding_error_handlerrUbackslashreplacerUdebugrNUembed_stylesheetr‰Uoutput_encoding_error_handlerrUstrictrU sectnum_xformrKUdump_transformsrNU docinfo_xformrKUwarning_streamrNUpep_file_url_templaterUpep-%04drUexit_status_levelr KUconfigr!NUstrict_visitorr"NUcloak_email_addressesr#ˆUtrim_footnote_reference_spacer$‰Uenvr%NUdump_pseudo_xmlr&NUexpose_internalsr'NUsectsubtitle_xformr(‰U source_linkr)NUrfc_referencesr*NUoutput_encodingr+Uutf-8r,U source_urlr-NUinput_encodingr.U utf-8-sigr/U_disable_configr0NU id_prefixr1UU tab_widthr2KUerror_encodingr3UUTF-8r4U_sourcer5hUgettext_compactr6ˆU generatorr7NUdump_internalsr8NU smart_quotesr9‰U pep_base_urlr:U https://www.python.org/dev/peps/r;Usyntax_highlightr<Ulongr=Uinput_encoding_error_handlerr>jUauto_id_prefixr?Uidr@Udoctitle_xformrA‰Ustrip_elements_with_classesrBNU _config_filesrC]rDUfile_insertion_enabledrEˆU raw_enabledrFKU dump_settingsrGNubUsymbol_footnote_startrHKUidsrI}rJ(hh+hh+hIhRhjÈuUsubstitution_namesrK}rLhh)h }rM(h$]h"]h#]Usourcehh%]h&]uU footnotesrN]rOUrefidsrP}rQ(h]rRhahI]rShNauub.