Configurar a mensagem do cabeçalho na página principal

  • Versão de lançamento: Xanadu
  • Atualizado 1 de ago. de 2024
  • 10 min. de leitura

    • Configure a mensagem do cabeçalho que faz parte do texto de saudação na página principal. Por exemplo: Você está de plantão até segunda-feira, 21 de março.

    Antes de Iniciar

    Função necessária: administrador

    Por Que e Quando Desempenhar Esta Tarefa

    O script do servidor Get Central de serviços Agent shift data broker aciona as Inclusões de script do SOWServiceDeskAgentShift para exibir as informações de turno no texto de saudação.

    Embora o texto de exibição possa ser personalizado para a página inicial padrão, as alterações de estilo visual no texto podem ser feitas apenas criando uma cópia da página inicial.

    Figura 1. Seção de cabeçalho
    Seção de cabeçalho

    Procedimento

    1. Navegue até Todos > Central de administração do Espaço de operações de serviços > Visão geral.
    2. Na guia Visão geral, na seção Configuração inicial, selecione a opção Configurar a página principal.
    3. No formulário da página principal, escolha Configurar ao lado de Saudações.
      O formulário de Inclusões de script é mostrado para SOWServiceDeskAgentShift, que internamente chama o SOWServiceDeskAgentShiftSNC
    4. Copie o valor Script de SOWServiceDeskAgentShiftSNC.
      1. Navegue até Todos > Definição do sistema > Inclusões de script.
      2. Na lista de Inclusões de script, abra SOWServiceDeskAgentShiftSNC.
      3. Copie o valor do campo Script.
    5. Edite o script SOWServiceDeskAgentShift.
      1. Navegue até Todos > Definição do sistema > Inclusões de script.
      2. Na lista de Inclusões de script, abra SOWServiceDeskAgentShift.
      3. Cole o valor do campo Script copiado de SOWServiceDeskAgentShiftSNC. 
        initialize: function() { 

        this.PLUGINS = { 

            ON_CALL: "com.snc.on_call_rotation", 

            SHIFT_PLANNING: "com.sn_shift_planning" 

        }; 

        this.DAYS_AHEAD = gs.getProperty('com.snc.on_call_rotation.upcoming_rota_days', 30); 

        this.DATE_FORMAT = gs.getDateFormat(); 

        this.TIME_FORMAT = gs.getTimeFormat(); 

        this.WFO_SCHEMA_IDENTIFIER = 'readInTimezone'; 

        this.WFO_ONCALL_TYPE_IDENTIFIER = 'oncallAPIReadInTimezone'; 

        this.WEEK_DAY_FORMAT = 'EEEE'; 

        this.FORMAT = { 

            SERVICE_DESK_HEADER: 'SERVICE_DESK_HEADER' 

        }; 

        this.DATE_TIME_FORMAT_FULL = "full"; 

    }, 

 

    getUpcomingShift: function(userId, outputFormat, wfoShift) { 

        var upcomingShifts, gd = new GlideDate(); 

        var from = gd.getDisplayValueInternal(); 

        gd.addDaysLocalTime(this.DAYS_AHEAD); 

        var to = gd.getDisplayValueInternal(); 

        var mayBeWFOUser = userId == gs.getUserID() ? gs.hasRole("sn_shift_planning.agent") : true; 

        if (GlidePluginManager.isActive(this.PLUGINS.SHIFT_PLANNING) && mayBeWFOUser && wfoShift) 

            upcomingShifts = this.getWFOShifts(from, to, userId); 

        var isWFOResponseValid = Array.isArray(upcomingShifts) && upcomingShifts.length > 0; 

        if (!isWFOResponseValid && GlidePluginManager.isActive(this.PLUGINS.ON_CALL)) 

            upcomingShifts = this.getOnCallShifts(from, to, userId); 

        return this.getFormattedShift(upcomingShifts, outputFormat); 

    }, 

 

    getWFOShifts: function(from, to, userId) { 

        var smUtil = new sn_shift_planning.ScheduleManagerUtil(); 

        var defaultEventCategories = [ 

            smUtil.WORK_CATEGORY_SYS_ID, 

            smUtil.ON_CALL_CATEGORY_SYS_ID 

        ]; 

        var params = { 

            "assignmentGroups": "", 

            "individualAgents": userId, 

            "startDate": from, 

            "endDate": to, 

            "published": true, 

            "eventCategories": defaultEventCategories, 

            "filter": { 

                "sn_shift_planning_agent_schedule": { 

                    "event": ["8d03fd9b0f310010717cc562ff767e4a", "936319993bd02010e81a4ee1f3efc419"] 

                } 

            } 

        }; 

        var upcomingShifts = []; 

        try { 

            var agentScheduleRESTAPIUtils = new sn_shift_planning.AgentScheduleRESTAPIUtils(); 

            var spans = agentScheduleRESTAPIUtils.retrieveAgentSchedulesFromParams(params); 

            if (spans && spans.shiftData && spans.shiftData.user && spans.shiftData.user.data && spans.shiftData.user.data.length > 0 && spans.shiftData.user.data[0].schedules) { 

                var schedules = spans.shiftData.user.data[0].schedules, 

                    arrayUtil = new global.ArrayUtil(); 

                for (var schedule in schedules) 

                    upcomingShifts = arrayUtil.union(upcomingShifts, schedules[schedule]); 

            } 

        } catch (e) { 

            gs.error("SOWServiceDeskAgentShiftSNC: Error fetching WFO shifts"); 

        } 

 

        return upcomingShifts; 

    }, 

 

    getOnCallShifts: function(from, to, userId) { 

        var onCallCommon = new global.OnCallCommon(); 

        var onCallGroups = onCallCommon.getMyGroups(); 

        var spans = new global.OCRotationV2(null, global.OCRotationV2.DEFAULT_FORMAT_OPTION).setStartDate(from).setEndDate(to).setUserIds(userId).setGroupIds(onCallGroups).getSpans(); 

        var upcomingShifts = []; 

        for (var i = 0; i < spans.length; i++) 

            if ((spans[i].type == "roster" || spans[i].type == "override") && spans[i].user_id == userId) 

                upcomingShifts.push(spans[i]); 

        return upcomingShifts; 

    }, 

 

    getFormattedShift: function(upcomingShifts, outputFormat) { 

        if (gs.nil(upcomingShifts)) 

            return; 

        switch (outputFormat) { 

            case this.FORMAT.SERVICE_DESK_HEADER: 

                return this.getServiceDeskFormattedShift(upcomingShifts); 

            default: 

                return upcomingShifts; 

        } 

    }, 

 

    getServiceDeskFormattedShift: function(upcomingShifts) { 

        var response = { 

            shiftText: "", 

            nearestShift: {} 

        }; 

        var startAttr = "start", 

            endAttr = "end", 

            isOnCall = true; 

        var dateFormat = 'EEEE, MMM dd', 

            timeFormat = 'hh:mm a'; 

        var isWFOSchema = Array.isArray(upcomingShifts) && upcomingShifts.length > 0 && this.WFO_SCHEMA_IDENTIFIER in upcomingShifts[0]; 

        if (isWFOSchema) 

            startAttr = "scheduledStartTime", endAttr = "scheduledEndTime"; 

        response.nearestShift = this.getNearestShift(upcomingShifts, startAttr, endAttr); 

        if (response.nearestShift) { 

            if (isWFOSchema) { 

                if (response.nearestShift.schedule && !(this.WFO_ONCALL_TYPE_IDENTIFIER in response.nearestShift.schedule)) 

                    isOnCall = false; 

            } 

            if (isOnCall) { 

                if (response.nearestShift.isCurrent) { 

                    if (response.nearestShift.roster_name) 

                        response.shiftText = gs.getMessage("You are on-call until {0} as {1}", [this.getFormattedDateTime(response.nearestShift[endAttr]), response.nearestShift.roster_name]); 

                    else 

                        response.shiftText = gs.getMessage("You are on-call until {0}", [this.getFormattedDateTime(response.nearestShift[endAttr])]); 

                } else { 

                    if (response.nearestShift.roster_name) 

                        response.shiftText = gs.getMessage("Your next on-call shift starts on {0} as {1}", [this.getFormattedDateTime(response.nearestShift[startAttr]), response.nearestShift.roster_name]); 

                    else 

                        response.shiftText = gs.getMessage("Your next on-call shift starts on {0}", [this.getFormattedDateTime(response.nearestShift[startAttr])]); 

                } 

            } else { 

                if (response.nearestShift.isCurrent) { 

                    response.shiftText = gs.getMessage("Your shift ends on {0}", [this.getFormattedDateTime(response.nearestShift[endAttr])]); 

                } else 

                    response.shiftText = gs.getMessage("Your next shift starts on {0}", [this.getFormattedDateTime(response.nearestShift[startAttr])]); 

            } 

        } 

 

        return response; 

    }, 

 

    getNearestShift: function(upcomingShifts, startAttr, endAttr) { 

        if (gs.nil(upcomingShifts) || gs.nil(startAttr) || gs.nil(endAttr)) 

            return; 

        var nearestShift; 

        upcomingShifts.sort(function(shift_1, shift_2) { 

            var gdt1 = new GlideDateTime(); 

            gdt1.setDisplayValueInternal(shift_1[startAttr]); 

            var gdt2 = new GlideDateTime(); 

            gdt2.setDisplayValueInternal(shift_2[startAttr]); 

            return GlideDateTime.subtract(gdt2, gdt1).getNumericValue(); 

        }); 

        var currentDateTime = new GlideDateTime(), 

            startDateTime = new GlideDateTime(), 

            endDateTime = new GlideDateTime(); 

        for (var i = 0; i < upcomingShifts.length; i++) { 

            startDateTime.setDisplayValueInternal(upcomingShifts[i][startAttr] + ""); 

            endDateTime.setDisplayValueInternal(upcomingShifts[i][endAttr] + ""); 

            if (currentDateTime.onOrBefore(endDateTime)) { 

                nearestShift = upcomingShifts[i]; 

                if (currentDateTime.onOrAfter(startDateTime)) 

                    nearestShift.isCurrent = true; 

                else 

                    nearestShift.isCurrent = false; 

                break; 

            } 

        } 

        return nearestShift; 

    }, 

 

    getFormattedDateSpan: function(date, dateFormat, timeFormat) { 

        var formattedDate = this.getFormattedDate(date, dateFormat); 

        var dateAmPmTime = this.getFormattedTime(date, timeFormat); 

        return formattedDate + " " + dateAmPmTime; 

    }, 

 

    getFormattedDate: function(inputDate, format) { 

        var date = new GlideDateTime(); 

        date.setDisplayValueInternal(inputDate); 

        format = !format ? this.DATE_FORMAT : format; 

        var gd = date.getLocalDate(); 

        return gd.getByFormat(format); 

    }, 

 

    getFormattedTime: function(inputDate, format) { 

        var date = new GlideDateTime(); 

        date.setDisplayValueInternal(inputDate); 

        format = !format ? this.TIME_FORMAT : format; 

        var gt = date.getLocalTime(); 

        return gt.getByFormat(format); 

    }, 

 

    getFormattedDateTime: function(date) { 

        var dateTime = new GlideDateTime(); 

        dateTime.setDisplayValueInternal(date); 

        return dateTime.getDisplayValueLang(this.DATE_TIME_FORMAT_FULL); 

    }, 

 

    endsToday: function(inputDate) { 

        var inputGdt = new GlideDateTime(); 

        inputGdt.setDisplayValueInternal(inputDate); 

        return new GlideDateTime().getLocalDate().getValue() == inputGdt.getLocalDate().getValue(); 

    }, 

 

    endingTomorrow: function(inputDate) { 

        var inputGdt = new GlideDateTime(); 

        inputGdt.setDisplayValueInternal(inputDate); 

        var tomorrowDateTime = new GlideDateTime(); 

        tomorrowDateTime.addDaysLocalTime(1); 

        return tomorrowDateTime.getLocalDate().getValue() == inputGdt.getLocalDate().getValue(); 

    },
      4. Edite a seguinte parte do script, conforme mencionado. 
                    if (isOnCall) { 

                if (response.nearestShift.isCurrent) { 

                    if (response.nearestShift.roster_name) 

                        response.shiftText = gs.getMessage("You are on-call until {0} as {1}", [this.getFormattedDateTime(response.nearestShift[endAttr]), response.nearestShift.roster_name]); 

                    else 

                        response.shiftText = gs.getMessage("You are on-call until {0}", [this.getFormattedDateTime(response.nearestShift[endAttr])]); 

                } else { 

                    if (response.nearestShift.roster_name) 

                        response.shiftText = gs.getMessage("Your next on-call shift starts on {0} as {1}", [this.getFormattedDateTime(response.nearestShift[startAttr]), response.nearestShift.roster_name]); 

                    else 

                        response.shiftText = gs.getMessage("Your next on-call shift starts on {0}", [this.getFormattedDateTime(response.nearestShift[startAttr])]); 

                } 

            } else { 

                if (response.nearestShift.isCurrent) { 

                    response.shiftText = gs.getMessage("Your shift ends on {0}", [this.getFormattedDateTime(response.nearestShift[endAttr])]); 

                } else 

                    response.shiftText = gs.getMessage("Your next shift starts on {0}", [this.getFormattedDateTime(response.nearestShift[startAttr])]); 

            }
    6. Selecione Atualizar.