Omnistudio 中的常見錯誤與解決方法

1. 以系統管理員的身分登入。
2. 進入「設定」,尋找並選取「Omnistudio」。
3. 為您的組織啟用 Omnistudio 權限。

如果您看不到該選項,請確認您的組織具有 Omnistudio 授權。如果需要授權,請連絡您的 Salesforce 帳戶主管。

小秘訣 啟用 Omnistudio 權限後,可能需要數分鐘的時間,變更才會在整個組織中移入。如果您繼續看到此錯誤,請嘗試登出並重新登入。

• 嘗試刪除已啟用的 Omniscript
• 嘗試更新已啟用 Omniscript 上的結構欄位
• 嘗試變更已啟用 Omniscript 上的「類型」、「子類型」或「語言」

1. 進入 App Launcher,尋找並選取「Omniscript」。
2. 找到您要修改或刪除的 Omniscript。
3. 記下目前的版本,並針對即將停用的情況警告使用者。
4. 取消選取「已啟用」」核取方塊以停用 Omniscript 並儲存您的變更。
5. 現在您可以進行所需的變更或刪除 Omniscript。
6. 如果您進行了變更,您可以再次選取「已啟用」核取方塊來重新啟用。

警告 停用 Omniscript 會立即影響目前使用 Omniscript 的所有使用者和程序。如果您需要維護服務連續性,請考慮建立新版本,而非修改已啟用的版本。

• 另一個具有相同類型、子類型和語言的 Omniscript 已啟用
• 建立新版本而不停用先前版本
• 已建立和嘗試啟用多個版本

請確認您擁有編輯 Omniscript 記錄的權限,並完成這些工作。

1. 進入 App Launcher,尋找並選取「Omniscript」。
2. 使用篩選條件或搜尋具有相符「類型」和「子類型」的 Omniscript。
3. 使用相同的 Type/SubType/Language 識別目前啟用的 Omniscript。
4. 檢閱這兩個版本,以決定哪些版本應保持啟用。
5. 開啟您要停用的 Omniscript。
6. 取消選取「已啟用」核取方塊並儲存您的變更。
7. 返回新版本並予以啟用。

警告 啟用新版本之前,請先在預覽或 Sandbox 環境中進行完整測試。當您準備好部署時,請停用舊版本,並立即啟用新版本以儘量縮短停機時間。

• 類型欄位為空白或空值
• 子類型欄位為空白或空值
• 未選取語言欄位
• 嘗試儲存新的 Omniscript,而不填入所有必要欄位

請確認您擁有編輯 Omniscript 記錄的權限,並完成這些工作。

1. 進入 App Launcher,尋找並選取「Omniscript」。
2. 在 Omniscript 內容面板中,找到「類型」欄位。
3. 輸入描述性「類型」名稱,例如 CustomerOnboarding 或 ClaimSubmission。
4. 找到「子類型」欄位,然後輸入特定的「子類型」名稱,例如「住宅」或「商業」。
5. 從下拉式清單中選取「語言」。
6. 確定已填入全部三個欄位,然後儲存您的變更。
7. 返回新版本並予以啟用。

小秘訣 選擇有意義的「類型」和「子類型」名稱,以清楚指出您 Omniscript 的用途。這些值會成為您在應用程式中參照 Omniscript 一部分,且無法在建立後輕鬆變更。

• 「類型」或「子類型」欄位包含空格
• 「類型」或「子類型」欄位包含底線
• 「類型」或「子類型」欄位包含不支援的特殊字元:!@#$%^&*,依此類推
• 「類型」或「子類型」欄位包含連字號或其他標點符號

1. 檢閱您的「類型」與「子類型」值。
2. 移除任何空格 - 改用 UpperCamelCase (或 PascalCase)。例如,CustomerOnboarding。
3. 移除任何底線,並將其取代為 UpperCamelCase (或 PascalCase)。
4. 移除任何特殊字元。
5. 請確保僅使用字母 (A-Z、a-z) 和數字 (0-9)。
6. 儲存您的變更。

小秘訣 針對 Type 和 SubType 值使用 PascalCase (也稱為 UpperCamelCase)。這可改善可讀性,而不需要空格或底線。

