사용자 정의 모양 렌더링

사용자 정의 모양을 다음과 통합할 수 있습니다. MicroStrategy 데이터를 수집하고 클라우드 기반 ESRI 지도에 렌더링합니다. 사용자 정의 모양을 에서 제공하는 기본 모양과 통합하려면 MicroStrategy, 아래 설명된 대로 플러그인에서 지리적 모양 구성 파일을 수정하고 KML 형식의 맞춤 모양 파일을 추가합니다.

지도의 맞춤 모양을 정의하는 KML 파일을 만들거나 가져옵니다.
ESRI 지도 시각화가 사용자 정의 모양을 사용할 수 있도록 지리 모양 구성 파일을 수정합니다.
사용자 정의 모양을 사용할 수 있는지 확인

제공된 ESRI 지도 시각화 플러그인을 다운로드하고 아래 단계를 따르세요.

지도의 맞춤 모양을 정의하는 KML 파일을 만들거나 가져옵니다.

이미 가지고 있는 KML 파일을 사용하거나 새 파일을 만들 수 있습니다. KML은 2차원 지도와 3차원 어스 브라우저에 지리 데이터를 표시하는 데 사용되는 파일 형식입니다. 샘플 KML 파일의 코드 조각은 다음과 같습니다.
복사
```
<?xml version="1.0" encoding="UTF-8"?>
<kml xmlns="http://www.opengis.net/kml/2.2">
    <Document>
        <Placemark>
            <name>attribute value</name>
            <ExtendedData>
                <Data name="attribute key">
                    <DisplayName>attribute display value</DisplayName>
                    <Value>attribute value</Value>
                </Data>
            </ExtendedData>
...
            <Polygon>
                <outerBoundaryIs>
                    <LinearRing>
                        <coordinates>set of custom shape coordinates</coordinates>
                    </LinearRing>
                </outerBoundaryIs>
            </Polygon>
        </Placemark>
...
    </Document>
</kml>
```
각 <Placemark> 요소에는 사용자 정의 모양 중 하나에 대한 모양 정의 데이터가 포함되어 있습니다. 또한 각 모양을 해당 데이터와 일치시키는 데 필요한 정보도 포함되어 있습니다.
- 기본적으로 <name> 요소는 데이터를 모양과 일치시키는 데 사용됩니다. 해당 값은 다음과 일치해야 합니다. MicroStrategy 지도에서 사용되는 속성 요소 데이터입니다. 예를 들어 사용자 정의 모양이 상태인 경우 <name> 요소는 "Maryland" 또는 "California"일 수 있습니다.
- <를 추가하여 기본 일치 동작을 재정의할 수 있습니다.ExtendedData> 요소를 다음의 자식으로 사용 <Placemark>. 이를 통해 사용자 정의 모양을 여러 방법으로 식별된 데이터와 일치시킬 수 있어 유연성이 제공됩니다. 예를 들어 KML 파일의 도형을 주 이름 외에 주 이름이나 개체 ID의 약어로 식별되는 주 데이터와 일치시키려는 경우 이 작업을 수행할 수 있습니다.
- 그만큼 <coordinates> 요소(의 하위 <Polygon><outerBoundaryIs><LinearRing>)에는 각 사용자 정의 모양의 정의가 포함되어 있습니다. 정의는 모양의 윤곽을 결정하는 경도, 위도 및 선택적 고도로 설명되는 일련의 점입니다.
ESRI 모양 파일과 KML 모양 파일 모두의 모양 유형에는 다각형만 지원됩니다.

좌표계는 다음과 같아야 합니다. WGS 84.

다음을 수행합니다.
- 맞춤 모양을 정의하는 KML 파일에 다음과 같은 의미 있는 이름을 지정하세요. CustomCountyShapesFile.kml를 사용하여 ESRI Map 시각화 플러그인 폴더에 저장합니다.
- KML 파일을 플러그인에 직접 저장하거나, 플러그인에 kml 폴더를 만들고 사용자 정의 모양 파일을 kml 폴더 아래에 저장하세요.

ESRI 지도 시각화가 사용자 정의 모양을 사용할 수 있도록 지리적 모양 구성 파일을 수정합니다.

로 이동 mstrGeoShapesConfig.xml, 아래에 위치 xml/config 플러그인 폴더에 있는 파일을 텍스트 편집기에서 엽니다. 파일에는 아래 표시된 샘플과 같은 코드가 포함되어야 합니다.

복사

