Omnistudio의 일반적인 오류 및 해결 방법

1. 시스템 관리자로 로그인합니다.
2. 설정에서 Omnistudio를 찾아서 선택합니다.
3. 조직에 대한 Omnistudio 권한을 활성화합니다.

옵션이 표시되지 않는 경우 조직에 Omnistudio 라이센스가 있는지 확인합니다. 라이센스가 필요한 경우 Salesforce 계정 담당자에게 문의하십시오.

팁 Omnistudio 권한을 활성화한 후 조직 전체에 변경 사항이 전파되기까지 몇 분이 소요될 수 있습니다. 계속해서 이 오류가 나타나면 로그아웃하고 다시 로그인하십시오.

• 활성 Omniscript 삭제 시도
• 활성 Omniscript에서 구조 필드 업데이트 시도
• 활성 Omniscript에서 유형, 하위 유형 또는 언어 변경 시도

1. 앱 시작 관리자에서 Omniscripts를 찾아서 선택합니다.
2. 수정 또는 삭제할 Omniscript를 찾습니다.
3. 현재 버전을 기록하고 사용자에게 예정된 비활성화에 대해 경고합니다.
4. Omniscript를 비활성화하고 변경 사항을 저장하려면 활성 확인란을 선택 취소합니다.
5. 이제 원하는 내용을 변경하거나 Omniscript를 삭제할 수 있습니다.
6. 변경한 경우 다시 활성 확인란을 선택하여 다시 활성화할 수 있습니다.

경고 OmniScript를 비활성화하면 현재 OmniScript를 사용하는 모든 사용자 및 프로세스에 즉시 영향을 미칩니다. 서비스 연속성을 유지해야 하는 경우 활성 버전을 수정하는 대신 새 버전을 만드는 것이 좋습니다.

• 유형, 하위 유형, 언어가 동일한 다른 Omniscript가 이미 활성화되어 있습니다.
• 이전 버전을 비활성화하지 않고 새 버전 만들기
• 여러 버전을 만들고 둘 이상을 활성화하려고 시도한 경우

Omniscript 레코드를 편집하고 다음 과업을 완료할 수 있는 권한이 있는지 확인하십시오.

1. 앱 시작 관리자에서 Omniscripts를 찾아서 선택합니다.
2. 필터를 사용하거나 유형 및 하위 유형이 일치하는 OmniScript를 검색합니다.
3. 동일한 유형/하위 유형/언어를 사용하여 현재 활성 Omniscript를 식별합니다.
4. 두 버전을 모두 검토하여 활성 상태를 유지해야 하는 버전을 결정합니다.
5. 비활성화할 Omniscript를 엽니다.
6. 활성 확인란을 선택 취소하고 변경 사항을 저장합니다.
7. 새 버전으로 돌아가 활성화합니다.

경고 새 버전을 활성화하기 전에 미리 보기 또는 Sandbox 환경에서 테스트하십시오. 배포할 준비가 되면 기존 버전을 비활성화하고 새 버전을 즉시 활성화하여 가동 중지 시간을 최소화합니다.

• 유형 필드가 비어 있거나 null임
• 하위 유형 필드가 비어 있음 또는 null
• 언어 필드가 선택되지 않음
• 모든 필수 필드를 작성하지 않고 새 Omniscript 저장 시도

Omniscript 레코드를 편집하고 다음 과업을 완료할 수 있는 권한이 있는지 확인하십시오.

1. 앱 시작 관리자에서 Omniscripts를 찾아서 선택합니다.
2. Omniscript 속성 패널에서 유형 필드를 찾습니다.
3. CustomerOnboarding 또는 ClaimSubmission과 같은 설명형 유형 이름을 입력합니다.
4. 하위 유형 필드를 찾고 특정 하위 유형 이름(예: Residential 또는 Commercial)을 입력합니다.
5. 드롭다운에서 언어를 선택합니다.
6. 세 개의 필드가 모두 작성되었는지 확인하고 변경 사항을 저장합니다.
7. 새 버전으로 돌아가 활성화합니다.

팁 Omniscript의 목적을 명확하게 나타내는 유의미한 유형 및 하위 유형 이름을 선택합니다. 이러한 값은 응용 프로그램에서 Omniscript를 참조하는 방식의 일부가 되고 생성 후에는 쉽게 변경할 수 없습니다.

• 유형 또는 하위 유형 필드에 공백 포함
• 유형 또는 하위 유형 필드에 밑줄 포함
• 유형 또는 하위 유형 필드에는 !@#$%^&* 등 지원되지 않는 특수 문자가 포함됩니다.
• 유형 또는 하위 유형 필드에 하이픈 또는 기타 문장 부호가 포함됨

