Keyboard shortcuts

Press ← or → to navigate between chapters

Press ? to show this help

Press Esc to hide this help

Gaia에서 온톨로지 객체 생성

Gaia 지도에 그린 도형, 배치한 점과 기호를 온톨로지 객체(Object)로 만들 수 있습니다. 객체 유형(Object type)이 해당 생성 인터페이스(Interface)를 구현하고 필요한 액션(Action)을 제공해야 합니다. 플랫폼 인스턴스(Enrollment)는 Foundry와 Gotham을 모두 사용해야 합니다.

인터페이스와 연결 경로

대상새 구성에 사용할 인터페이스구형 이름
도형Creatable GeoshapeGaia Geoshape Creatable
점Creatable GeopointGaia Geopoint Creatable
군사 기호 및 전술 그래픽MILSTD 2525C SymbolGaia Milsym Creatable

Gaia Geoshape Creatable과 Gaia Geopoint Creatable은 2026년 11월에 지원 중단 단계로 전환할 예정입니다. Gaia Milsym Creatable은 deprecated 상태이며 Gaia Geocreatable도 대체된 구형 이름입니다. 새 인터페이스가 보이지 않으면 Palantir Support에 제공 여부를 확인합니다.

새 Creatable Geoshape와 Creatable Geopoint에는 Marketplace 선행 설치가 없습니다. 구형 두 인터페이스를 계속 구성하는 경우에만 아래의 구형 Marketplace 설치를 먼저 수행합니다.

MRS 확인과 Gotham 연결을 마칩니다. MRS가 있으면 지리 속성이 있는 유형을 추가 유형 매핑 없이 사용할 수 있습니다. MRS가 없으면 유형 매핑 경로의 geopoint 요구를 충족해야 합니다. Gaia에서 기존 온톨로지 객체를 편집하거나 전술 그래픽을 객체에 연결하는 기능은 MRS가 필요합니다.

입력 데이터와 접근 정책

일반 데이터셋(Dataset)을 기반으로 사용할 수 있습니다. 보안 분류나 강제적 보안 표지(Marking)로 객체별 접근을 통제하려면 제한 뷰(Restricted view)를 사용합니다.

객체 속성입력 구성과 용도
Geoshape도형을 저장할 문자열 열을 만들고 객체 속성은 geoshape로 매핑합니다.
Object ID문자열 기본 키(Primary key)입니다. Gaia에서 객체를 만들 때 Foundry가 고유 값을 생성합니다.
Classification제한 뷰를 사용하는 경우에만 필요한 보안 분류 배열입니다. 처음에는 문자열 배열로 매핑합니다.
Name, Category, Notes사용자 설명이 필요하면 문자열 열로 추가합니다. 아래 예제에서 Name을 제목 키로 쓰려면 이 열도 준비합니다.

프로젝트(Project)의 New에서 CSV를 가져오거나 Fusion으로 데이터셋을 만듭니다. 제한 뷰를 쓸 경우에는 그 기반 데이터셋을 준비합니다.

제한 뷰 생성의 첫 단계에서 보안 분류 접근을 검사하는 세분화된 정책을 구성합니다.

다음 JSON은 실제 입력 열 이름이 소문자 classification일 때 CBAC 보안 표지를 검사하는 정책입니다. 객체 속성의 표시 이름 Classification과 입력 열 이름을 구분하고, 다른 열 이름을 쓴다면 fieldName을 맞춥니다.

{
  "condition": {
    "and": {
      "conditions": [
        {
          "markings": {
            "value": {
              "field": {
                "fieldName": "classification"
              },
              "type": "field"
            },
            "filters": [
              {
                "markingTypes": {
                  "markingTypes": [
                    "CBAC"
                  ]
                },
                "type": "markingTypes"
              }
            ]
          },
          "type": "markings"
        }
      ]
    },
    "type": "and"
  }
}

이 예제는 CBAC 분류를 검사합니다. 객체에 CBAC 또는 강제 보안 표지 속성이 있으면 Gaia 지도에서 그 표지를 상속하여 객체를 만듭니다. 지도의 Security and sharing에 지정한 그룹 제한은 이 객체에 자동 적용하지 않습니다. 필요한 객체 접근 요건은 제한 뷰 정책에 구성합니다.

도형 객체 유형과 공유 속성

