차트 조회하기

뒤끝 콘솔 사이트에 등록한 차트를 조회하는 기능을 제공합니다.
이 차트는 뒤끝 콘솔의 차트 관리 항목에서 업로드하여 적용한 엑셀파일의 데이터 입니다.
엑셀 데이터의 형식은 첫번째 컬럼의 이름이 num이어야 하고, 그 값은 숫자이며 유일해야합니다.

차트 리스트 조회하기

콘솔에서 만든 차트의 리스트를 받아오는 기능입니다.

  • 차트의 명과 차트의 ID/UUID, 차트의 버전이 리턴됩니다.
  • 차트의 데이터는 포함되어 있지 않습니다.

동기

GetChartList ( ) -> BackendReturnObject

// example
Backend.Chart.GetChartList();

비동기

GetChartList ( Function callback ) -> void

// example
Backend.Chart.GetChartList( ( callback ) => 
{
    // 이후 작업
});

결과값 예시

{
    rows:
    [
        // version 1 (old)
        // selectedChartFile 이 없는 경우
        {
            // 차트 uuid
            uuid: { S: "538b3a20-7b7a-11e8-8002-f31a1dd37719" },
            // 차트 indate
            inDate: { S: "2018-06-29T08:56:35.266Z" },
            // 차트 설명
            chartExplain: { S: "2" },
            // 차트명
            chartName: { S: "v1" },
            // version 정보 (y: version1 , n: version2)
            old: { S: "y" }
        },
        // version 1 (old)
        // selectedChartFile 이 있는 경우
        {
            // 차트에 적용한 파일 정보
            selectedChartFile:
            {
                M:
                {
                    // 차트의 row 수
                    count: { N: "1000" },
                    // 차트 파일 uuid
                    uuid: { S: "780932f0-75fb-11e8-bf7a-cbcc37090d69" },
                    // 차트 파일 indate
                    inDate: { S: "2018-06-22T09:05:54.591Z" },
                    // 차트 파일 명
                    chartFileName: { S: "222222.xlsx" }
                }
            },
            // 차트 indate
            inDate: { S: "2018-06-22T09:05:38.562Z" },
            // 차트 uuid
            uuid: { S: "6e7b5e20-75fb-11e8-bf7a-cbcc37090d69" },
            // 차트 설명
            chartExplain: { S: "v1" },
            // 차트명 (이 이름으로 PlayerPrefs에 selectedChartFile에 대한 차트 내용이 저장 됨)
            chartName: { S: "23" },
            // version 정보 (y: version1 , n: version2)
            old: { S: "y" }
        },
        // version 2 (new)
        // selectedChartFile 이 없는 경우
        {
            // 차트명
            chartName: { S: "gggg" },
            // 차트 설명
            chartExplain: { NULL: true },
            // 적용된 차트 파일 id ( 없는 경우 )
            selectedChartFileId: { NULL: true },
            // version 정보 (y: version1 , n: version2)
            old: { S: "n" }
        },
        // version 2 (new)
        // selectedChartFile 이 있는 경우
        {
            // 차트명
            chartName: { S: "ㅎㅇㅎㅇ" },
            // 차트 설명
            chartExplain: { NULL: true },
            // 적용된 차트 파일 id ( 있는 경우 )
            selectedChartFileId: { N: "47" },
            // version 정보 (y: version1 , n: version2)
            old: { S: "n" }
        }
    ]
}

차트 내용 조회하기

한 가지 차트에 대하여 콘솔에서 적용한 엑셀파일의 데이터를 받아오는 기능입니다.

주의
OLD 차트를 사용하는 경우 GetChartContents함수를 호출하기 전에 반드시 GetChartList함수를 호출해야 합니다.

동기

GetChartContents ( String selectedChartFileId ) -> BackendReturnObject

// example
// 해당 uuid 의 차트 내용을 받아옴
Backend.Chart.GetChartContents(selectedChartFileId);

비동기

GetChartContents ( String selectedChartFileId, Function callback ) -> void

// example
// 해당 uuid 의 차트 내용을 받아옴
Backend.Chart.GetChartContents( selectedChartFileId, ( callback ) =>
{
    // 이후 작업
});

Parameter

ValueTypeDescription
ChartUuidString차트 파일의 uuid 혹은 id
[version1] : bro.GetReturnValuetoJSON()["rows"][i]["selectedChartFile"]["M"]["uuid"]["S"]
[version2] : bro.GetReturnValuetoJSON()["rows"][i]["selectedChartFileId"]["N"]

Error case

  • 올바르지 못한 { uuid | id } 를 입력한 경우
    statusCode : 400
    errorCode : BadParameterException
    message : bad chart { uuid | id }, 잘못된 chart { uuid | id } 입니다

결과값 예시

{
    rows:
    [
        {
            num: { S: "1" }, // row num(번호)
            column1: { S: "contents1" },
            column2: { S: "contents2" },
            column3: { S: "contents3" }
        },
        {
            num: [Object],
            column1: [Object],
            column2: [Object],
            column3: [Object]
        }
    ]
}