<layers>
    <layer id="900" title="Custom County Map Layer" ml="CustomCountyShapesFile.kml">
        <shapeKeys>
            <shapeKey key="name" path="/ExtendedData/Data[@name='name']/value"/>
            <shapeKey key="abbr" path="/ExtendedData/Data[@name='abbreviatedName']/value"/>
            <shapeKey key="id" path="/ExtendedData/Data[@name='object_id']/value"/>
        </shapeKeys>
    </layer>
</layers>
<shapes>
    <shape id="901"
        custom="true"
        plugin="ConnectorForMap"
        desc="Custom Counties by Name"
        descWeb="mstrweb.7777n"
        descFlash="mstr.6666n"
        descDesktop="5555n"
        roleId="9"
        type="Polygon"
        default="false"
        shapeCat="1004"
        shapeKey="name"
        layerId="900"
        sf="name"
        sfr="2"
    />
    <shape id="902"
    custom="true"
    plugin="ConnectorForMap"
    desc="Custom Counties by Abbreviation"
    descWeb="mstrweb.7777a"
    descFlash="mstr.6666a"
    descDesktop="5555a"
    roleId="9"
    type="Polygon"
    default="false"
    shapeCat="1004"
    shapeKey="abbr"
    layerId="900"
    sf="name"
    sfr="2"
    />
    <shape id="903"
        custom="true"
        plugin="ConnectorForMap"
    desc="Custom Counties by ID"
    descWeb="mstrweb.7777i"
    descFlash="mstr.6666i"
    descDesktop="5555i"
    roleId="9"
    type="Polygon"
    default="false"
    shapeCat="1004"
    shapeKey="id"
    layerId="900"
    sf="name"
    sfr="2"
    />
</shapes>

환경에 맞게 지리적 모양 구성 파일을 사용자 정의하려면 아래 내용을 변경하세요. 변경해야 하는 값은 위의 코드 샘플에서 굵게 표시되어 있습니다.

• 아이를 위해 <layer> 부모 아래의 요소 <layers> 요소에서 다음을 수행합니다.

에 대한 id 속성에서 "900"을 고유한 값(이미 사용된 값이 아님)으로 바꾸십시오. MicroStrategy 지도 레이어의 경우). 이 값은 사용자 정의 모양을 사용하는 지도 레이어를 고유하게 식별합니다. 이는 다음에서 참조됩니다. layerID 의 속성 <shape> 요소.

여러 <shape> 요소는 동일한 지도 레이어(즉, 동일한 KML 파일)를 사용할 수 있지만 모양과 데이터(예: 이름, 약어, ID)를 일치시키기 위해 서로 다른 키를 사용할 수 있습니다. 일치하는 데 사용되는 키는 다음에서 제공됩니다. shapeKey 다름의 속성 <shape> 강요. 일치는 각 사용자 정의 모양에 대해 다음과 같이 발생합니다.

각각의 가치 shapeKey 속성은 키 속성과 일치하는 항목을 찾는 데 사용됩니다. <shapeKey> 요소.

ShapeKey 값은 대소문자를 구분합니다.
매칭 <shapeKey> 요소에는 path 특정을 가리키는 속성 <Data> KML 파일의 요소( name 의 속성 <Data> 요소).
매칭 <Data> 요소에 자식이 있음 <Value> 요소이며 그 값은 MicroStrategy 이 사용자 정의 모양과 관련된 데이터입니다.

에 대한 title 속성에서 "Custom County Map Layer"를 사용자 정의 모양을 사용하는 이 지도 레이어를 설명하는 값으로 바꿉니다.
에 대한 ml 속성, 교체 "CustomCountyShapesFile.kml"를 플러그인 폴더 내의 상대 경로를 포함하여 KML 파일 이름으로 바꿉니다. 예를 들어 ml="CustomCountyShapesFile.kml" 플러그인 폴더 바로 아래에 저장된 파일의 경우 ml="kml/CustomCountyShapesFile.kml" 플러그인 폴더 아래 kml이라는 폴더에 저장된 파일입니다.

• 아이를 위해 <shapeKey> 부모 아래의 요소 <shapeKeys> 요소에서 다음을 수행합니다.

모든 하위 항목 제거 <shapeKey> 환경에 필요하지 않은 요소입니다. 귀하에게 제공된 플러그인에는 이러한 세 가지 요소가 있습니다. 하나는 이름으로 모양을 식별하고, 다른 하나는 약어로, 세 번째는 ID로 식별합니다.

이러한 요소 중 하나 이상을 사용하지 않으려면 해당 요소를 삭제하세요.
이러한 요소 중 하나 이상을 사용하려면 적절한 요소를 유지하세요.
다른 값으로 모양을 식별하려면 key 다음 중 하나의 속성 <shapeKey> 강요. 예를 들어 SMSA라는 값을 사용하여 모양을 식별하려는 경우 코드는 다음과 같습니다.
<shapeKey key="SMSA" path="/ExtendedData/Data[@name='SMSA']/value"/>

