SZDBZ 17.6-2008 深圳市電子政務應用服務規(guī)范 第6部分：組織身份服務接口規(guī)范

深圳市電子政務應用服務規(guī)范第6部分：組織身份服務接口規(guī)范2008-11-18發(fā)布深圳市質(zhì)量技術監(jiān)督局發(fā)布ISZDB/Z17.6—2008 I1范圍 2規(guī)范性引用文件 3作用 4.1身份認證接口 4.2組織身份管理接口 24.3組織身份信息接口 114.4組織身份監(jiān)聽接口 20 22ⅡSZDB/Z17-2008《深圳市電子政務應用服務規(guī)范》目前分為10個部分：——第1部分《總則》——第2部分《應用系統(tǒng)分類及代碼規(guī)范》——第3部分《應用系統(tǒng)描述規(guī)范》——第4部分《組織身份模型數(shù)據(jù)規(guī)范》——第5部分《應用服務運行管理框架規(guī)范》——第6部分《組織身份服務接口規(guī)范》——第7部分《訪問控制服務接口規(guī)范》——第8部分《單點登錄服務接口規(guī)范》——第9部分《電子表單服務接口規(guī)范》——第10部分《業(yè)務流程服務接口規(guī)范》本部分為SZDB/Z17-2008的第6部分。本技術規(guī)范適用于深圳市各級黨政機關的信息化建設工作。對于本部分未能術規(guī)范的編寫原則對本部分內(nèi)容進行擴充。本技術規(guī)范文件由深圳市信息化領導小組辦公室、深圳市福田區(qū)信息中心提出。有限公司共同起草。禮洪、楊海波、王姝、張煥煥、劉用軍、梁文龍等。本技術規(guī)范文件為首次發(fā)布。第6部分：組織身份服務接口規(guī)范本部分規(guī)定了電子政務應用系統(tǒng)中組織身份各種實體的操作接口、實體間關詢接口，規(guī)定了組織身份服務的服務注冊接口、同其它系統(tǒng)的數(shù)據(jù)同步接口。本部分主要用于深圳市各級黨政機關的信息系統(tǒng)規(guī)劃與建設，以及電子政務成商、軟件開發(fā)商和監(jiān)理單位進行信息化規(guī)劃、建設。適用于依據(jù)本規(guī)范第3部分《組織身份模型數(shù)據(jù)本部分也適用于指導基于組織模型構(gòu)建的各類應用系統(tǒng)對組織模型相關接口的調(diào)管理。2規(guī)范性引用文件下列文件中的條款通過本部分的引用而成為本部分的條款。凡是修改單(不包括勘誤的內(nèi)容)或修訂版均不適用于本部分，然而，鼓勵根據(jù)本部分達成協(xié)議的各方研究是否可使用這些文件的最新版本。凡是不注日期的引用文件，其最新版本適用于本部分。SZDB/Z17.1-2008電子政務應用服務規(guī)范第1部分：總則SZDB/Z17.4-2008電子政務應用服務規(guī)范第4部分：組織身份模型數(shù)據(jù)規(guī)范3作用應用系統(tǒng)只需關注業(yè)務流程及業(yè)務邏輯的設計，認證、組織身份信息均可以由組織身份服務接口獲得。組織身份服務以組織身份模型為數(shù)據(jù)來源，為訪問控制服務、單點登錄服務等提供運行支撐。4接口定義組織身份服務接口分為身份認證接口、組織身份管理接口、組織身份信類。為其他應用系統(tǒng)提供統(tǒng)一的身份認證。4.1.1認證接口AuthenticateService.authentica服務說明參數(shù)名稱參數(shù)說明String類型，用戶名AuthenticateFailExcept如果認證過程發(fā)生錯誤，則拋出此異常2boolean值，認證通過返回true,否則返回false。備注AuthenticateService.caPass服務說明用戶，存在即設置此用戶為已登錄狀態(tài)，否則參數(shù)名稱參數(shù)說明的唯一標識。AuthenticateFailExcept如果認證過程發(fā)生錯誤，則拋出此異常boolean值，認證通過返回true,否則返回false。備注DepartmentManager.cr服務說明在指定的父節(jié)點下創(chuàng)建一個部門參數(shù)名稱參數(shù)說明如果創(chuàng)建失敗，拋出此異常Department對象，返回已創(chuàng)建的子部門對象，包含為子部門對象新生成的U本號為0。備注服務說明參數(shù)名稱參數(shù)說明Department對象，用于更新的部門對象實例boolean類型，是否要生成新的版本號如果更新失敗，則拋出此異常返回成功更新后的部門(Department)實例，如果生成了新版本，則版本號加備注服務說明參數(shù)名稱參數(shù)說明String類型，需要移動的部門對象唯一標識3String類型，目標父節(jié)點對象的唯一標識。如果移動失敗，則拋出此異常無備注DepartmentManager.de服務說明刪除指定的部門，同時刪除此部門下的所有對象及其所有版本。參數(shù)名稱參數(shù)說明String類型，被刪除的部門對象唯一標識如果刪除失敗，則拋出此異常無備注本操作是遞歸刪除。禁用部門DepartmentManager.dis服務說明被查詢。執(zhí)行禁用操作時，在被禁用部門上標記“禁用”狀態(tài)。參數(shù)名稱參數(shù)說明String類型，被禁用部門對象唯一標識如果禁用操作失敗，則拋出此異常無備注DepartmentManager.ena服務說明參數(shù)名稱參數(shù)說明String類型，需要恢復的部門對象唯一標識如果恢復操作失敗，則拋出此異常無備注服務說明在指定的父節(jié)點下創(chuàng)建人員，父節(jié)點可以是部門或機構(gòu)。參數(shù)名稱參數(shù)說明String類型，父節(jié)點對象唯一標識如果創(chuàng)建失敗，拋出此異常返回已創(chuàng)建的人員對象，包含新生成的人員對象UID,初始版本號為0。4服務說明參數(shù)名稱參數(shù)說明如果更新失敗，則拋出此異常返回成功更新后的人員(Person)實例，如果生成了新版本，則版本號加1。備注服務說明將指定的人員移動到另一個父節(jié)點下，父節(jié)點可以是部門或機構(gòu)。參數(shù)名稱參數(shù)說明String類型，被移動的人員對象唯一標識String類型，目標父節(jié)點對象唯一標識。如果移動操作失敗，拋出此異常無備注服務說明刪除指定的人員參數(shù)名稱參數(shù)說明String類型，被刪除的人員對象唯一標識如果刪除失敗，則拋出此異常無備注服務說明禁用人員上標記“禁用”狀態(tài)。參數(shù)名稱參數(shù)說明String類型，被禁用人員對象唯一標識如果禁用操作失敗，則拋出此異常無備注服務名稱DepartmentManager.服務名稱DepartmentManager.enable5服務說明參數(shù)名稱參數(shù)說明String類型，被恢復人員對象唯一標識如果恢復操作失敗，則拋出此異常無備注服務說明在指定的父節(jié)點下創(chuàng)建角色，父節(jié)點是部門或機構(gòu)。參數(shù)名稱參數(shù)說明String類型，父節(jié)點的唯一標識如果創(chuàng)建失敗，拋出此異常備注服務說明更新指定的角色。參數(shù)名稱參數(shù)說明Role對象，用于更新的角色對象實例如果更新失敗，拋出此異常備注服務說明將指定的角色移動到另一個父節(jié)點下，父節(jié)點是部門或機構(gòu)。參數(shù)說明String類型，被移動的角色對象唯一標識String類型，目標父節(jié)點對象唯一標識。如果移動失敗，則拋出此異常無備注服務說明參數(shù)名稱參數(shù)說明String類型，被刪除的角色對象唯一標識6如果刪除失敗，拋出此異常無備注服務說明參數(shù)名稱參數(shù)說明String類型，父節(jié)點的唯一標識如果創(chuàng)建失敗，拋出此異常備注服務說明更新用戶組。參數(shù)名稱參數(shù)說明如果更新失敗，拋出此異常備注服務說明將指定的用戶組移動到另一個父節(jié)點下，父節(jié)點是部門或機構(gòu)。參數(shù)名稱參數(shù)說明String類型，被移動的用戶組對象唯一標識String類型，目標父節(jié)點對象的唯一標識。如果移動失敗，則拋出此異常無備注服務說明體本身。參數(shù)名稱參數(shù)說明String類型，被刪除用戶組對象唯一標識如果刪除失敗，拋出此異常無備注7服務說明參數(shù)名稱參數(shù)說明String類型，父節(jié)點的唯一標識如果創(chuàng)建失敗，拋出此異常備注服務說明更新指定的崗位。參數(shù)說明如果更新失敗，拋出此異常備注服務說明將指定的崗位移動到另一個父節(jié)點下，父節(jié)點是部門或機構(gòu)。參數(shù)名稱參數(shù)說明String類型，被移動的崗位對象唯一標識String類型，目標父節(jié)點對象的唯一標識。如果移動失敗，則拋出此異常無備注服務說明參數(shù)名稱參數(shù)說明String類型，被刪除的崗位對象唯一標識如果刪除失敗，拋出此異常無備注8OrganizationManager服務說明創(chuàng)建新的機構(gòu)。參數(shù)名稱參數(shù)說明如果創(chuàng)建失敗，拋出此異常備注服務說明更新指定的機構(gòu)。參數(shù)名稱參數(shù)說明如果更新失敗，拋出此異常備注OrganizationManager服務說明參數(shù)名稱參數(shù)說明String類型，被刪除的機構(gòu)對象唯一標識如果刪除失敗，拋出此異常無備注本操作是遞歸刪除。OrganizationManager.服務說明被查詢。執(zhí)行禁用操作時，在被禁用機構(gòu)上標記“禁用”狀態(tài)。參數(shù)名稱參數(shù)說明String類型，被禁用的機構(gòu)對象唯一標識如果禁用操作失敗，則拋出此異常無備注OrganizationManager服務說明9的“禁用”標記，恢復到禁用之前的狀態(tài)。參數(shù)名稱參數(shù)說明String類型，被恢復的機構(gòu)對象唯一標識如果恢復操作失敗，則拋出此異常無備注服務說明在指定的組下添加指定的人員參數(shù)名稱參數(shù)說明String類型，用戶組對象唯一標識String類型，被添加到用戶組的人員對象唯一標識如果添加失敗，則拋出此異常無備注服務說明在指定的組下刪除指定的人員參數(shù)名稱參數(shù)說明String類型，用戶組對象唯一標識String類型，被刪除的人員對象唯一標識如果刪除失敗，則拋出此異常無備注服務說明參數(shù)名稱參數(shù)說明String類型，父用戶組對象唯一標識String類型，子用戶組對象唯一標識如果添加失敗，則拋出此異常無備注服務名稱GroupManager.removeSubGroup服務說明參數(shù)名稱參數(shù)說明String類型，父用戶組對象唯一標識String類型，子用戶組對象唯一標識如果刪除失敗，則拋出此異常無備注服務說明在指定的角色中添加人員參數(shù)名稱參數(shù)說明String類型，角色對象唯一標識String類型，人員對象唯一標識如果添加失敗，則拋出此異常無備注服務說明刪除指定角色中的人員參數(shù)名稱參數(shù)說明String類型，角色對象唯一標識String類型，人員對象唯一標識如果刪除失敗，則拋出此異常無備注服務說明參數(shù)名稱參數(shù)說明String類型，父角色對象唯一標識String類型，子角色對象唯一標識如果添加失敗，則拋出此異常無備注服務說明參數(shù)名稱參數(shù)說明String類型，父角色對象唯一標識String類型，子角色對象唯一標識如果刪除失敗，則拋出此異常無備注PositionManager.add服務說明在指定的崗位下添加人員參數(shù)說明String類型，崗位對象唯一標識String類型，人員對象唯一標識如果添加失敗，則拋出此異常無備注PositionManager.remove服務說明刪除指定的崗位下的人員參數(shù)說明String類型，崗位對象唯一標識String類型，人員對象唯一標識如果刪除失敗，則拋出此異常無備注OrgUnitManager.getOrg服務說明參數(shù)名稱參數(shù)說明String類型，實體對象唯一標識OrgRelationRetrieve如果獲取失敗，則拋出此異常備注服務說明使用實體屬性構(gòu)成的查詢條件，查詢實體對象。參數(shù)名稱參數(shù)說明String類型，實體對象的完整類名，其格式為：命名空間+“.”+實體對象類名，區(qū)分大小寫。String類型，查詢條件，不包含where字符串。查詢條件的格式應符合ANSISQL92中where子句對查詢?nèi)绻@取失敗，則拋出此異常返回實體對象唯一標識數(shù)組。備注OrganizationManager.getAll0rga服務說明獲得組織身份模型中所有的機構(gòu)對象如果獲取失敗，則拋出此異常備注OrganizationManager.getDe服務說明獲得機構(gòu)下直接包含的部門對象參數(shù)名稱參數(shù)說明String類型，機構(gòu)對象唯一標識OrgRelationRetrieve如果獲取失敗，則拋出此異常備注不遞歸，只返回該機構(gòu)直接包含的部門對象OrganizationManager.服務說明獲得機構(gòu)下直接包含的用戶組對象參數(shù)名稱參數(shù)說明String類型，機構(gòu)對象唯一標識OrgRelationRetrieve如果獲取失敗，則拋出此異常備注不遞歸，只返回該機構(gòu)直接包含的用戶組對象服務名稱OrganizationManager.getRoles服務名稱OrganizationManager.getRoles服務說明獲得機構(gòu)下直接包含的角色對象參數(shù)名稱參數(shù)說明String類型，機構(gòu)對象唯一標識OrgRelationRetrieve如果獲取失敗，則拋出此異常備注不遞歸，只返回該機構(gòu)直接包含的角色對象OrganizationManager.get服務說明獲得機構(gòu)下直接包含的崗位對象參數(shù)名稱參數(shù)說明String類型，機構(gòu)對象唯一標識OrgRelationRetrieve如果獲取失敗，則拋出此異常備注不遞歸，只返回該機構(gòu)直接包含的崗位對象OrganizationManager.g服務說明參數(shù)說明String類型，機構(gòu)對象唯一標識OrgRelationRetrieve如果獲取失敗，則拋出此異常備注服務說明獲得人員的父節(jié)點(機構(gòu)或部門對象)參數(shù)名稱參數(shù)說明String類型，人員對象唯一標識OrgRelationRetrieve如果獲取失敗，則拋出此異常備注PersonManager.getPos服務說明獲得人員所擔任的所有崗位對象參數(shù)名稱s參數(shù)說明String類型，人員對象唯一標識OrgRelationRetrieve如果獲取失敗，則拋出此異常備注服務說明獲得人員所屬的所有用戶組對象參數(shù)名稱參數(shù)說明String類型，人員對象唯一標識OrgRelationRetrieve如果獲取失敗，則拋出此異常備注如果返回的用戶組存在父子關系，則父用戶組和子用戶組都返回服務說明獲得指定人員所承擔的所有角色對象參數(shù)名稱參數(shù)說明String類型，人員對象唯一標識OrgRelationRetrieve如果獲取失敗，則拋出此異常備注如果返回的角色存在父子關系，則父角色和子角色都返回服務說明獲得部門父節(jié)點(機構(gòu)或部門對象)參數(shù)名稱參數(shù)說明String類型，部門對象唯一標識OrgRelationRetrieve如果獲取失敗，則拋出此異常備注DepartmentManager.getSubDepar服務說明獲得部門下直接包含的子部門對象參數(shù)名稱參數(shù)說明String類型，部門對象唯一標識OrgRelationRetrieve如果獲取失敗，則拋出此異常備注不遞歸，只返回直接包含的部門DepartmentManager.get服務說明獲得部門下直接包含的用戶組對象參數(shù)名稱參數(shù)說明String類型，部門對象唯一標識OrgRelationRetrieve如果獲取失敗，則拋出此異常備注DepartmentManager.ge服務說明獲得部門下直接包含的角色對象參數(shù)名稱參數(shù)說明String類型，部門對象唯一標識OrgRelationRetrieve如果獲取失敗，則拋出此異常備注不遞歸，只返回直接包含的角色對象。DepartmentManager.getPosi服務說明參數(shù)說明String類型，部門對象唯一標識OrgRelationRetrieve如果獲取失敗，則拋出此異常備注DepartmentManager.getP服務說明獲得部門下的直接包含的人員對象參數(shù)名稱參數(shù)說明String類型，部門對象唯一標識OrgRelationRetrieve如果獲取失敗，則拋出此異常備注DepartmentManager.getAl1P服務說明獲得部門下所有的人員參數(shù)名稱參數(shù)說明String類型，部門對象唯一標識OrgRelationRetrieve如果獲取失敗，則拋出此異常備注服務說明獲得用戶組父節(jié)點(機構(gòu)或部門對象)參數(shù)名稱參數(shù)說明String類型，用戶組對象的唯一標識OrgRelationRetrieve如果獲取失敗，則拋出此異常備注GroupManager.getAl1服務說明獲得指定用戶組下的所有人員對象參數(shù)名稱參數(shù)說明String類型，用戶組對象唯一標識OrgRelationRetrieve如果獲取失敗，則拋出此異常備注服務說明獲得指定用戶組直接包含的人員對象參數(shù)名稱參數(shù)說明String類型，用戶組對象唯一標識OrgRelationRetrieve如果獲取失敗，則拋出此異常備注服務說明獲得指定用戶組下直接包含的子用戶組對象參數(shù)名稱參數(shù)說明String類型，用戶組對象唯一標識OrgRelationRetrieve如果獲取失敗，則拋出此異常備注服務名稱服務說明參數(shù)說明String類型，用戶組對象唯一標識OrgRelationRetrieve如果獲取失敗，則拋出此異常備注不向上遞歸，只返回直接隸屬的父用戶組對象。服務說明獲得指定角色的父節(jié)點(機構(gòu)或部門對象)參數(shù)名稱參數(shù)說明String類型，角色對象唯一標識OrgRelationRetrieve如果獲取失敗，則拋出此異常返回值是機構(gòu)或部門對象。備注服務說明獲得指定角色的所有承擔者(人員對象)參數(shù)名稱參數(shù)說明String類型，角色對象唯一標識OrgRelationRetrieve如果獲取失敗，則拋出此異常備注服務說明獲得指定角色的直接承擔者(人員對象)參數(shù)名稱參數(shù)說明String類型，角色對象唯一標識OrgRelationRetrieve如果獲取失敗，則拋出此異常備注服務說明獲得指定角色直接包含的子角色對象參數(shù)名稱參數(shù)說明String類型，角色對象唯一標識OrgRelationRetrieve如果獲取失敗，則拋出此異常備注不遞歸，只返回直接包含的子角色對象。服務說明獲得指定角色的父角色對象參數(shù)名稱參數(shù)說明String類型，角色對象唯一標識OrgRelationRetrieve如果獲取失敗，則拋出此異常備注不向上遞歸，只返回直接隸屬的父角色對象。服務說明獲得指定崗位的父節(jié)點(機構(gòu)或部門對象)參數(shù)名稱參數(shù)說明String類型，崗位對象唯一標識OrgRelationRetrieve如果獲取失敗，則拋出此異常返回值是機構(gòu)或部門對象。備注服務說明獲得指定崗位的所有人員對象參數(shù)名稱參數(shù)說明String類型，崗位對象唯一標識OrgRelationRetrieve如果獲取失敗，則拋出此異常備注4.4組織身份監(jiān)聽接口組織身份同步服務可以從組織身份模型向其他應用系統(tǒng)同步組織身份數(shù)由組織身份數(shù)據(jù)模型進行同步，它必須提供一個監(jiān)聽器，此監(jiān)聽器應實現(xiàn)如下接口：InterfaceOrgMPublicvoidhasChanged(inteventType,Object[]objects,StringtargetUID);}eventType:事件類型，表明由于該類型事件引起源對象發(fā)生變化，對應下表中的第二列。事件類更新(U):更新了一個實體對象的屬性，或者改變了該實體的狀態(tài)，值為2。移動(M):移動了一個實體到另一個節(jié)點下面，并移動了包含