Օգտագործողի կողմից ընդլայնվող մշակիչներ

Տրված է հնարավորություն սահմանել լրացուցիչ մշակիչներ փաստաթղթում, տվյալների աղբյուրում և դիալոգում առաջացող որոշ իրադարձությունների համար, որոնք աշխատում են հիմնական իրադարձություններից առաջ կամ հետո։

Մշակիչները հնարավոր է սահմանել հիմնական մշակիչին նախորդող(Pre) աշխատող կամ հաջորդող(Post) աշխատող տարբերակով։

Մշակիչները կարող են տեղադրված լինել կամայական մոդուլի մեջ և կամայական անունով։

Ամեն մի իրադարձության համար հնարավոր է սահմանել միայն մեկ նախորդող (Pre) և միայն մեկ հաջորդող (Post) լրացուցիչ մշակիչ։

Փաստաթղթի համար հնարավոր է մշակիչ սահմանել հետևյալ իրադարձությունների համար`

• BeforeImport
• When
• Valid
• Validate
• Action
• Folders
• BeforeCommit
• AfterCreate
• AfterLoad
• AfterProcess
• BeforeCopy
• BeforeExport
• ClickDropDown
• ClickDropDownGrid
• Delete
• OnUIDelete
• Functions
• GridCellValid
• GridRowValid
• GridValid
• IsHidden
• LoadGrid
• Magic
• Print
• StoreGrid
• TemplateSubstitution

Տվյալների աղբյուրի համար հասանելի է՝

• Functions
• Valid

Դիալոգի համար հասանելի է՝

• Activate
• ClickDropDown
• Validate
• ValueChanged

Մշակիչների գրանցում

Նախորդող և հաջորդող մշակիչները միացնելու համար հարկավոր է համակարգում ավելացնել PUBLIC հասանելիությամբ մոդուլ AppExt անունով, որում առկա է Init մեթոդ։ Init մեթոդում սահմանվում են նոր մշակիչները` ScriptExtension.AddHandler մեթոդի միջոցով։

MODULE {
NAME = AppExt;
CAPTION = "Extensions";
PUBLIC = 1;

SCRIPT {
Option Explicit

Public Sub Init()
    ...
End Sub
};
};

Ստորև բերված օրինակում սահմանված է նոր մշակիչ IMemOrd փաստաթղթի Validate իրադարձության համար՝ PostValidate: Այժմ իրադարձության առաջացման ժամանակ կաշխատի նաև NewMod մոդուլի MyValidateHandler մեթոդը։

Public Sub Init()
    ScriptExtension.AddHandler(ExtensionEvents.DocPostValidate, "IMemOrd", "NewMod.MyValidateHandler")
End Sub

NewMod մոդուլում MyValidateHandler մեթոդը պետք է սահմանված լինի հետևյալ սահմանմամբ՝

Public Sub MyValidateHandler(ByVal args As EventArgsDocValidate)
    '
End Sub

ScriptExtension.AddHandler մեթոդ

Այս մեթոդի միջոցով ավելացվում են նոր մշակիչներ իրադարձությունների համար։ Թույլատրելի իրադարձությունները սահմանված են ExtensionEvents-ի մեջ։

Sub ScriptExtension.AddHandler(ByVal eventType As ExtensionEvents, ByVal instanceName As String, ByVal handlerName As String)

ExtensionEvents Enum

Սահմանում է, այն թույլատրված իրադարձությունների բազմությունը, որոնց վրա հնարավոր է լրացուցիչ մշակիչ միացնել։

Օրինակ՝

ScriptExtension.AddHandler(ExtensionEvents.DocPreValidate, "IMemOrd", "NewMod.MemOrdPreValidateHandler")
ScriptExtension.AddHandler(ExtensionEvents.DocPreValidate, "C1Univer", "NewMod.AgrCustomValidate")
ScriptExtension.AddHandler(ExtensionEvents.DocPostWhen, "C1Univer", "NewMod.AgrCustomWhen")

EventArgs տիպեր

Ամեն մի մշակիչ ստանում է մեկ պարամետր EventArgsXXXXYYYY տիպի, որի մեջ հասանելի են այդ իրադարձությանը վերաբերող տվյալները։