Ontology Manager의 New에서 Object type을 만들고 기존 데이터소스 선택으로 데이터셋 또는 제한 뷰를 지정합니다. 이름과 설명을 정하고 Object ID를 기본 키, 준비한 Name을 제목 키(Title key)로 선택합니다.

Geoshape는 geoshape 자료형으로, 제한 뷰 경로의 Classification은 문자열 배열로 설정합니다. 액션은 생성 후에 구성하므로 이 단계에서는 Create로 유형을 만듭니다.

Properties에서 Classification을 열어 Base type을 Mandatory control 및 CBAC Marking으로 구성하고 Max Classification을 정합니다. 분류 값은 배열로 유지합니다. 이 기능이 보이지 않으면 Palantir Support에 확인합니다.

Shared property에서 Classification 공유 속성에 연결합니다. Geoshape도 해당 공유 속성에 연결하지만 분류나 강제적 접근 통제 설정은 하지 않습니다. Classification이 없는 일반 데이터셋 경로에서는 Geoshape만 구성합니다.

Save로 이 변경을 저장하고 MRS 또는 유형 매핑으로 Gotham 연결을 확인합니다.

생성과 수정을 함께 제공하는 액션

객체 유형 Overview의 Action types에서 New를 선택합니다. 버튼을 사용할 수 없다면 Datasources에서 Allow edits가 켜졌는지 확인합니다.

  1. Object actions에서 Modify or create object를 선택합니다.
  2. Or create a new object with에서 Auto-generated primary key를 선택합니다.
  3. Add property로 기존 속성을 추가합니다. Classification은 제한 뷰 경로에서만 필요합니다.

  1. 액션 이름, 선택 설명과 아이콘을 정합니다.
  2. 실행할 Organization, Group 또는 User를 지정하고 Create 후 Save합니다.

Rules의 Geoshape 옆 Configure parameter에서 입력 자료형이 Geoshape 또는 String인지 확인합니다. General의 Disabled를 선택하여 사용자 폼에서 위치 값을 직접 바꾸지 않게 합니다. 도형 값은 Gaia의 그리기 과정에서 채웁니다.

제한 뷰 경로에서는 Classification 매개변수의 Type이 Mandatory control인지 확인합니다. Back to Form에서 Object Id를 제거합니다. ID는 Foundry가 자동 생성합니다. 변경을 Save합니다.

생성 인터페이스 구현

객체 유형의 Interfaces에서 Implement new interface를 선택하고 Creatable Geoshape를 찾습니다. 구형 경로를 사용하는 경우에는 설치한 Gaia Geoshape Creatable을 선택합니다. Choose an option의 Replace existing으로 Geoshape 공유 속성을 연결하고 Confirm 및 Save합니다.

점 객체의 차이

점에는 Geoshape 대신 Geopoint 열과 속성을 사용합니다. 속성 자료형과 액션 Parameters의 Type은 모두 Geopoint로 설정합니다. Creatable Geopoint 또는 구형 Gaia Geopoint Creatable을 구현하고 Replace existing에서 Geopoint를 연결합니다.

MILSTD 2525C Symbol의 차이

이 인터페이스를 구현하는 유형은 제한 뷰가 필수입니다. 기반 자료의 최소 열은 Object ID, Classification과 Title이며 Object ID를 기본 키, Title을 제목 키로 정합니다.

액션에는 최소한 SIDC와 Symbol Anchor Points를 함께 매핑합니다. Classification 매개변수 연결은 선택 사항이지만 연결하면 생성 시 적용할 분류를 제어할 수 있습니다.

Classification을 연결했다면 Rules에서 Configure parameter를 엽니다.

Classification이 공유 속성으로 구현되어 있고 지도 분류를 자동 상속하게 하려면 General의 Disabled를 켭니다. 생성 시 수동 분류 선택이 필요하면 켜지 않습니다. Set a parameter max classification에서 Add를 선택하고 액션과 객체 유형의 최대 분류가 같게 맞춥니다.

MILSTD 2525C Symbol을 구현할 때 Classification에는 Replace existing, 나머지 속성에는 Create edit-only property를 선택합니다. SIDC는 기호 식별 문자열이고 Symbol Anchor Points는 위치나 모양을 정의하는 점의 목록입니다.

