عرض مصدر وحدة:ResolveEntityId/شرح

{{تقييم وحدة|beta}}

== الاستخدام ==
وظائف مماثلة لـ [[:mw:Extension:Wikibase_Client/Lua#mw.wikibase.resolvePropertyId|mw.wikibase.resolvePropertyId]]، لكن تستخدم ل[[:mw:Extension:Wikibase_Client/Lua#mw.wikibase.entity|عناصر/كيانات]] [[:ويكي بيانات:|ويكي بيانات]] بدلًا من الخواص.

=== عبر الوحدات (_id) ===
الاستدعاءات النموذجية للوحدات:

{| class="wikitable"
|+ style="text-align:right"|
!الكود !! النتيجة !! ملاحظة
|-
|<syntaxhighlight lang="lua">local resolveEntityId = require( "Module:ResolveEntityId" )._id
id = resolveEntityId('Q42')</syntaxhighlight>
|style="vertical-align: mid;"|<code>id</code> = <code>{{#invoke:ResolveEntityId|entityid|Q42|'''nil'''}}</code>
| "Q42" هو معرف Wikidata صحيح ويتم إرجاعه كما هو.
|-
|<syntaxhighlight lang="lua">local resolveEntityId = require( "Module:ResolveEntityId" )._id
id = resolveEntityId('Q0')</syntaxhighlight>
|style="vertical-align: mid;"|<code>id</code> = <code>{{#invoke:ResolveEntityId|entityid|Q0|'''nil'''}}</code>
| لا يعتبر "Q0" معرف Wikidata صحيح
|-
|<syntaxhighlight lang="lua">local resolveEntityId = require( "Module:ResolveEntityId" )._id
id = resolveEntityId('Q404')</syntaxhighlight>
|style="vertical-align: mid;"|<code>id</code> = <code>{{#invoke:ResolveEntityId|entityid|Q404|'''nil'''}}</code>
| يعتبر عنصر "Q404" تحويلة في ويكي بيانات إلى عنصر Q395
|-
|<syntaxhighlight lang="lua">local resolveEntityId = require( "Module:ResolveEntityId" )._id
id = resolveEntityId('Q2147483647')</syntaxhighlight>
|style="vertical-align: mid;"|<code>id</code> = <code>{{#invoke:ResolveEntityId|entityid|Q2147483647|'''nil'''}}</code>
| عنصر Q2147483647 غير موجود في ويكي بيانات بعد
|-
|<syntaxhighlight lang="lua">local resolveEntityId = require( "Module:ResolveEntityId" )._id
id = resolveEntityId('دوغلاس آدمز')</syntaxhighlight>
|style="vertical-align: mid;"|<code>id</code> = <code>{{#invoke:ResolveEntityId|entityid|دوغلاس آدمز|'''nil'''}}</code>
| مقالة [[دوغلاس آدمز]] موجوده ولها معرف ويكي بيانات "Q42"
|-
|<syntaxhighlight lang="lua">local resolveEntityId = require( "Module:ResolveEntityId" )._id
id = resolveEntityId('ThisIsNotARealWikidataItem')</syntaxhighlight>
|style="vertical-align: mid;"|<code>id</code> = <code>{{#invoke:ResolveEntityId|entityid|ThisIsNotARealWikidataItem|'''nil'''}}</code>
| "ThisIsNotARealWikidataItem" is not a valid Wikidata ID, and no Wikipedia article exists at [[ThisIsNotARealWikidataItem]], so <code>'''nil'''</code> is returned
|-
|<syntaxhighlight lang="lua">local resolveEntityId = require( "Module:ResolveEntityId" )._id
id = resolveEntityId('ThisIsNotARealWikidataItem', 'Wikidata ID not found!')</syntaxhighlight>
|style="vertical-align: mid;"|<code>id</code> = <code>{{#invoke:ResolveEntityId|entityid|ThisIsNotARealWikidataItem|'Wikidata ID not found!'}}</code>
| Same as above, but the custom error message <code>Wikidata ID not found!</code> is returned
|-
|<syntaxhighlight lang="lua">local resolveEntityId = require( "Module:ResolveEntityId" )._id
id = resolveEntityId('Douglas adams')</syntaxhighlight>
|style="vertical-align: mid;"|<code>id</code> = <code>{{#invoke:ResolveEntityId|entityid|Douglas adams|'''nil'''}}</code>
| "Douglas adams" is not a valid Wikidata ID, and while [[دوغلاس آدمز]] (with a lower-case "a") exists, it is a redirect to [[دوغلاس آدمز]]. Therefore the Wikidata ID for the latter page is returned
|-
|<syntaxhighlight lang="lua">local resolveEntityId = require( "Module:ResolveEntityId" )._id
id = resolveEntityId('Wikipedia:Village pump (technical)/Archive 1')</syntaxhighlight>
|style="vertical-align: mid;"|<code>id</code> = <code>{{#invoke:ResolveEntityId|entityid|Wikipedia:Village pump (technical)/Archive 1|'''nil'''}}</code>
| "Wikipedia:Village pump (technical)/Archive 1" is not a valid Wikidata ID, and while [[أرابيكا:Village pump (technical)/Archive 1]] exists, it does not have a Wikidata ID, so <code>'''nil'''</code> is returned
|}

=== من خلال القوالب (entityid) ===
* تنتج الوحدة معرف الكيان (أو لا تنتج شيء إذا لم يكن المعرف موجودًا):
*: <code><nowiki>{{</nowiki>#invoke:ResolveEntityId|entityid|''id''}}</code>
*: مثال:
*:* {{#invoke:DemoTemplate|#invoke:ResolveEntityId|entityid|دوغلاس آدمز}}
*:* {{#invoke:DemoTemplate|#invoke:ResolveEntityId|entityid|Douglas Adams}}
* يمكن استخدام نص بديل في حالة عدم وجود قيمة:
*: <code><nowiki>{{</nowiki>#invoke:ResolveEntityId|entityid|''id''|'''نص بديل في حالة عدم وجود قيمة'''}}</code>
*: مثال:
*:* {{#invoke:DemoTemplate|#invoke:ResolveEntityId|entityid|مقالة غير موجودة|نص بديل للنتيجة}}

<includeonly>{{#ifeq:{{SUBPAGENAME}}|ملعب| |
<!-- Categories below this line, please; interwikis at Wikidata -->
[[تصنيف:وحدات ويكي بيانات]]
}}</includeonly>