Օրինակ՝ Valid իրադարձության մշակիչը ստանում է EventArgsDocValid տիպի օբյեկտ, որտեղ հասանելի են որպես հատկություն փաստաթուղթը, առաջացնող դաշտը և հին արժեքը։

EventArgsDocBeforeImport Class

Պարունակում է տվյալներ BeforeImport իրադարձության մշակիչներին փոխանցելու համար։

Օգտագործվում է հետևյալ իրադարձությունների համար

• DocPreBeforeImport
• DocPostBeforeImport

Մշակիչի օրինակ՝

Public Sub MyDocPostBeforeImportHandler(ByVal args As EventArgsDocBeforeImport)
    If Trim(args.Doc("AIM")) = "" Then
        args.CancelDocStore = True
    End If
End Sub

EventArgsDocWhen Class

Պարունակում է տվյալներ փաստաթղթի When իրադարձության մշակիչներին փոխանցելու համար։

Օգտագործվում է հետևյալ իրադարձությունների համար

• DocPreWhen
• DocPostWhen

Մշակիչի օրինակ՝

Public Sub MyDocPostWhenHandler(ByVal args As EventArgsDocWhen)
    If Trim(args.Doc("CLICODE")) = "" Then
        RaiseError "Սխալ", "Հաճախորդի լրացումը պարտադիր է։", "Error", "Filling client field is required."
    End If
End Sub

EventArgsDocValid Class

Պարունակում է տվյալներ փաստաթղթի Valid իրադարձության մշակիչներին փոխանցելու համար։

Օգտագործվում է հետևյալ իրադարձությունների համար

• DocPreValid
• DocPostValid

Մշակիչի օրինակ՝

Public Sub MyDocPreValidHandler(ByVal args As EventArgsDocValid)
    If args.Name = "CLICODE" AndAlso Trim(args.Doc("CLICODE")) = "" Then
        RaiseError "Սխալ", "Հաճախորդի լրացումը պարտադիր է։", "Error", "Filling client field is required."
    End If
End Sub

EventArgsDocValidate Class

Պարունակում է տվյալներ փաստաթղթի Validate իրադարձության մշակիչներին փոխանցելու համար։

Օգտագործվում է հետևյալ իրադարձությունների համար

• DocPreValidate
• DocPostValidate

Մշակիչի օրինակ՝

Public Sub MyDocPreValidateHandler(ByVal args As EventArgsDocValidate)
    If Trim(args.Doc("CLICODE")) = "" Then
        RaiseError "Սխալ", "Հաճախորդի լրացումը պարտադիր է։", "Error", "Filling client field is required."
    End If
End Sub

EventArgsDocAction Class

Պարունակում է տվյալներ փաստաթղթի Action իրադարձության մշակիչներին փոխանցելու համար։

Օգտագործվում է հետևյալ իրադարձությունների համար

• DocPreAction
• DocPostAction

Մշակիչի օրինակ՝

Public Sub MyDocPostActionHandler(ByVal args As EventArgsDocAction)
    Dim bonus As AsFact
    With args.Doc
        If .Value("DBCR") = "C" Then
            Set bonus = CreateFact("BO")
            bonus.OpDate = .Value("DATE")
            bonus.Object = .Value("CLICODE")
            bonus.Summa = .Value("SUMMA")
            bonus.DBCR = "C"
            bonus.Op = "CRD"
            .StoreFact(bonus)
        End If
    End With
End Sub

EventArgsDocFolders Class

Պարունակում է տվյալներ փաստաթղթի Folders իրադարձության մշակիչներին փոխանցելու համար։

Օգտագործվում է հետևյալ իրադարձությունների համար

• DocPreFolders
• DocPostFolders

Մշակիչի օրինակ՝

