AnyDevice and softphone fallback scenarios

Hint

You will find sample scripts for mass changes to users in the following chapters:

• Change in locations/configuration groups

• Changes with export and import

The Fallbeck scenarios are intended to take effect when an AnyDevice or Softphone user is busy, their device is not available or is not answered after a certain time.

These settings can be configured individually in each client. Via the Powershell, it is now possible to make these settings centrally.

The Powershell commands are Get-XpLineForwardData to read and Set-XpLineForwardData to set the data.

The parameters available are ForwardMode and UserNames.

The parameter -ForwardMode is mandatory. It supports the following values:

• NoAnswer

  • For setting: Call is not answered.

• Busy

  • For setting: Busy - If you are using another device.

• Busy2

  • For setting: Busy - If you use softphone Desktop.

• Busy3

  • For setting: Busy - If you use Softphone Mobile.

• Unavailable

  • For setting: not ready for use - If you are using Softphone Desktop.

• Unavailable2

  • For setting: not operational - If you use Softphone Mobile.

The corresponding settings can be found in the XPhone Client under Configuration - Device management - Advanced

NoAnswer

This is a fallback if the call is not answered. The following properties are available:

• NoAnswerDelaySeconds

  Delay in seconds from when the fallback takes effect if the call is not answered. Transfer as Integer , supported values are -1 (default), 20, 25, 30, 45, 60

• NoAnswerTargetInternal

  Action target for internal calls Transfer as string, supported values are off and forward (call number)

• NoAnswerTargetInternalCallNumber

  Phone number to be forwarded to if the fallback takes effect. Transfer as String, must be set if NoAnswerTargetInternal has the value forward.

• NoAnswerTargetExternal

  Action target for external calls handover as string, supported values are off (off) and forward (call number)

• NoAnswerTargetExternalCallNumber

  Phone number to be forwarded to if the fallback takes effect. Transfer as String, must be set if NoAnswerTargetExternal has the value forward.

Example

For the user Testuser01, the fallback is to be set so that internal calls are forwarded to the number +4989840798333. Nothing should happen for external calls. The delay until the fallback takes effect should be 30 seconds:

Get-XpLineForwardData -ForwardMode "NoAnswer" -UserNames "Testuser01" | foreach{$_.NoAnswerDelaySeconds = 30; $_.NoAnswerTargetInternal = "forward"; $_.NoAnswerTargetInternalCallNumber = "+4989840798333"; $_.NoAnswerTargetExternal = "off";$_} | Set-XpLineForwardData

Hint

This example only works if you specify the users explicitly. If you want to perform a mass change on the basis of locations/configuration groups, please follow the example in the Practical use cases.

Result

Busy

This fallback is used when AnyDevice is used and busy. The following properties are available:

• BusyTargetInternal

  Action target for internal calls handover as string, supported values are reject and forward (call number)

• BusyTargetInternalCallNumber

  Phone number to be forwarded to if the fallback takes effect. Transfer as String, must be set if BusyTargetInternal has the value forward.

• BusyTargetExternal

  Action target for external calls Transfer as string, supported values are reject and forward (call number)

• BusyTargetExternalCallNumber

  Phone number to be forwarded to if the fallback takes effect. Transfer as String, must be set if BusyTargetExternal has the value forward.

Example:

For the user Testuser01, the fallback is to be set so that internal calls are forwarded to the number +4989840798333. External callers are to be rejected:

Get-XpLineForwardData -ForwardMode "Busy" -UserNames "Testuser01" | foreach{$_.BusyTargetInternal = "Forward"; $_.BusyTargetInternalCallNumber = "+4989840798333"; $_.BusyTargetExternal ="reject"; $_} | Set-XpLineForwardData

Hint

This example only works if you specify the users explicitly. If you want to perform a mass change on the basis of locations/configuration groups, please follow the example in the Practical use cases.

Result

Busy2

This fallback is used when Softphone Desktop is used and is busy. The following properties are available:

• Busy2TargetInternal

  Action target for internal calls Transfer as string, supported values are reject (reject), camp on (call waiting) and forward (call number)

• Busy2TargetInternalCallNumber

  Phone number to be forwarded to if the fallback takes effect. Transfer as String, must be set if Busy2TargetInternal has the value forward.

• Busy2TargetExternal

  Action target for external calls Transfer as string, supported values are reject, camp on (call waiting) and forward (call number).

• Busy2TargetExternalCallNumber

  Phone number to be forwarded to if the fallback takes effect. Transfer as String, must be set if Busy2TargetExternal has the value forward.

Example

For the user Testuser01 the fallback is to be set so that Call waiting is set for internal calls. For external calls, the number +4989840798333 is to be forwarded:

Get-XpLineForwardData -ForwardMode "Busy2" -UserNames "Testuser01" | foreach{$_.Busy2TargetInternal = "camp on"; $_.Busy2TargetExternal ="forward"; $_.Busy2TargetExternalCallNumber ="+4989840798333"; $_} | Set-XpLineForwardData

