하드 코딩된 참조 업데이트

일반 FAQ

1. 하드 코딩된 참조란(즉, 인스턴스별 참조) 무엇입니까?

a) 하드 코딩된 참조는 인스턴스 이름을 포함하는 URL입니다(예: na1.salesforce.com). 이러한 하드 코딩된 참조를 일반, 비인스턴스별 또는 상대 URL(예: login.salesforce.com 또는 <mydomain>.my.salesforce.com)로 바꾸십시오.

다음은 하드 코딩된 참조의 예입니다. https://na1.salesforce.com/{Case.Id}
'na1.salesforce.com'을 제거하여 /{Case.Id}로 만들면 상대 참조가 됩니다.

참고: Salesforce에서 상대 참조를 사용하면 올바른 레코드로 자동으로 이동합니다. 외부 요청은 https://na1.salesforce.com 대신 https://login.salesforce.com과 같은 일반 끝점으로 전송되어야 합니다.
 

2. 하드 코딩된 참조는 어떻게 찾을 수 있습니까?

a) 다음과 같이 Lightning Experience 준비 점검 Salesforce 도구에서 하드 코딩된 참조를 찾으면 Lightning Experience의 준비 상태를 알 수 있습니다.
Lightning: 설정 | Lightning Experience | 준비 점검
Classic: 설정 | 'Lightning Experience Migration Assistant' 아래에서 '시작하기' 클릭 | 준비 점검

Lightning Experience 준비 점검 도구로 모든 하드 코딩된 참조를 찾을 수 있는 것은 아닙니다. 이 도구가 보고하는 내용에 대해 자세히 알아보려면 Lightning Experience 점검 도구가 평가하는 항목은?문서를 검토하십시오.

b) Visual Studi용o Code Salesforce 확장 기능을 사용하여 하드 코딩된 참조를 검색합니다.
Visual Studio Code용 Salesforce 확장 기능은 하드 코딩된 참조를 찾을 때 활용할 수 있는 개발자 도구입니다. 조직에서 하드 코딩된 참조*와 조직의 메타데이터(설정 또는 고객 코드)를 업데이트하려면 Visual Studio Code에서 Salesforce 프로젝트 만들기 및 하드 코딩된 참조 검색 기사의 단계를 따르십시오.

3. 통합에서 하드 코딩된 참조는 어떻게 업데이트할 수 있습니까?