Public Sub MyDocPostFoldersHandler(ByVal args As EventArgsDocFolders)
Dim fld As AsFoldElement
    If args.Doc.State = 2 AndAlso Trim(args.Doc("EMAIL")) <> "" Then
        Set fld = CreateFolderElement("UniqueEmail")
        fld.Status = "E"
        fld.Key = Trim(args.Doc("EMAIL"))
        fld.Com = Trim(args.Doc("NAME"))
        fld.ErrorMessage = "Էլ.փոստի հասցեն լրացված է այլ հաճախորդի համար։"
        args.Doc.StoreInFolder(fld)
    End If
End Sub

EventArgsDocBeforeCommit Class

Պարունակում է տվյալներ փաստաթղթի BeforeCommit իրադարձության մշակիչներին փոխանցելու համար։

Օգտագործվում է հետևյալ իրադարձությունների համար

• DocPreBeforeCommit
• DocPostBeforeCommit

Մշակիչի օրինակ՝

Public Sub MyDocPostBeforeCommitHandler(ByVal args As EventArgsDocBeforeCommit)
    If args.State = 3 AndAlso args.LastFixedState <> 3 Then
        SendMailUsingDefaultMailClient args.Doc("EMAIL"), , , "Հաճախորդի քարտի փակում", "Հարգելի Հաճախորդ, Ձեր քարտը փակվել է։"
    End If
End Sub

EventArgsDocAfterCreate Class

Պարունակում է տվյալներ փաստաթղթի AfterCreate իրադարձության մշակիչներին փոխանցելու համար։

Օգտագործվում է հետևյալ իրադարձությունների համար

• DocPreAfterCreate
• DocPostAfterCreate

EventArgsDocAfterLoad Class

Պարունակում է տվյալներ փաստաթղթի AfterLoad իրադարձության մշակիչներին փոխանցելու համար։

Օգտագործվում է հետևյալ իրադարձությունների համար

• DocPreAfterLoad
• DocPostAfterLoad

EventArgsDocAfterProcess Class

Պարունակում է տվյալներ փաստաթղթի AfterProcess, PreAfterProcess, PostAfterProcess իրադարձությունների մշակիչներին փոխանցելու համար։

EventArgsDocBeforeCopy Class

Պարունակում է տվյալներ փաստաթղթի BeforeCopy իրադարձության մշակիչներին փոխանցելու համար։

Օգտագործվում է հետևյալ իրադարձությունների համար

• DocPreBeforeCopy
• DocPostBeforeCopy

EventArgsDocBeforeExport Class

Պարունակում է տվյալներ փաստաթղթի BeforeExport իրադարձության մշակիչին փոխանցելու համար։

Օգտագործվում է հետևյալ իրադարձությունների համար

• DocPostBeforeExport

EventArgsDocClickDropDown Class

Պարունակում է տվյալներ փաստաթղթի ClickDropDown իրադարձության մշակիչին փոխանցելու համար։

Օգտագործվում է հետևյալ իրադարձությունների համար

• DocPreClickDropDown

EventArgsDocClickDropDownGrid Class

Պարունակում է տվյալներ փաստաթղթի ClickdropDownGrid իրադարձության մշակիչին փոխանցելու համար։

Օգտագործվում է հետևյալ իրադարձությունների համար

• DocPreClickDropDownGrid

EventArgsDocDelete Class

Պարունակում է տվյալներ փաստաթղթի Delete իրադարձության մշակիչներին փոխանցելու համար։

Օգտագործվում է հետևյալ իրադարձությունների համար

• DocPreDelete
• DocPostDelete

EventArgsDocOnUIDelete Class

Պարունակում է տվյալներ փաստաթղթի OnUIDelete իրադարձության մշակիչին փոխանցելու համար։

Օգտագործվում է հետևյալ իրադարձությունների համար

• DocPreOnUIDelete

EventArgsDocFunctions Class

Պարունակում է տվյալներ փաստաթղթի Functions իրադարձության մշակիչին փոխանցելու համար։

Օգտագործվում է հետևյալ իրադարձությունների համար

• DocPostFunctions

EventArgsDocGridCellValid Class

Պարունակում է տվյալներ փաստաթղթի GridCellValid իրադարձության մշակիչներին փոխանցելու համար։

Օգտագործվում է հետևյալ իրադարձությունների համար

• DocPreGridCellValid
• DocPostGridCellValid

