Denna version av användarhandledningen gäller för uppdateringen maj 2020 och tidigare. För det senaste innehållet, besök vår engelska användarhandledning.

Tillgängliga händelsehanterare

Nedan ser du de tillgängliga händelsehanterarna, med variabler och förklaringar. Mer information om variabler finns i Tillgängliga VBScript-variabler.

Händelsehanterare på valvnivå

Händelsehanterarna listade i detta avsnitt initieras av åtgärder på valvnivå.

Notera: Ett undantag i en händelsehanterare hindrar den initierande åtgärden från att utföras.


Händelsehanterare	Variabler	Utförande
BeforeSetProperties AfterSetProperties	ObjVer DisplayID Vault CurrentUserID CurrentUserSessionInfo PropertyValues VaultSharedVariables SavepointVariables TransactionCache MFScriptCancel GetExtensionObject MasterTransactionID CurrentTransactionID ParentTransactionID	Händelsehanterarna utförs när egenskapsvärdena för objektet som sparats i dokumentvalvet återställs. Du kan granska egenskaperna under BeforeSetProperties innan du ställer in dem. Vi rekommenderar dock inte att du modifierar egenskaper under BeforeSetProperties eftersom de kan skrivas över när händelsehanteraren har utförts. Du kan däremot modifiera egenskaper under AfterSetProperties-händelsen.
BeforeCreateNewObjectFinalize AfterCreateNewObjectFinalize	ObjVer DisplayID Vault CurrentUserID CurrentUserSessionInfo PropertyValues VaultSharedVariables SavepointVariables TransactionCache MFScriptCancel GetExtensionObject MasterTransactionID CurrentTransactionID ParentTransactionID	Händelsehanterare utförs när ett nytt objekt skapas i dokumentvalvet, oavsett om det nya objektet har checkats in eller inte. När AfterCreateNewObjectFinalize-händelsehanteraren utförs kan objektet redan ha checkats in. Därför kan metadata eller filer inte längre modifieras medan händelsehanteraren jobbar och därmed passar händelsehanteraren bara för att validera ändringar.
BeforeCancelCreateObject AfterCancelCreateObject	ObjVer DisplayID Vault CurrentUserID CurrentUserSessionInfo VaultSharedVariables SavepointVariables TransactionCache MFScriptCancel GetExtensionObject MasterTransactionID CurrentTransactionID ParentTransactionID	Händelsehanterare utförs när ett objekt som aldrig har checkats in tas bort från dokumentvalvet. Utförande sker till exempel när användaren använder funktionen Ångra utcheckning för objektet eller tar bort objektet från dokumentvalvet.
BeforeCheckInChanges AfterCheckInChanges	ObjVer DisplayID Vault CurrentUserID CurrentUserSessionInfo VaultSharedVariables SavepointVariables TransactionCache MFScriptCancel GetExtensionObject MasterTransactionID CurrentTransactionID ParentTransactionID	Händelsehanterare utförs när användaren checkar in objektet. Händelsehanterare utförs inte om objektet inte modifieras. I sådana fall utförs BeforeCancelCheckOut- och AfterCancelCheckOut-händelsehanterarna. Det är fortfarande möjligt att modifiera objektet under BeforeCheckInChanges. Dessa händelsehanterare utförs även när användaren skapar ett nytt objekt med alternativet Checka in omedelbart avmarkerat och checkar in objektet utan att ändra i filen. Dessa händelsehanterare utförs inte när ett nytt objekt skapas med alternativet Checka in omedelbart aktiverat. När AfterCheckInChanges-händelsehanteraren utförs kan objektet inte längre modifieras eftersom det redan har checkats in. Därför passar händelsehanteraren bara för att validera ändringar.
BeforeCancelCheckOut AfterCancelCheckOut	ObjVer DisplayID Vault CurrentUserID CurrentUserSessionInfo VaultSharedVariables SavepointVariables TransactionCache MFScriptCancel GetExtensionObject MasterTransactionID CurrentTransactionID ParentTransactionID	Händelsehanterarna utförs när modifieringar för ett utcheckat objekt ångras med hjälp av exempelvis funktionen Ångra utcheckning. Händelsehanterarna utförs även om objektet checkas in utan några modifieringar. När AfterCancelCheckOut-händelsehanteraren utförs kan objektet inte modifieras eftersom objektet inte längre är utcheckat.
AfterCancelCheckoutFinalize	ObjVer DisplayID Vault CurrentUserID CurrentUserSessionInfo VaultSharedVariables SavepointVariables TransactionCache MFScriptCancel GetExtensionObject MasterTransactionID CurrentTransactionID ParentTransactionID	En händelse som initieras efter att åtgärden Ångra utcheckning är slutförd, vilket betyder att objektet inte längre är utcheckat. Ett script kan användas för att utföra utcheckningsåtgärden och för att utföra ytterligare objektåtgärder med den utcheckade objektversionen.
BeforeCheckOut AfterCheckOut	ObjVer DisplayID Vault CurrentUserID CurrentUserSessionInfo VaultSharedVariables SavepointVariables TransactionCache MFScriptCancel GetExtensionObject MasterTransactionID CurrentTransactionID ParentTransactionID	The event handlers are executed when a document vault object is checked out. During execution of the BeforeCheckOut event handler, the object has not been checked out, so the object cannot be modified.
BeforeDeleteObject AfterDeleteObject	ObjVer DisplayID Vault CurrentUserID CurrentUserSessionInfo VaultSharedVariables SavepointVariables TransactionCache MFScriptCancel GetExtensionObject MasterTransactionID CurrentTransactionID ParentTransactionID	Händelsehanterare utförs när ett objekt markeras som borttaget.
BeforeDestroyObject AfterDestroyObject	ObjVer DisplayID Vault CurrentUserID CurrentUserSessionInfo VaultSharedVariables SavepointVariables TransactionCache MFScriptCancel GetExtensionObject MasterTransactionID CurrentTransactionID ParentTransactionID	Händelsehanterare utförs när ett objekt förstörs i dokumentvalvet.
BeforeDestroyObjectVersion AfterDestroyObjectVersion	ObjVer DisplayID Vault CurrentUserID CurrentUserSessionInfo VaultSharedVariables SavepointVariables TransactionCache MFScriptCancel GetExtensionObject MasterTransactionID CurrentTransactionID ParentTransactionID	Händelsehanterare utförs när en enskild version av objektet förstörs i dokumentvalvet.
BeforeSetObjectPermissions AfterSetObjectPermissions	ObjVer DisplayID Vault CurrentUserID CurrentUserSessionInfo VaultSharedVariables SavepointVariables TransactionCache MFScriptCancel GetExtensionObject MasterTransactionID CurrentTransactionID ParentTransactionID ObjectAccessControlList	Händelsehanterare utförs när objektbehörigheterna ändras.
BeforeFileUpload	Vault CurrentUserID CurrentUserSessionInfo VaultSharedVariables SavepointVariables TransactionCache MFScriptCancel GetExtensionObject MasterTransactionID CurrentTransactionID ParentTransactionID FileTransferSessionID	Händelsehanteraren utförs när användaren startar en filöverföring till M-Files Server.
AfterFileUpload	ObjVer DisplayID Vault CurrentUserID CurrentUserSessionInfo VaultSharedVariables SavepointVariables TransactionCache MFScriptCancel GetExtensionObject MasterTransactionID CurrentTransactionID ParentTransactionID FileTransferSessionID FileVer	Händelsehanteraren utförs när filöverföringen till servern har slutförts.
BeforeFileDownload AfterFileDownload	Vault CurrentUserID CurrentUserSessionInfo VaultSharedVariables SavepointVariables TransactionCache MFScriptCancel GetExtensionObject MasterTransactionID CurrentTransactionID ParentTransactionID FileTransferSessionID ObjID FileVer	Händelsehanterare utförs när användaren läser in en fil från M-Files Server till klientdatorns lokala cacheminne. Om det behövs kan dessa händelsehanterare användas för att förhindra att vissa filer överförs till användarens datorer.
BeforeCreateNewValueListItem AfterCreateNewValueListItem	Vault CurrentUserID CurrentUserSessionInfo VaultSharedVariables SavepointVariables TransactionCache MFScriptCancel GetExtensionObject MasterTransactionID CurrentTransactionID ParentTransactionID ValueListItem	Händelsehanterarna utförs när nya värden läggs till i en viss värdelista i dokumentvalvet. Dessa händelsehanterare kan exempelvis användas för att se till att alla värden som anges i värdelistan är i den önskade formen.
BeforeLoginToVault	Vault VaultSharedVariables SavepointVariables TransactionCache MFScriptCancel GetExtensionObject MasterTransactionID CurrentTransactionID ParentTransactionID LoginAccount	Händelsehanteraren utförs omedelbart innan användaren loggar in till dokumentvalvet. I det här skedet har användaren redan identifierats mot M-Files Server, så händelsehanteraren utförs inte till exempel om en användare som försöker logga in inte har ett inloggningskonto på servern.
AfterLoginToVault	Vault CurrentUserID CurrentUserSessionInfo VaultSharedVariables SavepointVariables TransactionCache MFScriptCancel GetExtensionObject MasterTransactionID CurrentTransactionID ParentTransactionID LoginAccount	Händelsehanteraren utförs när användaren har loggat in till dokumentvalvet.
BeforeLogoutFromVault	Vault CurrentUserID CurrentUserSessionInfo VaultSharedVariables SavepointVariables TransactionCache GetExtensionObject MasterTransactionID CurrentTransactionID ParentTransactionID	Händelsehanteraren utförs omedelbart innan användaren loggas ut från dokumentvalvet. Det går inte att avbryta utloggningen under den här händelsehanteraren. Klientprogramvaran reagerar inte på felmeddelanden som kommer från den här händelsehanteraren.
AfterLogoutFromVault	Vault VaultSharedVariables SavepointVariables TransactionCache GetExtensionObject MasterTransactionID CurrentTransactionID ParentTransactionID LoggedOutUserID	Händelsehanteraren utförs när användaren har loggats ut från dokumentvalvet. Det går inte att avbryta utloggningen under den här händelsehanteraren. Klientprogramvaran reagerar inte på felmeddelanden som kommer från den här händelsehanteraren.
Replikering: AfterCheckInChanges	Vault VaultSharedVariables SavepointVariables TransactionCache MFScriptCancel GetExtensionObject MasterTransactionID CurrentTransactionID ParentTransactionID RestoredVersions ObjVer	Händelsehanterarna anropas när nya versioner importeras till det befintliga objektet från innehållspaketet eller när en konflikt mellan två objekt löses till förmån för källvalvsversionen. När AfterCheckInChanges-händelsehanteraren anropas har objektet redan checkats in. Därför kan metadata eller filer inte längre modifieras medan händelsehanteraren jobbar.
Replikering: AfterCreateNewObjectFinalize	Vault VaultSharedVariables SavepointVariables TransactionCache MFScriptCancel GetExtensionObject MasterTransactionID CurrentTransactionID ParentTransactionID RestoredVersions ObjVer	Händelsehanteraren anropas när ett nytt objekt importeras till dokumentvalvet från innehållspaketet. När AfterCreateNewObjectFinalize-händelsehanteraren anropas har objektet redan checkats in. Därför kan metadata eller filer inte längre modifieras medan händelsehanteraren jobbar.
VaultExtensionMethod	Vault CurrentUserID CurrentUserSessionInfo VaultSharedVariables SavepointVariables TransactionCache MFScriptCancel GetExtensionObject MasterTransactionID CurrentTransactionID ParentTransactionID Indata Utdata	Händelsehanteraren anropas explicit av klienten (den så kallade valvtilläggsmetoden).
BeforeCreateLoginAccount AfterCreateLoginAccount	Vault CurrentUserID CurrentUserSessionInfo VaultSharedVariables SavepointVariables TransactionCache MFScriptCancel GetExtensionObject MasterTransactionID CurrentTransactionID ParentTransactionID LoginAccount	BeforeCreateLoginAccount: Händelsen initieras innan ett inloggningskonto på valvnivå skapas i valvdatabasen. AfterCreateLoginAccount: Händelsen initieras efter att ett inloggningskonto på valvnivå har skapats i valvdatabasen.
BeforeModifyLoginAccount AfterModifyLoginAccount	Vault CurrentUserID CurrentUserSessionInfo VaultSharedVariables SavepointVariables TransactionCache MFScriptCancel GetExtensionObject MasterTransactionID CurrentTransactionID ParentTransactionID LoginAccount	BeforeModifyLoginAccount: Händelsen initieras innan ett inloggningskonto på valvnivå modifieras i valvdatabasen. AfterModifyLoginAccount: Händelsen initieras efter att ett inloggningskonto på valvnivå har modifierats i valvdatabasen.
BeforeRemoveLoginAccount AfterRemoveLoginAccount	Vault CurrentUserID CurrentUserSessionInfo VaultSharedVariables SavepointVariables TransactionCache MFScriptCancel GetExtensionObject MasterTransactionID CurrentTransactionID ParentTransactionID LoginAccount	BeforeRemoveLoginAccount: Händelsen initieras innan ett inloggningskonto på valvnivå tas bort från valvdatabasen. AfterRemoveLoginAccount: Händelsen initieras efter att ett inloggningskonto på valvnivå har tagits bort från valvdatabasen.
BeforeCreateUserAccount AfterCreateUserAccount	Vault CurrentUserID CurrentUserSessionInfo VaultSharedVariables SavepointVariables TransactionCache MFScriptCancel GetExtensionObject MasterTransactionID CurrentTransactionID ParentTransactionID UserAccount	BeforeCreateUserAccount: Händelsen initieras innan ett användarkonto skapas i valvdatabasen. AfterCreateUserAccount: Händelsen initieras efter att ett användarkonto har skapats i valvdatabasen.
BeforeModifyUserAccount AfterModifyUserAccount	Vault CurrentUserID CurrentUserSessionInfo VaultSharedVariables SavepointVariables TransactionCache MFScriptCancel GetExtensionObject MasterTransactionID CurrentTransactionID ParentTransactionID UserAccount	BeforeModifyUserAccount: Händelsen initieras innan ett användarkonto modifieras i valvdatabasen. AfterModifyUserAccount: Händelsen initieras efter att ett användarkonto har modifierats i valvdatabasen.
BeforeRemoveUserAccount AfterRemoveUserAccount	Vault CurrentUserID CurrentUserSessionInfo VaultSharedVariables SavepointVariables TransactionCache MFScriptCancel GetExtensionObject MasterTransactionID CurrentTransactionID ParentTransactionID UserAccount	BeforeRemoveUserAccount: Händelsen initieras innan ett användarkonto tas bort från valvdatabasen. AfterRemoveUserAccount: Händelsen initieras efter att ett användarkonto har tagits bort från valvdatabasen.
BeforeCreateUserGroup AfterCreateUserGroup	Vault CurrentUserID CurrentUserSessionInfo VaultSharedVariables SavepointVariables TransactionCache MFScriptCancel GetExtensionObject MasterTransactionID CurrentTransactionID ParentTransactionID UserGroupAdmin	BeforeCreateUserGroup: Händelsen initieras innan en användargrupp skapas i valvdatabasen. AfterCreateUserGroup: Händelsen initieras efter att en användargrupp har skapats i valvdatabasen.
BeforeModifyUserGroup AfterModifyUserGroup	Vault CurrentUserID CurrentUserSessionInfo VaultSharedVariables SavepointVariables TransactionCache MFScriptCancel GetExtensionObject MasterTransactionID CurrentTransactionID ParentTransactionID UserGroupAdmin	BeforeModifyUserGroup: Händelsen initieras innan en användargrupp modifieras i valvdatabasen. AfterModifyUserGroup: Händelsen initieras efter att en användargrupp har modifierats i valvdatabasen. Notera: AfterModifyUserGroup-händelsehanteraren utförs när gruppen Alla interna användare modifieras.
BeforeRemoveUserGroup AfterRemoveUserGroup	Vault CurrentUserID CurrentUserSessionInfo VaultSharedVariables SavepointVariables TransactionCache MFScriptCancel GetExtensionObject MasterTransactionID CurrentTransactionID ParentTransactionID UserGroupAdmin	BeforeRemoveUserGroup: Händelsen initieras innan en användargrupp tas bort från valvdatabasen. AfterRemoveUserGroup: Händelsen initieras efter att en användargrupp har tagits bort från valvdatabasen.
AfterBringOnline BeforeTakeOffline	Vault CurrentUserID CurrentUserSessionInfo VaultSharedVariables SavepointVariables TransactionCache MFScriptCancel GetExtensionObject MasterTransactionID CurrentTransactionID ParentTransactionID	AfterBringOnline: Händelsen initieras efter att valvet har tagits till onlineläge. BeforeTakeOffline: Händelsen utförs innan valvet tas till offlineläge. Eventuella undantag i någon av de två händelsehanterarna förhindrar inte övergången till online/offline.
AfterCheckInChangesFinalize	ObjVer DisplayID Vault CurrentUserID CurrentUserSessionInfo VaultSharedVariables SavepointVariables TransactionCache MFScriptCancel GetExtensionObject MasterTransactionID CurrentTransactionID ParentTransactionID	Händelsen initieras när ett objekt har checkats in helt (eller när ett objekt checkas in omedelbart efter att det har skapats) efter att alla åtgärder som sker efter incheckningen (till exempel tillståndsövergångar) har slutförts.
BeforeCreateView AfterCreateView	Vault CurrentUserID CurrentUserSessionInfo VaultSharedVariables SavepointVariables TransactionCache MFScriptCancel GetExtensionObject MasterTransactionID CurrentTransactionID ParentTransactionID Vy	BeforeCreateView: Händelsen initieras innan en ny vy skapas i valvet. AfterCreateView: Händelsen initieras efter att en ny vy har skapats i ett valv.
BeforeModifyView AfterModifyView	Vault CurrentUserID CurrentUserSessionInfo VaultSharedVariables SavepointVariables TransactionCache MFScriptCancel GetExtensionObject MasterTransactionID CurrentTransactionID ParentTransactionID Vy	BeforeModifyView: Händelsen initieras innan ändringar som har gjorts i en vy börjar att gälla. AfterModifyView: Händelsen initieras efter att ändringar som har gjorts i en vy har börjat gälla.
BeforeDeleteView AfterDeleteView	Vault CurrentUserID CurrentUserSessionInfo VaultSharedVariables SavepointVariables TransactionCache MFScriptCancel GetExtensionObject MasterTransactionID CurrentTransactionID ParentTransactionID Vy	BeforeDeleteView: Händelsen initieras innan en vy som har ställts in för borttagning faktiskt tas bort. AfterDeleteView: Händelsen initieras efter att en vy har tagits bort.
BeforeReturnView	Vault CurrentUserID CurrentUserSessionInfo VaultSharedVariables SavepointVariables TransactionCache MFScriptCancel GetExtensionObject MasterTransactionID CurrentTransactionID ParentTransactionID Vy	Händelsehanteraren initieras efter att en vy har hämtats från valvet men innan den returneras till klienten. Den gör att du kan modifiera en vy, till exempel genom att filtrera den med dynamiska sökvillkor, bland annat sådana som utgår ifrån den aktuella användaren.
BeforeUndeleteObject AfterUndeleteObject	ObjVer DisplayID Vault CurrentUserID CurrentUserSessionInfo VaultSharedVariables SavepointVariables TransactionCache MFScriptCancel GetExtensionObject MasterTransactionID CurrentTransactionID ParentTransactionID	BeforeUndeleteObject: Händelsehanteraren initieras innan du ångrar borttagningen av ett objekt. AfterUndeleteObject: Händelsehanteraren initieras efter att du ångrar borttagningen av ett objekt. Ett script kan användas för att utföra utcheckningsåtgärden och för att utföra ytterligare objektåtgärder med den utcheckade objektversionen.
AfterUndeleteObjectFinalize	ObjVer DisplayID Vault CurrentUserID CurrentUserSessionInfo VaultSharedVariables SavepointVariables TransactionCache MFScriptCancel GetExtensionObject MasterTransactionID CurrentTransactionID ParentTransactionID	Den här händelsen initieras efter att åtgärden för att ångra borttagningen av objektet är slutförd och du kan jobba med det objekt för vilket borttagningen har ångrats.
BeforeModifyMFilesCredentials AfterModifyMFilesCredentials	Vault CurrentUserID CurrentUserSessionInfo VaultSharedVariables SavepointVariables TransactionCache GetExtensionObject MasterTransactionID CurrentTransactionID ParentTransactionID ActivityID	BeforeModifyMFilesCredentials: Händelsehanteraren initieras innan lösenordet till M-Files-inloggningskontot ändras. AfterModifyMFilesCredentials: Händelsehanteraren initieras efter att lösenordet till M-Files-inloggningskontot ändras.
BeforeCheckinChangesFinalize	ObjVer DisplayID Vault CurrentUserID CurrentUserSessionInfo VaultSharedVariables SavepointVariables TransactionCache MFScriptCancel GetExtensionObject MasterTransactionID CurrentTransactionID ParentTransactionID	BeforeCheckinChangesFinalize-händelsehanteraren initieras innan ett objekt checkas in, men efter att tillståndsövergångarna och signaturerna har avslutats. Arbetsflödesändringar är inte tillåtna.