Speed Modifier (Z)는 구조체(Struct), Altitude/Depth Modifier (X)는 구조체 목록입니다. 공통 Actions의 V2 구조체 지원과 Gaia 일괄 생성 표의 지원은 다릅니다. 일괄 생성에 사용할 액션은 이 구조체 매개변수를 넣지 않고 SIDC, Symbol Anchor Points와 필요한 지원 스칼라 입력으로 구성합니다.

액션 제약으로 자동 발견

새 생성 인터페이스에는 선택적인 Create or Modify 액션 유형 제약이 있습니다. 이 제약을 매핑하면 객체 유형과 액션 RID를 수동 등록하지 않아도 Gaia에서 객체 생성 유형을 찾습니다. 구현 선언만으로 끝내지 않고 액션 및 매개변수 매핑을 완료합니다.

  1. 객체 유형이 Creatable Geoshape, Creatable Geopoint 또는 MILSTD 2525C Symbol을 구현하는지 확인합니다.
  2. 새 객체 생성과 기존 객체 수정을 모두 지원하는 Create or Modify 액션을 준비합니다.
  3. Interfaces의 Actions에서 그 액션을 인터페이스 제약에 매핑합니다.
  4. 설정 아이콘으로 제약 매개변수를 연결합니다. 점은 Geopoint, 도형은 Geoshape, 기호는 최소 SIDC와 Symbol Anchor Points가 필요합니다.

  1. Save합니다.
  2. 같은 유형을 과거에 수동 등록했다면 관리 설정의 Foundry Object Creation Config에서 해당 유형 및 액션 RID 항목을 제거하고 저장합니다.
  3. Gaia를 다시 로드하고 Object type 목록에 유형이 표시되는지 확인합니다.

여러 생성 인터페이스를 구현하는 유형은 액션 하나를 모든 제약에 연결하는 방식을 권장합니다. 설정이 적지만 각 생성 방식에 필요하지 않은 선택 매개변수가 폼에 있을 수 있습니다. 인터페이스마다 별도 Create or Modify 액션을 만들면 폼에 관련 입력만 표시할 수 있으나 구성할 매핑이 늘어납니다.

온톨로지 설정과 구형 수동 등록

Gaia 관리 앱은 플랫폼 관리자, Control Panel 확장은 Organization administrator 역할이 있어야 접근할 수 있습니다.

Ontology Config 또는 Ontology 패널에서 대상 온톨로지가 구성되어 있는지 확인합니다. 없으면 관리 앱은 overridden, Control Panel은 Override로 바꾸고 Ontology RID와 API Name을 입력합니다. 값은 Ontology Manager의 Ontology configuration에서 확인합니다.

새 인터페이스의 액션 제약을 충족했다면 개별 유형과 액션의 수동 등록은 생략합니다. 구형 Gaia Geoshape Creatable과 Gaia Geopoint Creatable 등 대체된 인터페이스에는 이 제약이 없으므로 수동 항목이 필요합니다.

수동 경로에서는 Foundry Object Creation Config의 Show 또는 Override를 선택하고 Add로 유형별 Object type rid와 Action type rid를 짝지어 입력합니다. 관리 앱은 Preview and save, Control Panel은 Save for {Organization}으로 저장합니다.

각 RID는 Ontology Manager의 객체 유형 Overview 및 연결된 액션의 상세에서 복사할 수 있습니다.

2026년 11월부터 Foundry Object Creation Config와 Actions for Creating Objects From Gaia 설정은 읽기 전용으로 전환할 예정입니다. 기존 수동 등록은 새 인터페이스 및 액션 제약 경로로 이전하며 필요한 지원은 Palantir Support에 확인합니다.

지도에서 생성 방식 선택

유형을 먼저 고르면 Gaia는 그 유형이 구현한 인터페이스에 맞는 그리기 도구만 표시하고 왼쪽 패널의 Object type을 미리 채웁니다. 점과 도형을 모두 구현한 유형은 두 종류의 도구를 사용할 수 있지만 맞지 않는 기호 Search는 표시하지 않습니다.

도구를 먼저 고르면 Object type이 비어 있고 그 도구와 호환되는 인터페이스 구현 유형만 목록에 표시됩니다.

도형 생성과 수정

위쪽 도구 모음의 객체 아이콘으로 Draw annotation에서 Create object 모드로 전환합니다.

도형 도구를 선택하고 지도를 그립니다. Create shape에서 유형을 선택하거나 미리 채운 유형을 확인하고 Name과 Category 등 액션의 필수 입력을 채운 뒤 Finish합니다.