EventArgsDocGridRowValid Class

Պարունակում է տվյալներ փաստաթղթի GridRowValid իրադարձության մշակիչներին փոխանցելու համար։

Օգտագործվում է հետևյալ իրադարձությունների համար

• DocPreGridRowValid
• DocPostGridRowValid

EventArgsDocIsHidden Class

Պարունակում է տվյալներ փաստաթղթի IsHidden իրադարձության մշակիչին փոխանցելու համար։

Օգտագործվում է հետևյալ իրադարձությունների համար

• DocPostIsHidden

EventArgsDocLoadGrid Class

Պարունակում է տվյալներ փաստաթղթի LoadGrid իրադարձության մշակիչին փոխանցելու համար։

Օգտագործվում է հետևյալ իրադարձությունների համար

• DocPostLoadGrid

EventArgsDocMagic Class

Պարունակում է տվյալներ փաստաթղթի Magic իրադարձության մշակիչին փոխանցելու համար։

Օգտագործվում է հետևյալ իրադարձությունների համար

• DocPreMagic

EventArgsDocPrint Class

Պարունակում է տվյալներ փաստաթղթի Print իրադարձության մշակիչին փոխանցելու համար։

Օգտագործվում է հետևյալ իրադարձությունների համար

• DocPrePrint

EventArgsDocStoreGrid Class

Պարունակում է տվյալներ փաստաթղթի StoreGrid իրադարձության մշակիչին փոխանցելու համար։

Օգտագործվում է հետևյալ իրադարձությունների համար

• DocPostStoreGrid

EventArgsDocTemplateSubst Class

Պարունակում է տվյալներ փաստաթղթի TemplateSubstitution իրադարձության մշակիչին փոխանցելու համար։

Օգտագործվում է հետևյալ իրադարձությունների համար

• DocPostTemplateSubstitution

EventArgsDataFunctions Class

Պարունակում է տվյալներ տվյալների աղբյուրի Functions և PostFunctions իրադարձությունների մշակիչներին փոխանցելու համար։

Մշակիչի օրինակ՝

Public Sub MyDataPostFunctionsHandler(ByVal args As EventArgsDataFunctions)
    args.CurrentView.RegistrFunction "Ուղարկել նամակ", "NewMod.SendMail"
End Sub

EventArgsDataValid

Պարունակում է տվյալներ տվյալների աղբյուրի ընդլայնման PostValid իրադարձության մշակիչին փոխանցելու համար։

EventArgsDialogActivate Class

Պարունակում է տվյալներ դիալոգի Activate իրադարձության մշակիչին փոխանցելու համար։

Օգտագործվում է հետևյալ իրադարձությունների համար

• DialogPostActivate

EventArgsDialogClickDropDown Class

Պարունակում է տվյալներ դիալոգի ClockDropDown իրադարձության մշակիչին փոխանցելու համար։

Օգտագործվում է հետևյալ իրադարձությունների համար

• DialogPreClickDropDown

EventArgsDialogValidate Class

Պարունակում է տվյալներ դիալոգի Validate իրադարձության մշակիչներին փոխանցելու համար։

Օգտագործվում է հետևյալ իրադարձությունների համար

• DialogPreValidate
• DialogPostValidate

EventArgsDialogValueChanged Class

Պարունակում է տվյալներ դիալոգի ValueChanged իրադարձության մշակիչին փոխանցելու համար։

Օգտագործվում է հետևյալ իրադարձությունների համար

• DialogPreValueChanged

EventArgsAccountingOnDelete Class

Պարունակում է տվյալներ հաշվառման OnDelete, PreOnDelete, PostOnDelete իրադարձությունների մշակիչներին փոխանցելու համար։

EventArgsDocPostMessage Class

Պարունակում է տվյալներ փաստաթղթի PrePostMessage, PostPostMessage իրադարձությունների մշակիչներին փոխանցելու համար։

EventArgsDocOnConfirmDCR Class

Պարունակում է տվյալներ փաստաթղթի PreOnConfirmDCR, PostOnConfirmDCR իրադարձությունների մշակիչներին փոխանցելու համար։