Hint

This example only works if you specify the users explicitly. If you want to perform a mass change on the basis of locations/configuration groups, please follow the example in the Practical use cases.

Result

Busy3

This fallback is used when Softphone Mobile is used and is busy. The following properties are available:

• Busy3TargetInternal

  Action target for internal calls handover as string, supported values are reject and forward (call number)

Busy3TargetInternalCallNumber

Phone number to be forwarded to if the fallback takes effect. Transfer as String, must be set if Busy3TargetInternal has the value forward.

• Busy3TargetExternal

  Action target for external calls Transfer as string, supported values are reject and forward (call number)

• Busy3TargetExternalCallNumber

  Phone number to be forwarded to if the fallback takes effect. Transfer as String, must be set if Busy3TargetExternal has the value forward.

Example

For the user Testuser01, the fallback is to be set so that internal calls are forwarded to the number +4989840798333. For external callers, the number +4989840798555 is to be forwarded:

Get-XpLineForwardData -ForwardMode "Busy3" -UserNames "Testuser01" | foreach{$_.Busy3TargetInternal = "forward"; $_.Busy3TargetInternalCallNumber = "+4989840798333"; $_.Busy3TargetExternal ="Forward"; $_.Busy3TargetExternalCallNumber ="+4989840798555"; $_} | Set-XpLineForwardData

Hint

This example only works if you specify the users explicitly. If you want to perform a mass change on the basis of locations/configuration groups, please follow the example in the Practical use cases.

Result

Unavailable

Fallback when the state is not operational and Softphone Desktop is used. The following properties are available:

• UnavailableTargetInternal

  Action target for internal calls handover as string, supported values are reject and forward (call number)

• UnavailableTargetInternalCallNumber

  Phone number to be forwarded to if the fallback takes effect. Transfer as String, must be set if UnavailableTargetInternal has the value “forward”.

• UnavailableTargetExternal

  Action target for external calls Transfer as string, supported values are reject and forward (call number)

• UnavailableTargetExternalCallNumber

  Phone number to be forwarded to if the fallback takes effect. Transfer as String, must be set if UnavailableTargetExternal has the value forward.

Example

For the user Testuser01 the fallback is to be set so that internal calls are rejected. For external callers, forward to the number +4989840798555:

Get-XpLineForwardData -ForwardMode "Unavailable" -UserNames "Testuser01" | foreach{$_.UnavailableTargetInternal = "reject"; $_.UnavailableTargetExternal ="forward"; $_.UnavailableTargetExternalCallNumber ="+4989840798555"; $_} | Set-XpLineForwardData

Hint

This example only works if you specify the users explicitly. If you want to perform a mass change on the basis of locations/configuration groups, please follow the example in the Practical use cases.

Result

Unavailable2

Fallback when the state is not operational and Softphone Mobile is used. The following properties are available:

• Unavailable2TargetInternal

  Action target for internal calls handover as string, supported values are reject and forward (call number)

• Unavailable2TargetInternalCallNumber

  Phone number to be forwarded to if the fallback takes effect. Transfer as String, must be set if Unavailable2TargetInternal has the value forward.

• Unavailable2TargetExternal

  Action target for external calls Transfer as string, supported values are reject and forward (call number)

• Unavailable2TargetExternalCallNumber

  Phone number to be forwarded to if the fallback takes effect. Transfer as String, must be set if Unavailable2TargetExternal has the value forward.

Example

For the user Testuser01 the fallback is to be set so that internal calls are rejected. For external callers, forward to the number +4989840798555:

Get-XpLineForwardData -ForwardMode "Unavailable2" -UserNames "Testuser01" | foreach{$_.Unavailable2TargetInternal = "reject"; $_.Unavailable2TargetExternal ="forward"; $_.Unavailable2TargetExternalCallNumber ="+4989840798555"; $_} |
Set-XpLineForwardData

Hint

This example only works if you specify the users explicitly. If you want to perform a mass change on the basis of locations/configuration groups, please follow the example in the Practical use cases.

Result

Mass change

For all users in the Main location and in the Development configuration group, the settings for Call is not answered are to be set.

Look at the settings of the relevant users:

Get-XpConfigGroups "Hauptstandort" -ConfigGroupNames "Entwicklung" | Get-XpLineForwardData -ForwardMode "noanswer"

Set the settings as follows:

Get-XpConfigGroups "Hauptstandort" -ConfigGroupNames "Entwicklung" | Get-XpLineForwardData -ForwardMode "noanswer" | foreach{$_.NoAnswerDelaySeconds = 30; $_.NoAnswerTargetInternal = "forward"; $_.NoAnswerTargetInternalCallNumber = "+4989840798-333"; $_.NoAnswerTargetExternal = "off";$_} | Set-XpLineForwardData

Retrieving the information again will then show the changed settings:

Have you found a mistake on this page?

Or is something not formulated well or too vague? Then we look forward to receiving an e-mail, preferably with a suggestion for improvement, to doku@c4b.de. Thank you very much!