생성한 객체는 Layers에 나타납니다. 이름을 선택하면 오른쪽 Selection에서 속성과 표시를 확인할 수 있습니다.

같은 객체를 Foundry의 Object Explorer에서도 조회할 수 있습니다.

MRS 환경에서 기존 객체의 Edit selection을 선택하거나 지도에서 두 번 클릭하면 Edit shape가 열립니다. 꼭짓점을 끌어 형상을 바꾸거나 도형 안을 끌어 위치를 옮긴 뒤 Finish합니다.

180도 경도선, 즉 날짜 변경선을 가로지르는 지도 주석은 만들 수 있지만 Foundry 객체로 태그하는 도형은 이 선을 가로지르도록 그릴 수 없습니다.

점 생성

도구 모음의 아래쪽 화살표에서 기호 Search를 열고 지도에 배치할 기호를 선택합니다. Coordinates는 지도의 좌표계 설정을 사용해 채웁니다. 좌표계는 File > Preferences > Coordinate system에서 바꿉니다.

Create symbol에서 점 생성 인터페이스의 객체 유형을 선택합니다. 필요한 경우 Bearing (mag)를 조정하고 Title을 입력한 뒤 Finish합니다. 생성한 점의 레이어 조회와 기존 객체 편집은 도형과 같은 방식이며 편집에는 MRS가 필요합니다.

전술 그래픽 생성

전술 그래픽을 객체로 만들려면 MRS와 MILSTD 2525C Symbol 구현이 필요합니다. Search symbols...에서 Brigade Support Area 같은 기호 이름을 찾아 선택합니다.

지도에 그린 뒤 Create symbol에서 호환 객체 유형과 액션 입력을 지정하여 Finish합니다. 기존 그래픽 편집도 도형과 같은 경로를 사용합니다.

여러 객체 생성

Create shape 또는 Create symbol의 Bulk create를 선택합니다.

표의 각 행은 지리 도형 하나를 객체 하나로 만드는 별도 액션 제출이며, 각 열은 액션 매개변수입니다. 한 표에서 최대 5,000개 객체를 만들 수 있습니다.

첫 행에는 처음 그린 도형이나 배치한 기호가 들어갑니다. Add row 또는 마지막 빈 행의 셀로 새 행을 추가합니다. geoshape 또는 geopoint 셀을 선택하여 편집 패널을 열고 지도를 그리거나 점을 배치한 뒤 Save합니다.

기호는 같은 액션에 SIDC와 Symbol Anchor Points를 구성합니다. 기호 선택기가 SIDC를 채우고 좌표 편집기를 열며 그린 형상으로 앵커 점 목록을 채웁니다. 지원하는 추가 스칼라 수식자는 선택적으로 포함할 수 있습니다.

단일점 그래픽도 Symbol Anchor Points는 목록이며 그 안에 점 하나가 들어갑니다. 여러 점으로 이루어진 형상과 자료형 자체가 달라지는 것은 아닙니다.

입력을 마치면 Submit으로 제출합니다. 저장하지 않고 표에서 나가려면 Return to single object를 선택합니다. 행 번호를 선택한 뒤 macOS의 Cmd+Up 또는 Cmd+Down, Windows의 Ctrl+Up 또는 Ctrl+Down으로 여러 행 선택을 조정할 수 있습니다. 행이나 값은 Cmd+C와 Cmd+V 또는 Ctrl+C와 Ctrl+V로 복사하고 붙여 넣습니다.

기존 지도 주석을 객체로 만들기

주석(Annotation)은 현재 지도에만 있는 도형, 점 또는 기호입니다. 이를 온톨로지 객체로 만들면 해당 유형에 접근할 수 있는 다른 사용자의 지도에서도 사용할 수 있습니다.

주석을 두 번 클릭하거나 Layers의 연필 아이콘으로 편집기를 열고 Promote to object를 선택합니다. 유형을 고르고 액션 입력을 완료합니다.

승격은 원래 주석을 삭제하지 않습니다. 새 객체가 별도 레이어에 표시되고 원래 주석과 원본 레이어도 남습니다. 더 이상 필요 없는 원래 주석은 생성 결과를 확인한 뒤 따로 숨기거나 제거합니다.

주석 여러 개 승격