Händelsehanterare på servernivå

Detta avsnitt listar händelsehanterare som initieras av åtgärder på servernivå. Dessa åtgärder orsakar även att en motsvarande händelse utförs i alla onlinevalv på servern.

Notera: Ett undantag i en händelsehanterare på servernivå hindrar den initierande åtgärden från att utföras, men alla undantag i en händelsehanterare på servernivå påverkar inte åtgärder på servernivå.


Händelsehanterare	Variabler	Utförande
BeforeRunScheduledJob AfterRunScheduledJob	CurrentUserID CurrentUserSessionInfo GetExtensionObject MFScriptCancel ScheduledJob ScheduledJobOutputInfo	Händelsehanteraren utförs när ett av de tidsinställda jobben på servern genomförs. Dessa händelsehanterare kan användas för att automatiskt övervaka utförandet av automatiskt tidsinställda jobb. Om det uppstår fel kan händelsehanteraren automatiskt skicka ett e-postmeddelande till administratören för att lättare lösa problemet.
BeforeCreateLoginAccount AfterCreateLoginAccount	LoginAccount CurrentUserID CurrentUserSessionInfo VaultSharedVariables SavepointVariables TransactionCache MFScriptCancel GetExtensionObject MasterTransactionID CurrentTransactionID ParentTransactionID	BeforeCreateLoginAccount: Händelsen initieras för alla onlinevalv innan ett inloggningskonto skapas på servern. AfterCreateLoginAccount: Händelsen initieras för alla onlinevalv efter att ett inloggningskonto har skapats på servern.
BeforeModifyLoginAccount AfterModifyLoginAccount	LoginAccount CurrentUserID CurrentUserSessionInfo VaultSharedVariables SavepointVariables TransactionCache MFScriptCancel GetExtensionObject MasterTransactionID CurrentTransactionID ParentTransactionID	BeforeModifyLoginAccount: Händelsen initieras för alla onlinevalv innan ett inloggningskonto modifieras på servern. AfterModifyLoginAccount: Händelsen initieras för alla onlinevalv efter att ett inloggningskonto har modifierats på servern.
BeforeRemoveLoginAccount AfterRemoveLoginAccount	LoginAccount CurrentUserID CurrentUserSessionInfo VaultSharedVariables SavepointVariables TransactionCache MFScriptCancel GetExtensionObject MasterTransactionID CurrentTransactionID ParentTransactionID	BeforeRemoveLoginAccount: Händelsen initieras för alla onlinevalv innan ett inloggningskonto har tagits bort från servern. AfterRemoveLoginAccount: Händelsen initieras för alla onlinevalv efter att ett inloggningskonto har tagits bort från servern.
BeforeModifyMFilesCredentials AfterModifyMFilesCredentials	CurrentUserID CurrentUserSessionInfo GetExtensionObject	BeforeModifyMFilesCredentials: Händelsehanteraren initieras för alla onlinevalv innan lösenordet till M-Files-inloggningskontot ändras. AfterModifyMFilesCredentials: Händelsehanteraren initieras för alla onlinevalv efter att lösenordet till M-Files-inloggningskontot har ändrats.