KB-2118 How to upgrade a!twilioField from version 1 to version 2

Parmida Borhani — Tue, 19 May 2020 07:02:44 GMT

Current Revision posted to Appian Knowledge Base by Parmida Borhani on 5/19/2020 7:02:44 AM

Purpose

This article provides instructions on how to upgrade the a!twilioField component plug-in from version 1 to version 2. The upgrade is required when upgrading from Appian 19.2 and earlier to Appian 19.3 and later, but can also be performed on Appian 19.2 in advance of an upgrade to prevent service disruptions.

The upgrade is not necessary for the ICC Baseline application version 5 and later, as these versions natively utilize twilioField version 2.

Instructions

Deploying the New Plug-Ins

In an self-managed Appian installation, perform the following steps:

Uninstall the twilioField-v1_*.zip and twilioServlets-v1_*.jar plug-ins from <APPIAN_HOME>/_admin/plugins by moving them to a different directory or adding a .bak extension to the files.
Install the latest ICC Components following the Downloading ICC Documentation.

For Appian Cloud installations, contact Appian Technical Support to request the above steps to be performed in the Appian Cloud environment.

Upgrading the Twilio Component

After the new plug-ins have been deployed, the a!twilioField component needs to be updated in the SAIL code. Perform the following steps to update the component:

In Appian Designer, create a new Connected System object and select the Twilio Connected System. Provide all required fields. If the original API key secret has been lost, it may be necessary to create a new API key via the Twilio Console.
Create a constant pointing to the Twilio Connected System object created in step 1.
Find all interfaces containing the twilioField. In the standard ICC application, the two interfaces using a!twilioField are named ICC_CP_twilioField and ICC_RT_twilioAioReport. An expression search may also be performed for any references to twilioField to find references. Steps 4-8 should be performed for each interface identified.
Change twilioField_v1 to twilioField.
Change the value of the twilioConnectedSystem parameter to the constant created in step 2.
If used, rename parameter twilioTransferWorkflowSid to twilioWorkflowSid while keeping the same value.
Remove the redundant parameters: twilioTwiMLAppSid, twilioWorkspaceSid, twilioChatConnectedSystem and twilioChatServiceSid.
Save and test the interface(s).

After completing the above steps, the differences in code should look similar to the following example:

Old Code

twilioField_v1(
 twilioConnectedSystem: cons!ICC_CS_TWILIO_SUBACCOUNT,
 twilioTwiMLAppSid: cons!ICC_VAL_TWIL_APPLICATION_SID,
 twilioWorkspaceSid: cons!ICC_VAL_TWIL_WORKSPACE_SID,
 twilioChatConnectedSystem: cons!ICC_CS_REST_API,
 twilioChatServiceSid: cons!ICC_VAL_TWIL_CHAT_SERVICE_SID, 
 twilioTransferWorkflowSid: cons!ICC_VAL_TWIL_WORKFLOW_SID
 /* other unchanged twilioField inputs here */
)

Upgraded Code

twilioField(
 twilioConnectedSystem: cons!ICC_CS_TWILIO,
 twilioWorkflowSid: cons!ICC_VAL_TWIL_WORKFLOW_SID
 /* other unchanged twilioField inputs here */
)

Affected Versions

This article applies to Appian 19.2 and later using the ICC baseline application version 4 and earlier.

Last Reviewed: May 2020

Tags: ICC, administration, SAIL, how-to, application design, twilio, upgrade, Intelligent Contact Center, plugins

KB-2118 How to upgrade a!twilioField from version 1 to version 2

Parmida Borhani — Tue, 19 May 2020 07:02:12 GMT

Revision 10 posted to Appian Knowledge Base by Parmida Borhani on 5/19/2020 7:02:12 AM

Purpose

The upgrade is not necessary for the ICC Baseline application version 5 and later, as these versions natively utilize twilioField version 2.

Instructions

Deploying the New Plug-Ins

In an on-premise Appian installation, perform the following steps:

Uninstall the twilioField-v1_*.zip and twilioServlets-v1_*.jar plug-ins from <APPIAN_HOME>/_admin/plugins by moving them to a different directory or adding a .bak extension to the files.
Install the latest ICC Components following the Downloading ICC Documentation

For Appian Cloud installations, contact Appian Technical Support to request the above steps to be performed in the Appian Cloud environment.

