資訊型錄管理程式管理手冊

INSTANCE

定義或識別物件或要在其中執行動作的關係。

上下文

這個標籤必須跟隨在:

:ACTION.OBJINST
INSTANCE 標籤跟隨 OBJECT 標籤。

:ACTION.RELATION
INSTANCE 標籤跟隨 RELTYPE 標籤。

語法

INSTANCE 標籤有 4 種格式,這要根據 ACTION 標籤而定:

ACTION.OBJINST(ADD) 或 ACTION.OBJINST(MERGE)

新增或合併物件



:INSTANCE.short_name (property_value) . . .

上下文

圖 45. 新增物件時,使用 INSTANCE 標籤

:ACTION.OBJINST(ADD)
:OBJECT.TYPE()
:INSTANCE.short_name()

圖 46. 合併物件時,使用 INSTANCE 標籤

:ACTION.OBJINST(MERGE)
:OBJECT.TYPE()
:INSTANCE.short_name()
:short_name()
:short_name()

關鍵字

short_name
依屬性的 8 個字元簡稱來識別屬性。此值是不區分大小寫; 您可以使用大寫或小寫字元指定此值。 如果 INSTANCE 標籤有多個相關的簡稱,請依照圖 46所示, 在各個簡稱之後,只用一個 INSTANCE 標籤。

property_value
指定給定的物件之屬性值。這個值有區分大小寫。

規則

ACTION.OBJINST(DELETE) 或 ACTION.OBJINST(DELETE_TREE_ALL) 或 ACTION.OBJINST(DELETE_TREE_REL)

刪除物件



:INSTANCE.SOURCEKEY(UUI_short_name (UUI_property_value) . . . )

上下文

圖 47. 刪除物件時,使用 INSTANCE 標籤

:ACTION.OBJINST(DELETE)
:OBJECT.TYPE()
:INSTANCE.SOURCEKEY(UUI_short_name()...)

圖 48. 刪除「群組」種類的物件及其包含的物件時,使用 INSTANCE 標籤

:ACTION.OBJINST(DELETE_TREE_ALL)
:OBJECT.TYPE()
:INSTANCE.SOURCEKEY(UUI_short_name()...)

圖 49. 刪除「群組」種類的物件及其關係時,使用 INSTANCE 標籤

:ACTION.OBJINST(DELETE_TREE_REL)
:OBJECT.TYPE()
:INSTANCE.SOURCEKEY(UUI_short_name()...)

關鍵字

SOURCEKEY
指定用來識別特定物件的 UUI 屬性值。

SOURCEKEY 必須是 INSTANCE 標籤的第一個關鍵字。

UUI_short_name
依 UUI 屬性名稱的 8 個字元簡稱來識別 UUI 屬性名稱。指定所有的 UUI_short_name(UUI_property_value) 組合。 UUI_short_name 不區分大小寫;您可以使用大寫或小寫字元指定此值。

UUI_property_value
指定特定物件的 UUI 屬性值。這個值有區分大小寫。

規則

您必須對每一個已定義為物件類型的 UUI 屬性之屬性,指定 一個 UUI_short_name(value) 組合。 每一個物件類型都有一或多個屬性定義為 UUI 屬性。這些屬性會 唯一識別資訊目錄中的物件。

ACTION.OBJINST(UPDATE)

更新物件的屬性值



:INSTANCE.SOURCEKEY(UUI_short_name (UUI_property_value) . . . )
                       short_name (property_value) . . .

上下文

圖 50. 更新物件時,使用 INSTANCE 標籤

:ACTION.OBJINST(UPDATE)
:OBJECT.TYPE()
:INSTANCE.SOURCEKEY(UUI_short_name()...) short_name()

關鍵字

SOURCEKEY
指定用來識別特定物件的 UUI 屬性值。

SOURCEKEY 必須是 INSTANCE 標籤的第一個關鍵字。

