自訂代碼 Snippet

本説明頁面上的資訊同時適用於 StudioDesktop Studio

有些指令碼需要比 Studio 動作本身更複雜的動作。 Studio 允許您在您的指令碼中新增自訂代碼。 這使您可以自訂指令碼,以滿足貴組織需求。

自訂編碼需要一些指令碼或程式設計知識。 Studio 使用一種稱為 Snippet 的自訂程式設計語言,為在 Studio 中使用而開發。 線上說明中提供了完整的技術參考指南,以讓您能學會使用這種語言。

有關 Snippet 的重要資訊

  • Snippet 可以幫助提高指令碼的組織和效率。 這些代碼片段增加了您對執行的進程,以及代碼片段何時和如何執行的控制。 您可以建立自己的變數和物件,並使用 IFFORFOREACH 等語句新增程式設計邏輯。
  • 有些產品和功能需要 snippet,但即使不需要,您也可以在您的的指令碼中使用這些 snippet。
  • 當一個產品或功能需要 snippet 時,線上說明提供了有關您需要包含的 snippet 的詳細資訊。 提供了一些指令碼範例,以說明如何在指令碼中使用 snippet。 可能需要額外的指令碼來實現產品或功能。
  • Snippet 指令碼語言建立在 .NET 框架之上。 該語言在伺服器端執行並編譯為 MSIL(Microsoft 中間語言),就像 C# 和 Visual Basic .NET 一樣。

Snippet 動作

要在您的指令碼中新增自訂代碼,需要 Snippet 動作。 您可以點擊兩下此動作,打開編輯器視窗,您可以在其中新增自訂代碼。 您也可以在編輯器視窗中對代碼進行偵錯。 您的指令碼中可能需要多個 Snippet 動作。 如果您使用多個動作,請使用有助於識別的一個短語來更新每個動作的 新增 Caption 欄位。

Snippet 動作的位置至關重要。 如果 Snippet 為變數賦值,必須放在需要該值的動作之前。 另一方面,如果 Snippet 包含基於獲得傳遞的值而執行動作的決策代碼,則 Snippet 必須放在提供該值的動作之後。

與行動相比的 Snippet

您在 Snippet 中可以做的一些事情也可以用 Studio 動作來完成。 例如,IFFOR 語句的動作。 還有 ASSIGN 動作,您可以使用該動作來建立自訂變數並為其賦值。 使用這些動作是一種將這些能力新增到指令碼中的可接受方式。 然而,使用 Snippet 的效率更高。

透過將代碼放在 Snippet 中,您的指令碼會更乾淨,更有條理,也更容易瀏覽。 這使您更容易、更有效率地完成指令碼編寫員的工作。 如果您養成習慣,總是在 Snippet 中聲明變數,那麼在將來,如果您需要找到某個特定的聲明,您僅需尋找更少的地方。

將自訂程式碼新增至指令碼

Snippet動作可讓您將自訂程式碼新增至指令碼。

  1. CXone Mpower 中,點擊應用程式選擇器 並選擇Studio
  2. 在指令碼頁面上,找到並開啟您的指令碼。
  3. Snippet動作新增至指令碼,然後點擊屬性面板上的開啟編輯器
  4. 在編輯器視窗中輸入您的代碼。 您可以輸入代碼,或者從其他來源複製和貼上,例如此說明網站或其他指令碼。
  5. 點擊 Apply 儲存變更。 Snippet 編輯器關閉。 重新開啟它以繼續編輯程式碼。