백엔드 통합 이슈 해결

증상

1. 백엔드 API를 수동으로 구현하거나 우리의 튜토리얼을 따라 시도하지만, 페이지를 열었을 때 Gantt에 작업이나 링크가 보이지 않습니다.

또는

2. 백엔드에 변경 사항을 저장하는 데 문제가 있습니다.

원인

다양한 플랫폼에서 잘못된 동작에 대한 원인과 해결책은 여러 가지가 있을 수 있으며, 이 글에서 다루지 않겠습니다.

여기에서의 목표는 이러한 유형의 이슈를 조사하는 일반적인 절차를 안내하는 것입니다. 문제를 찾아 내고 앱이 왜 작동하지 않는지 이해하면 대개 해결책은 사소합니다.

페이지에서 오류 메시지 확인

1. 브라우저 개발자 도구를 열고 페이지를 다시 로드합니다. 브라우저 콘솔에 오류 메시지가 보이나요?

2. 있다면, 오류를 평가하고 스스로 처리할 수 있는지 결정합니다. 그렇지 않다면 다음 단계로 진행합니다.

클라이언트가 요청한 내용 확인

1. Network 패널을 열고 XHR 요청이 보이도록 합니다.

2. 페이지를 다시 로드하고 백엔드에서 데이터를 로드해야 하는 요청을 찾습니다. 올바른 URL로 전송되는지 확인하고 응답 상태를 확인합니다.

오류가 있나요?

404 응답 상태는 gantt.init 메서드에 잘못된 URL이 전달되었거나 애플리케이션의 라우팅 설정에 문제가 있음을 의미합니다.

서버에서 반환되는 내용 확인

해당 요청을 선택하고 응답 미리보기나 원시 응답 콘텐츠를 확인합니다.

응답이 예상 데이터 형식과 유사하게 보이나요?

웹 서버에서 Gantt 데이터 대신 오류 메시지가 보이는 경우

백엔드 코드나 데이터베이스 연결 설정에 문제가 있을 가능성이 큽니다. 일반적으로 오류 응답에는 문제의 원인을 파악하는 데 충분한 정보가 포함되어 있습니다. 500 server error와 같은 일반적인 메시지가 보이면 실제 오류를 확인하기 위해 서버의 커스텀 에러 페이지를 일시적으로 비활성화해야 할 수 있습니다. 플랫폼마다 방법이 다릅니다. 어디서부터 시작해야 할지 확실하지 않다면 "disable custom error page in (your server or framework)"를 구글에서 검색해 보세요.

데이터가 대체로 괜찮아 보이는 경우

다음 속성들을 확인해 보십시오: id, start_date, end_date, duration, parent.

• id - 같은 id를 가진 항목은 병합됩니다. 동일한 id를 가진 다섯 개의 작업이 있으면 Gantt는 그 중 하나만 표시합니다.

• parent - parent 값이 root_id 설정과 일치하는 항목은 작업 트리의 루트 레벨에 표시됩니다(기본값은 빈 값으로 간주되며, 0이나 null 포함). 만약 parent 속성이 비어 있지 않으나 데이터 세트에 적절한 상위 작업이 없으면 해당 항목은 전혀 표시되지 않습니다.

• start_date, end_date, duration - 항목에 이 세 속성 중 최소 두 가지가 포함되어 있는지 확인합니다(예: start_date+duration). 데이터 로딩에 대한 자세한 내용은 Data Loading 문서를 참조하십시오.

Gantt의 date_format 설정에서 지정한 형식과 start_date/end_date 형식이 일치하는지 확인합니다.

속성 값에서 이상한 점 발견

데이터베이스에 저장된 내용을 확인하세요. 문제의 원인이 그곳에 있을 가능성이 큽니다. 날짜 형식이 일치하지 않는 경우, date_format 설정을 변경하거나 클라이언트로 출력되기 전에 작업 날짜를 직렬화하는 코드를 수정하세요.

Gantt에 로드되는 내용 확인

1. 브라우저 콘솔을 열고 gantt.getTaskByTime()을 실행합니다.

2. 콘솔 출력을 확인합니다. 아마도 작업 배열이 보일 것입니다.

다시 한 번 start_date, end_date 및 parent 속성을 확인할 수 있습니다.

필터

거기에서 명백한 문제가 보이지 않는다면, 코드도 확인해 보세요. 아마도 작업이 필터에 의해 숨겨져 있을 수 있습니다.

마지막 수단

위의 방법들 중 어느 것도 도움이 되지 않거나, 작업도 콘솔 오류도 보이지 않는 경우 저희 포럼에 질문을 남기십시오 또는 이 이슈에 대해 기술 지원에 문의하십시오.

또한, 위의 단계를 따라 수집한 모든 정보를 제공해 주세요.

또한 저희 팀은 최소 재현 가능한 데모가 필요합니다: 간소화된 앱을 포함한 독립 실행형 패키지( gantt 페이지, 필요한 모든 파일, 테스트 데이터를 포함한 데이터베이스 덤프, 또는 로드하려는 데이터를 담은 정적 JSON 파일), 혹은 브라우저에서 이슈를 확인할 수 있는 온라인 링크.