이 틀은 위키데이터로부터 데이터를 페치(fetch)하기 위해 사용합니다.
사용법[원본 편집]
{{위키데이터|명령어 1|플래그 1a|플래그 1b|플래그 1c|명령어 2|플래그 2a|플래그 2b|플래그 2c|플래그 0a|플래그 0b|플래그 0c|인수 1|인수 2|인수 3}}
명령어[원본 편집]
명령어(명령어 1, 명령어 2, ...)는 어떤 값을 반환시킬 것인지를 결정합니다.
값 클래스[원본 편집]
값 클래스의 명령어는 조합시킬 수 있습니다. 즉, 이 클래스의 다른 종류의 명령어를 동시에 부여할 수 있습니다.
반환된 정보의 단편을 각각 모두 확인하기 위해서는 명령어를 하나하나 이 틀에 대해서 복수 호출하는 것이 아닌 복수 명령어를 조합해서 이 틀를 한 번으로 호출해주세요.
| 구분 | 명령어 | 반환되는 값 | 기본적인 사용법 | 설명 |
|---|---|---|---|---|
| 1 | property
|
첫 번째로 일치하는 것* | {{위키데이터|property|P1}}
|
현재의 항목 개체 또는 주어진 개체에서 요구된 속성(또는 속성의 목록)을 반환합니다. |
properties
|
일치하는 것 모두 | {{위키데이터|properties|P1}}
| ||
| 2 | qualifier
|
첫 번째로 일치하는 것* | {{위키데이터|qualifier|P1|P2}}
|
현재의 항목 개체 또는 주어진 개체의 주어진 속성에서 요구된 한정자(또는 한정자의 목록)를 반환합니다. 다른 값 클래스의 명령어와는 다르며, 이 명령어는 1회 호출로 여려번으로 다른 한정자를 참조할 수가 있습니다. |
qualifiers
|
일치하는 것 모두 | {{위키데이터|qualifiers|P1|P2}}
| ||
| 3 | reference
|
첫 번째로 일치하는 것* | {{위키데이터|reference|P1}}
|
현재의 항목 개체 또는 주어진 개체의 주어진 속성에서 출처(또는 출처의 목록)를 반환합니다. |
references
|
일치하는 것 모두 | {{위키데이터|references|P1}}
| ||
| * (여러 주장 또는 내용이 일치한 경우) 여러 값 대신에 단일 값을 반환합니다. 반환된 값은 순위가 가장 높은 주장 중에서 첫 번째로 찾은 것입니다. | ||||
이름 클래스[원본 편집]
이름 클래스는 조합시킬 수 없습니다.
| 종류 | 명령어 | 출력 | 기본적인 사용법 | 설명 |
|---|---|---|---|---|
| I | label
|
{{위키데이터|label}}
|
현재의 항목 개체 또는 주어진 개체의 레이블을 반환합니다. 레이블이 없는 항목 개체는 링크된 문서의 제목이 있으면 그 제목으로 반환됩니다. | |
| II | title
|
{{위키데이터|title}}
|
현재의 항목 개체 또는 주어진 항목 개체에 링크된 문서의 제목이 있으면 그 제목을 반환합니다. 항목 개체의 레이블이 대신 반환되지 않습니다. | |
| III | alias
|
첫 번째의 것 하나* | {{위키데이터|alias}}
|
현재의 항목 개체 또는 주어진 항목 개체의 다른 이름(의 목록)을 반환합니다. |
aliases
|
모든 것 | {{위키데이터|aliases}}
| ||
| *(여러개의 다른 이름이 등록되어 있으면) 모든 것이 아닌 하나만을 반환합니다 | ||||
플래그[원본 편집]
아래의 (옵션의) 플래그는 이 틀의 행동을 바꾸는 것에 사용할 수 있습니다. 플래그는 (첫 번째의) 명령어 뒤, 다른 인수 앞에 부여되어야 합니다. 편의성을 위해서 빈 플래그(즉 ||)도 허가되고 있지만 단순히 무시됩니다.
명령어 플래그[원본 편집]
이들의 플래그(플래그 1*, 플래그 2*, ...)는 직전에 서술된 명령어에 직접 적용됩니다.
| 플래그 | 설명 |
|---|---|
linked
|
그 속성이나 한정자에 연결된 이음위키 문서가 있으면 그것으로 연결되는 링크를 작성합니다. 값에 추가되어 있는 측정 단위가 있으면 그것에도 링크합니다.
매개변수 생략 시에는 링크가 없는 속성 또는 한정자가 반환됩니다. |
short
|
[EXPENSIVE] 반환된 임의의 개체에 준말이 있으면 틀:P를 반환합니다. 그렇지 않으면, 개체의 레이블을 반환할 때 기본 동작이 발생합니다.
|
raw
|
사용할 수 있는 것이 있으면, 원시 값을 반환합니다.
이 플래그가 항목 또는 속성의 데이터 종별로 사용된 경우에는 Q 식별자 혹은 P 식별자를 반환합니다. 수량 데이터에 대해서는 이 플래그는 측정 단위를 제거합니다. 이 플래그가 일시 데이터에서 사용된 경우에는 반환된 날짜는 세계 좌표 데이터가 사용되고 있는 경우에는 반환된 값(예시: |
multilanguage
|
현재의 위키의 언어만이 아닌 임의의 사용 가능한 언어로 출력을 줄 수 있습니다. |
구성 플래그[원본 편집]
이들의 플래그(플래그 0*)은 전반적인 구성으로 첫 번째 명령어 뒤(이거나 다른 인수 앞)이면 어디에 두어도 상관없습니다.
| 플래그 | 설명 | |
|---|---|---|
| 조합 가능: | preferred
|
선택된 주장에 대한 랭크 제약을 설정합니다.
처음의 세 개는 어느 주장을 선택할지, 등급을 설정합니다. 옵션에 추가로 기본값은 출력은 (어느 플래그가 설정되어 있어도) 항상 높은 등급에서 낮은 것으로 정렬됩니다. |
normal
| ||
deprecated
| ||
best
| ||
| 조합 가능: | future
|
선택된 주장에 일시 제약을 설정합니다. 주장의 틀:P 및 틀:P 한정자를 사용해서 선택된 기간에 대해서 합리적인지 아닌지를 판단합니다.
기본값으로 |
current
| ||
former
| ||
| 택일: | edit
|
반환된 위키데이터 상의 주장을 독자가 편집하는데 사용할 수 있는, 출력 후의 클릭할 수 있는 아이콘을 추가합니다.
만약, |
edit@end
| ||
mdy
|
날짜 값을 일-월-년 순 대신에 월-일-년 순으로 반환합니다. | |
single
|
복수(여러 주장이 일치한 경우)가 아닌, 단일의 주장을 반환합니다. property/properties 명령어가 주어져 있는 경우에는 무의미하며, 이 플래그는 불필요합니다.
| |
sourced
|
적어도 하나의 합리적인 출처를 가지는 주장만을 반환합니다. |
인수[원본 편집]
인수는 모든 반환값을 얻어올 정보원을 결정합니다.
숫자 인수[원본 편집]
다음 표는 사용가능한 숫자 인수(인수*)를 고정된 순서로 나타내고 있습니다. 각 명령어에는 사용가능한 인수의 세트가 마크되어 있습니다. 여러 명령어가 주어진 경우에는 사용가능한 세트는 각각의 세트를 연결한 것이 됩니다. 예를들면properties와 qualifiers 명령어가 주어진 경우, 적어도 property_id 및 qualifier_id 인수의 양쪽이 마찬가지로 주어져야합니다.
하나 이상의 qualifier/qualifiers 명령어를 부여할 수가 있습니다. 플래그를 가지는 이들의 명령어 내에 주어져있는 순번은 각각의 qualifier_id 인수가 주어져있는 순번에 일치합니다.
| (필수) | (선택) | (선택) | (필수) | (선택) | (필수) | (필수) | |||
{{위키데이터
|
명령어
|
플래그
|
entity_id
|
property_id
|
raw_value
|
qualifier_id
|
qualifier_id
|
}}
| |
|---|---|---|---|---|---|---|---|---|---|
label, title
|
|||||||||
property/properties
|
|||||||||
reference/references
|
|||||||||
qualifier/qualifiers
|
|||||||||
qualifier/qualifiers (optional 2nd, 3rd, etc.)
| |||||||||
아래는 모든 인수를 설명합니다.
| 인수 | 설명 |
|---|---|
entity_id
(선택) |
[EXPENSIVE] 액세스해야할 항목 개체의 Q식별자(예시: Q55), 또는 Property: 접두사(예시: Property:P38)가 있는 액세스해야할 속성 개체의 P식별자(혹은 사용가능한 다른 이름).
이 매개변수가 생략된 경우, 현재 문서에 접속하고 있는 항목 개체가 사용됩니다. |
property_id
|
액세스해야할 개체 내의 속성의 P식별자(또는 사용가능한 다른 이름)로, Property: 접두사가 없는 것(예시: P35)).
|
raw_value
(선택) |
Q식별자가 속성값(예시: Q29574)과 같은지, 혹은 원시값(즉, 문자열 혹은 숫지 등 비항목 레이블)이 액세스해야할 특정 주장의 오리지널 속성값과 같은지.
Dates as literal values must be formatted Globe coordinates as literal values must be formatted with forward slashes (i.e. The special type 'no value' can be given by entering the empty string (i.e. 이 매개변수가 생략된 경우, 속성 내의 모든 주장(임의의 다른 제약에 일치하는 것)이 액세스됩니다. |
qualifier_id
|
액세스해야할 개체 내의 수식자의 P식별자(혹은 사용가능한 다른 이름)로, Property: 접두사(예시: P580)를 가지지 않는다.
|
이름 있는 인수[원본 편집]
이름 있는 인수는 식별자의 값을 기초로 해서 어느 주장에 액세스해야할지 결정합니다. 이것은 속성값에 기초로 해서 액세스를 결정하는 숫자 인수 property_id 및 raw_value의 한쌍과 닮아있습니다.
이름 있는 인수는 이름-값의 한쌍|qualifier=value으로, 호출 내부의 어디에서나 아래의 조건 하에 부여할 수 있습니다：
qualifier는 수식자의 P식별자(혹은 사용가능한 다른 이름)로Property:접두사(예시:P518)를 가지지 않습니다;value는 Q식별자가 수식자의 값 하나(예시:Q27561)와 같거나, 또는 원시값(즉 문자열이나 숫자 등, 비항목 레이블)이 액세스해야할 특정 주장의 오리지널 수식자의 값 하나와 같거나. 값의 형식은 숫자 인수raw_value용의 것과 같습니다. 빈 문자열의 주어진 '값 없음' 은, 특정 수식자의 주장 내에 전혀 없는 경우에도 일치합니다.
예시: |P518=Q27561
여러 이름 있는 인수는, 주장마다 동시에 여러 수식자의 값에 일치하도록 부여할 수가 있습니다.
속성의 다른 이름[원본 편집]
속성의 다른 이름은 P식별자 대신에 사용할 수 있는 다른 이름입니다. 아래의 속성의 다른 이름(대소문자를 구분)이 현재 사용할 수 있습니다:
| 다른 이름 | P식별자 | |
|---|---|---|
| coord | → | 틀:P |
| author | → | 틀:P |
| publisher | → | 틀:P |
| importedFrom | → | 틀:P |
| statedIn | → | 틀:P |
| pages | → | 틀:P |
| language | → | 틀:P |
| publicationDate | → | 틀:P |
| startTime | → | 틀:P |
| endTime | → | 틀:P |
| chapter | → | 틀:P |
| retrieved | → | 틀:P |
| referenceURL | → | 틀:P |
| archiveURL | → | 틀:P |
| title | → | 틀:P |
| quote | → | 틀:P |
| shortName | → | 틀:P |
| archiveDate | → | 틀:P |