• 類型值太長。
• 「子類型」值太長。
• 「組合類型 + 子類型 + 語言」超過字元限制。

1. 檢閱錯誤訊息以查看允許的長度上限。
2. 縮短「類型」或「子類型」值。
3. 儲存您的變更。

小秘訣 視需要使用縮寫。移除冗餘文字。使用較短的命名慣例。

「類型」或「子類型」欄位使用保留的關鍵字。常見的受限制關鍵字包括:in、out、exc、cb、kt、vt、v、x785f、x5f

如錯誤訊息中的建議,請以不同的值取代受限制的關鍵字。如需詳細資訊,請參閱「Omnistudio 命名慣例」頁面上的「保留字詞」。

• 嘗試將新元素新增至已啟用的 Omniscript。
• 嘗試修改已啟用 Omniscript 上的現有元素。
• 嘗試從啟用的 Omniscript 中刪除元素。
• Omniscript 已啟用且正在使用中。

請確認您擁有編輯 Omniscript 記錄的權限,並完成這些工作。

1. 確認 Omniscript 是否目前已啟用。
2. 請考慮建立新版本,而非修改已啟用的版本。
3. 若要建立新版本:按一下 Omniscript 上的「複製」。
4. 若要修改現有的項目:透過取消選取「已啟用」 核取方塊來停用,然後儲存您的變更。
5. 現在您可以新增、更新或刪除元素。
6. 測試您的變更。
7. 當準備好可供使用時啟用 Omniscript。

警告 建議您建立新的版本來進行重大變更,而非停用和修改已啟用的版本。這可讓您在部署前進行完整測試,並在發生問題時提供簡單的回復選項。

• 相同 Omniscript 中的另一個元素名稱相同。
• 不同步驟中元素之間的命名衝突。
• 元素已複製,且名稱未變更。

1. 檢閱 Omniscript 中的所有元素。
2. 識別具有衝突名稱的元素。
3. 決定要保留名稱的元素。
4. 以唯一名稱重新命名另一個元素。
5. 請考慮使用字首來表示步驟或區段,例如,step1_firstName、step2_firstName。
6. 更新參照重新命名元素的任何公式或資料對應,然後儲存您的變更。

• Omniscript 來自受管理封裝,且您沒有修改或刪除的權限。
• 嘗試從封裝命名空間外更新封裝的 Omniscript。

1. 確認 Omniscript 是否來自受管理封裝。
2. 如果您需要自訂 Omniscript,請改為複製。
3. 以您自己的 Type/SubType/Language 組合重新命名複製的版本。
4. 對複製的版本進行所需的修改,然後儲存並啟用您的 Omniscript。
5. 更新參照重新命名元素的任何公式或資料對應,然後儲存您的變更。

小秘訣 如果您需要對封裝元件進行變更,請連絡封裝提供者或您的 Salesforce 管理員。它們可提供組態選項或擴充點,不需要直接修改封裝的 Omniscript。

• Omniscript 可重複使用。
• Omniscript 包含 Omniscript 元素 (內嵌的 Omniscript)。
• 新增內嵌的 OmniScript 後嘗試讓 Omniscript 可重複使用

1. 決定此 Omniscript 應是可重複使用還是包含內嵌的 Omniscript。
2. 選項 1:保持可重複使用 - 移除所有內嵌的 Omniscript 元素
3. 選項 2:允許內嵌:取消選取「可重複使用」核取方塊。
4. 如果您要移除內嵌的 Omniscript,請考慮改用「整合程序」。您可以將邏輯重新定義為可從 Omniscript 呼叫的整合程序。

小秘訣 針對共用業務邏輯使用整合程序,而非嵌套可重複使用的 Omniscript。這可建立更整齊的結構,並避免 Omniscript 相依性產生複雜性。

• 另一個具有相同名稱的 FlexCard 已啟用。
• 嘗試啟用新版本而不停用舊版本。

1. 搜尋具有相同「名稱」欄位的 FlexCard。
2. 檢閱這些項目以判斷哪些項目應保持啟用。
3. 開啟您要停用的 FlexCard。
4. 取消選取「已啟用」」核取方塊以停用 FlexCard 並儲存您的變更。

