OCRosterSpanApprovalUtil : global

L’include de script OCRosterSpanApprovalUtil fournit des méthodes pour la fonctionnalité d’approbation des congés payés.

OCRosterSpanApprovalUtil : approvePTOSpan (GlideRecord rosterSpanGr)

Modifie le type de roster_schedule_span en congé à partir de l’approbation.

Tableau 1. Paramètres
Nom Type Description
rosterSpanGr GlideRecord Un enregistrement roster_schedule_span_proposal.
Tableau 2. Renvoie
Type Description
nul

OCRosterSpanApprovalUtil : getContextualCalUrlPerSpanProposal (GlideRecord rosterSpanProposalGr)

Renvoie une URL vers le calendrier d’astreinte en fonction de rosterSpanProposalGr.

Tableau 3. Paramètres
Nom Type Description
rosterSpanProposalGr GlideRecord Un enregistrement roster_schedule_span_proposal.
Tableau 4. Renvoie
Type Description
Chaîne URL vers le calendrier d’astreinte basé sur rosterSpanProposalGr.

OCRosterSpanApprovalUtil : getFromDateDisplayValuePerSpanProposal (GlideRecord rosterSpanProposalGr)

Renvoie une chaîne GlideScheduleDateTime formatée basée sur la date de début de rosterSpanProposalGr.

Tableau 5. Paramètres
Nom Type Description
rosterSpanProposalGr GlideRecord Un enregistrement roster_schedule_span_proposal.
Tableau 6. Renvoie
Type Description
Chaîne Chaîne GlideScheduleDateTime formatée basée sur la date de début de rosterSpanProposalGr.

OCRosterSpanApprovalUtil : getPTOApproversList(GlideRecord rosterSpanProposalGr)

Renvoie un tableau de gestionnaires de groupes en fonction des groupes de rotation de l’utilisateur.

Tableau 7. Paramètres
Nom Type Description
rosterSpanProposalGr GlideRecord Un enregistrement roster_schedule_span_proposal.
Tableau 8. Renvoie
Type Description
Tableau Tableau de gestionnaires de groupes basés sur les groupes de rotation de l’utilisateur.

L’exemple suivant est un include de script à la demande nommé OCPTOApprovalReminder. Lorsqu’ils sont appelés par l’exécution manuelle de la tâche planifiée, les gestionnaires et leurs responsables délégués sont informés des employés qui doivent passer le PTO le lendemain.