Upgrading the Twilio Component

After the new plug-ins have been deployed, the a!twilioField component needs to be updated in the SAIL code. Perform the following steps to update the component:

In Appian Designer, create a new Connected System object and select the Twilio Connected System. Provide all required fields. If the original API key secret has been lost, it may be necessary to create a new API key via the Twilio Console.
Create a constant pointing to the Twilio Connected System object created in step 1.
Find all interfaces containing the twilioField. In the standard ICC application, the two interfaces using a!twilioField are named ICC_CP_twilioField and ICC_RT_twilioAioReport. An expression search may also be performed for any references to twilioField to find references. Steps 4-8 should be performed for each interface identified.
Change twilioField_v1 to twilioField.
Change the value of the twilioConnectedSystem parameter to the constant created in step 2.
If used, rename parameter twilioTransferWorkflowSid to twilioWorkflowSid while keeping the same value.
Remove the redundant parameters: twilioTwiMLAppSid, twilioWorkspaceSid, twilioChatConnectedSystem and twilioChatServiceSid.
Save and test the interface(s).

After completing the above steps, the differences in code should look similar to the following example:

Old Code

twilioField_v1(
 twilioConnectedSystem: cons!ICC_CS_TWILIO_SUBACCOUNT,
 twilioTwiMLAppSid: cons!ICC_VAL_TWIL_APPLICATION_SID,
 twilioWorkspaceSid: cons!ICC_VAL_TWIL_WORKSPACE_SID,
 twilioChatConnectedSystem: cons!ICC_CS_REST_API,
 twilioChatServiceSid: cons!ICC_VAL_TWIL_CHAT_SERVICE_SID, 
 twilioTransferWorkflowSid: cons!ICC_VAL_TWIL_WORKFLOW_SID
 /* other unchanged twilioField inputs here */
)

Upgraded Code

twilioField(
 twilioConnectedSystem: cons!ICC_CS_TWILIO,
 twilioWorkflowSid: cons!ICC_VAL_TWIL_WORKFLOW_SID
 /* other unchanged twilioField inputs here */
)

Affected Versions

This article applies to Appian 19.2 and later using the ICC baseline application version 4 and earlier.

Last Reviewed: May 2020

Tags: ICC, administration, SAIL, how-to, application design, twilio, upgrade, Intelligent Contact Center, plugins

DRAFT KB-[SP-3575] How to upgrade a!twilioField from version 1 to version 2

Zach Puderbach — Mon, 18 May 2020 13:43:33 GMT

Revision 9 posted to Appian Knowledge Base by Zach Puderbach on 5/18/2020 1:43:33 PM

Purpose

The upgrade is not necessary for the ICC Baseline application version 5 and later, as these versions natively utilize twilioField version 2.

Instructions

Deploying the New Plug-Ins

In an on-premise Appian installation, perform the following steps:

Uninstall the twilioField-v1_*.zip and twilioServlets-v1_*.jar plug-ins from <APPIAN_HOME>/_admin/plugins by moving them to a different directory or adding a .bak extension to the files.
Install the latest ICC Components following the Downloading ICC Documentation

For Appian Cloud installations, contact Appian Technical Support to request the above steps to be performed in the Appian Cloud environment.

Upgrading the Twilio Component

After the new plug-ins have been deployed, the a!twilioField component needs to be updated in the SAIL code. Perform the following steps to update the component:

In Appian Designer, create a new Connected System object and select the Twilio Connected System. Provide all required fields. If the original API key secret has been lost, it may be necessary to create a new API key via the Twilio Console.
Create a constant pointing to the Twilio Connected System object created in step 1.
Find all interfaces containing the twilioField. In the standard ICC application, the two interfaces using a!twilioField are named ICC_CP_twilioField and ICC_RT_twilioAioReport. An expression search may also be performed for any references to twilioField to find references. Steps 4-8 should be performed for each interface identified.
Change twilioField_v1 to twilioField.
Change the value of the twilioConnectedSystem parameter to the constant created in step 2.
If used, rename parameter twilioTransferWorkflowSid to twilioWorkflowSid while keeping the same value.
Remove the redundant parameters: twilioTwiMLAppSid, twilioWorkspaceSid, twilioChatConnectedSystem and twilioChatServiceSid.
Save and test the interface(s).

