project BLF > class BUserRole > method ApiSaveUserMembership

Description

Method to save the user membership.


Parameters


tUserMembershipinputtemp-table
oiReturnStatusoutputintegerReturn status of the method.


Internal usage


unused


program code (program3/buserrole.p)

if oiReturnStatus = 0
then assign oiReturnStatus = -98.

/*get the users and roles to do a dataload for*/
/*only the changed records*/
assign vcUserIdList = ''
       vcRoleIdList = ''.

for each tUserMembership where
         tUserMembership.tlChanged = true:    
    
    if lookup(string(tUserMembership.tiUsr_ID), vcUserIdList) = 0
    then assign vcUserIdList = (if vcUserIdList = ''
                                then string(tUserMembership.tiUsr_ID)
                                else vcUserIdList + ',' + string(tUserMembership.tiUsr_ID)).

    if lookup(string(tUserMembership.tiRole_ID), vcRoleIdList) = 0
    then assign vcRoleIdList = (if vcRoleIdList = ''
                                then string(tUserMembership.tiRole_ID)
                                else vcRoleIdList + ',' + string(tUserMembership.tiRole_ID)).
end. /*for each tUserMembership:*/

if vcUserIdList = '' or vcRoleIdList = ''
then do:
    assign oiReturnStatus = 0.
    return.
end.

/*added here 1 validation so you get a message when you try to set a default role to a not linked usr role*/
find first tUserMembership where
           tUserMembership.tlChanged              = true  and           
           tUserMembership.tlUsrRoleIsDefaultRole = true no-error.
