New-CsRgsQuestion
Tópico modificado em: 2012-03-23
Cria uma nova pergunta do Grupo de Resposta. O Aplicativo Grupo de Resposta usa perguntas para fornecer opções aos chamadores e, em seguida, executa ações com base nessas escolhas.
Sintaxe
New-CsRgsQuestion -Prompt <Prompt> [-AnswerList <PSListModifier>] [-InvalidAnswerPrompt <Prompt>] [-Name <String>] [-NoAnswerPrompt <Prompt>]
Descrição Detalhada
Para processar chamadas, o Aplicativo Grupo de Resposta geralmente faz uma declaração ou apresenta uma pergunta e, em seguida, executa a ação com base na resposta do chamador. Por exemplo, o serviço pode pedir para um chamador pressionar 1, para inglês, ou 2, para espanhol. Depois da apresentação de uma pergunta como essa, o sistema deve esperar que o chamador responda e, então, executará a ação apropriada. Nesse caso, isso significa transferir a chamada para uma fila de espera no idioma inglês, se o chamador pressionar 1 no teclado do telefone, ou transferir a chamada para uma fila de espera no idioma espanhol, se o chamador pressionar 2 no teclado.
Para criar uma pergunta, deve se utilizar o cmdlet New-CsRgsQuestion. Ao criar uma pergunta do Grupo de Resposta, é necessário, no mínimo, fornecer um prompt (ou seja, a própria pergunta), além de um conjunto de respostas para as quais haja suporte. Por exemplo: se você estiver oferecendo aos chamadores a opção de pressionar 1 ou 2, precisará fornecer duas respostas: uma para especificar a ação a ser tomada se o chamador pressionar 1 e a outra para especificar a ação a ser tomada caso o chamador pressione 2. Se você oferecer aos chamadores a opção de pressionar 1, 2, 3 ou 4, precisará de quatro respostas.
Além disso, o cmdlet New-CsRgsQuestion possibilita especificar uma solicitação, a ser usada caso um chamador forneça uma resposta inválida ou não responda. Por exemplo, se o chamador na situação original pressionar 3, a solicitação poderá ser: "Desculpe, esta não é uma resposta válida." Neste ponto, a solicitação original será repetida.
Quem pode executar este cmdlet: Por padrão, membros dos seguintes grupos estão autorizados a executar o cmdlet New-CsRgsQuestion localmente: RTCUniversalUserAdmins, RTCUniversalServerAdmins e RTCUniversalReadOnlyAdmins. No entanto, como este cmdlet cria um objeto em memória e, por si próprio, não altera o sistema, ele pode ser essencialmente executado por qualquer pessoa. Para retornar uma lista de todas as funções de controle de acesso baseado em função (RBAC) às quais este cmdlet tiver sido atribuído (inclusive qualquer função RBAC personalizada que tiver sido criada por você), execute o seguinte comando no prompt do Windows PowerShell:
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "New-CsRgsQuestion"}
Parâmetros
| Parâmetro | Obrigatório | Digite | Descrição |
|---|---|---|---|
Prompt |
Obrigatório |
Objeto de prompt |
Pergunta a ser feita ao chamador. As solicitações devem ser criadas usando-se o cmdlet New-CsRgsPrompt. |
AnswerList |
Opcional |
Modificador de Lista PS |
Matriz de respostas válidas para a pergunta. Por exemplo, uma pergunta de assistência técnica deve conter respostas tais como Suporte de Hardware, Instalação de Software e Conexões de Rede. As respostas devem ser criadas usando-se o cmdlet New-CsRgsAnswer. |
InvalidAnswerPrompt |
Opcional |
Objeto de prompt |
Resposta a ser emitida no caso de o chamador selecionar uma resposta inválida. InvalidAnswerPrompt deve ser criado usando-se o cmdlet New-CsRgsPrompt. Observe que depois de executar InvalidAnswerPrompt, o aplicativo repetirá a solicitação original. |
Name |
Opcional |
Cadeia de caracteres |
Identificador da pergunta. Os nomes de perguntas, que não precisam ser exclusivos, são limitados a 128 caracteres, no máximo. |
NoAnswerPrompt |
Opcional |
Objeto de prompt |
Resposta a ser emitida no caso de o chamador não responder ao prompt inicial. NoAnswerPrompt deve ser criado usando-se o cmdlet New-CsRgsPrompt. |
Tipos de Entrada
Nenhuma. New-CsRgsQuestion não aceita entradas canalizadas.
Tipos de Retorno
New-CsRgsQuestion cria instâncias do objeto Microsoft.Rtc.Management.WriteableSettings.Question.
Exemplo
-------------------------- Exemplo 1 ------------------------
$new = Get-CsRgsQueue -Identity service:ApplicationServer:pool0.litwareinc.com -Name "New Service Request"
$existing = Get-CsRgsQueue -Identity service:ApplicationServer:pool0.litwareinc.com -Name "Existing Service Request"
$w = New-CsRgsPrompt -TextToSpeechPrompt "Please hold while we transfer your call."
$y = New-CsRgsCallAction -Prompt $w -Action TransferToQueue -QueueID $new.Identity
$z = New-CsRgsCallAction -Prompt $w -Action TransferToQueue -QueueID $existing.Identity
$newRequest = New-CsRgsAnswer -Action $y -DtmfResponse 1 -VoiceResponseList "New" -Name "New Request"
$existingRequest = New-CsRgsAnswer -Action $z -DtmfResponse 2 -VoiceResponseList "Existing" -Name "Existing Request"
$u = New-CsRgsPrompt -TextToSpeechPrompt "Press 1 or say New for a new service request. Press 2 or say Existing for an existing service request."
$question = New-CsRgsQuestion -Prompt $u -AnswerList $newRequest $newRequest, $existingRequest
Os comandos mostrados no Exemplo 1 criam um par de respostas do Grupo de Resposta e, em seguida, associam-nas a uma nova pergunta do Grupo de Resposta. Para criar as duas respostas, especifique inicialmente as ações de chamada que serão executadas, dependendo da resposta fornecida pelo chamador. Consequentemente, os dois primeiros comandos no exemplo criam referências de objeto para um par de filas de espera do Grupo de Resposta: New Service Request e Existing Service Request. Depois que essas referências de objeto tiverem sido criadas, o próximo comando utilizará o cmdlet New-CsRgsPrompt para criar uma solicitação de texto em fala, que é armazenado em uma variável denominada $w.
Quando a operação estiver concluída, os dois próximos comandos criarão um par de ações de chamada correspondentes: uma para transferir os chamadores para a fila de espera New Service Request, a outra para transferir os chamadores para a fila de espera Existing Service Request. Após as ações de chamada terem sido criadas, utiliza-se o cmdlet New-CsRgsAnswer para criar duas respostas do Grupo de Resposta: uma armazenada na variável $newRequest e a outra armazenada na variável $existingRequest.
Com as duas respostas armazenadas, pode se utilizar New-CsRgsPrompt para criar uma solicitação para a nova pergunta. Nesse exemplo, a solicitação compreende texto em fala, que pede para o chamador pressionar 1 (ou dizer "Nova") para uma nova solicitação de serviço ou pressionar 2 (ou dizer "Existente") para uma solicitação de serviço existente. A própria solicitação será armazenada em uma variável denominada $u.
Depois da criação da solicitação, pode se chamar New-CsRgsQuestion para criar a nova pergunta. Além do parâmetro Prompt, utiliza-se o parâmetro AnswerList para indicar as duas respostas associadas à pergunta: as variáveis $newRequest e $existingRequest.