function OCPTOApprovalReminder() {

	//Passing parameters in 'getDateFormat()' function with the days which needs to be added
	var startDate = getDateFormat(1); //We can use System property to set Start Date
	var endDate = getDateFormat(2); //We can use System property to set End Date
	
	//Building the encoded query all the Pending approval state proposals whose start date is tomorrow
	var encodedQuery = 'state=1^roster_schedule_span.start_date_time>' + startDate + '^roster_schedule_span.start_date_time<' + endDate;
	
	//Sends an event notification to all rota managers and their delegate managers
	getNotApprovedList(encodedQuery);
	
	//Converts the date and time in ISO Format
	function getDateFormat(daysToBeAdded) {

		//Getting today's date and adding '1' day
		var todaysDate = new GlideDate();
		todaysDate.addDaysUTC(daysToBeAdded);
		todaysDate = todaysDate.getValue();

		//Converting to today's date object to GlideDate object
		var addingDaysToDate = new GlideDate();
		addingDaysToDate.setValue(todaysDate);

		//Setting the time default to '12:00:00' and returning the time in the specified format to match ISO
		var staticTime = new GlideTime();
		staticTime.setValue('00:00:00');
		staticTime.setValue(staticTime.getHourOfDayUTC() + ':' + staticTime.getMinutesUTC() + ':' + staticTime.getSeconds());

		//Returns the date & time in the specified format
		var isoFormattedDateTime = addingDaysToDate.getByFormat("yyyyMMdd") + 'T' + staticTime.getByFormat("HHmmss") + 'Z';
		return isoFormattedDateTime;
	}
	
	//Gliding Roster schedule span proposal table with the built-in query to fetch the records whose proposals are not approved/rejected
	function getNotApprovedList(addEncodedQuery) {
		var rosterScheduleEntryProposalGR = new GlideRecord('roster_schedule_span_proposal');
		rosterScheduleEntryProposalGR.addEncodedQuery(addEncodedQuery);
		rosterScheduleEntryProposalGR.query();
		while(rosterScheduleEntryProposalGR.next()) {

			//Call On-Call Scheduling OCRosterSpanApprovalUtil library with 'getPTOApproversList' function 
			//pass GlideRecord object of 'roster_schedule_span_proposal' table
			var rotaManagers = new OCRosterSpanApprovalUtil().getPTOApproversList(rosterScheduleEntryProposalGR);
			rotaManagers = rotaManagers.join(",");

			// Pull only the unique sys_ids
			var managerList = new ArrayUtil().unique(getManagerDelegateApprovals(rotaManagers).toString().split(','));

                     // Event to trigger a reminder notification for testing.
                     // To use, create a an event registry named "oc.manager.delegate.reminder"
                     // Call the event in a notification and uncomment the following line
			//gs.eventQueue("oc.manager.delegate.reminder", rosterScheduleEntryProposalGR, managerList, "");

               if(managerList)
			gs.info("Returns the list of manager and it's delegate members >>>>>> " + managerList);
		}
	}
	
	//Get the sys_ids of the managers and their delegate managers
	function getManagerDelegateApprovals(manager) {
		var answer = [];
        answer.push(manager);
		var delegateGR = new GlideRecord("sys_user_delegate");
		delegateGR.addQuery("user", 'IN', manager);
		delegateGR.addQuery("starts", "<=", gs.daysAgo(0));
		delegateGR.addQuery("ends", ">=", gs.daysAgo(0));
		delegateGR.addQuery("approvals", true);
		delegateGR.query();
		while(delegateGR.next()) {
			answer.push(delegateGR.getValue('user'));
			answer.push(delegateGR.getValue('delegate'));
		}
		return answer;
	}
}

Ajoutez l’appel suivant à un enregistrement de la table Exécution de script planifiée [sysauto_script]. Ce déclencheur appelle l’include de script OCPTOApprovalReminder lorsque la tâche planifiée est exécutée manuellement.

OCPTOApprovalReminder();

OCRosterSpanApprovalUtil : getToDateDisplayValuePerSpanProposal (rosterSpanProposalGr GlideRecord)

Renvoie une chaîne GlideScheduleDateTime formatée basée sur la date de fin de rosterSpanProposalGr.

Tableau 9. Paramètres
Nom Type Description
rosterSpanProposalGr GlideRecord Un enregistrement roster_schedule_span_proposal.
Tableau 10. Renvoie
Type Description
Chaîne Chaîne GlideScheduleDateTime formatée basée sur la date de fin de rosterSpanProposalGr.

OCRosterSpanApprovalUtil : getUserNamePerSpanProposal (GlideRecord rosterSpanProposalGr)

Renvoie le nom de l’utilisateur en fonction de rosterSpanProposalGr.

Tableau 11. Paramètres
Nom Type Description
rosterSpanProposalGr GlideRecord Un enregistrement roster_schedule_span_proposal.
Tableau 12. Renvoie
Type Description
Chaîne Nom de l’utilisateur basé sur rosterSpanProposalGr.

OCRosterSpanApprovalUtil : isPTOApprovalRequired()

Vérifie si la propriété com.snc.on_call_rotation.pto.approval.required système est vraie.

Tableau 13. Paramètres
Nom Type Description
Aucun
Tableau 14. Renvoie
Type Description
Booléen Renvoie la valeur true si la propriété com.snc.on_call_rotation.pto.approval.required système est vrai.

OCRosterSpanApprovalUtil : rejetPTOSpan (GlideRecord rosterSpanGr)

Modifie le type de roster_schedule_span en rejeté à partir de l’approbation.

Tableau 15. Paramètres
Nom Type Description
rosterSpanGr GlideRecord Un enregistrement roster_schedule_span_proposal.
Tableau 16. Renvoie
Type Description
nul