New-CsRgsWorkflow
Dernière rubrique modifiée : 2012-03-23
Crée un workflow Response Group. Les workflows déterminent les actions exécutées lorsque l’application Response Group reçoit un appel téléphonique.
Syntaxe
New-CsRgsWorkflow -Parent <RgsIdentity> -Name <String> -PrimaryUri <Uri> [-Active <$true | $false>] [-Anonymous <$true | $false>] [-BusinessHoursID <Nullable>] [-Confirm [<SwitchParameter>]] [-CustomMusicOnHoldFile <AudioFile>] [-DefaultAction <CallAction>] [-Description <String>] [-DisplayNumber <String>] [-EnabledForFederation <$true | $false>] [-Force <SwitchParameter>] [-HolidayAction <CallAction>] [-HolidaySetIDList <Collection>] [-InMemory <SwitchParameter>] [-Language <String>] [-LineUri <Uri>] [-NonBusinessHoursAction <CallAction>] [-TimeZone <String>] [-WhatIf [<SwitchParameter>]]
Description détaillée
Les workflows sont un élément clé de l’application Response Group. Chaque workflow est associé de manière unique à un numéro de téléphone ; lorsqu’une personne appelle ce numéro, le workflow détermine la manière de traiter l’appel. L’appel, par exemple, peut être transféré vers une série de questions du système de réponse vocale interactive qui demande à l’appelant d’entrer des informations supplémentaires (« Appuyez sur 1 pour accéder au support matériel. Appuyez sur 2 pour accéder au support logiciel ».) L’appel peut être également placé dans une file d’attente et l’appelant peut être mis en attente jusqu’à ce qu’un agent puisse répondre à l’appel. La disponibilité des agents pour répondre aux appels dépend également du workflow : les workflows permettent de définir les heures ouvrées (jours de la semaine et heures du jour pendant lesquels les agents sont disponibles pour répondre aux appels) et les congés (jours pendant lesquels aucun agent n’est disponible pour répondre aux appels).
Pour créer des workflows, utilisez la cmdlet New-CsRgsWorkflow.
Personnes autorisées à exécuter cette cmdlet : Par défaut, les membres des groupes qui suivent sont autorisés à exécuter localement la cmdlet New-CsRgsWorkflow : RTCUniversalServerAdmins. Pour retourner une liste de tous les rôles RBAC (Contrôle d’accès basé sur un rôle) auxquels cette cmdlet a été affectée (y compris les rôles RBAC personnalisés créés par vos soins), exécutez la commande suivante à l’invite Windows PowerShell :
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "New-CsRgsWorkflow"}
Paramètres
| Paramètre | Obligatoire | Type | Description |
|---|---|---|---|
Name |
Obligatoire |
Chaîne |
Nom unique à affecter au workflow. La combinaison de la propriété Parent et de la propriété Name vous permet d’identifier de manière unique les workflows sans que vous ayez à vous référer à leur identificateur global unique (GUID). |
Parent |
Obligatoire |
RgsIdentity |
Service qui hébergera le nouveau workflow. Par exemple : -Parent "service:ApplicationServer:atl-cs-001.litwareinc.com". |
PrimaryUri |
Obligatoire |
Adresse SIP |
Adresse SIP du workflow. Par exemple : -PrimaryUri "sip:helpdesk@litwareinc.com". Le paramètre PrimaryUri doit commencer par le préfixe "sip:". |
Active |
Facultatif |
Booléen |
Si vous définissez la valeur True, le workflow est actif et peut prendre des appels. Si vous définissez la valeur False (valeur par défaut), le workflow n’est pas disponible pour prendre des appels. Lorsque la propriété Active a la valeur True, le workflow est validé avant d’être créé. Par exemple, le workflow ne sera pas créé si aucune propriété DefaultAction n’a été spécifiée. Si la propriété Active est définie sur False (ou n’est pas configurée), alors aucune validation n’aura lieu et le workflow sera créé même si aucune propriété DefaultAction n’a été précisée. |
Anonymous |
Facultatif |
Booléen |
Si vous définissez la valeur True, les identités des agents Response Group individuels sont masquées chaque fois que les agents répondent à un appel. Si vous définissez la valeur False (valeur par défaut), les identités des agents seront communiquées aux appelants. |
BusinessHoursID |
Facultatif |
Objet BusinessHours |
Jours de la semaine et heures du jour pendant lesquels les agents du workflow sont disponibles pour répondre aux appels. Les identités des heures ouvrées peuvent être extraites à l’aide de la cmdlet Get-CsRgsHoursOfBusiness. |
CustomMusicOnHoldFile |
Facultatif |
Objet AudioFile |
Correspond à la musique personnalisée à diffuser lorsque les appelants sont mis en attente. (Si vous ne définissez pas ce paramètre, les appelants entendent la musique par défaut). Vous devez importer la musique personnalisée à l’aide de la cmdlet Import-CsRgsAudioFile. |
DefaultAction |
Obligatoire |
Objet CallAction |
Indique l’action à entreprendre lorsqu’un workflow est ouvert pendant des heures ouvrées. La propriété DefaultAction doit être définie au moyen de la cmdlet New-CsRgsCallAction et doit diriger l’appel soit vers une file d’attente, soit vers une question. Le paramètre DefaultAction est obligatoire si le workflow est actif mais il peut être omis s’il est inactif. |
Description |
Facultatif |
Chaîne |
Permet aux administrateurs d’ajouter des informations sur un workflow Response Group. La description, par exemple, peut contenir des informations de contact pour le propriétaire du workflow. La description apparaît dans la carte de visite Microsoft Lync 2010 du workflow. |
DisplayNumber |
Facultatif |
Chaîne |
Numéro de téléphone du workflow tel qu’il apparaît dans Lync 2010. Le numéro affiché (DisplayNumber) peut avoir le format de votre choix, par exemple : -DisplayNumber "555-1219" -DisplayNumber "1-(425)-555-1219" -DisplayNumber "1.425.555.1219" |
EnabledForFederation |
Facultatif |
Booléen |
Indique si le workflow est accessible aux utilisateurs depuis un domaine fédéré Si vous définissez la valeur False, seuls les utilisateurs de votre organisation peuvent accéder au workflow. |
HolidayAction |
Facultatif |
Objet CallAction |
Action à exécuter si un appel est reçu pendant un congé. Vous devez utiliser la cmdlet New-CsRgsCallAction pour définir l’action à exécuter si un appel est reçu pendant un congé (HolidayAction). |
HolidaySetIdList |
Facultatif |
Objet HolidaySet |
Représente les jours pendant lesquels les agents du workflow ne sont pas disponibles pour répondre aux appels. Les identités des groupes de congés peuvent être extraites à l’aide de la cmdlet Get-CsRgsHolidaySet. |
Language |
Facultatif |
Chaîne |
Langue utilisée pour lire les messages vocaux du workflow. Le paramètre Language est facultatif tant que le système d’exploitation utilise l’une des langues prises en charge figurant dans la liste ci-dessous. (Notez que les langues parlées prises en charge représentent un sous-ensemble des langues exploitables dans le système d’exploitation.) Si le système d’exploitation n’utilise pas une langue prise en charge, le paramètre Language est alors obligatoire et doit préciser le code d’une langue prise en charge. Si votre système d’exploitation utilise une langue qu’il ne prend pas en charge et si vous exécutez la cmdlet New-CsRgsWorkflow sans inclure le paramètre Language, la commande échouera. Par exemple, imaginons que votre système d’exploitation Windows fonctionne en langue féroïenne. Il prend en charge cette langue mais ce n’est pas le cas de l’application Response Group. Vous devez donc inclure le paramètre Language et une langue prise en charge au moment de créer un nouveau workflow. Ceci est obligatoire car, si aucune langue n’est définie, le workflow utilise celle du système d’exploitation. En revanche, cette langue pourra être utilisée dans un workflow seulement si elle est prise en charge par l’application Response Group. Vous devez définir la langue en utilisant l’un des codes de langue suivants : ca-Es – Catalan (Espagne) da-DK – Danois (Danemark) de-DE – Allemand (Allemagne) en-AU – Anglais (Australie) en-CA – Anglais (Canada) en-GB – Anglais (Royaume-Uni) en-IN – Anglais (Inde) en-US – Anglais (États-Unis) es-ES – Espagnol (Espagne) es-MX – Espagnol (Mexique) fi-FI – Finnois (Finlande) fr-CA – Français (Canada) fr-FR – Français (France) it-IT – Italien (Italie) ja-JP – Japonais (Japon) ko-KR – Coréen (Corée) nb-NO – Norvégien, Bokmal (Norvège) nl-NL – Néerlandais (Pays-Bas) pl-PL – Polonais (Pologne) pt-BR – Portugais (Brésil) pt-PT – Portugais (Portugal) ru-RU – Russe (Russie) sv-SE – Suédois (Suède) zh-CN – Chinois (République populaire de Chine) zh-HK – Chinois (Hong Kong R.A.S.) zh-TW – Chinois (Taïwan) Par exemple : -Language "nl-NL". |
LineUri |
Facultatif |
Chaîne |
Numéro de téléphone du workflow. L’URI (Uniform Resource Identifier) de ligne doit être défini d’après le format suivant : préfixe TEL: suivi du signe plus, de l’indicatif du pays, de l’indicatif régional et du numéro de téléphone (vous devez utiliser des chiffres uniquement. Les espaces, les points, les tirets, etc. ne sont pas autorisés). Par exemple : -LineUri "TEL:+14255551219" |
NonBusinessHoursAction |
Facultatif |
Objet CallAction |
Action à entreprendre si un appel est reçu en dehors des heures ouvrées du workflow. Vous devez utiliser la cmdlet New-CsRgsCallAction pour définir l’action à exécuter si un appel est reçu en dehors des heures ouvrées (NonBusinessHoursAction). |
TimeZone |
Facultatif |
Chaîne |
Informations de fuseau horaire utilisées pour définir les congés et les heures ouvrées. Par exemple : -TimeZone "Pacific Standard Time" |
Force |
Facultatif |
Paramètre de commutateur |
Supprime l’affichage de tous les messages d’erreur récupérable susceptibles d’apparaître lors de l’exécution de la commande. |
InMemory |
Facultatif |
Paramètre de commutateur |
Crée une référence d’objet sans valider l’objet comme une modification définitive. Si vous affectez à une variable la sortie de cette cmdlet appelée avec ce paramètre, vous pouvez apporter des modifications aux propriétés de la référence d’objet, puis les valider en appelant la cmdlet Set- correspondante. |
Types d’entrées
Aucun. New-CsRgsWorkflow n’accepte pas la saisie de données transmises via le pipeline.
Types de retours
New-CsRgsWorkflow crée des instances de l’objet Microsoft.Rtc.Rgs.Management.WritableSettings.Workflow.
Exemple
-------------------------- Exemple 1 ------------------------
New-CsRgsWorkflow -Parent service:ApplicationServer:atl-cs-001.litwareinc.com -Name "Help Desk" -PrimaryUri "sip:helpdesk@litwareinc.com"
La commande précédente crée un workflow dans le service ApplicationServer:atl-cs-001.litwareinc.com. Ce workflow est affecté du nom Help Desk et de l’URI principal sip:helpdesk@litwareinc.com.
-------------------------- Exemple 2 ------------------------
$prompt = New-CsRgsPrompt -TextToSpeechPrompt "Welcome to the help desk."
$queue = (Get-CsRgsQueue -Identity service:ApplicationServer:atl-cs-001.litwareinc.com -Name "Help Desk").Identity
$callAction = New-CsRgsCallAction -Prompt $prompt -Action TransferToQueue -QueueId $queue
New-CsRgsWorkflow -Parent service:ApplicationServer:atl-cs-001.litwareinc.com -Name "Help Desk" -PrimaryUri "sip:helpdesk@litwareinc.com" -DefaultAction $callAction
La commande de l’exemple 2 crée un message de workflow et une action d’appel, puis affecte ces nouveaux éléments à un nouveau workflow Response Group. Dans la première commande, la cmdlet New-CsRgsPrompt permet de créer le message vocal « Welcome to the help desk ». Le nouveau message est stocké dans la variable $prompt.
La deuxième commande utilise la cmdlet Get-CsRgsQueue pour extraire l’identité de la file d’attente Response Group existante « Help Desk Queue », l’identité retournée étant stockée dans la variable $queue.
La troisième commande crée une action d’appel (stockée dans la variable $callAction) qui fait référence au nouveau message ($prompt) et à la file d’attente extraite ($queue). Enfin, la dernière commande de l’exemple crée un nouveau workflow appelé Help Desk. Cette commande définit le paramètre PrimaryUri sur sip:helpdesk@litwareinc.com et la valeur de la propriété DefaultAction sur l’action d’appel créée lors de l’étape précédente.