ShapeKey 값은 대소문자를 구분합니다.

각 어린이마다 <shapeKey> 환경에 필요한 요소:

설정 key 속성을 식별하는 데 사용되는 값 <shape> 사용자 정의 모양 파일과 연관된 요소입니다. 이는 의 값과 동일한 값입니다. shapeKey 해당하는 속성 <shape> 요소.

데이터를 도형과 일치시키는 데 사용되는 데이터 필드를 도형의 값과 다르게 하려는 경우<name> 각각의 요소 <Placemark> KML 파일에서 path 형식을 사용하여 사용하려는 데이터 필드의 위치에 속성을 지정합니다. /ExtendedData/Data[@name='>MyCustomShapes']/value .

예를 들어 주 약어를 사용하여 맞춤 모양을 데이터와 일치시키고 KML 파일의 코드가 아래 코드와 같다고 가정해 보겠습니다.

복사

<?xml version="1.0" encoding="UTF-8"?>
<kml xmlns="http://www.opengis.net/kml/2.2">
    <Document>
        <Placemark>
            <name>custom shape name</name>
            <ExtendedData>
                <Data name="abbreviatedName">
                    <DisplayName>Pennsylvania</DisplayName>
                    <Value>PA</Value>
                </Data>
            </ExtendedData>
            <Polygon>
                <outerBoundaryIs>
                    <LinearRing>
                        <coordinates>set of custom shape coordinates</coordinates>
                    </LinearRing>
                </outerBoundaryIs>
            </Polygon>
        </Placemark>
...
    </Document>
</kml>

귀하의 코드 mstrGeoShapesConfig.xml 파일은 다음과 같습니다:

복사

<layers>
    <layer id="900" title="My Custom Map Layer" ml="MyCustomShapesFile.kml">
        <shapeKeys>
            <shapeKey key="abbr" path="/ExtendedData/Data[@name='abbreviatedName']/value"/>
        </shapeKeys>
    </layer>
</layers>

• 아이를 위해<shape> 부모 아래의 요소 <shapes> 요소에서 다음을 수행합니다.

모든 하위 항목 제거 <shape> 환경에 필요하지 않은 요소입니다. 귀하에게 제공된 플러그인에는 이러한 세 가지 요소가 있습니다. 하나는 이름으로 모양을 식별하고, 다른 하나는 약어로, 세 번째는 ID로 식별합니다. 이러한 값은 다음으로 식별됩니다. shapeKey 기인하다.

이들 중 하나 이상을 사용하지 않으려면 해당 요소를 삭제하세요.
이들 중 하나 이상을 사용하려면 적절한 요소를 유지하세요.
다른 값으로 모양을 식별하려면 shapeKey 다음 중 하나의 속성 <shape> 강요. 예를 들어 SMSA라는 값을 사용하여 모양을 식별하려는 경우 코드는 다음과 같습니다.

ShapeKey 값은 대소문자를 구분합니다.
복사
```
<shape
...
    shapeKey="SMSA"
...
/>
```

각 어린이마다 <shape> 환경에 필요한 요소:

에 대한 id 속성에서 현재 값을 고유한 값(이미 사용된 값이 아님)으로 바꿉니다. MicroStrategy 모양의 경우). 이 값은 이 사용자 정의 모양 정의를 고유하게 식별합니다.
에 대한 custom 속성에서 현재 값인 "true"를 유지합니다.
에 대한 plugin 속성에서 제공된 기본 플러그인을 사용하는 경우 현재 값을 유지하십시오. ConnectorForMap, 또는 다른 이름으로 플러그인을 생성한 경우 다른 이름으로 설정하세요.
에 대한 desc 속성에서 현재 값을 의미 있는 설명으로 변경합니다. 이는 영역이 포함된 지도를 표시하도록 선택할 때 ESRI 지도 시각화에 대한 속성 패널의 경계 드롭다운에 표시되는 값입니다. 예를 들어 SMSA로 식별된 지역인 경우 값은 다음과 같을 수 있습니다. desc="Regions by SMSA". 또는 주 약어로 식별되는 주인 경우 값은 다음과 같을 수 있습니다. desc="Custom States by Abbr". 설명을 현지화하려면 다음 추가 속성에 대한 값을 추가해야 합니다.
- descWeb
- descFlash
- descDesktop

에 대한 roleId 속성에서 아래 값 중 하나를 사용하여 현재 값을 사용자 정의 모양의 지리적 역할로 변경합니다.

