使用 Java API 來管理分組型樣

型樣排程屬性

每個型樣排程都必須包含下列屬性：

名

用來識別排程的排程名稱。 如果名稱不必為唯一名稱，則建議不建立同名的多個排程。

ExecutionGroupId

此排程所隸屬之執行群組的名稱。

使用執行群組建立排程並不自動表示會在任何儲存伺服器上建立任何新的執行緒儲存區。 它由每個儲存伺服器上的內容個別進行控制。

說明

排程的說明。

型樣排程的其他屬性

此外，每個型樣排程還必須包含下列其中一個屬性：

intervalInMinutes

觸發排程的頻率（分鐘）。

或

cronExpression

使用 Cron 格式的表示式，提供對型樣執行週期的進階控制。

附註: 如果要透過 JavaAPI 來使用型樣排程方法， API 用戶端類別路徑中必須提供一些額外的 jar 檔。 您可以在 TADDM_HOME/lib 目錄（也稱為 LIB）中尋找這些 jar 檔：

• LIB/schedules.jar
• LIB/quartz/c3p0-0.9.1.1.jar
• LIB/quartz/quartz-2.2.1.jar
• LIB/quartz/quartz-jobs-2.2.1.jar

• 可從任何伺服器中取得與處理狀態相關的資訊，且一律包含完整資訊（即使特殊儲存伺服器未提供執行群組的資源亦如此）。
• 可能會在儲存伺服器上而非用來要求實際處理型樣的伺服器上，對型樣進行實際處理。
• 可從任何儲存伺服器岔斷型樣執行，即使型樣正由用來導致該岔斷之伺服器以外的伺服器處理亦如此。

1. 建立「分組型樣」物件，並設定 name 和 hierarchyType 欄位的值。
2. 建立選取器物件的陣列，並設定其參數來定義集合建立規則。
3. 透過使用分組型樣來設定選取器 parent 欄位並將分組型樣選取器設為選取器的陣列，來將所有選取器附加至分組型樣。
4. 透過使用分組型樣 API 方法 createGroupingPattern 來建立型樣。

# ----------- Begin sample code -----------
import sys
import java

from java.io import *
from com.collation.platform.util import ModelFactory
from com.collation.proxy.api.client import *
from com.ibm.cdb.api import ApiFactory
from java.lang import System
from java.lang import String
from java.lang import Boolean
from java.lang import Class

from jarray import array

false = Boolean(0)
conn = ApiFactory.getInstance().getApiConnection("localhost", -1, None, false)
sess = ApiFactory.getInstance().getSession(conn, "administrator", "collation", ApiSession.DEFAULT_VERSION);
api = sess.createCMDBApi()


# create Grouping pattern with name "Grouping Pattern 1"
name = "Grouping Pattern 1"
gpattern = ModelFactory.newInstance(Class.forName("com.collation.platform.model.topology.customCollection.GroupingPattern"))
gpattern.setName("Grouping Pattern 1")
gpattern.setHierarchyType("BusinessApplication")

SelectorClass = Class.forName("com.collation.platform.model.topology.customCollection.Selector")
selector1 = ModelFactory.newInstance(SelectorClass)
selector1.setType(0) # type MQL
selector1.setName("Linux Computer systems")
selector1.setQuery("LinuxUnitaryComputerSystem")
selector1.setUseTraversalTemplate(false)
selector1.setGroupingNameExpression("LinuxComputerSystems")
selector1.setParent(gpattern)

selector2 = ModelFactory.newInstance(SelectorClass)
selector2.setType(0) # type MQL
selector2.setName("Windows Computer systems")
selector2.setQuery("WindowsComputerSystem")
selector2.setUseTraversalTemplate(false)
selector2.setGroupingNameExpression("WindowsComputerSystems")
selector2.setParent(gpattern)

gpattern.setSelectors(array([selector1, selector2], SelectorClass))

guid=api.createGroupingPattern(gpattern)

# retrieve stored grouping pattern
gpattern = api.getGroupingPattern(guid)

print 'Grouping pattern: ', gpattern
for sel in gpattern.getSelectors():
    print '    Selector:', sel

# retrieve all grouping patterns
allPatterns = api.getAllGroupingPatterns()

for pat in allPatterns:
    print 'Grouping pattern: ', pat
    for sel in pat.getSelectors():
        print '    Selector:', sel

# remove grouping pattern
api.removeGroupingPattern(guid)


api.close()
sess.close()
System.exit(0)

# ----------- End sample code -----------

尋找特定分組型樣的所有商業應用程式

api.sh -u user -p pass find "select * from CustomCollection where groupingPattern.guid == '9C704FF849993840B89FBECA5E183AFA'"
api.sh -u user -p pass find "select * from CustomCollection where groupingPattern.name == 'GP'"

尋找特定商業應用程式的所有節點與路徑

api.sh -u user -p pass find "select * from Node where parent.guid=='B71A946FEA753FB38B57B65775DA6519'"
api.sh -u user -p pass find "select * from Path where parent.guid=='B71A946FEA753FB38B57B65775DA6519'"

尋找指向特定 CI 的所有節點

api.sh -u user -p pass find "select * from Node where sourceGuid == '785614419CED31ACB24989A24F8ED52A'" 
api.sh -u user -p pass find "select * from Node where displayName contains 'NC9128109078'"

找尋與產生自新商業應用程式之較早版本相容的商業應用程式

首先，使用下列查詢並根據新的商業應用程式來收集部分起始資料：

api.sh -u user -p pass find "select backwardCompatibleBusinessAppGuid, hierarchyType, originalBusinessAppType from CustomCollection where guid == 'B71A946FEA753FB38B57B65775DA6519'"

因此，您將會取得與舊版相容的應用程式 GUID，以及要查詢哪個類別的相關資訊。 針對移轉的商業應用程式，originalBusinessAppType 欄位包含此資訊，否則 hierarchyType 會指向它。

您可以藉由此類資訊並使用下列查詢，來查詢與舊版相容的應用程式：

api.sh -u user -p pass find "select * from Application where guid == '9EA1FAD9B4153000BD21CB2967ADB3DB'"