After completing the above steps, the differences in code should look similar to the following example:

Old Code

twilioField_v1(
 twilioConnectedSystem: cons!ICC_CS_TWILIO_SUBACCOUNT,
 twilioTwiMLAppSid: cons!ICC_VAL_TWIL_APPLICATION_SID,
 twilioWorkspaceSid: cons!ICC_VAL_TWIL_WORKSPACE_SID,
 twilioChatConnectedSystem: cons!ICC_CS_REST_API,
 twilioChatServiceSid: cons!ICC_VAL_TWIL_CHAT_SERVICE_SID, 
 twilioTransferWorkflowSid: cons!ICC_VAL_TWIL_WORKFLOW_SID
 /* other unchanged twilioField inputs here */
)

Upgraded Code

twilioField(
 twilioConnectedSystem: cons!ICC_CS_TWILIO,
 twilioWorkflowSid: cons!ICC_VAL_TWIL_WORKFLOW_SID
 /* other unchanged twilioField inputs here */
)

Affected Versions

This article applies to Appian 19.2 and later using the ICC baseline application version 4 and earlier.

Last Reviewed: May 2020

Tags: ICC, administration, SAIL, how-to, application design, twilio, upgrade, Intelligent Contact Center, plugins

DRAFT KB-[SP-3575] How to upgrade a!twilioField from version 1 to version 2

Parmida Borhani — Sun, 17 May 2020 23:03:33 GMT

Revision 8 posted to Appian Knowledge Base by Parmida Borhani on 5/17/2020 11:03:33 PM

Purpose

The upgrade is not necessary for the ICC Baseline application version 5 and later, as these versions natively utilize twilioField version 2.

Instructions

Deploying the New Plug-Ins

In an on-premise Appian installation, perform the following steps:

Uninstall the twilioField-v1_*.zip and twilioServlets-v1_*.jar plug-ins from <APPIAN_HOME>/_admin/plugins by moving them to a different directory or adding a .bak extension to the files.
Install the latest ICC Componets following the Downloading ICC Documentation

For Appian Cloud installations, contact Appian Technical Support to request the above steps to be performed in the Appian Cloud environment.

Upgrading the Twilio Component

After the new plug-ins have been deployed, the a!twilioField component needs to be updated in the SAIL code. Perform the following steps to update the component:

In Appian Designer, create a new Connected System object and select the Twilio Connected System. Provide all required fields. If the original API key secret has been lost, it may be necessary to create a new API key via the Twilio Console.
Create a constant pointing to the Twilio Connected System object created in step 1.
Find all interfaces containing the twilioField. In the standard ICC application, the two interfaces using a!twilioField are named ICC_CP_twilioField and ICC_RT_twilioAioReport. An expression search may also be performed for any references to twilioField to find references. Steps 4-8 should be performed for each interface identified.
Change twilioField_v1 to twilioField.
Change the value of the twilioConnectedSystem parameter to the constant created in step 2.
If used, rename parameter twilioTransferWorkflowSid to twilioWorkflowSid while keeping the same value.
Remove the redundant parameters: twilioTwiMLAppSid, twilioWorkspaceSid, twilioChatConnectedSystem and twilioChatServiceSid.
Save and test the interface(s).

After completing the above steps, the differences in code should look similar to the following example:

Old Code

twilioField_v1(
 twilioConnectedSystem: cons!ICC_CS_TWILIO_SUBACCOUNT,
 twilioTwiMLAppSid: cons!ICC_VAL_TWIL_APPLICATION_SID,
 twilioWorkspaceSid: cons!ICC_VAL_TWIL_WORKSPACE_SID,
 twilioChatConnectedSystem: cons!ICC_CS_REST_API,
 twilioChatServiceSid: cons!ICC_VAL_TWIL_CHAT_SERVICE_SID, 
 twilioTransferWorkflowSid: cons!ICC_VAL_TWIL_WORKFLOW_SID
 /* other unchanged twilioField inputs here */
)

Upgraded Code

twilioField(
 twilioConnectedSystem: cons!ICC_CS_TWILIO,
 twilioWorkflowSid: cons!ICC_VAL_TWIL_WORKFLOW_SID
 /* other unchanged twilioField inputs here */
)

Affected Versions

