Services

ModifyDocumentChangeCategory

ModifyDocumentChangeCategory
Main
History-Relevant
Rückgabewert
 
RET
    
Parameterliste
DocumentId
IN
LONG_NUMERIC_IDENTIFIER
>DOCUMENT.DOCUMENTID
DocumentCategoryId
IN
LONG_NUMERIC_IDENTIFIER
>DOCUMENTCATEGORY.DOCUMENTCATEGORYID
FolderFromCategoryDefault
IN
Boolean
SecurityZoneFromCategoryDefault
IN
Boolean
AutoReleaseIfConfigured
IN
Boolean
Kurzbeschreibung:
Dieser Service überführt ein Dokument, welches sich in einer Vorkategorie befindet, in eine "normale" Kategorie. Dieser Service ist nicht erlaubt, wenn das Dokument, von wem auch immer, ausgecheckt ist!
Fehlerhandling/Plausibilisierung:
Generell gelten die Regeln (PK, AK, FK, Unique, NotNull) der Datenbank. Die zusätzlichen Fehler sind:
  • Aufgrund von Validator-Prüfungen (VD)
  • Wenn das Dokument über die DocumentId nicht gefunden wird (1)
  • Wenn auf der verknüpften Sicherheitszone die Modify-Rechte fehlen (2) **
  • Wenn das Document ausgecheckt ist (3)
  • Wenn das Dokument nicht einer Vorkategorie zugeteilt ist (4)
  • Wenn das Dokument einer Vorkategorie zugeteilt werden soll (5)
  • Wenn das ExternalTag des Dokuments in der neuen Dokumentkategorie nicht eindeutig ist (6)
  • Wenn die angegebene Dokumentkategorie nicht existiert (7)
Bemerkungen:
VD: siehe Validator-Fehler
(1): ModDocNEx
(2): ModDocInsuffPriv
(3): ModDocCheckedOut
(4): ModDocChaCatUpdBlkNPreCat
(5): ModDocChaCatUpdBlkPreCat
(6): ModDocChaCatUpdBlkExtTagNUq
(7): GetDocCatNEx
Folgende Attribute werden von der neuen Dokumentkategorie auf das Dokument übernommen:
  • UniqueFileNames
  • VersioningModeCd
  • ArchiveModeCd
  • RetentionPeriod
  • Folder (sofern FolderFromCategoryDefault true)
  • SecurityZone (sofern SecurityZoneFromCategoryDefault true)
Wenn AutoReleaseIfConfigured=true, so wird beim Kategoriewechsel, sofern auf der Zielkategorie AutoRelease gesetzt ist, die automatische Freigabe (basierend auf der höchsten verfügbaren Version) angestossen.
Dieser Service schreibt in jedem Fall einen History-Eintrag!
** Handelt es sich um ein Dokument im Archivierungsstatus „INITIATED“ so wird zusätzlich das Admin-Recht auf der Sicherheitszone benötigt!