참고: 이 문서는 현재 엔터프라이즈 플랜 고객에게 활성화된 새로운 샌드박스에 관한 것입니다. Freshservice의 현재 샌드박스 버전을 보려면 여기를 클릭하세요. 단계적 폐지 계획에 대해 알아보려면 여기를 클릭하세요.
일부 고객의 워크플로우 자동화 도구가 웹 요청 노드나 Webhook 액션 노드에서 하드코딩된 ID를 사용하고 있음을 확인했습니다. 이 문서는 워크플로우 자동화 도구에서 하드코딩된 ID를 플레이스홀더로 대체하는 방법에 대한 정보를 포함하고 있습니다.
샌드박스에서 워크플로우 실행 실패를 방지하려면 하드코딩된 ID를 플레이스홀더로 대체하세요. 이 변경은 엔터티 ID(예: 티켓 ID, 상담원 ID, 자산 ID)가 샌드박스와 프로덕션 환경 간에 다르기 때문에 필요합니다.
아래는 워크플로우에 하드코딩된 ID가 존재할 수 있는 시나리오입니다. 계정에서 유사한 문제를 식별하고 수정하여 원활한 샌드박스 경험을 누리세요.
시나리오 1: 웹 요청 엔드포인트에 하드코딩된 ID
예시: 상담원을 그룹에 추가하는 워크플로우가 API 엔드포인트에서 상담원 ID를 사용할 수 있습니다. 예를 들어:
http://accountname.freshservice.com/api/v2/agents/233234
샌드박스에서는 상담원 ID가 변경되어(예: 233234에서 456422로) 워크플로우 실행이 실패하게 됩니다.
예상 조치: 엔드포인트 URL에 플레이스홀더를 사용하세요:
http://accountname.freshservice.com/api/v2/agents/{{ticket.agent.id}}
프로필을 업데이트해야 하는 상담원이 티켓의 상담원이 아니거나 상담원의 ID가 없는 경우, 다른 웹 요청 노드를 사용하여 상담원의 ID를 파악한 후 리더 플레이스홀더를 사용하십시오.
시나리오 2: JSON 페이로드에 하드코딩된 ID
예시: 사용자의 보고 관리자 정보를 업데이트하는 워크플로우가 JSON 페이로드에 하드코딩된 보고 관리자 ID를 사용할 수 있습니다:
{
"reporting_manager_id": 453
}
샌드박스에서는 보고 관리자 ID가 변경되어(예: 453에서 678로) 워크플로우 실행이 실패할 수 있습니다.
예상 조치: JSON 페이로드에 플레이스홀더를 사용하십시오:
{
"reporting_manager_id": {{ticket.requester.reporting_manager.id}}
}
필요한 보고 관리자 ID가 요청자의 보고 관리자가 아니거나 티켓에 ID가 없는 경우, 다른 웹 요청 노드를 사용하여 ID를 파악한 후 리더 플레이스홀더를 사용하십시오.
시나리오 3: 필드 이름에 하드코딩된 ID
예시: 자산을 업데이트하는 워크플로우가 사용자 정의 필드 이름에 하드코딩된 자산 유형 ID를 사용할 수 있습니다:
{
"macosversion_54456": "Catalina"
}
샌드박스에서는 자산 유형 ID가 변경됩니다(예: 54456에서 86823으로), 이로 인해 워크플로우 실행이 실패할 수 있습니다.
예상 조치: API 요청 페이로드의 필드 이름에 플레이스홀더를 사용하세요:
{
"type_fields": {
"macosversion_{{ci_type_id}}": "Catalina"
}
}
자산 유형 ID를 업데이트해야 하는 자산이 티켓에 없거나 사용할 수 없는 경우, 다른 웹 요청 노드를 사용하여 이를 유도한 후 리더 플레이스홀더를 사용하세요.
프로 팁: 이 기회를 활용하여 새로운 샌드박스를 시도해 볼 수 있습니다. 아직 전환하지 않았다면 새로운 샌드박스로 전환하세요. 샌드박스를 생성하고 이러한 변경을 수행한 후 테스트 결과가 만족스러우면 변경 사항을 프로덕션 계정에 동기화하세요.
질문이 있으시면 support@freshservice.com으로 문의해 주세요.