This article applies to Appian 19.2 and later using the ICC baseline application version 4 and earlier.

Last Reviewed: May 2020

Tags: ICC, administration, SAIL, how-to, application design, twilio, upgrade, Intelligent Contact Center, plugins

DRAFT KB-[SP-3575] How to upgrade a!twilioField from version 1 to version 2

Zach Puderbach — Tue, 18 Feb 2020 14:42:26 GMT

Revision 7 posted to Appian Knowledge Base by Zach Puderbach on 2/18/2020 2:42:26 PM

Purpose

The upgrade is not necessary for the ICC Baseline application version 5 and later, as these versions natively utilize twilioField version 2.

Instructions

Deploying the new Plug-Ins

In an on-premise Appian installation, perform the following steps:

Uninstall the twilioField-v1_*.zip and twilioServlets-v1_*.jar plug-ins from <APPIAN_HOME>/_admin/plugins by moving them to a different directory or adding a .bak extension to the files.
Install the latest ICC Componets following the Downloading ICC Documentation

For Appian Cloud installations, contact Appian Technical Support to request the above steps to be performed in the Appian Cloud environment.

Upgrading the Twilio Component

After the new plug-ins have been deployed, the a!twilioField component needs to be updated in the SAIL code. Perform the following steps to update the component:

In /design, create a new Connected System object and select the Twilio Connected System. Provide all required fields. If the original API key secret has been lost, it may be necessary to create a new API key via the Twilio Console.
Create a constant pointing to the Twilio Connected System object created in step 1.
Find all interfaces containing the twilioField. In the standard ICC application, the two interfaces using a!twilioField are named ICC_CP_twilioField and ICC_RT_twilioAioReport. An expression search may also be performed for any references to twilioField to find references. Steps 4-8 should be performed for each interface identified.
Change twilioField_v1 to twilioField.
Change the value of the twilioConnectedSystem parameter to the constant created in step 2.
If used, rename parameter twilioTransferWorkflowSid to twilioWorkflowSid while keeping the same value.
Remove the redundant parameters twilioTwiMLAppSid, twilioWorkspaceSid, twilioChatConnectedSystem and twilioChatServiceSid.
Save and test the interface(s).

After completing the above steps, the differences in code should look similar to the following example:

Old Code

twilioField_v1(
 twilioConnectedSystem: cons!ICC_CS_TWILIO_SUBACCOUNT,
 twilioTwiMLAppSid: cons!ICC_VAL_TWIL_APPLICATION_SID,
 twilioWorkspaceSid: cons!ICC_VAL_TWIL_WORKSPACE_SID,
 twilioChatConnectedSystem: cons!ICC_CS_REST_API,
 twilioChatServiceSid: cons!ICC_VAL_TWIL_CHAT_SERVICE_SID, 
 twilioTransferWorkflowSid: cons!ICC_VAL_TWIL_WORKFLOW_SID
 /* other unchanged twilioField inputs here */
)

Upgraded Code

twilioField(
 twilioConnectedSystem: cons!ICC_CS_TWILIO,
 twilioWorkflowSid: cons!ICC_VAL_TWIL_WORKFLOW_SID
 /* other unchanged twilioField inputs here */
)

Affected Versions

This article applies to Appian 19.2 and later using the ICC baseline application version 4 and earlier.

Tags: administration, SAIL, how-to, application design, upgrade, Intelligent Contact Center, plugins

KB-XXXX How to upgrade a!twilioField from version 1 to version 2

Zach Puderbach — Tue, 04 Feb 2020 20:02:05 GMT

Revision 6 posted to Appian Knowledge Base by Zach Puderbach on 2/4/2020 8:02:05 PM

Purpose

The upgrade is not necessary for the ICC Baseline application version 5 and later, as these versions natively utilize twilioField version 2.

Instructions

Deploying the new Plug-Ins

In an on-premise Appian installation, perform the following steps:

Uninstall the twilioField-v1_*.zip and twilioServlets-v1_*.jar plug-ins from <APPIAN_HOME>/_admin/plugins by moving them to a different directory or adding a .bak extension to the files.
Install the latest ICC Componets following the Downloading ICC Documentation

For Appian Cloud installations, contact Appian Technical Support to request the above steps to be performed in the Appian Cloud environment.

Upgrading the Twilio Component