警告 停用 FlexCard 會立即影響目前使用的所有使用者和程序。如果您需要維護服務連續性,請考慮建立新版本,而非修改已啟用的版本。

1. 確認 FlexCard 是否來自受管理封裝。
2. 如果您需要將其從使用中移除,請停用而非刪除。
3. 若要這麼做,請開啟 FlexCard,然後取消選取「已啟用」核取方塊。
4. 如果您需要自訂版本的 FlexCard,請改為複製。

小秘訣 如果您需要對封裝元件進行變更,請連絡封裝提供者或您的 Salesforce 管理員。它們可提供組態選項或擴充點,不需要直接修改封裝的 FlexCard。

• 子系 FlexCard 名稱的名稱拼錯。
• 子系 FlexCard 存在但未啟用。
• 子系 FlexCard 已刪除。
• 子系 FlexCard 位於不同的命名空間中。

1. 進入 App Launcher,尋找並選取錯誤訊息中的「備註子系 FlexCard」名稱。
2. 依名稱搜尋子系 FlexCard。
3. 如果找到但未啟用,請將其啟用。
4. 若找不到,請確認正確的名稱。
5. 如果名稱不正確,請更新父系 FlexCard 組態。
6. 在父系 FlexCard 中,找到子系 FlexCard 參照。
7. 更正名稱以符合現有的已啟用 FlexCard,然後儲存父系 FlexCard。

備註 必須先啟用子系 FlexCard,父系 FlexCard 才能參照它們。先建立與測試子系 FlexCard,然後設定父系 FlexCard 以使用它們。

• Omniscript 的 Type/SubType/Language 不正確。
• Omniscript 存在但未啟用。
• 已刪除 Omniscript。
• Omniscript 的 Type/SubType/Language 已變更。

1. 記下錯誤訊息中的「類型」、「子類型」和「語言」。
2. 搜尋具有相符「類型」和「子類型」的 Omniscript。
3. 確認「語言」符合。
4. 如果找到但未啟用,請啟用 Omniscript。
5. 若找不到,請確認 Type/SubType/Language 值正確。
6. 返回您的 FlexCard,並以正確的值更新 Omniscript 參照。
7. 儲存您的變更。

小秘訣 啟用 FlexCard 之前,請確保參照的 Omniscript 已啟用。如果您要同時部署兩個功能,請先啟用 Omniscript。

• 資料對應器的名稱拼錯。
• 「資料對應器」存在但未啟用。
• 資料對應器已刪除。
• 資料對應器的名稱已變更。

1. 記下錯誤訊息中的「資料對應器」名稱。
2. 依名稱搜尋「資料對應器」。
3. 如果找到但未啟用,請將其啟用。
4. 若找不到,請確認正確的名稱。
5. 返回您的 FlexCard,以正確的名稱更新「資料對應器」參照,然後儲存您的變更。

小秘訣 請先啟用資料對應器,再啟用參照資料對應器的 FlexCard。獨立測試「資料對應器」,以確保其傳回預期的資料結構。

• 「整合程序」的名稱不正確。
• 「資料對應器」存在但未啟用。
• 資料對應器已刪除。
• 您使用的命名格式錯誤 (應該使用 Type_SubType 格式)。

1. 記下錯誤訊息中的「整合程序」名稱。
2. 搜尋整合程序。
3. 確認其存在,並記下其「類型」和「子類型」。
4. 如果找到但未啟用,請將其啟用。
5. 返回您的 FlexCard。
6. 使用以下格式更新整合程序參照:Type_SubType」,然後儲存您的變更。

警告 系統會使用其 OmniProcessKey 參照整合程序,其遵循 Type_SubType 格式。設定 FlexCard 時,請確定您使用的是正確的格式。

• 嘗試重新命名現有的 FlexCard。
• 嘗試變更現有 FlexCard 的「作者」。
• UniqueName 由其他元件使用,且無法變更。

