위치:
Salesforce Maps 외부 개체 고려 사항
Salesforce Maps에 외부 개체 레코드를 표시하기 전에 주요 제한 및 종속성을 검토합니다. 이 주제에서는 조직에서 Salesforce Connect 통해 데이터를 검색할 때 쿼리 동작, 지역 코드 및 암호화 제약, 성능 제약에 대해 다룹니다.
Salesforce Maps에서 외부 개체 데이터를 검색하는 방법
외부 개체를 사용하면 Salesforce 관리자가 Salesforce Connect 통해 Salesforce 조직 외부에 있는 데이터에 실시간으로 액세스할 수 있습니다. Salesforce Maps에서 외부 개체를 표시할 수 있지만 외부 데이터 소스에서 OData 2.0, OData 4.0 또는 cross-org 연결을 사용하는 경우 중요한 제한 사항이 있습니다.
외부 개체를 표시하면 Maps가 Salesforce Connect 통해 데이터를 검색하여 외부 시스템에 대한 콜아웃을 만듭니다. 이 실시간 통합은 표준 Salesforce 개체에 적용되지 않는 특정 제약을 도입합니다.
SOQL 및 쿼리 제한 사항
외부 개체에는 Salesforce Maps에서 데이터를 검색하고 표시하는 방법에 영향을 미치는 몇 가지 쿼리 제한이 있습니다.
- 관계 쿼리: 외부 개체와 표준 개체 간의 관계와 관련된 쿼리는 모든 SOQL 작업을 지원하지 않을 수 있습니다. 외부 개체 관계에서 표시해야 하는 필드를 지원하는지 확인합니다.
- 집계 함수: COUNT, SUM, AVG, MIN, MAX 함수는 대부분의 외부 데이터 소스에서 지원되지 않습니다. 집계에 의존하는 지도 기능은 외부 개체에서 작동하지 않을 수 있습니다.
- 필터 연산자: 일부 SOQL 필터 연산자는 외부 개체에 사용할 수 없습니다. 지원되는 특정 연산자는 외부 데이터 소스의 Odata 버전 및 구성에 따라 다릅니다.
- LIMIT 절: 외부 데이터 소스는 Salesforce SOQL LIMIT 절과 무관하게 자체 레코드 제한을 적용할 수 있습니다. 특정 제한 사항은 외부 데이터 소스 문서를 확인하십시오.
지역 코드 및 주소 필드 요구 사항
외부 개체의 지역 코드화는 특별히 고려해야 합니다.
- 주소 필드: 외부 개체에는 외부 데이터 소스를 통해 노출된 주소 필드가 있어야 합니다. 주소 필드를 직접 사용할 수 없는 경우 주소가 포함된 표준 또는 사용자 정의 개체에 대한 조회 관계를 구성해야 합니다.
- 지오코딩 API 제한: Maps가 외부 개체를 표시할 때마다 조직의 지역 코드 제한에 포함되는 지역 코드 작업을 트리거할 수 있습니다. 대규모 외부 데이터 집합에 대해 작업할 때 지역 코드 사용을 모니터링합니다.
- 간접 조회: 주소가 없는 레코드를 표시할 경우 외부 개체와 주소를 포함하는 개체 간의 관계가 간접 조회로 올바르게 구성되어 있는지 확인합니다.
Shield Platform Encryption 제한 사항
조직에서 Shield Platform Encryption 사용하는 경우 외부 개체를 표시할 때 다음과 같은 추가 제약 사항에 유의하십시오.
- 암호화된 필드: 외부 개체는 Shield Platform Encryption 직접 지원하지 않습니다. 그러나 암호화된 필드를 포함하는 표준 개체에 대한 간접 조회를 사용하는 경우 특정 필터 및 검색 작업이 예상대로 작동하지 않을 수 있습니다.
- 검색 제한: 관련 표준 개체의 암호화된 필드는 외부 개체 관계를 통해 액세스할 경우 검색 쿼리에서 사용할 수 없습니다.
- 운영자 제한 사항: 비교 연산자(LIKE, CONTAINS 등)는 외부 개체 관계를 통해 참조되는 암호화된 필드에서 작동하지 않을 수 있습니다.
성능 고려 사항
외부 개체를 표시하면 실시간 데이터 검색으로 인해 Maps 성능에 영향을 미칠 수 있습니다.
- 외부 콜아웃 제한: 외부 개체 데이터를 검색하는 각 요청은 조직의 콜아웃 제한에 포함됩니다. 대용량 데이터 집합 또는 빈번한 지도 새로 고침은 콜아웃을 빠르게 사용할 수 있습니다.
- 응답 시간: 지도 성능은 외부 데이터 소스의 응답 시간에 따라 다릅니다. 외부 시스템이 느리면 지도 로드 및 표시가 지연됩니다.
- 데이터 용량: 외부 개체 레코드의 대용량을 표시하는 것은 표준 개체를 표시하는 것보다 느릴 수 있습니다. 필터를 사용하여 검색 및 표시된 레코드 수를 줄이는 것이 좋습니다.
- 캐싱 제한 사항: 표준 개체와 달리 외부 개체 데이터는 각 요청에 대해 실시간으로 검색됩니다. 표준 개체의 성능을 향상하는 Salesforce의 캐싱 메커니즘은 외부 데이터에 적용되지 않습니다.
외부 개체의 계층 동작
외부 개체를 사용하여 데이터 레이어 또는 마커 레이어를 만드는 경우:
- 계층 작성: 외부 개체를 기반으로 데이터 레이어를 만들 수 있지만 위에 설명된 모든 쿼리 제한 사항이 적용됩니다.
- 만들기: 클릭-만들기 기능은 대상 개체로 외부 개체를 사용할 때 제한이 있을 수 있습니다. 외부 데이터 소스가 필수 삽입 작업을 지원하는지 확인합니다.
- 실시간 데이터 세트 업데이트: 캐싱 또는 데이터 소스 새로 고침 간격으로 인해 소스 시스템의 외부 데이터에 대한 변경 사항이 지도 레이어에 즉시 표시되지 않을 수 있습니다.
- 색상으로 구분된 레이어: 외부 개체 필드 값을 기반으로 하는 색상 구분은 표준 개체와 동일하게 작동하지만 대규모 외부 데이터 집합의 경우 성능이 느려질 수 있습니다.
검색 및 필터 동작
검색 기능에는 외부 개체에 대한 특정 제한 사항이 있습니다.
- POI 검색: 실시간 데이터 검색으로 인해 POI(관점 검색) 검색이 외부 개체에서 더 느리게 수행될 수 있습니다.
- 텍스트 검색: 전체 텍스트 검색 기능은 텍스트 검색 작업에 대한 외부 데이터 소스의 지원에 따라 다릅니다.
- 필터 지속성: 외부 개체 레이어에 적용된 필터는 각 지도 로드에서 다시 평가해야 할 수 있으므로 로드 시간이 잠재적으로 영향을 받을 수 있습니다.
외부 개체 문제 해결
외부 개체를 표시하는 데 문제가 발생하는 경우 다음을 확인하십시오.
| 증상 | 가능한 원인 및 해결 방법 |
|---|---|
| 지도의 외부 개체가 표시되지 않음 | 외부 데이터 소스가 연결되어 있고 액세스할 수 있는지 확인합니다. 외부 개체에서 직접 또는 간접 검색 관계를 통해 주소 필드가 올바르게 매핑되는지 확인합니다. |
| SOQL 쿼리가 지원되지 않는 오류 | 쿼리는 외부 데이터 소스에서 지원되지 않는 SOQL 연산을 사용합니다. 쿼리를 간소화하거나 지원되지 않는 연산자를 제거합니다. Developer Console에서 쿼리를 테스트하여 지원되지 않는 특정 작업을 식별합니다. |
| 로드를 느리게 매핑하거나 시간 초과 | 외부 데이터 소스가 느리게 응답하거나 너무 많은 레코드를 반환할 수 있습니다. 필터를 추가하여 데이터 집합 크기를 줄이거나 외부 시스템의 성능을 확인합니다. |
| 필터 옵션이 예상대로 작동하지 않음 | 일부 필터 연산자는 외부 데이터 소스에서 지원되지 않을 수 있습니다. OData 어댑터 설명서에서 지원되는 연산자를 확인하거나 관련 객체에 필터링을 방지하는 암호화된 필드가 포함되어 있지 않은지 확인하십시오. |
| 콜아웃 제한 오류 | 외부 개체를 표시하면 API 콜아웃이 사용됩니다. 조직의 콜아웃 제한을 모니터링하고 지도 새로 고침 빈도 또는 표시되는 외부 개체 수를 줄입니다. |
외부 개체 모범 사례
Salesforce Maps에서 외부 개체에 대해 작업할 때 다음 모범 사례를 따르십시오.
- 테스트 쿼리 먼저: Developer Console을 사용하여 Maps에서 구성하기 전에 외부 개체에 대해 SOQL 쿼리를 테스트합니다.
- 전략적으로 필터 사용: 필터를 적용하여 검색 및 표시되는 외부 레코드 수를 제한합니다.
- 모니터 제한: 외부 데이터에 대해 작업할 때 콜아웃 제한 및 지역 코드 API 사용을 추적합니다.
- 문서 데이터 소스: 제한 사항, 새로 고침 일정, 지원되는 작업 등 외부 데이터 소스에 대한 문서를 유지합니다.
- 대기 시간 계획: 외부 개체와 매핑하는 사용자 기대 설정은 표준 개체만 있는 지도보다 더 느리게 로드될 수 있습니다.
- 관계 확인: 자체 주소가 없는 외부 개체를 표시하기 전에 간접 조회 관계가 올바르게 구성되어 있는지 확인합니다.