After the new plug-ins have been deployed, the a!twilioField component needs to be updated in the SAIL code. Perform the following steps to update the component:

In /design, create a new Connected System object and select the Twilio Connected System. Provide all required fields. If the original API key secret has been lost, it may be necessary to create a new API key via the Twilio Console.
Create a constant pointing to the Twilio Connected System object created in step 1.
Find all interfaces containing the twilioField. In the standard ICC application, the two interfaces using a!twilioField are named ICC_CP_twilioField and ICC_RT_twilioAioReport. An expression search may also be performed for any references to twilioField to find references. Steps 4-8 should be performed for each interface identified.
Change twilioField_v1 to twilioField.
Change the value of the twilioConnectedSystem parameter to the constant created in step 2.
If used, rename parameter twilioTransferWorkflowSid to twilioWorkflowSid while keeping the same value.
Remove the redundant parameters twilioTwiMLAppSid, twilioWorkspaceSid, twilioChatConnectedSystem and twilioChatServiceSid.
Save and test the interface(s).

After completing the above steps, the differences in code should look similar to the following example:

Old Code

twilioField_v1(
 twilioConnectedSystem: cons!ICC_CS_TWILIO_SUBACCOUNT,
 twilioTwiMLAppSid: cons!ICC_VAL_TWIL_APPLICATION_SID,
 twilioWorkspaceSid: cons!ICC_VAL_TWIL_WORKSPACE_SID,
 twilioChatConnectedSystem: cons!ICC_CS_REST_API,
 twilioChatServiceSid: cons!ICC_VAL_TWIL_CHAT_SERVICE_SID, 
 twilioTransferWorkflowSid: cons!ICC_VAL_TWIL_WORKFLOW_SID
 /* other unchanged twilioField inputs here */
)

Upgraded Code

twilioField(
 twilioConnectedSystem: cons!ICC_CS_TWILIO,
 twilioWorkflowSid: cons!ICC_VAL_TWIL_WORKFLOW_SID
 /* other unchanged twilioField inputs here */
)

Affected Versions

This article applies to Appian 19.2 and later using the ICC baseline application version 4 and earlier.

Tags: administration, SAIL, how-to, application design, upgrade, Intelligent Contact Center, plugins

KB-XXXX How to upgrade a!twilioField from version 1 to version 2

Zach Puderbach — Tue, 04 Feb 2020 19:23:04 GMT

Revision 5 posted to Appian Knowledge Base by Zach Puderbach on 2/4/2020 7:23:04 PM

Purpose

This article provides instructions on how to upgrade the a!twilioField component plug-in from version 1 to version 2. The upgrade is required when upgrading from Appian 19.2 or earlier to Appian 19.3 and later, but can also be performed on Appian 19.2 in advance of an upgrade to prevent service disruptions.

The upgrade is not necessary for the ICC Baseline application version 5 and later, as these versions natively utilize twilioField version 2.

Instructions

Deploying the new Plug-Ins

In an on-premise Appian installation, perform the following steps:

Download the latest ICC Components bundle for the relevant Appian version from the Downloads section of Appian Community.
Copy the zip file to the server hosting Appian.
Uninstall the twilioField-v1_*.zip and twilioServlets-v1_*.jar plug-ins from <APPIAN_HOME>/_admin/plugins by moving them to a different directory or adding a .bak extension to the files.
Unzip the ICC Components.zip file into <APPIAN_HOME>/_admin/plugins

For Appian Cloud installations, contact Appian Technical Support to request the above steps to be performed in the Appian Cloud environment.

Upgrading the Twilio Component

After the new plug-ins have been deployed, the a!twilioField component needs to be updated in the SAIL code. Perform the following steps to update the component:

In /design, create a new Connected System object and select the Twilio Connected System. Provide all required fields. If the original API key secret has been lost, it may be necessary to create a new API key via the Twilio Console.
Create a constant pointing to the Twilio Connected System object created in step 1.
Find all interfaces containing the twilioField. In the standard ICC application, the two interfaces using a!twilioField are named ICC_CP_twilioField and ICC_RT_twilioAioReport. An expression search may also be performed for any references to twilioField to find references. Steps 4-8 should be performed for each interface.
Change twilioField_v1 to twilioField
Change the value of the twilioConnectedSystem parameter to the constant created in step 2.
If used, rename twilioTransferWorkflowSid to twilioWorkflowSid while keeping the same value.
Remove the redundant parameters twilioTwiMLAppSid, twilioWorkspaceSid, twilioChatConnectedSystem and twilioChatServiceSid.
Save and test the interface(s).