1. 如果您需要不同的名稱或作者,請改為複製 FlexCard。
2. 找到您的 FlexCard 並加以複製。
3. 輸入新的「名稱」或「作者」。
4. 對複製的版本進行任何其他必要的變更,並啟用新的 FlexCard。
5. 更新參照舊 FlexCard 的任何元件,以使用新的 FlexCard。
6. 一旦所有參照皆更新後,請停用舊版 FlexCard。

• 「整合程序名稱」開頭為 FileBased。
• 「整合程序類型」從 檔案型開始。
• 「整合程序子類型」開頭為 FileBased。

1. 開啟您的整合程序。
2. 檢查「名稱」、「類型」和「子類型」欄位。
3. 如果開頭為 FileBased,請選擇不同的字首。
4. 請考慮使用如 檔案、文件、資料或您組織名稱等字首。
5. 更新容易出錯的欄位並儲存您的變更。

• JSON 輸入結構描述具有超過 10 個層級的巢狀物件。
• JSON 輸出結構描述具有超過 10 個層級的巢狀物件。

1. 檢閱 JSON 結構描述結構。
2. 識別深度巢狀區段。
3. 透過減少巢狀層級來壓平結構。
4. 請考慮將深度巢狀的資料移至個別的「整合程序」。
5. 使用具有壓平物件的陣列,而非深度巢狀階層。
6. 重新建構以保持在 10 個層級以下的巢狀狀態。
7. 儲存更新的結構描述。

整合程序 JSON 結構描述在整個結構上限為 500 個鍵值。這包括所有巢狀層級的所有索引鍵合併。具體而言：

• JSON 輸入結構描述包含總計 500 個以上的鍵值。
• JSON 輸出結構描述包含總共 500 個以上的鍵值。
• 結構描述包含多個巢狀物件之間的大量欄位。

1. 檢閱 JSON 結構描述。
2. 計算所有層級之間的鍵值總數。
3. 識別有過多鍵值的區段。
4. 請考慮將整合程序分割成多個較小的程序。
5. 移除未使用或冗餘的金鑰。
6. 使用陣列代表重複的結構,而非編號的鍵值。
7. 將相關欄位合併至子物件。
8. 儲存最佳化的結構描述。

小秘訣 如果您合法需要超過 500 個金鑰,請考慮將流程拆分為可鏈結在一起的多個「整合程序」。

• 所選的 sObject 不支援用於「資料對應器」作業。
• 所選的 sObject 是不支援查詢的系統物件。
• 所選的 sObject 不具有使用「資料對應器」所需的 API 支援。

1. 檢閱您選取作為輸入類型的 sObject,並檢查 Salesforce 說明以瞭解支援的物件。
2. 請考慮使用不同的支援相關物件。
3. 如果您需要來自不支援物件的資料,請改為將整合程序與自訂 Apex 搭配使用。
4. 使用支援的物件更新您的「資料對應器」組態,然後儲存您的變更。

備註 支援大多數標準與自訂物件。如果您遇到不支援的物件,請考慮是否可以將資料流程重新結構化,以使用支援的替代物件。

• 未啟用 OmniAnalytics for Omnistudio。
• 您的組織尚未針對 OmniAnalytics 進行設定。

1. 以系統管理員身分登入,然後進入「設定」,搜尋「Omnistudio 設定」 或「Omni 互動組態」。
2. 找到「OmniAnalytics for Core」設定並予以啟用。
3. 儲存您的變更,然後等候幾分鐘,變更才會生效。
4. 測試分析追蹤是否運作。

備註 確認已正確設定 決策說明工具。

• 識別碼不具備有效的 Salesforce 識別碼格式,包含 15 或 18 個字元。
• 識別碼不屬於 OmniTrackingComponentDef 物件。
• 追蹤元件定義已刪除。
• 識別碼為空值或格式錯誤。

1. 確認您正在使用的元件定義識別碼。
2. 瀏覽至「設定 > Omnistudio > Analytics 追蹤」,並找到正確的追蹤元件定義。
3. 從記錄複製正確的識別碼。
4. 使用正確的識別碼更新程式碼或組態。
5. 如果已刪除定義,請建立新的追蹤元件定義。請參閱建立追蹤群組和新增要追蹤的元件。
6. 再次測試追蹤。

備註 確認已正確設定 決策說明工具。