بيانات سريعة هي أداة كتها ماغنوس مانسك، يمكن عبرها تعديل عناصر ويكي بيانات، بمجموعة بسيطة من الأوامر النصية، يمكن للأداة إضافة وإزالة البيانات والتسميات والأوصاف والتسميات المستعارة وكذلك إضافة بيانات مع التصفيات والمراجع. يمكن كتابة تسلسل الأوامر في نافذة الاستيراد أو يتم إنشاؤها في جدول بيانات، عبر محرر نصي ولصقها إلى الأداة. ويمكن أيضا أن يتم إنشاؤها بواسطة كود خارجي، عبر لغات برمجة مثل لوا وتمريرها عبر رابط إنترنت.
Syntax between versions can vary slightly. The rest of the document will describe the syntax of the current version, but will mark parts which were not supported in the earlier versions.
تركيب الأوامر
This section describes syntax used since V1 version of the tool, sometimes referred to as V1 commands[1].
إضافة بيان بسيط
You can specify the statements to add by typing/pasting into the tool's text area. Different parts of the statement are separated by a TAB or "|"[2] characters. Each command is in a new line, or separated by "||"[2] characters.
Hint: You can also use a spreadsheet software such as Microsoft Excel or LibreOffice Calc; copying/pasting the cells should automatically insert TABs. Also text editors like Notepad++ allow replacement of any symbol by the TAB character (\t).
كل جملة must تتكون من كيان وخاصية وقيمة.
الكيان يمكن أن يكون عنصر أو خاصية أو لكسيم أو شكل أو sense.
القيمة يمكن أن يكون كيان آخر أو سطر نصي أو وقت أو موقع أو كمية، اعتمادا على نوع الخاصية، أو واحدة من القيم الخاصة somevalue أو novalue (طالع Help:Statements#Unknown or no values).
A value can be another entity, a string, a time, a location, or a quantity, depending on the property type, or one of the special values somevalue or novalue (see Unknown or no values).
Formatting of each part:
Items on Wikidata are always in the form Qxx. On Commons they are always in the form Mxx. In QuickStatements version 1 one could use an article name instead of the q-code, if one filled in a xxwiki value in the input box above the text area; the correct item number (if available) was retrieved automatically.
Strings (including URLs, and numerical values of text fields, for example external-ID property values) must be in "double quotes". Many statements take values in string format, including external identifiers (like VIAF cluster ID (P214)), filenames (like image (P18)) or other page names (like Commons category (P373)).
Caution: Some characters in the string seem to confuse the tool. Those include: "_" (underscore), " (double quote), " " (spaces), "=", and possibly more. Adding URLs with those characters, like this one or this might fail. Strings and URLs with those characters might work when interacting with the tool through the interface but fail when interacting through URL.
Monolingual text prefix text in "double quotes" with the language and a colon, e.g. en:"Some text"
Time values must be in format eg +1967-01-17T00:00:00Z/11, where /11 designates the precision. The precision is: 0 - billion years, 1 - hundred million years, ..., 6 - millennium, 7 - century, 8 - decade, 9 - year (default), 10 - month, 11 - day, 12 - hour, 13 - minute, 14 - second.
Use "+" for CE dates and "-" for BCE dates; and use at least 4 digits.
Set an additional "/J" if you want to set the date in Julian Calendar (see this list to understand where this should be done).
If submitting to the API, use "%09" instead of the TAB symbol, "%2B" instead of the "+" symbol, "%3A" instead of the ":" symbol, and "%2F" instead of the "/" symbol.
Location coordinates in the form of @LAT/LON, with LAT and LON as decimal numbers.
Quantity in the form of amount~toleranceUxx[2], with amount and tolerance being a rational numbers and Uxx being the item number of a unit (Qxx). Unit and tolerance values are optional. Don't leave any spaces in the quantity definition.
QuickStatements version 1 used different syntax for Quantity: amount[lower,upper]Uxx, with amount, lower and upper being a rational numbers.
lower, upper are optional and must be either both present or both absent. When present, they should be enclosed in square brackets and separated by ,
amount, lower and uppermust use . as decimal separator, must not use any thousands separator and may be prefixed by "+" or "-".
10, 10U11573, -10[-12.5,-7.5], 0[-5,5]U11573 are all valid quantities (where U11573 indicates metre (Q11573))
Quantities with tolerance may be entered as 1.2~0.3 in QuickStatements version 2, which is the same as 1.2[0.9,1.5] in QuickStatements version 1 and means 1.2±0.3. [3]
novalue for no valueHelp. Both novalue and somevalue should be used without double quotes around it. Both of those statements do work as part of item creation statements using CREATE and LAST keywords.They don’t work in CREATE and LAST statements! Consider using these placeholders instead: placeholder for "novalue" (Q108474139), placeholder for "somevalue" (Q53569537)
إضافة بيان مع تصفيات
يمكن أن يتبع كل بيان "ثلاثي" عدد غير محدود من "أزواج تصفيات" propertyTABvalue.
يمكن أن يتبع كل بيان عدد غير محدود من "أزواج مصدر" خاصية المصدرتبويبقيمة، الخاصية المصدر مماثلة للخاصية "العادية"، إلا أنها تستخدم النموذج Sxx بدلا من Pxx.
By default, all sources will go into the same "reference group" (a block of property/value pairs). If you want to create more than one reference group in a single command row, simply prefix the first source property of the new group with an exclamation mark: "!Sxx" instead of "Sxx". (In the first reference group, the "!" is optional and will not influence the outcome.)
ملاحظات:
البيانات مع تطابق تام (للخاصية والقيمة) لن تضاف مرة أخرى؛ ولكن يمكن إضافة مراجع إضافية إلى البيان.
وفي الإصدار السابق، كانت كل مصدر تمثل مرجعا فرديا، ولم تكن تجمع ضمن مرجع واحد؛ لكن هذا تم تصويبه في الإصدار الثاني.
Existing statements with an exact match (property and value) will not be added again; however additional references might be added to the statement.
You can mix qualifiers and references in the same statement. Just use Sxx instead of Pxx when using sources.
In QuickStatements version 1 each source claim represented an individual reference, i.e. they were not grouped within one reference; it works properly now in QuickStatements version 2.
إضافة تسميات وتسميات مستعارة وأوصاف ووصلات مواقع
As with adding simple text statements, each command must consist of an item, a command, and a string in double quotes.
To add a label in a specific language to an item, use "Lxx" instead of a property, with "xx" as the language code. "Lmul" is valid for setting a default label for all languages, which is useful for brand names, software programs, etc.
Tip: Multiple aliases can be added at the same time by separating them with the pipe character ("|"). Warning: This does not work when creating a new item in QS 2.0 (magnusmanske/quickstatements_rs#3)
If you want to remove a label/alias/description/sitelink, the value has to be an empty string and the rest of the command will be the same.
إنشاء عنصر جديد
يُرجَى التأكد من عدم إنشاء عناصر مكررة!
يمكنك إنشاء عناصر جديدة عن طريق إدراج سطر يتكون فقط من الكلمة "إنشاء"، لإضافة بيانات إلى العنصر المنشاأ حديثا; استخدم الكلمة "LAST" بدلا من رقم Q، وستتم إضافة البيان إلى آخر عنصر تم إنشاؤه.
An example for creating a new item, adding a sitelink, and setting a label:
CREATE
LASTTABSfrwikiTAB"Le croissant magnifique !"
LASTTABLfrTAB"Le croissant magnifique !"
Meaning: create a new item with a link to French Wikipedia w:fr:Le croissant magnifique! and with French label "Le croissant magnifique!"
Properties may be created in the same way with "CREATE_PROPERTY" followed by a TAB or | and the entity type, e.g. one of:
name of statement node in RDF which may be queried by query service (you need to replace the - after entity ID with $)
تعليقات
Every command can have a comment at its end, which will be inserted into the edit summary for the command[2]. Use the /* ... */ syntax. Before this a TAB may be inserted. Spaces around the comment will be removed before processing. The tool splits adding of a claim and its reference in two edits. When using the "version 1 format" import it seems not to be possible to add a comment for the edit adding the reference. The comment is added to the edit adding the claim (if the claim does not exist yet and is added at all).
Example: Q4115189TABP31TABQ1 /* This is a comment. */
في الإصدار 2، يمكن للمرء أيضا قص ملف CSV منظم بشكل صحيح ولصقه كبديل للصياغة المقدمة في بيانات سريعة الإصدار 1، سيحدد ملف CSV الأوامر المطلوب تنفيذها، الصف الأول هو عنوان يصف كيفية تفسير الأعمدة.
For example, a column called P31 could contain the value Q5 to create a statement with property P31 and value Q5.
For some reason, string values need to be put in """triple double quotations""".
qid
Always the first column of commands: the values in the column should contain the id of the item or entity to edit. If the cell is left empty, a new item will be created. See the item creation sample below.
قد تحدد الأعمدة الأخرى الأوامر التالية:
P1234
A property ID (uppercase) begins a new statement. The column value specifies the main value of the statement, in the same format as in QuickStatements version 1.
qal1234
A lowercase "qal" followed by a property number (without "P") adds a qualifier to the current statement. The column value specifies the value of the qualifier, in QuickStatements version 1 syntax. There must be some "P" column before a "qal" column to specify which statement the qualifier is added to.
S1234
An uppercase "S" followed by a property number (without "P") begins a new source for the current statement. The column value specifies the value of the source, in QuickStatements version 1 syntax. There must be some "P" column before an "S" column to specify which statement the source is added to.
s1234
A lowercase "s" followed by a property number (without "P") adds another property-value pair to the current source. The column value specifies the value of the source, in QuickStatements version 1 syntax. There must be some "S" column before an "s" column to specify which source the property-value pair is added to.
Len
An uppercase "L" followed by a language code sets the label in that language.
Dfr
An uppercase "D" followed by a language code sets the description in that language.
Ade
An uppercase "A" followed by a language code adds an alias in that language.
Senwiki
An uppercase "S" followed by a site ID adds a sitelink to that site.
#
A number sign character sets the edit summary (comment) of the preceding command. The tool splits adding of a claim and its reference in two edits. A comment can be added to the edit summary of each of them. For the claim by putting a "#" column between the columns for the claim and its reference, for the reference by putting a "#" column behind its columns. For example:
qid,P21,#,S143,s813,#
Q22124656,Q6581097,comment to claim adding edit,Q24731821,+2017-10-04T00:00:00Z/11,comment to reference adding edit
Item creation
لإنشاء عنصر جديد; يجب أن يكون العنصر الأول من الصف فارغا، بحيث يبدأ السطر بـ,</code.
oil painting by Leonardo da Vinci in the Louvre, Paris
,Q3305213,"Mona Lisa","oil painting by Leonardo da Vinci in the Louvre, Paris","""Mona Lisa - the Louvre.jpg"""
Statement removal commands
قد تبدأ رؤوس أعمدة كشف البيان أيضا - لإزالة البيان. (لاحظ أن هذا صحيح فقط في الرأس للعمود بالكامل، وليس في القيم الفردية.) إزالة أنواع الأعمدة الأخرى غير مدعومة بعد وستؤدي إلى حدوث خطأ عند تشغيل الأمر، ومع ذلك، يمكن إزالة روابط المواقع والتسميات عن طريق تعيينها على السلسلة الفارغة (بدون - في رأس العمود).
Labels, descriptions, aliases and sitelinks do not need to be in double quotes unless they themselves contain commas (,) or double quotes (").
In this case, replace all double quotes with two double quotes (e.g. Toys "R" Us → Toys ""R"" Us) and then wrap the string in a pair of double quotes (e.g. "Toys ""R"" Us").
Q4115189,"Toys ""R"" Us",testin sample,Toys R Us,Q5,Q36180,Q6581097,Q463035,"""1""",Q54919,"""113230702""",Q328,"Toys ""R"" Us"
Samples by value type
Samples use the sandbox item (Q4115189) and can be pasted directly into QuickStatements for testing. Should be risk-free.
Label
qid,Len
Q4115189,Sandbox
Q4115189,"Patterns, Predictors, and Outcome"
Q4115189,"Toys ""R"" Us"
Description
qid,Den
Q4115189,Wikidata item for tests
Q4115189,"sample for Patterns, Predictors, and Outcome"
Q4115189,"description sample for Toys ""R"" Us"
Alias
qid,Aen
Q4115189,Wikidata sandbox
Q4115189,"Predictors, Patterns, and Outcome"
Q4115189,"Toys ""4"" You"
Item
qid,P369
Q4115189,Q5
Q4115189,somevalue
Q4115189,novalue
L123,Q5
L123-S1,Q5
L123-F1,Q5
somevalue is for unknown valueHelp, novalue for no valueHelp. At the moment, somevalue and novalue don’t work when creating new items! F1 and S1 on Lexeme:L123 would have to exist for it to work.
String or external identifiers (external-id)
qid,P370
Q4115189,"""Sandbox"""
Q4115189,"""Patterns, Predictors, and Outcome"""
Q4115189,"""Toys ""R"" Us"""
Monolingual text
qid,P1450
Q4115189,en:"Sandbox"
Q4115189,en:"Toys "R" Us"
Q4115189,"en:""Toys ""R"" Us"""
Q4115189,"en:""Patterns, Predictors, and Outcome"""
en is for English
Date/time
qid,P577
Q4115189,+1856-01-01T00:00:00Z/9
Q4115189,+1856-01-01T00:00:00Z/10
Q4115189,+1856-01-01T00:00:00Z/11
Precisions are 9=year, 10=month, 11=day, so the dates are 1856, January 1856 and 1 January 1856.
Image/Commons media file
qid,P18
Q4115189,"""Frans Breydel - A merry company.jpg"""
Q4115189,"""'Girl Reading' by Mary Colman Wheeler, El Paso Museum of Art.JPG"""
Q4115189,"""Kaubalaeva ""E. Russ"" vrakk.jpg"""
Q4115189,"""''L'empereur Napoleon III'' de Franz-Xaver Winterhalter.jpg"""
تأكد من تسجيل الدخول في OAuth ومن رؤية اسمك في الزاوية العلوية اليسرى، إن لم يكن ثم تسجيل الدخول.
انقر فوق "New batch".
قص والصق أوامرك. انظر بناء الجملة في القسم أعلاه.
عند الانتهاء، انقر فوق "Import V1 commands" أو "Import CSV commands".
ستقوم الأداة بتحويل الأوامر إلى نموذج قابل للقراءة، تفقده وانقر فوق "Run" للتنفيذ.
أثناء معالجة بياناتك، تحقق مرة أخرى من النتائج، واضغط على "Stop" إذا اكتشفت مشكلة.
ستخبرك واجهة المستخدم عند معالجة جميع البيانات.
إعداد بيانات في جدول بيانات
قص ولصق الخلايا مباشرة في إطار الاستيراد
تقوم الأداة بتحويل الأوامر الخاصة بك إلى شكل قابل للقراءة البشرية وينتظر الموافقة عليها
الإداة تقوم بتنفيذ الأوامر. يرجى الاطلاع على زر "إيقاف".
الأداة أكملت المهمة
عبر الإصدار الأول
لقطة شاشة لاستخدام بيانات سريعة الإصدار 1
الإصدار 1 من بيانات سريعة لا يزال متوفرا ولكن لم يعد مصانا، توقف عمله لبعض المستخدمين، في حين لا يزال تيمل بشكل جيد للآخرين، انشقاق NIOSH للأداة متاح أيضا.
تحذير:As of May 2020, duplicated items may be created in batch mode. Please make sure you can find and merge them! This does not affect frontend mode.
متى تستخدم طريقة الدفعات؟
الإصدار الثاني لدية زر "تشغيل في الخلفية"
يعني وضع الدفعات (المعروف أيضا بالتشغيل في الخلفية) أن بياناتك يتم تنفيذها من خادم ويكيميديا، بدلا من متصفح الويب الخاص بك، هذا له العديد من المزايا:
حتى إذا قمت بإغلاق المتصفح أو إذا تعطل حاسوبك، سيتم تنفيذ البيانات حتى آخرها.
يمكنك إطلاق عدة دفعات في نفس الوقت، دون إبطاء حاسوبك.
يمكنك الحصول على مسار فريد لدفعتك، يمكنك الرجوع إليه لاحقا، تعرض هذه الصفحة بعض الإحصاءات حول شغلك.
يمكن لأي شخص إيقاف دفعتك بالانتقال إلى هذا المسار، على سبيل المثال، إذا أدرك شخص ما أن مجموعتك خاطئة وأنك نائم، فيمكنه إيقافها على الفور (بالانتقال إلى صفحة الدفعة الفردية)، بدلا من الاضطرار إلى منعك.
Even if you close your browser or if your computer crashes, the statements will be executed until the last one.
You can launch several batches in parallel, without slowing down your computer. (The batches seem to be run sequentially)
You get a unique URL for your batch, to which you can refer later. This page shows some statistics about your run.
To see all your recent batches click "Your last batch". To see everybody else's recent batches click "Last batches"
You or a project admin can stop your batch by going to its URL. For instance, if it is realized that the batch is erroneous and you are offline, an admin can stop it immediately (by going to the individual batch page), rather than having to block you.
If you discover that something went wrong, you can revert the whole batch afterwards
ولكن هناك أيضا عيوب:
يمكنك فقط رؤية العدد الإجمالي للأخطاء، وليس البيانات التي تنتج خطأً، في الواقع، لا يمكنك رؤية أي بيان.
يستغرق الأمر بضع نقرات إضافية، كقاعدة عامة إذا كان لديك 10 بيانات أو أقل فقط، فعندئذ يمكنك تشغيلها بشكل أفضل في الوضع العادي.
التحقق من التعديلات أثناء الانتظار ليس سهلا; حيث لا تحصل على قائمة بالعناصر التي تمت معالجتها حتى الآن.
قبل تشغيل إحدى الدفعات، قد يكون من الجيد تشغيل بعض البيانات مباشرةً في وضع غير الدفعات للحصول على عرض جيد لما يتم تنفيذه.
Many templates on Commons, like c:Template:Creator or c:Template:Artwork use that technique to package information that can be imported to Wikidata into a clickable URL.
تلميحات:
لا يمكن أن يحتوي المسار على أية مسافات، استبدل TAB بـ "%09"، وعلامتي التنصيص بـ"%22"، والمساحة بـ"%20" ، ونهاية السطر بـ"%0A" والشرطة "/" with "%2F".
يمكن إضافة البيانات التي تحتوي على مدخلات المسار التي تحتوي على "_" أو " " من خلال واجهة عادية ولكن ليس من خلال المسار، على سبيل المثال هذا المسار تم إنتاجه بواسطة الأداة ويعمل، ومع ذلك، إذا قمت بالنقر فوقه أو قمت بقصه ولصقه، فسوف ينتهي بك الأمر في صفحة ذات مسار مختلف قليلا، وهذا لا يعمل.
[[File:Commons to Wikidata QuickStatements.svg|20px|link=https://tools.wmflabs.org/quickstatements/index_old.html/#v1=Q37887397%09P214%09%2296480189%22%09S143%09Q565]] يقوم بترميز مسار داخل أيقونة يدوية قابلة للنقر: (انقر فوقها ولكن لا تنقر فوق "run"، ولن يعمل الضغط عليها لأن هذا العنصر يحتوي بالفعل على هذه الخاصية).
يمكن تحديد الصفحات التي تحتوي على مسارات بيانات سريعة من خلال Special:LinkSearch (راجع هنا) أو من خلال استدعاء استعلام قاعدة بيانات externallinks table (انظر على سبيل المثال هنا).
[[File:Commons to Wikidata QuickStatements.svg|20px|link=https://quickstatements.toolforge.org/#/v1=Q37887397%7CP214%7C%2296480189%22%7CS143%7CQ565]] will encode the URL within a handy clickable icon: (click it but do not click "run"; pressing it will not work since that item already has that property).
إضافة بيان ثاني بنفس الخاصية والقيمة لكن بمعرفات مختلفة، بما أن المعرفات الإضافية ستتم إضافتها للبيان الأول
Note that for using QuickStatements, an account needs to be autoconfirmed. Also there is no way for users using bot accounts to mark their edits as bot edit (but there is an open ticket to address that).
الأسئلة الشائعة
هل يمكن لبيانات سريعة إضافة البيانات المرجعية بأكثر من ادعاء واحد؟
ما هو الحد الأقصى لعدد الأوامر التي يمكنني إدخالها دفعة واحدة؟
غير موثق، تم اختباره بالفعل بأكثر من 11000 أمر، ولكن لاحظ أن هذه الدفعات الكبيرة ستستغرق عدة ساعات حتى تكتمل.
أفضل الممارسات
تسمح بيانات سريعة بإجراء تعديلات تتراوح من بيان واحد إلى تشغيلات متعددة الآلاف للعناصر، يجب أن تتم عمليات التشغيل الكبيرة أو التي يُحتمَل أن تكون مثيرة للجدل من خلال عملية موافقة موضحة في Wikidata:Bots.
المستخدمون الذين يقومون بإجراء التعديلات مسؤولون عن إصلاح تغييراتهم أو التراجع عنها في حالة العثور على مشكلات، راجع إزالة البيانات.
Using the API to start batches
If you are logged in on QuickStatements, you can get a token on your user page. That page also contains information about how to use the token to submit batches programmatically. You need to have submitted at least one server-side batch manually before for this to work!
Edit groups
QuickStatements V2 creates edit groups for all individual batches. You may discuss individual edit groups, or rollback the whole edit group.
EditGroups is another external tool, not part of QuickStatements. Currently it works on Wikidata, and there is also an instance for Commons. On other Wikibase instances, it may be unavailable.
QuickStatements 3.0
QuickStatements 3.0 is a similar tool developed and maintained by Wikimedia Brasil. It uses a syntax compatible with Magnus Manske's QuickStatements V2, but is otherwise an unrelated tool.
↑ 2.02.12.22.3syntax works only in QuickStatements version 2
↑Note that due to the way computers operate with floating-point numbers the input format of version 2 may produce undesired results when working with decimal numbers.
إعداد بيانات في جدول بيانات
قص ولصق الخلايا مباشرة في إطار الاستيراد
تقوم الأداة بتحويل الأوامر الخاصة بك إلى شكل قابل للقراءة البشرية وينتظر الموافقة عليها
الإداة تقوم بتنفيذ الأوامر. يرجى الاطلاع على زر "إيقاف".
الأداة أكملت المهمة
(انقر فوقها ولكن لا تنقر فوق "run"، ولن يعمل الضغط عليها لأن هذا العنصر يحتوي بالفعل على هذه الخاصية).