New-CsRgsWorkflow
Ultima modifica dell'argomento: 2012-03-23
Crea un nuovo flusso di lavoro di Response Group. I flussi di lavoro determinano le azioni da eseguire quando l'applicazione Response Group riceve una chiamata telefonica.
Sintassi
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>]]
Descrizione dettagliata
I flussi di lavoro sono un elemento chiave dell'applicazione Response Group. Ciascun flusso di lavoro è associato in modo univoco a un numero di telefono. Quando una persona chiama questo numero, il flusso di lavoro determina il modo in cui la chiamata verrà gestita. La chiamata può ad esempio essere instradata a una serie di domande del sistema IVR (Interactive Voice Response), mediante cui si avvisa il chiamante che è necessario immettere ulteriori informazioni ("Premere 1 per supporto hardware. Premere 2 per supporto software.") In alternativa, la chiamata può essere messa in una coda e il chiamante può essere lasciato in attesa finché un agente non è disponibile per rispondere alla chiamata. La disponibilità di agenti che rispondano alle chiamate è determinata anche dal flusso di lavoro: i flussi di lavoro sono utilizzati per configurare sia l'orario di ufficio (i giorni della settimana e le ore del giorno in cui gli agenti sono disponibili per rispondere alle chiamate) sia le festività (giorni in cui non ci sono agenti disponibili per rispondere alle chiamate).
È possibile creare nuovi flussi di lavoro utilizzando il cmdlet New-CsRgsWorkflow.
Utenti autorizzati a eseguire il cmdlet: per impostazione predefinita, sono autorizzati a eseguire localmente il cmdlet New-CsRgsWorkflow i membri dei seguenti gruppi: RTCUniversalServerAdmins. Per restituire un elenco di tutti i ruoli RBAC (Role-Based Access Control) a cui è stato assegnato questo cmdlet, inclusi gli eventuali ruoli RBAC personalizzati creati dall'utente, dal prompt di Windows PowerShell eseguire il seguente comando:
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "New-CsRgsWorkflow"}
Parametri
| Parametro | Obbligatorio | Tipo | Descrizione |
|---|---|---|---|
Name |
Obbligatorio |
Stringa |
Nome univoco da assegnare al flusso di lavoro. La combinazione della proprietà Parent e della proprietà Name consente di identificare in modo univoco i flussi di lavoro senza dover fare riferimento al relativo identificatore univoco globale (GUID). |
Parent |
Obbligatorio |
Identità Rgs |
Servizio in cui sarà ospitato il nuovo flusso di lavoro. Ad esempio: -Parent "service:ApplicationServer:atl-cs-001.litwareinc.com". |
PrimaryUri |
Obbligatorio |
Indirizzo SIP |
Indirizzo SIP per il flusso di lavoro. Ad esempio: -PrimaryUri "sip:helpdesk@litwareinc.com". PrimaryUri deve iniziare con il prefisso "sip:". |
Active |
Facoltativo |
Booleano |
Se impostato su TRUE, il flusso di lavoro è attivo e disponibile a ricevere chiamate telefoniche. Se la proprietà è impostata su False (valore predefinito), il flusso di lavoro non sarà disponibile per ricevere chiamate telefoniche. Se la proprietà Active è impostata su True, il flusso di lavoro verrà convalidato prima di essere creato. Ad esempio, non verrà creato se non è stato specificato un parametro DefaultAction. Se la proprietà Active è impostata su False o non configurata, non verrà eseguita alcuna convalida e il flusso di lavoro verrà creato anche se non è stato specificato un parametro DefaultAction. |
Anonymous |
Facoltativo |
Booleano |
Se impostate su True, le identità dei singoli agenti di Response Group saranno mascherate ogni volta che questi agenti rispondono a una chiamata. Se questo parametro è impostato su False (valore predefinito), le identità degli agenti saranno disponibili per i chiamanti. |
BusinessHoursID |
Facoltativo |
Oggetto BusinessHours |
Giorni della settimana e ore del giorno in cui gli agenti del flusso di lavoro sono disponibili per rispondere alle chiamate. Le identità degli orari d'ufficio possono essere recuperate utilizzando il cmdlet Get-CsRgsHoursOfBusiness. |
CustomMusicOnHoldFile |
Facoltativo |
Oggetto AudioFile |
Rappresenta la musica personalizzata da riprodurre quando i chiamanti restano in attesa. Se non definita, durante l'attesa i chiamanti sentiranno la musica predefinita. La musica personalizzata deve essere importata utilizzando il cmdlet Import-CsRgsAudioFile. |
DefaultAction |
Obbligatorio |
Oggetto CallAction |
Indica l'azione da eseguire quando un flusso di lavoro viene aperto durante l'orario d'ufficio. Il parametro DefaultAction deve essere definito utilizzando il cmdlet New-CsRgsCallAction e deve instradare la chiamata a una coda oppure a una domanda. Il parametro DefaultAction è obbligatorio se il flusso di lavoro è attivo, ma può essere omesso se il flusso di lavoro non è attivo. |
Description |
Facoltativo |
Stringa |
Consente agli amministratori di aggiungere informazioni supplementari sul flusso di lavoro di Response Group. Ad esempio, la Descrizione può includere informazioni sui contatti per il proprietario del flusso di lavoro. Questa descrizione viene visualizzata nella scheda contatto di Microsoft Lync 2010 per il flusso di lavoro. |
DisplayNumber |
Facoltativo |
Stringa |
Numero di telefono per il flusso di lavoro così com'è visualizzato in Lync 2010. Il valore DisplayNumber può essere formattato come desiderato, ad esempio: -DisplayNumber "555-1219" -DisplayNumber "1-(425)-555-1219" -DisplayNumber "1.425.555.1219" |
EnabledForFederation |
Facoltativo |
Booleano |
Indica se il flusso di lavoro è disponibile per utenti di un dominio federato. Se impostato su FALSE, solo gli utenti interni all'organizzazione potranno accedere al flusso di lavoro. |
HolidayAction |
Facoltativo |
Oggetto CallAction |
Azione da eseguire quando la chiamata viene ricevuta durante le festività. Il parametro HolidayAction deve essere definito utilizzando il cmdlet New-CsRgsCallAction. |
HolidaySetIdList |
Facoltativo |
Oggetto HolidaySet |
Rappresenta i giorni in cui gli agenti del flusso di lavoro non sono disponibili per rispondere alle chiamate. Le identità degli insiemi di festività possono essere recuperate utilizzando il cmdlet Get-CsRgsHolidaySet. |
Language |
Facoltativo |
Stringa |
Lingua utilizzata per leggere i prompt di sintesi vocale del flusso di lavoro. Il parametro Language è facoltativo, purché nel sistema operativo venga utilizzata una delle lingue supportate elencate di seguito. Si noti infatti che le lingue per messaggi vocali supportate rappresentano un sottoinsieme delle lingue utilizzabili nel sistema operativo. Se nel sistema operativo non viene utilizzata una lingua supportata, sarà obbligatorio includere il parametro Language, che dovrà specificare il codice di una lingua supportata. Se nel sistema operativo viene utilizzata una lingua non supportata e si esegue New-CsRgsWorkflow senza includere il parametro Language, il comando avrà esito negativo. Si supponga ad esempio che nel sistema operativo sia in uso il faroese. Tale lingua è supportata dal sistema operativo Windows, ma non dall'applicazione Response Group. Al momento di creare un nuovo flusso di lavoro, sarà pertanto necessario includere il parametro Language e una lingua supportata. Tale operazione è necessaria perché, se non viene specificata alcuna lingua, per il flusso di lavoro verrà utilizzata quella del sistema operativo. Tale lingua potrà tuttavia essere utilizzata in un flusso di lavoro solo se è supportata dall'applicazione Response Group. Il linguaggio deve essere specificato utilizzando uno dei seguenti codici della lingua: ca-Es – Catalano (Spagna) da-DK – Danese (Danimarca) de-DE – Tedesco (Germania) en-AU – Inglese (Australia) en-CA – Inglese (Canada) en-GB – Inglese (Regno Unito) en-IN – Inglese (India) en-US – Inglese (Stati Uniti) es-ES – Spagnolo (Spagna) es-MX – Spagnolo (Messico) fi-FI – Finlandese (Finlandia) fr-CA – Francese (Canada) fr-FR – Francese (Francia) it-IT – Italiano (Italia) ja-JP – Giapponese (Giappone) ko-KR – Coreano (Corea) nb-NO – Norvegese, Bokmal (Norvegia) nl-NL – Olandese (Paesi Bassi) pl-PL – Polacco (Polonia) pt-BR – Portoghese (Brasile) pt-PT – Portoghese (Portogallo) ru-RU – Russo (Russia) sv-SE – Svedese (Svezia) zh-CN – Cinese (Repubblica popolare cinese) zh-HK – Cinese (Hong Kong - R.A.S.) zh-TW – Cinese (Taiwan) Ad esempio: -Lingua "nl-NL". |
LineUri |
Facoltativo |
Stringa |
Numero di telefono per il flusso di lavoro. L'URI (Uniform Resource Identifier) della linea deve essere specificato utilizzando il seguente formato: il prefisso TEL: seguito da un segno più, seguito dall'indicativo di chiamata del paese o dell'area geografica, dall'indicativo di località e dal numero di telefono (utilizzando solo cifre, senza spazi, punti o trattini). Ad esempio: -LineUri "TEL:+14255551219" |
NonBusinessHoursAction |
Facoltativo |
Oggetto CallAction |
Azione da eseguire quando una chiamata viene ricevuta fuori dall'orario di ufficio del flusso di lavoro. Il parametro NonBusinessHoursAction deve essere definito utilizzando il cmdlet New-CsRgsCallAction. |
TimeZone |
Facoltativo |
Stringa |
Le informazioni sul fuso orario utilizzate quando si definiscono l'orario di ufficio e le festività. Ad esempio: -TimeZone "Ora solare pacifico" |
Force |
Facoltativo |
Parametro opzionale |
Consente di non visualizzare i messaggi relativi agli errori non irreversibili che possono verificarsi durante l'esecuzione del comando. |
InMemory |
Facoltativo |
Parametro opzionale |
Crea un riferimento a un oggetto senza eseguire realmente il commit dell'oggetto come modifica permanente. Se si assegna l'output del cmdlet chiamato con questo parametro a una variabile, è possibile apportare modifiche alle proprietà del riferimento all'oggetto e quindi eseguire il commit di queste modifiche chiamando il cmdlet Set- corrispondente. |
Tipi di input
Nessuno. New-CsRgsWorkflow non accetta l'input da pipeline.
Tipi restituiti
New-CsRgsWorkflow crea nuove istanze dell'oggetto Microsoft.Rtc.Rgs.Management.WritableSettings.Workflow.
Esempio
-------------------------- Esempio 1 ------------------------
New-CsRgsWorkflow -Parent service:ApplicationServer:atl-cs-001.litwareinc.com -Name "Help Desk" -PrimaryUri "sip:helpdesk@litwareinc.com"
Il comando precedente crea un nuovo flusso di lavoro nel servizio ApplicationServer:atl-cs-001.litwareinc.com. A questo flusso di lavoro vengono assegnati il nome Help Desk e l'URI primario sip:helpdesk@litwareinc.com.
-------------------------- Esempio 2 ------------------------Add code example
$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
Il comando mostrato nell'esempio 2 crea un nuovo prompt di flusso di lavoro e una nuova azione di chiamata, quindi assegna tali elementi a un nuovo flusso di lavoro di Response Group. Nel primo comando viene utilizzato il cmdlet New-CsRgsPrompt per creare un prompt di sintesi vocale "Welcome to the help desk". Il nuovo prompt viene archiviato in una variabile denominata $prompt.
Nel secondo comando viene utilizzato il cmdlet Get-CsRgsQueue per recuperare l'identità di una coda esistente di Response Group denominata Help Desk. L'identità restituita viene archiviata in una variabile denominata $queue.
Il comando 3 crea quindi una nuova azione di chiamata (archiviata in una variabile denominata $callAction) che fa riferimento sia al nuovo prompt ($prompt), sia alla coda recuperata ($queue). L'ultimo comando dell'esempio infine crea un nuovo flusso di lavoro denominato Help Desk. Tale comando imposta il parametro PrimaryUri su sip:helpdesk@litwareinc.com e il valore della proprietà DefaultAction sull'azione di chiamata creata nel passaggio precedente.