Studio 基本概念

指令碼版本管理

如果您的公司使用 Studio 中的開發工作流程階段或版本控制系統（例如 GitHub），則您可以在 CXone Mpower 中了解更多關於推薦指令碼的資訊。 如果您是管理員，則您可以了解配置這些選用功能。

如果您不使用這些版本管理選項，請使用以下部分的資訊來管理您的指令碼版本。 請注意，以名稱為基礎的版本控制並非首選的版本控制方法，這是因為以新名稱儲存指令碼會將未經測試的變更引入生產環境。

以名稱為基礎的版本控制

您可以透過制定一個命名慣例來管理您的指令碼版本。 常見的命名慣例是在指令碼檔案名稱的末尾加入 DEV 或 PROD。 這些新增內容可以幫助您識別指令碼屬於開發還是生產階段。 如果符合您的組織的要求，您還可以加入其他資訊，如日期或版本號。

Studio 不允許在指令碼儲存後變更其名稱。 需要變更指令碼名稱時，請使用另存為製作該指令碼的副本並為其提供一個新名稱。 例如，將指令碼從開發階段轉入生產階段時需要這樣做。 在您將指令碼投入生產後，您可以停用舊的生產和開發版本，以此保持指令碼資料夾的整潔。 如果您需要再次使用，您可以重新啟動。

指令碼在 Studio 中有兩類歷史版本。 包括：

• 隨著指令碼在開發和生產過程中移入和移出而累積的單個檔案。
• 由 Studio 自動儲存和維護的以前版本。 每次儲存指令碼檔案時，Studio 都會在該檔案的歷程記錄中新增一個新版本。 如果需要，您可以將指令碼檔案還原為先前版本。 由 Studio 保留的版本數量是可配置的。

因為每次儲存指令碼時都會新增另一個版本，所以您可以在處理一個指令碼的過程中完全替換該指令碼的所有儲存版本。 您可能想在開始工作之前匯出一個指令碼的副本，特別是當您要做重大修改時。 這樣便可供您參考，或者在需要時完全還原。 給匯出的副本命名可能會非常有用，這樣您就能知道它是哪個版本，以及為什麼要保留它。

開始和結束指令碼

指令碼有三種啟動方式。 可能是：

• 從聯絡點 呼入聯絡人用來發起互動的入口點，如電話號碼或電郵地址。啟動。 這適用於從互動開始時開始處理聯絡的初始路由的指令碼。 對於這種指令碼，您可以透過將他們指派給聯絡點將他們投入生產。
• 再生或啟動來源為：
  • 使用 Runsub 或 Runscript 動作的另一個指令碼。
  • API。
  • ACD指令碼頁。
• 由 Digital Experience 中的工作流程自動化作業產生。

每個指令碼都以 Begin 動作開始。 指令碼以終止動作結束。 有幾個終止動作。 您使用哪一個至關重要，並取決於指令碼媒體類型：

• Discard ：終止一個電郵指令碼。
• End ：終止電話、語音郵件、SMS 或數位指令碼。 不終止數位聯絡，但終止其他媒體類型的指令碼中的聯絡。
• End a Contact: 終止活躍聯絡。 不終止當前指令碼。
• EndText: 終止不包含Regagent動作的 SMS 工作流程（僅適用於數位 任何與Digital Experience相關的通道、聯絡或技能。通道）。
• EndWi: 終止具有原因代碼的工作項目。 不終止當前指令碼。
• Exit ：終止聊天工作階段並斷開聊天聯絡人。
• Hangup ：終止電話指令碼。
• Return ：終止子指令碼並將控制權返回給源指令碼。

如果您使用 End 動作，則適用以下資訊：

• 如果您在一個不支援媒體類型的指令碼中使用End，可能無法正確結束所有流程或聯絡。 結束後台流程是終止動作的一個關鍵功能。 由於此原因，使用最適合您的指令碼的媒體類型的動作非常重要。
• 如果您在子指令碼中使用End，它將同時終止子指令碼和源指令碼。 如果您想終止子指令碼，但又想讓源指令碼繼續，請使用 Return 動作。
• End 應用來終止一個活躍指令碼的邏輯流程，並叫用 OnRelease 事件動作。 由於此原因，它不應在OnRelease事件邏輯之後使用。

使用 snippet 的自訂編碼

簡單的指令碼不需要自訂編碼。 對於這些指令碼，使用可用的動作足以管理 CXone Mpower 中的基本路由功能。

自訂編碼需要更複雜的路由或 CXone Mpower 中的某些產品或功能。 在某些情況下，Studio 動作或整個 CXone Mpower 應用程式需要 Snippet 代碼才能正常工作。 透過 Snippet 動作，您可以在指令碼中需要新增自訂代碼的地方插入代碼。