if available tUserMembership
then do:
    assign vcDefaultRole = tUserMembership.tcRoleName
           vcUser        = tUserMembership.tcUsrLogin.

    find first tUserMembership where
               tUserMembership.tlLink                 = true  and           
               tUserMembership.tlUsrRoleIsDefaultRole = true no-error.
    if not available tUserMembership
    then do:
        assign vcMessage = trim (substitute(#T-12'The default role (&1) is not linked to the user (&2).':255(9023)T-12#,vcDefaultRole,vcUser))
               oiReturnStatus = -1.
        <M-11 run SetMessage
           (input  vcMessage (icMessage), 
            input  '' (icArguments), 
            input  '' (icFieldName), 
            input  '' (icFieldValue), 
            input  'E':U (icType), 
            input  3 (iiSeverity), 
            input  '' (icRowid), 
            input  'BLF-426':U:U (icFcMsgNumber), 
            input  '' (icFcExplanation), 
            input  '' (icFcIdentification), 
            input  '' (icFcContext), 
            output viFcReturnSuper (oiReturnStatus)) in BUserRole>
        return.
    end.
end.

/* 1 transaction per user                   */
/* because danger of a to large transaction */
/* keep this by user for the validations on the default role */

do viCount = 1 to num-entries(vcUserIdList):

    /*create freeform*/
    /*only this user*/
    assign vcFreeForm = "for each UsrRole where UsrRole.Usr_ID = ":U + entry(viCount,vcUserIdList) + " and (".

    /*only the changed users*/
    do viFcCount1 = 1 to num-entries(vcRoleIdList):
        if viFcCount1 = 1 
        then assign vcFreeForm = vcFreeForm + " UsrRole.Role_ID = ":U + entry(viFcCount1,vcRoleIdList).
        else assign vcFreeForm = vcFreeForm + " or UsrRole.Role_ID = ":U + entry(viFcCount1,vcRoleIdList).
    end.

    assign vcFreeForm = vcFreeForm + ")".

    <M-1 run DataLoad
       (input  '' (icRowids), 
        input  '' (icPkeys), 
        input  '' (icObjectIds), 
        input  vcFreeForm (icFreeform), 
        input  false (ilKeepPrevious), 
        output viFcReturnSuper (oiReturnStatus)) in BUserRole>
    if viFcReturnSuper = -4 
    then assign viFcReturnSuper = 0.
    if viFcReturnSuper <> 0
    then assign oiReturnStatus = viFcReturnSuper.
    if viFcReturnSuper < 0
    then return.    

    /*tUserMembership.tlChanged = true*/
    for each tUserMembership where              
             tUserMembership.tlChanged = true and
             string(tUserMembership.tiUsr_ID) = entry(viCount,vcUserIdList):
    
        find tUsrRole where 
             tUsrRole.Role_ID = tUserMembership.tiRole_ID and
             tUsrRole.Usr_ID = tUserMembership.tiUsr_ID no-error.
        if not available tUsrRole and
           tUserMembership.tlLink = true
        then do:
            <M-9 run AddDetailLine
               (input  'UsrRole':U (icTable), 
                input  '' (icParentRowid), 
                output viFcReturnSuper (oiReturnStatus)) in BUserRole>
            if viFcReturnSuper <> 0
            then assign oiReturnStatus = viFcReturnSuper.
            if viFcReturnSuper < 0
            then return.
            assign tUsrRole.Role_ID              = tUserMembership.tiRole_ID
                   tUsrRole.Usr_ID               = tUserMembership.tiUsr_ID
                   tUsrRole.tcRoleName           = tUserMembership.tcRoleName /* needed for replication */
                   tUsrRole.tcUsrLogin           = tUserMembership.tcUsrLogin
                   tUsrRole.UsrRoleIsDefaultRole = tUserMembership.tlUsrRoleIsDefaultRole.
        end.
        else do:
            if available tUsrRole /*only treath available tUsrRole*/
            then do:
                if tUserMembership.tlLink = true
                then do:
                    /*only set status to C if the status is empty or D*/
                    assign tUsrRole.tc_Status = (if tUsrRole.tc_Status = '':U or
                                                    tUsrRole.tc_Status = 'D':U
                                                 then 'C':U
                                                 else tUsrRole.tc_Status)
                           tUsrRole.tcRoleName           = tUserMembership.tcRoleName
                           tUsrRole.tcUsrLogin           = tUserMembership.tcUsrLogin
                           tUsrRole.UsrRoleIsDefaultRole = tUserMembership.tlUsrRoleIsDefaultRole.
                end.                
            end. /**/
        end.                        

        /* tUsrRoleCompany records */
        find tUsrRoleCompany where
             tUsrRoleCompany.tc_ParentRowid = tUsrRole.tc_Rowid and
             tUsrRoleCompany.tcCompanyCode = tUserMembership.tcCompanyCode no-error.
        if not available tUsrRoleCompany and
           tUserMembership.tlLink = true
        then do:
            <M-3 run AddDetailLine
               (input  'UsrRoleCompany':U (icTable), 
                input  tUsrRole.tc_Rowid (icParentRowid), 
                output viFcReturnSuper (oiReturnStatus)) in BUserRole>

            if viFcReturnSuper <> 0
            then assign oiReturnStatus = viFcReturnSuper.
            if viFcReturnSuper < 0
            then return.

            /* Role_ID and Usr_ID are assigned in ValidateComponent */
            assign  tUsrRoleCompany.Company_ID    = tUserMembership.tiCompany_ID
                    tUsrRoleCompany.tcCompanyCode = tUserMembership.tcCompanyCode
                    tUsrRoleCompany.Domain_ID     = tUserMembership.tiDomain_ID.

        end. /*if not available tUsrRoleCompany*/
        else do:
            if available tUsrRoleCompany /*only treath available*/
            then do:
                if tUserMembership.tlLink = true
                then do:
                    /*only set status to C if the status is empty or D*/
                    assign tUsrRoleCompany.tc_Status = (if tUsrRoleCompany.tc_Status = '':U or
                                                           tUsrRoleCompany.tc_Status = 'D':U
                                                        then 'C':U
                                                        else tUsrRoleCompany.tc_Status)
                            tUsrRoleCompany.Company_ID    = tUserMembership.tiCompany_ID
                            tUsrRoleCompany.tcCompanyCode = tUserMembership.tcCompanyCode
                            tUsrRoleCompany.Domain_ID     = tUserMembership.tiDomain_ID.
                end.
                /*delete usrrolecompany record if tUsrRoleCompany is avail and not linked*/
                else do:
                    /*only set status to D if status is empty*/
                    assign tUsrRoleCompany.tc_Status = (if tUsrRoleCompany.tc_Status = '':U 
                                                        then 'D':U
                                                        else tUsrRoleCompany.tc_Status).
                end.
            end. /**/
        end.

        /* tUsrRoleDomain records */
        find tUsrRoleDomain where
             tUsrRoleDomain.tc_ParentRowid = tUsrRole.tc_Rowid and
             tUsrRoleDomain.tcDomainCode = tUserMembership.tcDomainCode no-error.
        if not available tUsrRoleDomain and
           tUserMembership.tlLink = true
        then do:
            <M-8 run AddDetailLine
               (input  'UsrRoleDomain':U (icTable), 
                input  tUsrRole.tc_Rowid (icParentRowid), 
                output viFcReturnSuper (oiReturnStatus)) in BUserRole>
            
            if viFcReturnSuper <> 0
            then assign oiReturnStatus = viFcReturnSuper.
            if viFcReturnSuper < 0
            then return.
            
            /* Role_ID and Usr_ID are assigned in ValidateComponent */
            assign  tUsrRoleDomain.Domain_ID    = tUserMembership.tiDomain_ID
                    tUsrRoleDomain.tcDomainCode = tUserMembership.tcDomainCode.

        end. /*if not available tUsrRoleDomain*/
        else do:
            if available tUsrRoleDomain /*only treath available*/
            then do:
                if tUserMembership.tlLink = true
                then do:
                    /*only set status to C if the status is empty or D*/
                    assign tUsrRoleDomain.tc_Status = (if tUsrRoleDomain.tc_Status = '':U or
                                                          tUsrRoleDomain.tc_Status = 'D':U
                                                       then 'C':U
                                                               else tUsrRoleDomain.tc_Status)
                            tUsrRoleDomain.Domain_ID    = tUserMembership.tiDomain_ID
                            tUsrRoleDomain.tcDomainCode = tUserMembership.tcDomainCode.
                end.                
            end. /**/
        end.
        
    end. /*for each tUserMembership:*/

    /*delete not used userroledomain records*/
    for each tUsrRole:
        for each tUsrRoleDomain where
                 tUsrRoleDomain.tc_ParentRowid = tUsrRole.tc_Rowid:
            if /*check if we can not find any good record in UsrRoleCompany*/
               not can-find(first tUsrRoleCompany where
                                  tUsrRoleCompany.Domain_ID      = tUsrRoleDomain.Domain_ID and
                                  tUsrRoleCompany.tc_ParentRowid = tUsrRole.tc_Rowid        and
                                  tUsrRoleCompany.tc_Status      <> 'D':U                      )             
            then assign tUsrRoleDomain.tc_Status = 'D':U.
        end.

        if /*check if we can not find any good record in UsrRoleCompany*/
           not can-find(first tUsrRoleCompany where                              
                              tUsrRoleCompany.tc_ParentRowid = tUsrRole.tc_Rowid        and
                              tUsrRoleCompany.tc_Status      <> 'D':U                      )             
        then do: 
            assign tUsrRole.tc_Status = 'D':U.
            /*set all tUsrRoleCompany.tc_Status to '' to avoid optimistic lock error*/
            for each tUsrRoleDomain where 
                     tUsrRoleDomain.tc_ParentRowid = tUsrRole.tc_Rowid:
                assign tUsrRoleDomain.tc_Status = '':U.
            end.
            for each tUsrRoleCompany where 
                     tUsrRoleCompany.tc_ParentRowid = tUsrRole.tc_Rowid:
                assign tUsrRoleCompany.tc_Status = '':U.
            end.
        end.
    end.


    <M-4 run ValidateBC
       (output viFcReturnSuper (oiReturnStatus)) in BUserRole>
    if viFcReturnSuper <> 0
    then assign oiReturnStatus = viFcReturnSuper.
    if viFcReturnSuper < 0
    then return.
    
    <M-5 run AdditionalUpdates
       (output viFcReturnSuper (oiReturnStatus)) in BUserRole>
    if viFcReturnSuper <> 0
    then assign oiReturnStatus = viFcReturnSuper.
    if viFcReturnSuper < 0
    then return.
    
    <M-6 run DataSave
       (output viFcReturnSuper (oiReturnStatus)) in BUserRole>
    if viFcReturnSuper <> 0
    then assign oiReturnStatus = viFcReturnSuper.
    if viFcReturnSuper < 0
    then return.

end. /*do viCount = 1 to num-entries(vcUserIdList):*/

if oiReturnStatus = -98
then assign oiReturnStatus = 0.


Sample code: how to call this method through RPCRequestService (QXtend Inbound)

define temp-table ttContext no-undo
    field propertyQualifier as character
    field propertyName as character
    field propertyValue as character
    index entityContext is primary unique
        propertyQualifier
        propertyName
    index propertyQualifier
        propertyQualifier.

define dataset dsContext for ttContext.

define variable vhContextDS as handle no-undo.
define variable vhExceptionDS as handle no-undo.
define variable vhServer as handle no-undo.
define variable vhInputDS as handle no-undo.
define variable vhInputOutputDS as handle no-undo.
define variable vhOutputDS as handle no-undo.
define variable vhParameter as handle no-undo.

/* Create context */
create ttContext.
assign ttContext.propertyName = "programName"
       ttContext.propertyValue = "BUserRole".
create ttContext.
assign ttContext.propertyName = "methodName"
       ttContext.propertyValue = "ApiSaveUserMembership".
create ttContext.
assign ttContext.propertyName = "applicationId"
       ttContext.propertyValue = "fin".
create ttContext.
assign ttContext.propertyName = "entity"
       ttContext.propertyValue = "1000".
create ttContext.
assign ttContext.propertyName = "userName"
       ttContext.propertyValue = "mfg".
create ttContext.
assign ttContext.propertyName = "password"
       ttContext.propertyValue = "".

/* Create input dataset */
create dataset vhInputDS.
vhInputDS:read-xmlschema("file", "xml/buserrole.apisaveusermembership.i.xsd", ?).
vhParameter = vhInputDS:get-buffer-handle("tUserMembership").
vhParameter:buffer-create().
assign vhParameter::<field-name-1> = <field-value-1>
       vhParameter::<field-name-2> = <field-value-2>
       ...

/* Connect the AppServer */
create server vhServer.
vhServer:connect("-URL <appserver-url>").

if not vhServer:connected()
then do:
    message "Could not connect AppServer" view-as alert-box error title "Error".
    return.
end.

/* Run */
assign vhContextDS = dataset dsContext:handle.

run program/rpcrequestservice.p on vhServer
    (input-output dataset-handle vhContextDS by-reference,
           output dataset-handle vhExceptionDS,
     input        dataset-handle vhInputDS by-reference,
     input-output dataset-handle vhInputOutputDS by-reference,
           output dataset-handle vhOutputDS).

/* Handle output however you want, in this example, we dump it to xml */
if valid-handle(vhExceptionDS)
then vhExceptionDS:write-xml("file", "Exceptions.xml", true).

if valid-handle(vhOutputDS)
then vhOutputDS:write-xml("file", "Output.xml", true).

/* Cleanup */
vhServer:disconnect().
assign vhServer = ?.

if valid-handle(vhInputDS)
then delete object vhInputDS.

if valid-handle(vhOutputDS)
then delete object vhOutputDS.

if valid-handle(vhExceptionDS)
then delete object vhExceptionDS.