사용자 정의 심볼 집합 추가—Esri Maps for IBM Cognos

Esri Maps for IBM Cognos는 맵에서 포인트 피처를 스타일 지정하는 데 사용하는 기본 심볼 집합을 제공합니다. 기본 심볼 수정 외에도 관리자는 사용자 정의 심볼 집합을 그림 표식 심볼 보고서 작성자의 목록에 추가할 수 있으며 사용자는 맵을 스타일 지정하도록 사용합니다.

Esri Maps for IBM Cognos에서 사용자 정의 그림 표식 심볼은 테마에 따라 폴더에 패키지됩니다. 이러한 사용자 정의 그림 표식 집합 폴더는 esri-maps-em4c 익스텐션 팩 폴더에 추가됩니다.

사용자 정의 그림 표식 심볼 집합 폴더에는 다음이 포함되어 있습니다.

테마가 지정된 그림 표식 심볼 파일 집합
집합에 있는 각 그림 표식을 설명하는 그림 표식 집합 정의 파일(JSON)

사용자 정의 그림 표식 심볼 집합을 생성하여 esri-maps-em4c 익스텐션 팩 폴더에 추가하면 사용자 정의 심볼 집합을 포함하도록 익스텐션 팩 매니페스트 파일을 수정해야 합니다.

참고 사항:

이러한 단계는 해당 환경의 모든 EM4C Server에서 완료해야 합니다.

사용자 정의 심볼 집합 폴더 생성

esri-maps-em4c 익스텐션 팩 폴더 내부에 폴더를 생성하여 심볼 집합 파일을 저장합니다.

<em4c_location>\webcontent\esrimap\esri-maps-em4c(으)로 이동합니다.
새 폴더를 생성하고 그림 표식 집합 테마에 따라 이름을 지정합니다(예: CrimeSymbols).
새 폴더에서 images(이)라는 이름의 하위 폴더를 생성합니다. 이 폴더는 생성한 그림 표식 심볼 파일을 저장합니다.

사용자 정의 그림 표식 생성

심볼 드롭다운 메뉴와 맵에서 심볼이 올바르게 보이도록 하려면 20x20 픽셀의 사용자 정의 그림 표식 심볼을 생성하고 PNG 형식으로 저장하여 투명도를 유지합니다.

선호하는 그래픽 소프트웨어를 사용하여 데이터를 가장 잘 나타내는 심볼 계열을 생성합니다.
맵에서 최상의 가시성을 확보하려면 심볼을 단순하게 유지합니다. 심볼 드롭다운 메뉴와 맵에서 심볼이 올바르게 보이도록 하려면 20x20 픽셀의 사용자 정의 그림 표식 심볼을 생성하고 PNG 또는 JPG 형식으로 저장합니다. PNG 형식을 사용하여 다음 이미지에 보이는 대로 투명도를 유지합니다.
JPG 심볼
투명도가 포함된 PNG 심볼
생성한 images 폴더에서 이미지 파일을 저장합니다(예: CrimeSymbols\images).

그림 표식 집합 정의 파일 생성

그림 표식 집합 정의는 집합에서 각 그림 표식 심볼을 설명하는 JSON 파일입니다.

다음 JSON 예에서 3개의 각 사용자 정의 심볼 표식(*.png)은 별도의 개체입니다. 개체는 중괄호({ })로 닫혀있으며 쉼표로 구분됩니다. 여러 개체는 배열을 나타내도록 대괄호([ ])로 닫혀 있습니다. 각 JSON 개체는 데이터를 나타내는 이름값 쌍 형식으로 된 등록정보를 포함합니다.

[
    {
        "type": "esriPMS",
        "url": "esri-maps-em4c/CrimeSymbols/images/crimeSymbol1.png",
        "width": "20",
        "height": "20",
        "xoffset": "0",
        "yoffset": "10"
    },
    {
        "type": "esriPMS",
        "url": "esri-maps-em4c/CrimeSymbols/images/crimeSymbol2.png",
        "width": "20",
        "height": "20",
        "xoffset": "0",
        "yoffset": "10"
    },
    {
        "type": "esriPMS",
        "url": "esri-maps-em4c/CrimeSymbols/images/crimeSymbol3.png",
        "width": "20",
        "height": "20",
        "xoffset": "0",
        "yoffset": "10"
    }
]

집합에 있는 각 그림 표식 심볼의 경우 다음 등록정보를 포함하는 JSON 개체를 생성합니다. 유형, url, 너비, 높이 등록정보가 필요합니다. 기타 항목은 선택 사항입니다.

유형 - 심볼 유형을 지정합니다. 그림 표시 심볼의 유형 등록정보는 esriPMS입니다.
url - 서버에서 이미지를 검색하는 데 사용되는 URL을 지정합니다.
너비 - 심볼의 너비를 포인트로 지정합니다. 기존 크기로 심볼을 나타내려면 너비와 높이 등록정보를 생략합니다. 심볼 이미지 크기를 다시 조정하려면 원하는 높이만 포인트로 지정합니다.
높이 - 심볼의 높이를 포인트로 지정합니다. 기존 크기로 심볼을 나타내려면 너비와 높이 등록정보를 생략합니다. 심볼 이미지 크기를 다시 조정하려면 원하는 높이만 포인트로 지정합니다.

선택 등록정보에는 다음이 포함됩니다.

