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

Versão de lançamento: Yokohama

Atualizado 30 de jan. de 2025

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.

Texto de saudação — Figura 1. Seção de cabeçalho

Nota:

A notificação de alerta na faixa em SOW se expande automaticamente para exibir a mensagem completa. Este recurso está habilitado por padrão no sistema de base. Você pode atualizar a propriedade da página de UX do sistema auto_expand_now_alert_message para falsa se não quiser expandir e exibir automaticamente a mensagem inteira.

Procedimento

Navegar até Tudo > Central de administração do Espaço de operações de serviços > Visão geral.
Na guia Visão geral, na seção Configuração inicial, selecione a opção Configurar a página principal.
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
Copie o valor Script de SOWServiceDeskAgentShiftSNC.
1. Navegar até Tudo > 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.

Edite o script SOWServiceDeskAgentShift.

Navegar até Tudo > Definição do Sistema > Inclusões de script.
Na lista de Inclusões de script, abra SOWServiceDeskAgentShift.

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(); 

    },

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])]); 

            }

Selecione Atualizar.