After completing the above steps, the differences in code should look similar to the following example:

Old Code

twilioField_v1(
 twilioConnectedSystem: cons!ICC_CS_TWILIO_SUBACCOUNT,
 twilioTwiMLAppSid: cons!ICC_VAL_TWIL_APPLICATION_SID,
 twilioWorkspaceSid: cons!ICC_VAL_TWIL_WORKSPACE_SID,
 twilioChatConnectedSystem: cons!ICC_CS_REST_API,
 twilioChatServiceSid: cons!ICC_VAL_TWIL_CHAT_SERVICE_SID, 
 twilioTransferWorkflowSid: cons!ICC_VAL_TWIL_WORKFLOW_SID
 /* other unchanged twilioField inputs here */
)

Upgraded Code

twilioField(
 twilioConnectedSystem: cons!ICC_CS_TWILIO,
 twilioWorkflowSid: cons!ICC_VAL_TWIL_WORKFLOW_SID
 /* other unchanged twilioField inputs here */
)

Affected Versions

This article applies to Appian 19.2 and later using the ICC baseline application version 4 and earlier.

Tags: administration, SAIL, how-to, application design, upgrade, Intelligent Contact Center, plugins

KB-XXXX How to upgrade a!twilioField from version 1 to version 2

Jussi Lundstedt — Mon, 02 Dec 2019 15:43:35 GMT

Revision 4 posted to Appian Knowledge Base by Jussi Lundstedt on 12/2/2019 3:43:35 PM

Purpose

The upgrade is not necessary for the ICC Baseline application version 5 and later, as these versions natively utilize twilioField version 2.

Instructions

Deploying the new Plug-Ins

In an on-premise Appian installation, perform the following steps:

Download the latest ICC Components bundle for the relevant Appian version from the Downloads section of Appian Community.
Copy the zip file to the server hosting Appian.
Uninstall the twilioField-v1_*.zip and twilioServlets-v1_*.jar plug-ins from <APPIAN_HOME>/_admin/plugins by moving them to a different directory or adding a .bak extension to the files.
Unzip the ICC Components.zip file into <APPIAN_HOME>/_admin/plugins

For Appian Cloud installations, contact Appian Technical Support to request the above steps to be performed in the Appian Cloud environment.

Upgrading the Twilio Component

After the new plug-ins have been deployed, the a!twilioField component needs to be updated in the SAIL code. Perform the following steps to update the component:

Create a new Connected System using the Twilio Connected System, including the Account SID, Subaccount SID and other values required. If the original API key secret has been lost, you may need to create a new API key via the Twilio Console.
Create a constant pointing to the new Twilio Connected System object.
Open the interface(s) containing the twilioField and change twilioField_v1 to twilioField. In the standard ICC application, the two interfaces using a!twilioField are named ICC_CP_twilioField and ICC_RT_twilioAioReport. You may also perform an Expression search for any references to twilioField to find references.
Change the value of the twilioConnectedSystem parameter to the constant created in step 2.
If used, rename twilioTransferWorkflowSid to twilioWorkflowSid while keeping the same value.
If desired, remove the redundant parameters twilioTwiMLAppSid, twilioWorkspaceSid, twilioChatConnectedSystem and twilioChatServiceSid.
Save and test the interface(s).

After completing steps 1 through 6, the differences in code should look similar to the following example:

Old Code

twilioField_v1(
 twilioConnectedSystem: cons!ICC_CS_TWILIO_SUBACCOUNT,
 twilioTwiMLAppSid: cons!ICC_VAL_TWIL_APPLICATION_SID,
 twilioWorkspaceSid: cons!ICC_VAL_TWIL_WORKSPACE_SID,
 twilioChatConnectedSystem: cons!ICC_CS_REST_API,
 twilioChatServiceSid: cons!ICC_VAL_TWIL_CHAT_SERVICE_SID, 
 twilioTransferWorkflowSid: cons!ICC_VAL_TWIL_WORKFLOW_SID
 /* other unchanged twilioField inputs here */
)

Upgraded Code