xoffset - 실제 포인트 위치에서 표시 심볼의 수평 오프셋을 지정합니다. 오른쪽에 양수값 오프셋, 왼쪽에 음수값 오프셋.
yoffset - 실제 포인트 위치에서 표시 심볼의 수직 오프셋을 지정합니다. 위로 양수값 오프셋, 아래로 음수값 오프셋.
각도 - 표시 심볼이 회전되는 도수의 숫자를 지정합니다(0~360). 회전은 동쪽이 0° 축인 위치에서 반시계 방향으로 동쪽에서 일어납니다.
imageData - base-64로 인코딩된 이미지 데이터를 지정합니다. 이는 ArcGIS Online에서 레이어 또는 맵을 공유하는 경우에만 사용됩니다.
contentType - 이미지 데이터의 유형을 지정합니다(예: image/png). imageData가 지정된 경우에만 사용됩니다.

새 심볼 집합 폴더(예: CrimeSymbols)에서 새 JSON 파일을 생성하고, 사용자 정의 표식 집합 테마에 따라 이름을 지정하고, .json.txt 확장명을 붙입니다(예: crimeSymbols.json.txt).
팁:
<em4c_location>\webcontent\esrimap\esri-maps-em4c\symbols.json.txt.default에서 Esri Maps for IBM Cognos가 제공된 예를 참고하세요.
선호하는 텍스트 편집기를 사용하여 별도의 라인에서 대괄호를 열기 및 닫기를 입력하여 배열을 생성합니다. 이 배열은 그림 표식 심볼을 설명하는 JSON 개체를 포함합니다. 예:
```
[
]
```
JSON 개체를 생성하여 첫 번째 사용자 정의 그림 표식을 설명합니다.
배열 괄호 내에 중괄호 집합을 입력한 다음 그림 표식 심볼을 설명하는 필수 이름값 쌍을 입력합니다. 각 등록정보를 쉼표로 구분하고 큰따옴표로 각 이름값 요소를 닫아야 합니다. 쉽게 읽을 수 있도록 코드를 적합하게 들여씁니다. 예:
```
[	
	{
		“type” : “esriPMS”,
		“url” : “esri-maps-em4c/CrimeSymbols/images/symbol1.png”,
		“width” : “20”,
		“height” : “20”,
		“xoffset” : “0”,
		“yoffset” : “10”

	}
]
```

집합에서 각 그림 표식 심볼에 새 JSON 개체를 생성하여 이전 개체의 중괄호를 닫은 후 쉼표를 추가합니다. 배열의 마지막 개체 다음에는 쉼표가 필요하지 않습니다. 예:

[	
	{
		“type” : “esriPMS”,
		“url” : “esri-maps-em4c/CrimeSymbols/images/symbol1.png”,
		“width” : “20”,
		“height” : “20”,
		“xoffset” : “0”,
		“yoffset” : “10”

	},
	{
	...
	}
]

JSONLint 등의 유효성 검사 도구를 사용하여 JSON 코드를 검증합니다.
정의 파일을 저장하고 닫습니다.

매니페스트 파일 수정

esri-maps-em4c 익스텐션 팩 폴더에는 다른 도구와 동작 외에도 Esri Maps for IBM Cognos에 대해 생성하는 사용자 정의 그림 표식 집합을 정의하는 manifest.json.txt라는 이름의 매니페스트 파일을 포함합니다. 사용자 정의 그림 표식 집합을 이 파일에 추가하려면 집합 정의 파일의 위치와 이름뿐만 아니라 집합에 대한 이름과 레이블을 지정합니다.

<em4c_location>\webcontent\esrimap\esri-maps-em4c(으)로 이동합니다.
텍스트 편집기에서 manifest.json.txt(을)를 엽니다.
사용자 정의 그림 표식 집합을 포함하도록 파일을 수정합니다. 예를 들어 다음 코드를 파일 끝에 추가합니다.
```
,
	"pictureMarkerSets": [{
		"name": "crimesymbols",
		"label": "Crime Symbols",
		"location": "./CrimeSymbols/CrimeSymbols.json.txt"
	}]
```
이름 등록정보는 집합의 이름을 참고합니다.
레이블 등록정보는 사용 가능한 심볼 집합의 드롭다운 메뉴에 나타나는 레이블을 지정합니다.
위치 등록정보는 사용자 정의 그림 표식 집합의 정의 파일 위치를 나타냅니다(예: crimeSymbols.json.txt).
팁:
<em4c_location>\webcontent\esrimap\esri-maps-em4c\manifest.json.txt.default에서 Esri Maps for IBM Cognos가 제공된 예를 참고하세요.
JSONLint 등의 유효성 검사 도구를 사용하여 업데이트된 JSON 코드를 검증합니다.
파일을 저장하고 닫습니다.

사용자 정의 그림 표식 심볼 테스트

사용자 정의 그림 표식을 Esri Maps for IBM Cognos 보고서 작성자 및 사용자가 사용할 수 있는지 확인합니다.

웹 서버를 다시 시작하고 브라우저 캐시를 지웁니다.
Esri Maps Designer에서 맵을 열어 편집합니다.
맵의 콘텐츠 창에서 아이콘 심볼로 스타일 지정한 포인트 레이어를 확장하고 심볼 집합 목록을 확인할 아이콘을 클릭합니다. 사용자 정의 그림 표식 집합은 목록 하단에 나타납니다.
해당 심볼이 목록에 나타나는지 확인하려면 Cognos Connection에서 보고서를 확인하여 사용자 모드에서 동일한 테스트를 수행합니다.

이제 사용자 정의 그림 표식 집합을 사용할 준비가 되었습니다.

이 항목에 대한 피드백?