1. 유형 및 하위 유형 값을 검토합니다.
2. 모든 공백을 제거합니다. 대신 UpperCamelCase(또는 PascalCase)를 사용하십시오. 예를 들어, CustomerOnboarding입니다.
3. 밑줄을 제거하고 UpperCamelCase(또는 PascalCase)로 교체합니다.
4. 모든 특수 문자를 제거합니다.
5. 문자(A~Z, a~z) 및 숫자(0~9)만 사용해야 합니다.
6. 변경 사항을 저장합니다.

팁 유형 및 하위 유형 값에 UpperCamelCase라고도 하는 PascalCase를 사용합니다. 이렇게 하면 공백이나 밑줄이 필요하지 않고 가독성이 향상됩니다.

• 유형 값이 너무 길었습니다.
• 하위 유형 값이 너무 길었습니다.
• 결합된 유형 + 하위 유형 + 언어가 문자 제한을 초과합니다.

1. 오류 메시지를 검토하여 허용되는 최대 길이를 확인합니다.
2. 유형 또는 하위 유형 값을 줄입니다.
3. 변경 사항을 저장합니다.

팁 필요한 경우 약어를 사용합니다. 중복 단어를 제거합니다. 짧은 명명 규칙을 사용합니다.

유형 또는 하위 유형 필드는 예약 키워드를 사용합니다. 일반적으로 제한되는 키워드: in, out, exc, cb, kt, vt, v, x785f, x5f

오류 메시지에 제안된 대로 제한된 키워드를 다른 값으로 대체합니다. 자세한 내용은 Omnistudio Naming Conventions 페이지의 예약된 단어를 참조하십시오.

• 활성 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. 앱 시작 관리자에서 오류 메시지에서 하위 Flexcard 이름 메모리를 찾아서 선택합니다.
2. 이름으로 하위 FlexCard를 검색합니다.
3. 검색되었지만 비활성 상태인 경우 활성화합니다.
4. 찾을 수 없는 경우 올바른 이름을 확인합니다.
5. 이름이 올바르지 않을 경우 상위 FlexCard 구성을 업데이트합니다.
6. 상위 FlexCard에서 하위 FlexCard 참조를 찾습니다.
7. 기존 활성 FlexCard와 일치하도록 이름을 수정하고 상위 FlexCard를 저장합니다.

노트 하위 FlexCard를 활성화해야만 상위 FlexCard가 참조할 수 있습니다. 먼저 하위 FlexCard를 만들고 테스트한 다음, 상위 FlexCard를 구성하여 사용합니다.

• Omniscript의 유형/하위 유형/언어가 올바르지 않습니다.
• Omniscript가 있지만 활성 상태가 아닙니다.
• Omniscript가 삭제되었습니다.
• Omniscript의 유형/하위 유형/언어가 변경되었습니다.

1. 오류 메시지에서 유형, 하위 유형, 언어를 기록합니다.
2. 유형 및 하위 유형이 일치하는 Omniscript를 검색합니다.
3. 언어 일치 여부를 확인합니다.
4. 검색되었지만 비활성 상태인 경우 Omniscript를 활성화합니다.
5. 찾을 수 없는 경우 올바른 유형/하위 유형/언어 값을 확인합니다.
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을 선택하고 변경 사항을 저장합니다.

경고 통합 절차는 Type_SubType 형식을 따르는 OmniProcessKey를 사용하여 참조됩니다. 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 설정 또는 옴니 상호 작용 구성을 검색합니다.
2. Core용 OmniAnalytics 설정을 찾아서 활성화합니다.
3. 변경 사항을 저장하고 변경 사항이 적용될 때까지 몇 분 정도 기다립니다.
4. 분석 추적이 작동하는지 테스트합니다.

노트 결정 설명기가 올바르게 구성되어 있는지 확인합니다.

• ID는 유효한 Salesforce ID 형식이 아니며 15자 또는 18자입니다.
• ID는 OmniTrackingComponentDef 개체에 속하지 않습니다.
• 추적 구성 요소 정의가 삭제되었습니다.
• ID가 null이거나 잘못되었습니다.

1. 사용 중인 구성 요소 정의 ID를 확인합니다.
2. 설정 > Omnistudio > Analytics 추적으로 이동하여 올바른 추적 구성 요소 정의를 찾습니다.
3. 레코드에서 올바른 ID를 복사합니다.
4. 올바른 ID로 코드 또는 구성을 업데이트합니다.
5. 정의가 삭제된 경우 새 추적 구성 요소 정의를 만듭니다. 추적 그룹 만들기 및 추적할 구성 요소 추가를 참조하십시오.
6. 추적을 다시 테스트합니다.

노트 결정 설명기가 올바르게 구성되어 있는지 확인합니다.