역할 ID	설명
1	도시
2	주
3	국가
4	위치
5	위도
6	경도
7	기타
8	우편 번호
9	국가

에 대한 type 속성에서는 "Polygon"의 현재 값을 유지합니다.

ESRI 모양 파일과 KML 모양 파일 모두의 모양 유형에는 다각형만 지원됩니다.
에 대한 default 속성을 기본 모양 파일로 사용하지 않으려면 현재 값인 "false"를 유지하세요. 그렇지 않으면 "true"로 설정합니다.
사용 shapeCat 모양에 대해 더 세부적인 식별이 필요한 경우 속성을 사용하세요. 모양 범주는 정수입니다(예: 국가는 1002, 미국은 1003, 미국 카운티는 1004). 예를 들어, roleId 속성 값으로 "7"(기타)을 선택하고 SMSA를 사용하여 모양을 정의한다고 가정합니다. ShapeCat 속성을 에서 사용되지 않는 값으로 설정할 수 있습니다. MicroStrategy. 또한 모바일에서 사용자 정의 모양을 표시하려면 고유한 ShapeCat 값이 필요합니다.
에 대한 shapeKey 속성에서 이를 데이터와 모양을 일치시키는 데 사용되는 값으로 설정합니다. 예를 들어 위 코드에서 값은 name, id, desc였습니다. 이것이 key 해당하는 속성 <shapeKey> 요소 <layers> 계층.
에 대한 layerid 속성의 값으로 설정합니다. id 당신이 사용한 속성 <layer> 요소 <layers> 이 지도 레이어와 연결된 KML 파일을 참조하는 계층 구조입니다. 예를 들어, layerid="900".
사용 sf 그리고 sfr 위치를 고유하게 만들기 위해 추가 지리 정보가 필요한 경우 속성을 사용합니다. 서로 다른 위치는 동일한 기본 위치 이름을 가질 수 있으며 이를 고유하게 만들려면 보조 위치 이름이 필요할 수 있습니다. 예를 들어, 미국의 많은 카운티에는 "워싱턴"이라는 이름이 있습니다. 이 카운티 이름은 주 내에서는 고유하지만 주 외부에서는 고유하지 않습니다. 기본 위치 이름이 여러 주에 존재하기 때문입니다. 이러한 카운티를 고유하게 식별하려면 주 이름으로 한정해야 합니다. 이렇게 하면 앨라배마주 워싱턴은 조지아주 워싱턴이나 펜실베니아주 워싱턴과 고유하게 달라집니다.
- 설정 sf 모양을 데이터와 일치시키는 데 사용되는 보조 위치 필드에 속성을 지정합니다. 이는 다음과 유사합니다. shapeKey 기본 필드의 속성입니다.
- 설정 sfr 모양을 데이터와 일치시키는 데 사용되는 보조 위치의 역할에 속합니다. 이는 다음과 유사합니다. roleId 기본 필드의 속성입니다. 예를 들어 기본 현장 역할이 카운티인 경우 이 값을 주로 설정할 수 있습니다.

•

변경 사항을 저장합니다.

사용자 정의 모양을 사용할 수 있는지 확인하십시오.
1. 재시작 MicroStrategy Web.
2. VI 대시보드에서 ESRI 맵 시각화를 사용하고 영역 맵을 Map Type 속성 패널에서
3. ESRI 속성 패널에서 경계 드롭다운을 확장합니다. 사용자 정의 모양에 대한 설명이 옵션으로 포함되어 있는지 확인하세요.
4. 사용자 정의 모양에 대한 옵션을 선택하십시오. 지도 시각화는 ml 속성에 지정된 KML 파일을 읽습니다. <layer> 노드 인 mstrGeoShapesConfig.xml 적절한 사용자 정의 모양을 렌더링합니다.
5. 문제가 발생하면 아래 문제 해결 팁을 확인하세요.
  - 시각화를 적용하려는 보고서 그리드에 해당 값과 일치하는 애트리뷰트 요소가 있는지 확인하세요. <name> 에 대한 요소 <Placemark> KML 파일의 요소입니다.
  - KML에 사용된 값과 mstrGeoShapesConfig.xml 플러그인의 파일이 올바른 경우입니다. 이러한 값은 모두 대소문자를 구분합니다.
  - 모든 요소에 종료 태그가 있는지 확인하세요.
  - 기본적으로, MicroStrategy Cloud 고객은 맞춤형 클라우드 기반 ESRI 지도를 사용할 수 없습니다. 그들은 ESRI 공용 서버를 사용합니다. ESRI 공용 서버를 사용하려면 다음을 수행해야 합니다. 클라이언트 인증 활성화.