Salesforce 제품 또는 Force.com에 대한 통합에는 Force.com API의 login() 요청을 시작점으로 사용하십시오. login() 요청은 일반 끝점(예: https://login.salesforce.com/services/Soap/u/26.0)으로 전송해야 합니다.
login() 호출은 Force.com 세션을 설정하며 로그인 서버 URL로 응답합니다. 이 서버 URL을 이후 API 요청의 대상 서버로 설정한 다음, SOAP 헤더의 반환된 세션 ID를 설정하여 이후 API 요청의 서버 인증을 제공합니다.

인스턴스 새로 고침 및 조직 마이그레이션 관련 FAQ
새 인스턴스로의 이동을 준비할 때 하드 코딩된 참조와 관련하여 궁금한 점이 있을 수 있습니다.

4. 새 인스턴스로 이동한 후 Salesforce 서버에서 리디렉션할 수 있는 하드 코딩된 참조는 무엇입니까?

인스턴스 새로 고침 또는 조직 마이그레이션 후에 일부 하드 코딩된 참조는 리디렉션되지 않으므로 이동하기 전에 내 도메인을 구현하고 모든 하드 코딩된 참조를 제거하는 것이 좋습니다. 다음은 Salesforce 서버가 리디렉션할 수 있는 항목의 목록입니다. 그러나 새 인스턴스로 이동한 후에 이러한 개체를 사용할 때 성능이 저하될 수 있습니다. 

i. 브라우저 링크
ii. 브라우저 북마크에 추가된 URL
iii. 사용자 정의 버튼
iv. 콘텐츠 URL
v. Chatter 게시물
vi. 셀프 서비스 로그인 URL(sserv/login.jsp?orgid)
vii. 통합

5. 새 인스턴스로 이동하기 전에 업데이트해야 하는 하드 코딩된 참조는 무엇입니까(즉 리디렉션되지 않음)?

내 도메인이 활성화되어 있는 경우 이메일 템플릿 및 Knowledge 기사에서 하드 코딩된 참조를 반드시 업데이트해야 합니다.
내 도메인의 활성화 여부에 상관없이, Knowledge 기사와 이메일 템플릿 내의 모든 이미지가 서비스 점검 후에 계속해서 표시되도록 웹 주소가 아닌 컴퓨터에서 업로드되었는지 확인해야 합니다.

i. 이미지가 웹 주소를 통해 삽입된 경우에는 해당 이미지를 컴퓨터에 다운로드하고 Knowledge 기사 또는 이메일 템플릿 내에 이미지를 삽입할 때 "이미지 업로드" 옵션을 선택하여 이미지를 다시 업로드해야 합니다. 적절한 프로세스의 표현을 보려면 다음 다이어그램을 참조하십시오.

참고: 이미지가 컴퓨터에서 업로드되지 않아 서비스 점검 후 해당 이미지가 손상된 경우 이미지 URL의 기존 인스턴스 이름을 새 인스턴스 이름으로 바꿔야 합니다. 그런 다음, 이미지를 컴퓨터에 다운로드하고 향후 서비스 점검 후 이미지가 손상되지 않도록 컴퓨터에서 이미지를 다시 업로드해야 합니다.

6. 내 Knowledge 기사 및 이메일 템플릿 내의 모든 이미지가 웹 주소가 아닌 내 컴퓨터에서 업로드되었는지 어떻게 확인할 수 있습니까?

이미지가 로컬 시스템에서 업로드된 경우 이미지 URL이 “https://[HOST-OR-MY-DOMAIN]/servlet/rtaImage…”로 표시됩니다.

이미지가 웹 주소 또는 문서 탭에서 링크된 경우 이미지 URL이 “https://[HOST-OR-MY-DOMAIN]/servlet/servlet.ImageServer...” 또는 “https://[HOST-OR-MY-DOMAIN]/servlet/servlet.FileDownload…”로 표시됩니다.

7. 새 인스턴스로 이동하는 경우 CTI 통합의 하드 코딩된 참조를 업데이트해야 합니까?

Open CTI를 사용하고 있으며 콜센터 정의의 CTI Adapter URL이 Salesforce 인스턴스로 하드 코딩된 경우(예: https://c.na6-visual.force.com/apex/Softphone), CTI 통합에 영향을 미칩니다.
이 하드 코딩된 참조를 상대 URL(예: /apex/Softphone)로 변경하여 새 인스턴스로 이동한 후에도 CTI 통합이 계속 작동하도록 하십시오. 이렇게 업데이트하려면 콜센터 개체의 특정 클릭 경로인 설정 > Call Center로 이동하십시오.

Salesforce Desktop CTI 통합 툴킷을 사용하는 경우 하드 코딩된 참조를 허용하지 않으므로 이 서비스 점검이 CTI 통합에 영향을 미치지 않습니다.

8. 새 인스턴스로 이동하는 경우 이메일 스레드 ID를 업데이트해야 합니까?

사용자 정의 이메일 스레드 ID를 만든 경우 새 인스턴스로 이동한 후에 영향을 받을 수 있습니다. 만들지 않은 경우 새 인스턴스로 이동한 후에 Salesforce에서 생성한 기존 이메일 스레드 ID를 업데이트하지 않아도 됩니다(기존 인스턴스 이름이 계속 참조되는 경우에도).

사용자 정의 생성 이메일 스레드 ID를 수정하려면 다음 단계를 검토하십시오.
i. 사용자 정의 수식을 ref:_00D[XX][yyyyy]._500[AA][bbbbb]:ref 형식으로 업데이트합니다.
ii. 여기서 yyyyy와 bbbbb는 앞에 나오는 0을 제거한 10자 ID입니다.
iii. 시스템 코드에서 구문 분석할 수 있는 이메일 스레드 ID는 다음과 같습니다(yyyyy와 bbbbb는 앞에 나오는 0을 제거한 레코드 ID).

참고: ref:00DXyyyyy.500Abbbbb:ref는 이제 사용하지 않는 이전 형식입니다.

시간이 흐름에 따라 Salesforce가 형식을 변경할 수 있으므로 고객은 자체 스레드 ID 생성을 삼가야 합니다. 사용자 정의 스레드 ID를 사용하면 새 사례가 만들어진 후 원래 사례에 답변이 포함되어 첨부되지 않는 주문형 E2C(Email-To-Case) 문제가 발생할 수 있습니다. 자체 사용자 정의 스레드 ID 형식을 생성하지 마십시오. 저희는 사례 스레드 ID에 대해 사용자 정의 수식을 공식적으로 지원하지 않습니다. 따라서 고객께서는 Salesforce가 기본으로 제공하여 생성되는 스레드 ID 수식을 사용하는 것이 좋습니다. 사용자 정의 형식을 사용하지 않아야 하는 이유에 대한 자세한 내용은 Email-to-Case에서 사용자 정의 스레드 ID 사용 기사를 검토하십시오.

9. 새 인스턴스로 이동한 이후에도 고객들이 예전 인스턴스 URL에서 파트너 포털에 액세스할 수 있습니까?

고객은 새 인스턴스로 이동한 후 약 30일 동안 예전 인스턴스 URL을 사용하여 파트너 포털에 액세스할 수 있습니다. 그러나 30일의 기간이 지난 후에는 예전 인스턴스 로그인 URL이 해제됩니다. 관리자들은 새 인스턴스로 이동하기 전에 조직 파트너 포털의 "시스템 서비스 점검" 메시지를 추가하여 새 인스턴스로 이동한 후 고객들이 새 파트너 포털 URL을 사용하도록 안내하는 것이 좋습니다. 또한 관리자는 고객들이 새 파트너 포털 URL을 로그인 북마크에 업데이트하도록 제안할 수 있습니다.

10. 새 인스턴스로 이동하면 W2X(Web-to-Leads/Cases)에 영향을 미칩니까?

W2X에 하드 코딩된 참조가 있는 경우 새 인스턴스로 이동하기 전에 참조를 관련 URL로 업데이트해야 합니다. 하드 코딩된 참조를 업데이트하지 않을 경우 서비스 점검 후 의도치 않은 W2X 서비스 중단이 발생할 수 있습니다. 서비스 점검이 완료되면 W2X가 대기열에 지정된 후 처리됩니다.

11. 새 인스턴스로 이동한 후 원격 사이트 이름을 업데이트해야 합니까?

예. 내 도메인을 사용할 경우, 서비스 점검 직후 원격 사이트 이름의 하드 코딩된 참조를 새 인스턴스 이름으로 업데이트해야 합니다.
서비스 점검 후 원격 사이트 이름의 하드 코딩된 참조를 업데이트하지 않을 경우 의도치 않은 원격 사이트 서비스 중단이 발생할 수 있습니다.

12. 새 인스턴스로 이동하면 Salesforce 모바일 SDK에도 영향이 미칩니까?

사용자가 최신 버전을 보유하고 있지 않을 경우 새 인스턴스로 이동하면 Salesforce 모바일 SDK 생성 앱의 데이터가 영향을 입게 됩니다. 서비스 점검 작업 전에 모든 Salesforce 모바일 SDK 생성 앱을 업데이트하고 업데이트를 조직 내 모든 사용자에게 푸시하는 것이 좋습니다.
사용자가 모든 Salesforce 모바일 SDK 생성 앱 최신 버전을 보유하고 있는 경우 새 인스턴스는 앱의 데이터에 영향을 미치지 않습니다.

13. Live Agent 또는 SOS 구현이 있는 경우 어떻게 합니까?

웹 페이지 또는 인증서에 Live Agent 끝점 URL에 대한 하드 코딩된 참조가 있는 경우 인스턴스 새로 고침, 조직 마이그레이션 또는 사이트 전환이 Live Agent/SOS 기능에 영향을 줄 수 있습니다. 영향을 최소화하려면 모범 사례를 따르고 끝점에 하드 코딩된 참조를 사용하지 마십시오. 또한 설정의 배포 페이지에서 복사한 배포 코드의 끝점 URL을 업데이트하십시오. 제공해드린 배포 코드에는 새로 할당된 서버로 리디렉션할 수 있는 기능이 있지만 새로 고침이 완료되는 즉시 끝점을 업데이트해야 합니다. 

Live Agent 끝점과 하드 코딩된 끝점이 의미하는 내용에 대한 자세한 내용은 Live Agent 서버(끝점 URL)가 변경되었고 이제 Live Agent 채팅은 더 이상 작동하지 않습니다 기사를 검토하십시오.

14. Apex 웹 서비스 생성 WSDL에 필요한 조치는 무엇입니까?

WSDL을 사용하여 코드를 생성하는 경우 코드를 이용한 모든 영역에서 하드 코딩된 참조를 확인해야 합니다. 하드 코딩된 참조를 모두 내 도메인 URL 또는 상대 URL(login.salesforce.com)로 업데이트해야 합니다. 새 인스턴스로 이동하기 전에 내 도메인을 구현하는 것이 좋습니다. 이렇게 하면 하드 코딩된 참조가 모두 새로운 내 도메인 URL을 가리키도록 수정할 때 이 작업을 다시 수행할 필요가 없습니다.