Studio 使用一種名為Snippet的內部指令碼語言。 該語言在伺服器端執行並編譯為 MSIL（Microsoft 中間語言），就像 C# 和 Visual Basic .NET 一樣。 線上說明提供了關於 Snippet 的完整參考指南。

檔案儲存

所需權限：ACD>工作室>檔案瀏覽器> 查看或ACD>儲存>瀏覽ACD檔案> 查看；建立、編輯或刪除需要額外的權限

CXone Mpower 系統有您可以存取的檔案儲存。 指令碼檔案儲存在此處，以及您在 Studio 中上載或建立以在指令碼中使用的音訊和提示檔案。 您在指令碼中使用的任何其他檔案也必須位於您的CXone Mpower檔案儲存中。 例如，動作 在Studio指令碼中執行處理序，例如收集客戶資料或播放音樂。，如Readfile和Writefile（從檔案中讀取資料或將資料寫入檔案中）。 這些檔案必須位於您的檔案儲存中。

如果您的使用者設定檔有相應權限，您可以透過 CXone Mpower 存取所有這些檔案。 您可以對檔案執行的某些動作需要額外權限。 要CXone Mpower 中與 Studio 相關的檔案：

• 在 CXone Mpower 中，點擊應用程式選擇器 並選擇ACD. 您可以：
  • 點擊支援 > 瀏覽ACD檔案以檢視、上載或刪除音樂、提示和Studio指令碼中使用的其他檔案。
  • 點擊聯絡設定 > Scripts以查看、停用或重新啟用您的指令碼。
• 在 CXone Mpower 中，點擊應用程式選擇器 並選擇Studio. 您可以：
  • 點擊提示以檢視、上載或播放預錄製的音訊提示檔案。
  • 點擊文法以上載ASR 允許客服專員在完成互動後完成工作要求的狀態。系統的文法檔案。
  • 點擊 Scripts 檢視，建立、修改或停用指令碼。

在 Scripts 中處理檔案

您可以在 Studio 指令碼中處理檔案。 檔案必須存在於您的 CXone Mpower 系統上。 您可以在瀏覽ACD檔案頁面上的 CXone Mpower 中檢視檔案。 您可以從該頁面上載和下載檔案。 您也可以使用 Desktop Studio 上載和下載檔案。

有一些動作可以讓您探索 CXone Mpower系統 中的檔案：

• Writefile：將資料儲存到 CXone Mpower 中的檔案。
• Readfile：從檔案讀取資料。
• Filesize：定義檔案大小（位元）。
• Fileinfo：擷取檔案的相關資訊，例如位置以及是否已修改。
• Fileexist：確定特定檔案是否存在。
• Delete：從 CXone Mpower 移除檔案 。

有一些動作可以讓您透過電郵或 FTP/SFTP 傳送檔案：

• EMAIL：傳送有檔案附件的電郵。
• EMAIL（數位指令碼）：傳送有檔案附件的電郵。
• Attach：將檔案附加到已產生的電郵。
• Sendfile：透過 FTP 或 SFTP 傳送檔案。

有一些操作允許您在互動中使用預先錄製的音訊檔案或提示：

• MENU ：為聯絡人播放提示或預先錄製的音訊檔案，並建立選項選單供他們選擇。
• Play ：播放自訂音訊 WAV 檔案或文字轉語音 (TTS 允許使用者將錄音的提示輸入為文字形式，並使用電腦產生的語音來講述內容。) 提示。 如果使用檔，則會播放整個檔。 只有聯絡人能聽到音訊。
• Playlog ：播放只有聯絡人才能聽到的自訂音訊 WAV 檔案。 它允許您選擇一個特定的開始和停止點。 不能播放內建在其他動作中的音樂檔案，如 Music。
• Reqagent: 播放只有客服專員才能聽到的自訂音訊 WAV 檔案或文字轉語音提示。 提示在客服專員和聯絡人連結之前播放，所以提示不會導致聯絡人聽到靜音。
• Whisper ：播放自訂 WAV 檔案或文字轉語音提示。 您可以把它設定為只有聯絡人可以聽到，只有客服專員可以聽到，或者兩者都可以聽到。 提示在客服專員和聯絡人連結後播放，所以如果該動作只為客服專員或聯絡人播放，另一方在提示期間聽到靜音。

檔案路徑

當您需要在指令碼中參考檔案路徑時，請檢查您正在使用的動作的說明頁面。 某些動作使用絕對路徑。 其他動作需要相對路徑。 如果說明頁面並未指定，且其中一種路徑在您的指令碼中無法運作，請嘗試其他類型。 絕對路徑和相對路徑的差異是：

• 絕對路徑始終從根目錄開始。 相對於您所指的檔案，指令碼檔案的位置並不重要。 使用波浪號和反斜杠 （~\） 表示根資料夾。 例如，~\資料夾\file.wav。

