Mettre à jour une rotation de planning

Mettez à jour les participants et les restrictions horaires d'une rotation de planning spécifique.

Options

Champ Définition Type Obligatoire

Identificateur de planning

Type d'identificateur de planning pour l'équipe. Sélectionnez l'une des options suivantes :

  • Schedule ID : ID unique du planning.
  • Schedule Name : nom du planning.
Liste déroulante TRUE

Mettre à jour la restriction de temps ?

Indiquez si la restriction de temps est mise à jour. Sélectionnez l'une des options suivantes :

  • No: aucune restriction de temps mise à jour.
  • Time Only: limitez la rotation du planning à une heure de la semaine.
  • Day and Time: limitez la rotation des plannings en fonction d'un certain jour et d'une certaine heure de la semaine.
Liste déroulante TRUE

Entrée

Ces champs sont générés de façon dynamique en fonction des champs sélectionnés dans Options.

Champ Définition Type Obligatoire

Rotation

ID du planning

ID unique du planning.

Ce champ s'affiche lorsque Schedule ID est sélectionné dans les options Identificateur de planning.

Texte TRUE

Nom du planning

Nom du planning.

Ce champ s'affiche lorsque Schedule Name est sélectionné dans l'option Identificateur de planning.

Texte TRUE

ID de rotation

ID unique de la rotation de planning.

Texte TRUE

Nom

Nom de la rotation.

Texte FALSE

Date de début

Date de début de la rotation. Format de date de la manière suivante : yyyy-MM-dd'T'HH:mm:ssZ (par exemple, 2017-01-15T08:00:00+02:00). Les minutes peuvent prendre 0 ou 30 comme valeur. Dans le cas contraire, elles seront automatiquement converties à la valeur 0 ou 30 la plus proche.

Date et heure FALSE

Date de fin

Date de fin de la rotation. Format de date de la manière suivante : yyyy-MM-dd'T'HH:mm:ssZ (par exemple, 2017-01-15T08:00:00+02:00). Les minutes peuvent prendre 0 ou 30 comme valeur. Dans le cas contraire, elles seront automatiquement converties à la valeur 0 ou 30 la plus proche.

Date et heure FALSE

Type

Durée de la rotation. Sélectionnez l'une des options suivantes :

  • Horaire
  • Quotidien
  • Hebdomadaire
Liste déroulante FALSE

Longueur

Longueur de la rotation. La valeur par défaut est 1.

Nombre FALSE

Fusionner les participants ?

Indique s'il faut fusionner la liste des participants existante avec la liste d'entrée. Sélectionnez l'une des options suivantes :

  • Oui
  • Non
Liste déroulante FALSE

Participants

Liste des remontées, des équipes, des utilisateurs ou « none » utilisés dans un planning. Chacun d'eux peut être utilisé plusieurs fois et fera l'objet d'une rotation selon l'ordre indiqué.

Pour les utilisateurs et les équipes, vous pouvez définir les propriétés ID ou Nom d'utilisateur de manière facultative.

Par exemple :

[
	{
		"type":"escalation",
		"id":"3f145401-e6f3-428f-9f3c-41b0e1d172d5",
		"name":"Team 2_escalation"
	},
	{
		"type":"user",
		"id":"d92b2aa1-4bc8-481b-a30e-4f19e5a27f83",
		"username":"johnathan.doe@okta.com"
	},
	{
		"type":"team",
		"id":"d00f95c1-2cce-4110-adbc-2ceca786c305",
		"username":"lily.doe@okta.com"
	},
	{
	"type":"none"
	}
]

Tableau d'objets

FALSE

Restrictions de temps

Utilisé pour limiter la rotation des plannings à un certain jour et à une certaine heure de la semaine, en utilisant plusieurs heures de début et de fin pour chaque jour de la semaine. Cela permet d'appliquer différentes rotations de planification à des moments différents.

Ce champ s'affiche lorsque Time Only ou Day and Time est sélectionnée dans Mettre à jour la restriction de temps ? dans les options.

Objet TRUE

Lorsque Time Only est sélectionné pour le champ Mettre à jour la restriction de temps ? dans les options, les options suivantes sont disponibles.

Remarque : Les heures sont arrondies à l'unité inférieure et les minutes sont arrondies au 00/30 le plus proche.

Nombre TRUE

startHour : de 0 à 23

Nombre TRUE

startMinute : 00 ou 30

Nombre TRUE

endHour : 0 à 23

Nombre TRUE

endMinute : 00 ou 30

Nombre TRUE

Par exemple :

{
	"startHour": 5
	"startMin": 30
	"endHour": 16
	"endMin": 0
}

Lorsque >Day and Time est sélectionné pour le champ Mettre à jour la restriction de temps ? dans Options, les options suivantes sont disponibles.

Remarque : Les options de jour et d'heure sont obligatoires.

Tableau d'objets

TRUE

startDay : de lundi à dimanche

Texte TRUE

startHour : de 0 à 23

Nombre TRUE

startMinute : 00 ou 30

Nombre TRUE

endDay : de lundi à dimanche

Texte TRUE

endHour : 0 à 23

Nombre TRUE

endMinute : 00 ou 30

Nombre TRUE

Par exemple :

[
	{
		"startDay":"monday",
		"endDay":"tuesday",
		"startHour":8,
		"endHour":18,
		"startMin":0,
		"endMin":30
	},
	{
		"startDay":"thursday",
		"endDay":"sunday",
		"startHour":6,
		"endHour":8,
		"startMin":0,
		"endMin":30
	}
]

Sortie

Champ Définition Type

Code de statut

Résultat de l'opération. Le connecteur retourne un code de statut HTTP qui indique si l'action effectuée par la carte a réussi ou échoué. Par exemple :

  • Un code de statut 201 Created indique un succès où une nouvelle ressource a été créée.
  • Une erreur 403 Forbidden indique que la requête HTTP n'a pas été traitée parce que les permissions nécessaires étaient manquantes.

Pour une liste complète des codes de statut possibles, voir Codes de statut HTTP.

Nombre

Résultat

Résultat de l'appel d'API.

Par exemple, Deleted.

Texte