public interface WorkspaceService
[ 操作ユーザについて ]
このクラスでは、アカウントコンテキストのユーザコードを元に操作します。
またユーザの所属組織は、ユーザコンテキストのカレント組織を元に操作します。
[ 操作可能なワークスペースについて ]
ワークスペースを操作する場合、操作ユーザがワークスペースのメンバーである必要があります。
String addGroupBox(WorkspaceKey workspaceKey) throws InvalidParameterException, AuthenticationException, OperationException, ModuleCallInterfaceException
ここでは、ワークスペースのメンバーのみのプライベートなGroupBoxを作成します。
指定したワークスペースのGroupBoxが既に存在する場合、新たに作成することはできません。
IMBox機能がインストールしていない場合、NULL
が返却されます。
[ 操作ユーザの権限状態 ]
操作ユーザが以下の場合、このAPIを利用することができます。
workspaceKey
- ワークスペースキーInvalidParameterException
- 入力項目値に不正があった場合に発生します。AuthenticationException
- アクセス権違反した場合に発生します。OperationException
- データ不整合が起こる場合に発生します。ModuleCallInterfaceException
- IMBoxとの連携に失敗した場合に発生します。WorkspaceItem addItem(WorkspaceAddItemKey itemKey, Map<String,String> itemStteing) throws InvalidParameterException, AuthenticationException, OperationException, ModuleCallInterfaceException, WorkspaceNoItemConfigException
操作ユーザがアイテム追加を許可されている場合のみ、アイテムを追加できます。
[ アイテムの固有設定について ]
追加しようとするアイテム固有の設定がある場合に利用します。
固有設定のキー値については、各アイテムを参照してください。
[ 操作ユーザの権限状態 ]
操作ユーザが以下のいずれかに該当する場合、このAPIを利用することができます。
itemKey
- アイテムキーitemStteing
- 追加するアイテムの固有設定情報InvalidParameterException
- 入力項目値に不正があった場合に発生します。AuthenticationException
- アクセス権違反した場合に発生します。OperationException
- データ不整合が起こる場合に発生します。ModuleCallInterfaceException
- アイテム側で不備があった場合に発生します。WorkspaceNoItemConfigException
- アイテム定義に不備がある場合に発生します。@Deprecated Workspace addWorkspace(Workspace workspace) throws InvalidParameterException, OperationException, ModuleCallInterfaceException
IMBoxのGroupBoxも合わせて作成します。
作成されるGroupBoxは、ワークスペースメンバーのみのプライベートなグループとなります。
ワークススペースの追加には、操作ユーザのカレント組織に所属組織情報が存在する必要があります。
workspace
- ワークスペース情報InvalidParameterException
- 入力項目値に不正があった場合に発生します。OperationException
- データ不整合が起こる場合に発生します。ModuleCallInterfaceException
- IMBoxとの連携に失敗した場合に発生します。WorkspaceCreateResult createWorkspace(Workspace workspace) throws InvalidParameterException, OperationException, ModuleCallInterfaceException
IMBoxのGroupBoxも合わせて作成します。
作成されるGroupBoxは、ワークスペースメンバーのみのプライベートなグループとなります。
GroupBox作成権限がない等、GroupBoxの作成に失敗した場合でもワークスペースを作成します。
ワークススペースの追加には、操作ユーザのカレント組織に所属組織情報が存在する必要があります。
workspace
- ワークスペース情報data
プロパティには、WorkspaceCreateResult
を設定します。InvalidParameterException
- 入力項目値に不正があった場合に発生します。OperationException
- データ不整合が起こる場合に発生します。ModuleCallInterfaceException
- IMBoxとの連携に失敗した場合に発生します。WorkspaceCreateResult createWorkspace(Workspace workspace, boolean isPublicGroupBox) throws InvalidParameterException, OperationException, ModuleCallInterfaceException
IMBoxのGroupBoxも合わせて作成します。
GroupBox作成権限がない等、GroupBoxの作成に失敗した場合でもワークスペースを作成します。
ワークススペースの追加には、操作ユーザのカレント組織に所属組織情報が存在する必要があります。
workspace
- ワークスペース情報isPublicGroupBox
- true : 公開 GroupBox/ false : 非公開 GroupBoxdata
プロパティには、WorkspaceCreateResult
を設定します。InvalidParameterException
- 入力項目値に不正があった場合に発生します。OperationException
- データ不整合が起こる場合に発生します。ModuleCallInterfaceException
- IMBoxとの連携に失敗した場合に発生します。WorkspaceCreateResult createWorkspaceLimited(Workspace workspace) throws InvalidParameterException, OperationException, ModuleCallInterfaceException, AuthenticationException
IMBoxのGroupBoxも合わせて作成します。
作成されるGroupBoxは、ワークスペースメンバーのみのプライベートなグループとなります。
GroupBox作成権限がない等、GroupBoxの作成に失敗した場合でもワークスペースを作成します。
ワークススペースの追加には、操作ユーザのカレント組織に所属組織情報が存在する必要があります。
ワークスペース作成権限設定がtrueの場合は、以下のいずれかに該当するユーザのみがワークスペースを作成することが出来ます。
workspace
- ワークスペース情報data
プロパティには、WorkspaceCreateResult
を設定します。InvalidParameterException
- 入力項目値に不正があった場合に発生します。OperationException
- データ不整合が起こる場合に発生します。ModuleCallInterfaceException
- IMBoxとの連携に失敗した場合に発生します。AuthenticationException
- アクセス権違反した場合に発生します。WorkspaceCreateResult createWorkspaceLimited(Workspace workspace, boolean isPublicGroupBox) throws InvalidParameterException, OperationException, ModuleCallInterfaceException, AuthenticationException
IMBoxのGroupBoxも合わせて作成します。
GroupBox作成権限がない等、GroupBoxの作成に失敗した場合でもワークスペースを作成します。
ワークススペースの追加には、操作ユーザのカレント組織に所属組織情報が存在する必要があります。
ワークスペース作成権限設定がtrueの場合は、以下のいずれかに該当するユーザのみがワークスペースを作成することが出来ます。
workspace
- ワークスペース情報isPublicGroupBox
- true : 公開 GroupBox/ false : 非公開 GroupBoxdata
プロパティには、WorkspaceCreateResult
を設定します。InvalidParameterException
- 入力項目値に不正があった場合に発生します。OperationException
- データ不整合が起こる場合に発生します。ModuleCallInterfaceException
- IMBoxとの連携に失敗した場合に発生します。AuthenticationException
- アクセス権違反した場合に発生します。WorkspaceCreateResult createWorkspaceLimitedNoGroupBox(Workspace workspace) throws InvalidParameterException, OperationException, ModuleCallInterfaceException, AuthenticationException
ワークススペースの追加には、操作ユーザのカレント組織に所属組織情報が存在する必要があります。
ワークスペース作成権限設定がtrueの場合は、以下のいずれかに該当するユーザのみがワークスペースを作成することが出来ます。
workspace
- ワークスペース情報data
プロパティには、WorkspaceCreateResult
を設定します。InvalidParameterException
- 入力項目値に不正があった場合に発生します。OperationException
- データ不整合が起こる場合に発生します。ModuleCallInterfaceException
- IMBoxとの連携に失敗した場合に発生します。AuthenticationException
- アクセス権違反した場合に発生します。WorkspaceCreateResult createWorkspaceNoGroupBox(Workspace workspace) throws InvalidParameterException, OperationException, ModuleCallInterfaceException
ワークススペースの追加には、操作ユーザのカレント組織に所属組織情報が存在する必要があります。
workspace
- ワークスペース情報data
プロパティには、WorkspaceCreateResult
を設定します。InvalidParameterException
- 入力項目値に不正があった場合に発生します。OperationException
- データ不整合が起こる場合に発生します。ModuleCallInterfaceException
- IMBoxとの連携に失敗した場合に発生します。Integer deleteItem(WorkspaceItemKey itemKey) throws InvalidParameterException, AuthenticationException, OperationException, ModuleCallInterfaceException
[ 操作ユーザの権限状態 ]
操作ユーザが以下のいずれかに該当する場合、このAPIを利用することができます。
itemKey
- アイテムキーInvalidParameterException
- 入力項目値に不正があった場合に発生します。AuthenticationException
- アクセス権違反した場合に発生します。OperationException
- データ不整合が起こる場合に発生します。ModuleCallInterfaceException
- アイテム側で不備があった場合に発生します。Integer deleteWorkspace(WorkspaceKey workspaceKey) throws InvalidParameterException, AuthenticationException, OperationException, ModuleCallInterfaceException
操作ユーザが ワークスペースの削除は、オーナー権限をユーザのみ可能です。
IMBoxと連携している場合、GroupBoxの削除は行いません。
[ 操作ユーザの権限状態 ]
操作ユーザが以下の場合、このAPIを利用することができます。
workspaceKey
- ワークスペースキーInvalidParameterException
- 入力項目値に不正があった場合に発生します。AuthenticationException
- アクセス権違反した場合に発生します。OperationException
- データ不整合が起こる場合に発生します。ModuleCallInterfaceException
- アイテム側で不備があった場合に発生します。Item findItem(String itemType, ItemKey itemKey) throws InvalidParameterException, AuthenticationException
該当するアイテムが存在しない場合、NULL
を返却します。
itemType
- アイテム種別itemKey
- アイテムキーInvalidParameterException
- 入力項目値に不正があった場合に発生します。AuthenticationException
- アクセス権違反した場合に発生します。Item[] findItems(WorkspaceKey workspaceKey, String itemType) throws InvalidParameterException, AuthenticationException
アイテム種別には、各アイテムで定義している種別を設定します。
アイテム種別を設定していない場合、すべてのワークスペースのアイテムを取得します。
該当するデータが無い場合、空の配列を返却します。
workspaceKey
- ワークスペースキーitemType
- アイテム種別InvalidParameterException
- 入力項目値に不正があった場合に発生します。AuthenticationException
- アクセス権違反した場合に発生します。Item[] findItemsByItemKeys(WorkspaceKey workspaceKey, ItemUniqueKey[] keys) throws InvalidParameterException, AuthenticationException
該当するデータが無い場合、空の配列を返却します。
workspaceKey
- ワークスペースキーkeys
- アイテムのユニークキーInvalidParameterException
- 入力項目値に不正があった場合に発生します。AuthenticationException
- アクセス権違反した場合に発生します。Item[] findItemsByUser(String[] userCds, String itemType) throws InvalidParameterException
指定したユーザと操作ユーザがメンバーとなっているワークスペースで、指定したアイテム種別のアイテムを取得します。
アイテム種別を指定しない場合、すべてのアイテムを取得します。
該当するデータがない場合、NULL
を返却します。
userCds
- ユーザコードitemType
- アイテム種別InvalidParameterException
- 入力項目値に不正があった場合に発生します。Item[] findItemsExcludable(WorkspaceKey workspaceKey, String[] excludeItemTypes, ItemUniqueKey[] excludeItems) throws InvalidParameterException, AuthenticationException
アイテム種別を設定した場合、指定したアイテム種別を除外したアイテムを取得します。
アイテムユニークキーを指定した場合、対象のアイテムを除外したアイテムを取得します。
上記を設定していない場合は、指定したワークスペースに登録されているすべてのアイテムを取得します。
workspaceKey
- ワークスペースキーexcludeItemTypes
- 除外対象のアイテム種別excludeItems
- 除外対象のアイテムユニークキーInvalidParameterException
- 入力項目値に不正があった場合に発生します。AuthenticationException
- アクセス権違反した場合に発生します。Item findItemWithSort(ItemKey itemKey, String itemType) throws InvalidParameterException, AuthenticationException
itemKey
- アイテムキーitemType
- アイテム種別InvalidParameterException
- 入力項目値に不正があった場合に発生します。AuthenticationException
- アクセス権違反した場合に発生します。WorkspaceMain findWorkspace(WorkspaceKey workspaceKey) throws InvalidParameterException, AuthenticationException
該当するデータが存在しない場合、NULL
を返却します。
workspaceKey
- ワークスペースキーInvalidParameterException
- 入力項目値に不正があった場合に発生します。AuthenticationException
- アクセス権違反した場合に発生します。WorkspaceSummary findWorkspaceSummary(WorkspaceKey workspaceKey) throws InvalidParameterException, AuthenticationException
該当するデータが存在しない場合、NULL
を返却します。
workspaceKey
- ワークスペースキーInvalidParameterException
- 入力項目値に不正があった場合に発生します。AuthenticationException
- アクセス権違反した場合に発生します。Map<String,ItemConfigration> getItemConfigrationMap()
ワークスペースのシステム設定ファイルで定義したアイテムの定義情報を取得します。
Long getMaxQueueTime(WorkspaceKey workspaceKey) throws InvalidParameterException, AuthenticationException
workspaceKey
- ワークスペースキーInvalidParameterException
- 入力項目値に不正があった場合に発生します。AuthenticationException
- アクセス権違反した場合に発生します。@Deprecated BroadcastData pushBroadcastData(BroadcastDataRegister parameter) throws InvalidParameterException, AuthenticationException
sendBroadcast(BroadcastSend)
を使用して下さい。BroadcastData
オブジェクトを返します。parameter
- 通知情報InvalidParameterException
- 入力項目値に不正があった場合に発生します。AuthenticationException
- アクセス権違反した場合に発生します。void sendBroadcast(BroadcastSend parameter) throws InvalidParameterException, AuthenticationException
parameter
- BroadcastSend 通知依頼情報InvalidParameterException
- 入力項目値に不正があった場合に発生します。AuthenticationException
- アクセス権違反した場合に発生します。void unWatch(WorkspaceKey workspaceKey) throws InvalidParameterException, AuthenticationException, ModuleCallInterfaceException
IMBox連携時に、操作ユーザがウォッチしているワークスペースに対してアンウォッチします。
workspaceKey
- ワークスペースキーInvalidParameterException
- 入力項目値に不正があった場合に発生します。AuthenticationException
- アクセス権違反した場合に発生します。ModuleCallInterfaceException
- IMBoxとの連携に失敗した場合に発生します。WorkspaceKey[] updateActiveStatus(WorkspaceKey[] workspaceKeys, Boolean isActive) throws InvalidParameterException, AuthenticationException
[ 操作ユーザの権限状態 ]
操作ユーザが以下の場合、このAPIを利用することができます。
workspaceKeys
- ワークスペースキーisActive
- true : アクティブに更新 / false : 非アクティブに更新InvalidParameterException
- 入力項目値に不正があった場合に発生します。AuthenticationException
- アクセス権違反した場合に発生します。Integer updateAllowAddOwnerStatus(WorkspaceKey workspaceKey, Boolean isArrowAddItem) throws InvalidParameterException, AuthenticationException
[ 操作ユーザの権限状態 ]
操作ユーザが以下の場合、このAPIを利用することができます。
workspaceKey
- ワークスペースキーisArrowAddItem
- true : メンバーによるアイテム追加を許可 / false : オーナーのみアイテム追加を許可InvalidParameterException
- 入力項目値に不正があった場合に発生します。AuthenticationException
- アクセス権違反した場合に発生します。int updateItemSortKey(ItemSortKeyUpdate parameter) throws InvalidParameterException, AuthenticationException, OperationException
parameter
- 表示順変更情報InvalidParameterException
- 入力項目値に不正があった場合に発生します。AuthenticationException
- アクセス権違反した場合に発生します。OperationException
- データ不整合が起こる場合に発生します。Integer updateItemTitle(WorkspaceItemKey itemKey, String title) throws InvalidParameterException, AuthenticationException, OperationException
[ 操作ユーザの権限状態 ]
操作ユーザが以下のいずれかに該当する場合、このAPIを利用することができます。
itemKey
- アイテムキーtitle
- タイトルInvalidParameterException
- 入力項目値に不正があった場合に発生します。AuthenticationException
- アクセス権違反した場合に発生します。OperationException
- データ不整合が起こる場合に発生します。Integer updateWorkspaceSummary(WorkspaceSummary summary) throws InvalidParameterException, AuthenticationException, ModuleCallInterfaceException
IMBox連携時、ワークスペースのタイトルを更新すると、GroupBoxのタイトルも合わせて更新します。
[ 操作ユーザの権限状態 ]
操作ユーザが以下の場合、このAPIを利用することができます。
summary
- 概要情報InvalidParameterException
- 入力項目値に不正があった場合に発生します。AuthenticationException
- アクセス権違反した場合に発生します。ModuleCallInterfaceException
- IMBoxとの連携に失敗した場合に発生します。void watch(WorkspaceKey workspaceKey) throws InvalidParameterException, AuthenticationException, OperationException, ModuleCallInterfaceException
IMBox連携時に、操作ユーザがワークスペースに対してウォッチします。
workspaceKey
- ワークスペースキーInvalidParameterException
- 入力項目値に不正があった場合に発生します。AuthenticationException
- アクセス権違反した場合に発生します。OperationException
- データ不整合が起こる場合に発生します。ModuleCallInterfaceException
- IMBoxとの連携に失敗した場合に発生します。Copyright © 2012-2015 NTT DATA INTRAMART CORPORATION