twilioField(
 twilioConnectedSystem: cons!ICC_CS_TWILIO,
 twilioWorkflowSid: cons!ICC_VAL_TWIL_WORKFLOW_SID
 /* other unchanged twilioField inputs here */
)

Affected Versions

This article applies to Appian 19.2 and later using the ICC baseline application version 4 and earlier.

Tags: administration, SAIL, how-to, application design, upgrade, Intelligent Contact Center, plugins

KB-XXXX How to upgrade a!twilioField from version 1 to version 2

Jussi Lundstedt — Mon, 02 Dec 2019 15:41:59 GMT

Revision 3 posted to Appian Knowledge Base by Jussi Lundstedt on 12/2/2019 3:41:59 PM

Purpose

Instructions

Deploying the new Plug-Ins

In an on-premise Appian installation, perform the following steps:

Download the latest ICC Components bundle for the relevant Appian version from the Downloads section of Appian Community.
Copy the zip file to the server hosting Appian.
Uninstall the twilioField-v1_*.zip and twilioServlets-v1_*.jar plug-ins from <APPIAN_HOME>/_admin/plugins by moving them to a different directory or adding a .bak extension to the files.
Unzip the ICC Components.zip file into <APPIAN_HOME>/_admin/plugins

For Appian Cloud installations, contact Appian Technical Support to request the above steps to be performed in the Appian Cloud environment.

Upgrading the Twilio Component

After the new plug-ins have been deployed, the a!twilioField component needs to be updated in the SAIL code. Perform the following steps to update the component:

Create a new Connected System using the Twilio Connected System, including the Account SID, Subaccount SID and other values required. If the original API key secret has been lost, you may need to create a new API key via the Twilio Console.
Create a constant pointing to the new Twilio Connected System object.
Open the interface(s) containing the twilioField and change twilioField_v1 to twilioField. In the standard ICC application, the two interfaces using a!twilioField are named ICC_CP_twilioField and ICC_RT_twilioAioReport. You may also perform an Expression search for any references to twilioField to find references.
Change the value of the twilioConnectedSystem parameter to the constant created in step 2.
If used, rename twilioTransferWorkflowSid to twilioWorkflowSid while keeping the same value.
If desired, remove the redundant parameters twilioTwiMLAppSid, twilioWorkspaceSid, twilioChatConnectedSystem and twilioChatServiceSid.
Save and test the interface(s).

After completing steps 1 through 6, the differences in code should look similar to the following example:

Old Code

twilioField_v1(
 twilioConnectedSystem: cons!ICC_CS_TWILIO_SUBACCOUNT,
 twilioTwiMLAppSid: cons!ICC_VAL_TWIL_APPLICATION_SID,
 twilioWorkspaceSid: cons!ICC_VAL_TWIL_WORKSPACE_SID,
 twilioChatConnectedSystem: cons!ICC_CS_REST_API,
 twilioChatServiceSid: cons!ICC_VAL_TWIL_CHAT_SERVICE_SID, 
 twilioTransferWorkflowSid: cons!ICC_VAL_TWIL_WORKFLOW_SID
 /* other unchanged twilioField inputs here */
)

Upgraded Code

twilioField(
 twilioConnectedSystem: cons!ICC_CS_TWILIO,
 twilioWorkflowSid: cons!ICC_VAL_TWIL_WORKFLOW_SID
 /* other unchanged twilioField inputs here */
)

Affected Versions

This article applies to Appian 19.2 and later using the ICC baseline application version 4 and earlier.

Tags: administration, SAIL, how-to, application design, upgrade, Intelligent Contact Center, plugins

KB-XXXX How to upgrade a!twilioField from version 1 to version 2

Jussi Lundstedt — Mon, 02 Dec 2019 15:30:06 GMT

Revision 2 posted to Appian Knowledge Base by Jussi Lundstedt on 12/2/2019 3:30:06 PM

Purpose

This article provides instructions on how to upgrade the a!twilioField component plug-in from version 1 to version 2. The upgrade is required when upgrading from Appian 19.2 or earlier to Appian 19.3 and later, but can also be performed on Appian 19.2 in advance of an upgrade to prevent service disruptions.

Instructions

Deploying the new Plug-Ins

In an on-premise Appian installation, perform the following steps:

Download the latest ICC Components bundle for your Appian version from the Downloads section of Appian Community.
Copy the zip file to the server hosting Appian.
Uninstall the twilioField-v1_*.zip and twilioServlets-v1_*.jar plug-ins from <APPIAN_HOME>/_admin/plugins by moving them to a different directory or adding a .bak extension to the files.
Unzip the ICC Components.zip file into <APPIAN_HOME>/_admin/plugins

For Appian Cloud installations, contact Appian Technical Support to request the above steps to be performed in the Appian Cloud environment.

Upgrading the Twilio Component

After the new plug-ins have been deployed, the a!twilioField component needs to be updated in the SAIL code. Perform the following steps to update the a!twilioField:

Create a new Connected System using the Twilio Connected System, including the Account SID, Subaccount SID and other values required. If the original API key secret has been lost, you may need to create a new API key via the Twilio Console.
Create a constant pointing to the new Twilio Connected System object.
Open the interface(s) containing the twilioField and change twilioField_v1 to twilioField. In the standard ICC application, the two interfaces using a!twilioField are named ICC_CP_twilioField and ICC_RT_twilioAioReport. You may also perform an Expression search for any references to twilioField to find references.
Change the value of the twilioConnectedSystem parameter to the constant created in step 2.
If used, rename twilioTransferWorkflowSid to twilioWorkflowSid while keeping the same value.
If desired, remove the redundant parameters twilioTwiMLAppSid, twilioWorkspaceSid, twilioChatConnectedSystem and twilioChatServiceSid.
Save and test the interface(s).

After completing steps 1 through 6, the differences in code should look similar to the following example:

Old Code

twilioField_v1(
 twilioConnectedSystem: cons!ICC_CS_TWILIO_SUBACCOUNT,
 twilioTwiMLAppSid: cons!ICC_VAL_TWIL_APPLICATION_SID,
 twilioWorkspaceSid: cons!ICC_VAL_TWIL_WORKSPACE_SID,
 twilioChatConnectedSystem: cons!ICC_CS_REST_API,
 twilioChatServiceSid: cons!ICC_VAL_TWIL_CHAT_SERVICE_SID, 
 twilioTransferWorkflowSid: cons!ICC_VAL_TWIL_WORKFLOW_SID
 /* other unchanged twilioField inputs here */
)

Upgraded Code

twilioField(
 twilioConnectedSystem: cons!ICC_CS_TWILIO,
 twilioWorkflowSid: cons!ICC_VAL_TWIL_WORKFLOW_SID
 /* other unchanged twilioField inputs here */
)

Affected Versions

This article applies to Appian 19.2 and later.

Tags: administration, SAIL, how-to, application design, upgrade, Intelligent Contact Center, plugins

KB-XXXX How to upgrade a!twilioField from version 1 to version 2

Jussi Lundstedt — Tue, 26 Nov 2019 18:50:57 GMT

Revision 1 posted to Appian Knowledge Base by Jussi Lundstedt on 11/26/2019 6:50:57 PM

Purpose

Instructions

Deploying the new Plug-Ins

In an on-premise Appian installation, perform the following steps:

Download the latest ICC Components bundle for your Appian version from the Downloads section of Appian Community.
Copy the zip file to the server hosting Appian.
Uninstall the twilioField-v1_*.zip and twilioServlets-v1_*.jar plug-ins from <APPIAN_HOME>/_admin/plugins by moving them to a different directory or adding a .bak extension to the files.
Unzip the ICC Components.zip file into <APPIAN_HOME>/_admin/plugins

For Appian Cloud installations, contact Appian Technical Support to request the above steps to be performed in the Appian Cloud environment.

Upgrading the Twilio Component

After the new plug-ins have been deployed, the a!twilioField component needs to be updated in the code. Perform the following steps to update the a!twilioField:

Create a new Connected System using the Twilio Connected System, including the Account SID, Subaccount SID and other values required. If the original API key secret has been lost, you may need to create a new API key via the Twilio Console.
Create a constant pointing to the new Twilio Connected System object.
Open the interface(s) containing the twilioField and change twilioField_v1 to twilioField. In the standard ICC application, the two interfaces using a!twilioField are named ICC_CP_twilioField and ICC_RT_twilioAioReport

Tags: administration, SAIL, how-to, application design, upgrade, Intelligent Contact Center, plugins