From 2d419d019443af14351316d7de756531f3969acf Mon Sep 17 00:00:00 2001 From: Alberto Abella Date: Thu, 26 Oct 2023 03:12:30 +0200 Subject: [PATCH] updated SMAnalysis/doc/spec_KO.md --- SMAnalysis/doc/spec_KO.md | 529 ++++++++++++++++++++++++++++++++++++++ 1 file changed, 529 insertions(+) create mode 100644 SMAnalysis/doc/spec_KO.md diff --git a/SMAnalysis/doc/spec_KO.md b/SMAnalysis/doc/spec_KO.md new file mode 100644 index 0000000..3d24065 --- /dev/null +++ b/SMAnalysis/doc/spec_KO.md @@ -0,0 +1,529 @@ + +[![Smart Data Models](https://smartdatamodels.org/wp-content/uploads/2022/01/SmartDataModels_logo.png "Logo")](https://smartdatamodels.org) + 엔티티: SMAnalysis +=============== + + [오픈 라이선스](https://github.com/smart-data-models//dataModel.SocialMedia/blob/master/SMAnalysis/LICENSE.md) + [문서 자동 생성](https://docs.google.com/presentation/d/e/2PACX-1vTs-Ng5dIAwkg91oTTUdt8ua7woBXhPnwavZ0FxgR8BsAI_Ek3C5q97Nd94HS8KhP-r_quD4H0fgyt3/pub?start=false&loop=false&delayms=3000#slide=id.gb715ace035_0_60) + + + 글로벌 설명: **이 엔티티에는 소셜 미디어 도메인에 대해 만들어진 일반 SMAnalysis에 대한 조화로운 설명이 포함되어 있습니다. 이 엔티티는 주로 소셜 미디어 애플리케이션의 게시물을 분석하는 프로세스와 연관되어 있습니다.** + 버전: 0.1.1 + + + + ## 속성 목록 + + [*] 속성에 유형이 없는 것은 여러 유형 또는 다른 형식/패턴을 가질 수 있기 때문입니다. +- `address[object]`: 우편 주소 . Model: [https://schema.org/address](https://schema.org/address) - `addressCountry[string]`: 국가. 예를 들어, 스페인 . Model: [https://schema.org/addressCountry](https://schema.org/addressCountry) + - `addressLocality[string]`: 도로명 주소가 있는 지역 및 해당 지역에 속한 지역 . Model: [https://schema.org/addressLocality](https://schema.org/addressLocality) + - `addressRegion[string]`: 해당 지역이 위치한 지역과 해당 국가의 지역 . Model: [https://schema.org/addressRegion](https://schema.org/addressRegion) + - `district[string]`: 지구는 일부 국가에서는 지방 정부에서 관리하는 행정 구역의 일종입니다. + - `postOfficeBoxNumber[string]`: 사서함 주소의 우체국 사서함 번호입니다. 예: 03578 . Model: [https://schema.org/postOfficeBoxNumber](https://schema.org/postOfficeBoxNumber) + - `postalCode[string]`: 우편 번호입니다. 예: 24004 . Model: [https://schema.org/https://schema.org/postalCode](https://schema.org/https://schema.org/postalCode) + - `streetAddress[string]`: 거리 주소 . Model: [https://schema.org/streetAddress](https://schema.org/streetAddress) + - `streetNr[string]`: 공공 도로의 특정 건물을 식별하는 번호 +- `alternateName[string]`: 이 항목의 대체 이름 - `analyzedAt[date-time]`: 분석이 완료된 시간 - `areaServed[string]`: 서비스 또는 제공 품목이 제공되는 지리적 영역 . Model: [https://schema.org/Text](https://schema.org/Text) - `dataProvider[string]`: 조화된 데이터 엔티티의 공급자를 식별하는 일련의 문자 - `dateCreated[date-time]`: 엔티티 생성 타임스탬프. 이는 일반적으로 스토리지 플랫폼에서 할당합니다. - `dateModified[date-time]`: 엔티티의 마지막 수정 타임스탬프입니다. 이는 일반적으로 스토리지 플랫폼에서 할당합니다. - `description[string]`: 이 항목에 대한 설명 - `hasAnalysisType[string]`: 분석의 가치 . Model: [ https://schema.org/Text]( https://schema.org/Text) - `hasAnalysisValue[string]`: 분석 유형 . Model: [ https://schema.org/Text]( https://schema.org/Text) - `hasConfidence[number]`: 분석의 신뢰도를 나타냅니다. 모든 단위는 [CEFACT](https://www.unece.org/cefact.html) 코드에서 허용됩니다. . Model: [ https://schema.org/Number]( https://schema.org/Number) - `id[*]`: 엔티티의 고유 식별자 - `isAnalysisOf[*]`: 분석에 사용된 게시물의 ID입니다. - `location[*]`: 항목에 대한 지오숀 참조입니다. 포인트, 라인 문자열, 다각형, 멀티포인트, 멀티라인 문자열 또는 멀티폴리곤일 수 있습니다. - `name[string]`: 이 항목의 이름 - `owner[array]`: 소유자의 고유 ID를 참조하는 JSON 인코딩된 문자 시퀀스가 포함된 목록입니다. - `seeAlso[*]`: 항목에 대한 추가 리소스를 가리키는 URL 목록 - `source[string]`: 엔티티 데이터의 원본 소스를 URL로 제공하는 문자 시퀀스입니다. 소스 공급자의 정규화된 도메인 이름 또는 소스 개체에 대한 URL을 사용하는 것이 좋습니다. - `type[string]`: NGSI-LD 엔티티 유형. SMAnalysis와 같아야 합니다. + + 필수 속성 +- `analyzedAt` - `id` - `type` + + + + ## 속성에 대한 데이터 모델 설명 + 알파벳순으로 정렬(자세한 내용을 보려면 클릭) + + +
full yaml details + ```yaml +SMAnalysis: + description: This entity contains a harmonised description of a generic SMAnalysis made for the Social Media domain. This entity is primarily associated with the process of analysis of Social Media applications' posts. + properties: + address: + description: The mailing address + properties: + addressCountry: + description: 'The country. For example, Spain' + type: string + x-ngsi: + model: https://schema.org/addressCountry + type: Property + addressLocality: + description: 'The locality in which the street address is, and which is in the region' + type: string + x-ngsi: + model: https://schema.org/addressLocality + type: Property + addressRegion: + description: 'The region in which the locality is, and which is in the country' + type: string + x-ngsi: + model: https://schema.org/addressRegion + type: Property + district: + description: 'A district is a type of administrative division that, in some countries, is managed by the local government' + type: string + x-ngsi: + type: Property + postOfficeBoxNumber: + description: 'The post office box number for PO box addresses. For example, 03578' + type: string + x-ngsi: + model: https://schema.org/postOfficeBoxNumber + type: Property + postalCode: + description: 'The postal code. For example, 24004' + type: string + x-ngsi: + model: https://schema.org/https://schema.org/postalCode + type: Property + streetAddress: + description: The street address + type: string + x-ngsi: + model: https://schema.org/streetAddress + type: Property + streetNr: + description: Number identifying a specific property on a public street + type: string + x-ngsi: + type: Property + type: object + x-ngsi: + model: https://schema.org/address + type: Property + alternateName: + description: An alternative name for this item + type: string + x-ngsi: + type: Property + analyzedAt: + description: The time at which the analysis finished + format: date-time + type: string + x-ngsi: + type: Property + areaServed: + description: The geographic area where a service or offered item is provided + type: string + x-ngsi: + model: https://schema.org/Text + type: Property + dataProvider: + description: A sequence of characters identifying the provider of the harmonised data entity + type: string + x-ngsi: + type: Property + dateCreated: + description: Entity creation timestamp. This will usually be allocated by the storage platform + format: date-time + type: string + x-ngsi: + type: Property + dateModified: + description: Timestamp of the last modification of the entity. This will usually be allocated by the storage platform + format: date-time + type: string + x-ngsi: + type: Property + description: + description: A description of this item + type: string + x-ngsi: + type: Property + hasAnalysisType: + description: The value of the analysis + type: string + x-ngsi: + model: ' https://schema.org/Text' + type: Property + units: No unit + hasAnalysisValue: + description: The type of the analysis + type: string + x-ngsi: + model: ' https://schema.org/Text' + type: Property + units: No unit + hasConfidence: + description: 'It represents the confidence of the analysis. All units are accepted in [CEFACT](https://www.unece.org/cefact.html) code' + type: number + x-ngsi: + model: ' https://schema.org/Number' + type: Property + units: No unit + id: + anyOf: + - description: Identifier format of any NGSI entity + maxLength: 256 + minLength: 1 + pattern: ^[\w\-\.\{\}\$\+\*\[\]`|~^@!,:\\]+$ + type: string + x-ngsi: + type: Property + - description: Identifier format of any NGSI entity + format: uri + type: string + x-ngsi: + type: Property + description: Unique identifier of the entity + x-ngsi: + type: Property + isAnalysisOf: + anyOf: + - description: Identifier format of any NGSI entity + maxLength: 256 + minLength: 1 + pattern: ^[\w\-\.\{\}\$\+\*\[\]`|~^@!,:\\]+$ + type: string + x-ngsi: + type: Property + - description: Identifier format of any NGSI entity + format: uri + type: string + x-ngsi: + type: Property + description: The ID of the post that was used in the analysis + x-ngsi: + type: Relationship + location: + description: 'Geojson reference to the item. It can be Point, LineString, Polygon, MultiPoint, MultiLineString or MultiPolygon' + oneOf: + - description: Geojson reference to the item. Point + properties: + bbox: + items: + type: number + minItems: 4 + type: array + coordinates: + items: + type: number + minItems: 2 + type: array + type: + enum: + - Point + type: string + required: + - type + - coordinates + title: GeoJSON Point + type: object + x-ngsi: + type: GeoProperty + - description: Geojson reference to the item. LineString + properties: + bbox: + items: + type: number + minItems: 4 + type: array + coordinates: + items: + items: + type: number + minItems: 2 + type: array + minItems: 2 + type: array + type: + enum: + - LineString + type: string + required: + - type + - coordinates + title: GeoJSON LineString + type: object + x-ngsi: + type: GeoProperty + - description: Geojson reference to the item. Polygon + properties: + bbox: + items: + type: number + minItems: 4 + type: array + coordinates: + items: + items: + items: + type: number + minItems: 2 + type: array + minItems: 4 + type: array + type: array + type: + enum: + - Polygon + type: string + required: + - type + - coordinates + title: GeoJSON Polygon + type: object + x-ngsi: + type: GeoProperty + - description: Geojson reference to the item. MultiPoint + properties: + bbox: + items: + type: number + minItems: 4 + type: array + coordinates: + items: + items: + type: number + minItems: 2 + type: array + type: array + type: + enum: + - MultiPoint + type: string + required: + - type + - coordinates + title: GeoJSON MultiPoint + type: object + x-ngsi: + type: GeoProperty + - description: Geojson reference to the item. MultiLineString + properties: + bbox: + items: + type: number + minItems: 4 + type: array + coordinates: + items: + items: + items: + type: number + minItems: 2 + type: array + minItems: 2 + type: array + type: array + type: + enum: + - MultiLineString + type: string + required: + - type + - coordinates + title: GeoJSON MultiLineString + type: object + x-ngsi: + type: GeoProperty + - description: Geojson reference to the item. MultiLineString + properties: + bbox: + items: + type: number + minItems: 4 + type: array + coordinates: + items: + items: + items: + items: + type: number + minItems: 2 + type: array + minItems: 4 + type: array + type: array + type: array + type: + enum: + - MultiPolygon + type: string + required: + - type + - coordinates + title: GeoJSON MultiPolygon + type: object + x-ngsi: + type: GeoProperty + x-ngsi: + type: GeoProperty + name: + description: The name of this item + type: string + x-ngsi: + type: Property + owner: + description: A List containing a JSON encoded sequence of characters referencing the unique Ids of the owner(s) + items: + anyOf: + - description: Identifier format of any NGSI entity + maxLength: 256 + minLength: 1 + pattern: ^[\w\-\.\{\}\$\+\*\[\]`|~^@!,:\\]+$ + type: string + x-ngsi: + type: Property + - description: Identifier format of any NGSI entity + format: uri + type: string + x-ngsi: + type: Property + description: Unique identifier of the entity + x-ngsi: + type: Property + type: array + x-ngsi: + type: Property + seeAlso: + description: list of uri pointing to additional resources about the item + oneOf: + - items: + format: uri + type: string + minItems: 1 + type: array + - format: uri + type: string + x-ngsi: + type: Property + source: + description: 'A sequence of characters giving the original source of the entity data as a URL. Recommended to be the fully qualified domain name of the source provider, or the URL to the source object' + type: string + x-ngsi: + type: Property + type: + description: NGSI-LD Entity Type. It must be equal to SMAnalysis + enum: + - SMAnalysis + type: string + x-ngsi: + type: Property + required: + - id + - type + - analyzedAt + type: object + x-derived-from: "" + x-disclaimer: 'Redistribution and use in source and binary forms, with or without modification, are permitted provided that the license conditions are met. Copyleft (c) 2022 Contributors to Smart Data Models Program' + x-license-url: https://github.com/smart-data-models/dataModel.SocialMedia/blob/master/SMAnalysis/LICENSE.md + x-model-schema: https://raw.githubusercontent.com/smart-data-models/dataModel.SocialMedia/master/SMAnalysis/schema.json + x-model-tags: "" + x-version: 0.1.1 +``` +
+ + + + + ## 페이로드 예시 + #### SMAnalysis NGSI-v2 키-값 예시 + 다음은 키값으로 JSON-LD 형식의 SMAnalysis의 예입니다. 이는 `옵션=키값`을 사용할 때 NGSI-v2와 호환되며 개별 엔티티의 컨텍스트 데이터를 반환합니다. +
show/hide example + ```json + { + "id": "urn:ngsi-ld:Analysis:X", + "type": "SMAnalysis", + "hasConfidence": 0.4, + "analyzedAt": "2020-12-24T12:00:00Z", + "hasAnalysisValue": "Anger", + "hasAnalysisType": "Sentiment", + "isAnalysisOf": "urn:ngsi-ld:SMCollection:001" +} +``` +
+ #### SMAnalysis NGSI-v2 정규화 예제 + 다음은 정규화된 JSON-LD 형식의 SMAnalysis의 예입니다. 이는 옵션을 사용하지 않을 때 NGSI-v2와 호환되며 개별 엔티티의 컨텍스트 데이터를 반환합니다. +
show/hide example + ```json + { + "id": "urn:ngsi-ld:Analysis:X", + "type": "SMAnalysis", + "hasConfidence": { + "type": "Number", + "value": 0.4 + }, + "analyzedAt": { + "type": "DateTime", + "value": "2020-12-24T12:00:00Z" + }, + "hasAnalysisValue": { + "type": "Text", + "value": "Anger" + }, + "hasAnalysisType": { + "type": "Text", + "value": "Sentiment" + }, + "isAnalysisOf": { + "type": "Relationship", + "object": "SMCollection.001" + } +} +``` +
+ #### SMAnalysis NGSI-LD 키 값 예제 + 다음은 키 값으로 JSON-LD 형식의 SMAnalysis의 예입니다. 이는 `옵션=키값`을 사용할 때 NGSI-LD와 호환되며 개별 엔티티의 컨텍스트 데이터를 반환합니다. +
show/hide example + ```json + { + "id": "urn:ngsi-ld:Analysis:X", + "type": "SMAnalysis", + "analyzedAt": "2020-12-24T12:00:00Z", + "hasAnalysisType": "Sentiment", + "hasAnalysisValue": "Anger", + "hasConfidence": 0.4, + "isAnalysisOf": "urn:ngsi-ld:SMCollection:001", + "@context": [ + "https://raw.githubusercontent.com/smart-data-models/dataModel.SocialMedia/master/context.jsonld" + ] +} +``` +
+ #### SMAnalysis NGSI-LD 정규화 예제 + 다음은 정규화된 JSON-LD 형식의 SMAnalysis의 예입니다. 이는 옵션을 사용하지 않을 때 NGSI-LD와 호환되며 개별 엔티티의 컨텍스트 데이터를 반환합니다. +
show/hide example + ```json + { + "id": "urn:ngsi-ld:Analysis:X", + "type": "SMAnalysis", + "analyzedAt": { + "type": "Property", + "value": { + "@type": "DateTime", + "@value": "2020-12-24T12:00:00Z" + } + }, + "hasAnalysisType": { + "type": "Property", + "value": "Sentiment" + }, + "hasAnalysisValue": { + "type": "Property", + "value": "Anger" + }, + "hasConfidence": { + "type": "Property", + "value": 0.4 + }, + "isAnalysisOf": { + "type": "Relationship", + "object": "urn:ngsi-ld:SMCollection:001" + }, + "@context": [ + "https://raw.githubusercontent.com/smart-data-models/dataModel.SocialMedia/master/context.jsonld" + ] +} +``` +
+ + + + [FAQ 10](https://smartdatamodels.org/index.php/faqs/)을 참조하여 규모 단위를 다루는 방법에 대한 답변을 확인하세요. + + +--- + [Smart Data Models](https://smartdatamodels.org) +++ [Contribution Manual](https://bit.ly/contribution_manual) +++ [About](https://bit.ly/Introduction_SDM)