UUI_short_name
依 UUI 屬性的 8 個字元簡稱來識別 UUI 屬性。UUI_short_name 不區分大小寫;您可以使用大寫或小寫字元指定此值。

UUI_property_value
這個值有區分大小寫。 在 UUI_short_name 中,指定特定物件的 UUI 屬性值。

short_name
依要更新的屬性之 8 個字元簡稱來識別屬性。 short_name 不區分大小寫;您可以使用大寫或小寫字元指定 此值。

您不能指定下列屬性短檔名,因為您不能更新這些屬性: OBJTYPID、INSTIDNT、UPDATIME、UPDATEBY。

property_value
short_name 中,為給定的物件指定屬性的新值。 這個值有區分大小寫。

規則

您必須對每一個已定義為物件類型的 UUI 屬性之屬性,指定 一個 UUI_short_name(value) 組合。 每一個物件類型都有一或多個屬性定義為 UUI 屬性。這些屬性會 唯一識別資訊目錄中的物件。

如果您指定一個屬性值,該值會在資訊目錄內更新。 如果您不指定屬性值,該值就不會更新。

ACTION.RELATION(ADD) 或 ACTION.RELATION(DELETE)

新增或刪除關係



:INSTANCE.SOURCEKEY(UUI_short_name (UUI_property_value)...)
                TARGETKEY(UUI_short_name (UUI_property_value)...)

上下文

圖 51. 新增關係時,使用 INSTANCE 標籤

:ACTION.RELATION(ADD)
:RELTYPE.TYPE() SOURCETYPE() TARGETYPE()
:INSTANCE.SOURCEKEY(UUI_short_name()...) TARGETKEY(UUI_short_name()...)

圖 52. 刪除關係時,使用 INSTANCE 標籤

:ACTION.RELATION(DELETE)
:RELTYPE.TYPE() SOURCETYPE() TARGETYPE()
:INSTANCE.SOURCEKEY(UUI_short_name()...) TARGETKEY(UUI_short_name()...)

關鍵字

SOURCEKEY
指定用來識別關係中的第一個物件的 UUI 屬性值。

當關係為:
SOURCEKEY 即識別:

Contains
「群組」種類的物件

聯絡人
物件所屬的聯絡人

附件
物件具有的備註

Link
鏈結的物件

SOURCEKEY 必須是 INSTANCE 標籤的第一個關鍵字。

TARGETKEY
指定用來識別關係中的第二個物件的 UUI 屬性值。

當關係為:
TARGETKEY 即識別:

Contains
「元素」種類的物件

聯絡人
「聯絡人」種類的物件

附件
「附件」種類的物件

Link
鏈結的物件

TARGETKEY 必須是 INSTANCE 標籤的第二個關鍵字。

UUI_short_name
依 UUI 屬性名稱的 8 個字元簡稱來識別 UUI 屬性名稱。此值 是不區分大小寫;您可以使用大寫或小寫字元指定此值。

UUI_property_value
指定特定物件的 UUI 屬性值。這個值有區分大小寫。

規則

對於每一個物件,您必須為每一個已定義為物件類型的 UUI 屬性的屬性指定一個 UUI_short_name(value) 組合。 每一個物件類型都有一或多個屬性定義為 UUI 屬性。這些屬性會 唯一識別資訊目錄中的物件。

您必須使用一個空格將每一個 UUI_short_name(value) 和 short_name(value) 配對隔開,如圖 53所示。

圖 53. 具有數個簡稱的 INSTANCE 標籤範例

:INSTANCE.SOURCEKEY(UUIname1(value1) UUIname2(value2)) sname3(value3) sname4(value4)

在值的括弧間所併入的前導空白會成為值的一部份;尾端的空白則會除去。 資訊型錄管理程式在判斷值的長度是否有效時,會將這些空白計算為資料長度的一部份。 如果您在值中併入額外的前導空白或尾端的空白,讓整個值的長度超過 容許的長度上限,則會發生錯誤。


[ 頁面頂端 | 前一頁 | 下一頁 | 目錄 | 索引 ]