Umgang mit alternativen Schlüsseln

Alternative Schlüssel

Alternative Schlüssel gibt es in den folgenden Tabellen:

Tabelle	PK	AK
USER	UserId	OOUserId
USERGROUP	UserGroupId	UserGroupNo
SECURITYZONE	SecurityZoneId	SecurityZoneNo
POSTPROCESSING	PostProcessingId	PostProcessingNo
DOCUMENTCATEGORY	DocumentCategoryId	DocumentCategoryNo
USAGE	UsageId	UsageNo
STORAGE	StorageId	StorageNo
FOLDER	FolderId	FolderNo, [UDF]
FILETYPE	FileTypeId	Extension
BOTYPE	BOTypeId	BOTypeName
OOLINKTYPE	OOLinkTypeId	OOLinkTypeCode
MEDIABASETYPE	MediaBaseTypeId	MediaBaseTypeCode
MEDIASUBTYPE	MediaSubTypeId	MediaSubTypeCode

Der Umgang mit alternativen Schlüsseln ist dabei folgendermassen geregelt:

1) NamedValue-Einträge

Wenn ein Fremdschlüsselattribut (zB. DocumentCategoryId auf Document) in einem NamedValue übergeben wird (zB. In AddDocument) kann der NamedValue-Eintrag wie folgt gefüllt sein:

a) Name: „DocumentCategoryId“ Value: „2“ (PK)
b) Name: „DocumentCategoryId“ Value: „{1001}“ (AK, in geschweiften Klammern)
c) Name: „DocumentCategoryId!“ Value: „1001“ (AK, Name ergänzt mit !)

Die Variante c) ist der Variante b) vorzuziehen da diese den eigentlichen Wert nicht verändert

[UDF] User Defined Folder (ab Version 14.10) Mögliche Schreibweisen:

Attr = {[UDF]291} Attr = {[UDF]{76}} Attr = {[UDF!]76}
Attr! = [UDF]291 Attr! = [UDF]{76} Attr! = [UDF!]76

Wobei 291 den PK und 76 den AK des Users darstellt!

2) Services vom Typ Main

Die Schnittstelle aller Services vom Typ „Main“ ist so ausgelegt, dass jeweils neben dem PK auch der entsprechende AK mit übergeben werden kann. Dies wird künftig auch bei einer Verwendung im „Scripting“ auf wohlwollen stossen.

3) Services vom Typ Admin

Die Schnittstellen der folgenden Services vom Typ „Admin“ sehen keine spezielle AK-Unterstützung vor, da diese typischerweise NUR im Studio verwendet werden und dort ein „Umweg“ über den PK zumutbar ist:

ModifyUserGroup
RemoveUserGroup
ModifySecurityZone
RemoveSecurityZone
ModifyDocumentCategory
ModifyDocumentCategoryBofUsages
RemoveDocumentCategory
ModifyUsage
RemoveUsage
ModifyStorage
ModifyStorageState
ModifyStorageRecalculateUsedSize
RemoveStorage
ModifyFileType
RemoveFileType
ModifyBOType
RemoveBOType
ModifyOOLinkType
RemoveOOLinkType
ModifyFolder
RemoveFolder
ModifyMediaBaseType
RemoveMediaBaseType
ModifyMediaSubType
RemoveMediaSubType