• 相對路徑描述所引用的檔相對於腳本檔的位置，從腳本檔的位置開始。 如果檔案位於與指令碼位於同一資料夾中的子資料夾中，請將指令碼的位置視為根目錄，並在路徑中包含子資料夾名稱。 例如，如果腳本在 \資料夾 中，file.wav在 \資料夾\Subfolder1 中，則可以像這樣編寫路徑：\Subfolder1\file.wav。 如果文件位於腳本的資料夾之外，或者相對路徑不起作用，請使用絕對路徑改為。

指令碼中的注釋和注解

Studio 提供了幾種向指令碼新增注釋的方法。 此關鍵步驟可以確保您以及任何在您之後從事指令碼工作的人，都能理解該指令碼。 您可以：

• 使用 Note 和 ANnotation Studio 動作。
• 變更指令碼中的動作在畫布工作區上顯示的標籤。
• 為 Snippet 動作代碼新增註釋。

使用 NOTE 和 ANNOTATION 動作

您可以在您的指令碼中加入 Studio 的兩個動作：Note和 Annotation。 這些動作都不影響指令碼的工作方式。 它們只是提供資訊。 這些動作之間的區別在於：

• Note 動作可以放在指令碼畫布的任何位置，不需要與其他動作連接。 要新增或檢視使用此動作制定的備註，您必須點擊兩下。

• Annotation動作在畫布上以灰色矩形直接顯示您的評論。 如果您想直接指向注釋引用的指令碼部分，還可以將 Annotation 連接到另一個動作。

變更動作標籤

在指令碼中做注釋的另一個選項是變更指令碼中動作的標題。 在每個動作的屬性中都有一個新增標題或標題欄位，您可以在新增名稱或簡短描述，這些名稱或描述會出現在畫布上的 Studio 動作下。 在Desktop Studio中，它會變更畫布上的動作名稱。 您可以用來命名每個動作，用一個詞或短語來提醒該動作在指令碼中的用途。

例如，您可以變更 Snippet 動作的名稱，以表明它所包含的代碼。 或者，您可以在 IVR 互動式語音應答。 自動電話選單聯絡人透過語音或按鍵輸入來獲取資訊、路由呼入語音呼叫或兩者兼而有之。 選單中用播放中的音訊檔案或提示的名稱命名每個 Play 動作。

在 SNIPPET 動作中新增註釋

您可以在 Snippet 動作中為自訂代碼新增註釋。 註釋可以在單獨的連結上，也可以在一行代碼的末尾。 Snippet 語言使用兩個正斜線表示注釋 ( // )。 下面的範例顯示了 snippet 中的註釋：

//custom payload parameters are optional and
//customizable
DYNAMIC customPayload
customPayload.context.id="123"
customPayload.context.parameters.name="Beowulf"
CustomPayload.context.parameters.age=25
ASSIGN tokenjson = "{customPayload.asjson()}" //converts to JSON	

有關使用 Studio 的重要資訊

• 錯誤和警告面板顯示與指令碼相關的任何警告和錯誤。 您可以使用這些資訊來幫助對指令碼進行測試和偵錯。 在 Studio 中，警告和錯誤出現在畫布工作區的右側。
• 您可以將導入和匯出腳本為 JSON 檔。

• Studio不允許在儲存指令碼後對其進行重新命名。 如果需要更改腳本的名稱，可以複製它以創建新名稱的副本，然後停用舊腳本或將其移動到單獨的資料夾中，這樣它就不會妨礙它。

• 您可以在兩個位置檢視指令碼的先前版本：
  • 在 Desktop Studio 中，右鍵點擊瀏覽器標籤中的指令碼（檢視 > 瀏覽器），將滑鼠停留在歷程記錄選項。 Studio 中目前沒有此選項。
  • 在 CXone Mpower 中，點擊 ACD > 指令碼。 在此頁，您也可以將指令碼還原為先前版本。
• 您可以使用 CXone Mpower 中的 ACD > 指令碼排程選項執行排程指令碼。
• 在 ACD> Scripts 頁面中的 CXone Mpower，您可以使用腳本用作變數的臨時自定義參數生成腳本。
• 為了防止指令碼變得過於龐大和複雜，您可以將其分成多個較小的指令碼，並用 Runsub 或 Runscript 動作進行連結。
• 您可以用 Studio 的某些指令碼 API 以程式設計方式打開和儲存指令碼。 這需要進階指令碼技能。

• 指令碼的變更會自動儲存在您的瀏覽器本地。 這可以防止您在瀏覽器意外關閉時遺失未儲存的工作。 如果發生這種情況，下次打開指令碼時，Studio會提示您打開包含未儲存變更的指令碼。