점, 도형(다각형, 사각형, 선과 범위 링), 군사 기호 및 단일점이나 다중점 전술 그래픽을 지원합니다.

  1. 지도나 Layers에서 지원 주석을 최소 두 개 선택합니다.
  2. 오른쪽 Selection에서 Create objects를 선택합니다.

  1. 유형을 선택하여 Bulk create objects를 엽니다.
  2. 위치, 형상과 앵커 점이 채워진 행을 확인하고 남은 필수 입력을 채운 뒤 Submit합니다.

Selection과 일괄 표는 호환 및 비호환 유형을 함께 표시합니다. 포인터를 두면 비호환 이유를 볼 수 있습니다.

점, 도형과 전술 그래픽을 섞어 선택했다면 해당 유형의 액션에 최소 Geopoint, Geoshape, SIDC와 Symbol Anchor Points가 모두 있어야 합니다. 선택한 주석의 각 인터페이스 입력을 한 액션이 처리할 수 있어야 합니다.

일괄 생성 문제 해결

문제확인 및 처리
Bulk create가 없음Create object 모드인지, 지도 Edit 권한과 액션 실행 권한이 있는지, 지원 생성 인터페이스를 구현했는지 확인합니다. 구조체 매개변수가 있으면 일괄 표를 사용할 수 없습니다. 조건을 갖췄는데 단일 생성만 되면 플랫폼 인스턴스의 일괄 기능 활성화를 Support에 확인합니다.
Tabular view unavailable액션에 표가 표현하지 못하는 규칙이나 매개변수가 있습니다. 구조체 입력을 제외하는 등 지원 입력으로 별도 Modify or create 액션을 구성합니다.
위치 또는 기호가 미리 채워지지 않음인터페이스 속성과 실제 속성 및 액션 입력의 매핑을 확인합니다. SIDC와 Symbol Anchor Points는 같은 액션에 있어야 합니다. 자동 발견 경로는 액션 제약과 온톨로지 설정을, 구형 수동 경로는 유형 및 액션 RID 등록도 확인합니다.
잘못되거나 너무 많은 선택폴더, fragment와 주석이 아닌 레이어를 제외합니다. 적합한 항목이 5,000개를 넘으면 선택 해제 기능을 쓰거나 작은 배치로 나누어 제출합니다.
제출했지만 지도에서 보이지 않음Insight에서 이름이나 속성으로 생성 여부를 확인하고 해당 유형의 대상 레이어 및 지도와 객체 유형의 보안 표지 호환성을 확인합니다.
셀 오류 없이 제출 실패표가 제출 전에 잡지 못한 필수 매개변수, 좌표와 형상 유효성, 보안 표지 한도 및 액션 실행 권한을 확인합니다.

구형 인터페이스의 Marketplace 설치

이 절차는 Gaia Geoshape Creatable과 Gaia Geopoint Creatable을 사용하는 경우에만 적용합니다. Marketplace는 홈 검색 또는 Applications에서 엽니다.

Core Ontology Store의 Core Property Types와 Gaia App Store의 필요한 생성 인터페이스 제품을 설치합니다. Core Ontology Store가 없으면 Palantir Support에 Foundry product로 Core Ontology 설치를 요청합니다. Gaia Geoshape Creatable은 더 오래된 Gaia Geocreatable을 대체한 인터페이스입니다.

  1. Gaia App Store에서 Gaia Geoshape Creatable을 선택하고 Install로 설치 초안을 엽니다. 설명용 접미사는 선택 사항입니다.
  2. Namespace를 선택합니다. Marketplace가 그 안에 프로젝트를 만듭니다.
  3. Permissions에서 분류와 접근 통제를 구성합니다. CBAC 선택값은 설치본의 최대 보안 분류입니다.
  4. Next로 Inputs를 열고 Shared properties에서 Geoshape를 매핑합니다.
  5. Next로 Content로 이동합니다.

  1. Prefix Ontology entities는 선택 사항이며 괄호나 대괄호 같은 허용되지 않는 문자를 접두사에 넣지 않습니다.
  2. 필요한 Ontology schema migrations를 선택합니다.
  3. New versions의 자동 업그레이드 설정을 검토합니다. 일부 제품은 자동 업그레이드가 미리 설정되어 있습니다.
  4. Next에서 구성을 검토하고 Install합니다.

Gaia Geopoint Creatable도 같은 절차를 사용하되 Inputs의 공유 속성은 Geoshape 대신 Geopoint에 매핑합니다.