¶ تصدير واستيراد التسلسل الهرمي للمجتمعات والحاويات
¶ أداة استيراد بنية المجتمع والحاوية
تمنحك هذه الأداة القدرة على استيراد دليل بنية المجتمع والحاوية من ملف XML مصدري.
¶ الاستخدام
|
[dspace]/bin/dspace structure-builder |
الأمر المستخدم: |
|
org.dspace.administer.StructBuilder |
طبقة جافا: |
|
وصف الحجة |
الحجة: صيغ قصيرة وطويلة (إن وجدت): |
|
ملف xml المصدر. يؤدي وجود هذه الحجة إلى وضع الاستيراد. |
-f |
|
ملف الإخراج xml. مطلوب. نسخة من المدخلات معززة بالهاندل المخصصة لكل مجتمع أو حاوية جديدة. |
-o |
|
البريد الإلكتروني لمدير دي سبيس. مطلوب. |
-e |
¶ تنسيق استيراد XML
يحتاج مدير النظام إلى إنشاء مستند xml مصدري بالتنسيق التالي:
|
<import_structure> <community> <name>Community Name</name> <description>Descriptive text</description> <intro>Introductory text</intro> <copyright>Special copyright notice</copyright> <sidebar>Sidebar text</sidebar> <community> <name>Sub Community Name</name> <community> ...[ad infinitum]... </community> </community> <collection> <name>Collection Name</name> <description>Descriptive text</description> <intro>Introductory text</intro> <copyright>Special copyright notice</copyright> <sidebar>Sidebar text</sidebar> <license>Special licence</license> <provenance>Provenance information</provenance> </collection> </community> </import_structure> |
سيبدو مستند الإخراج الناتج كالتالي:
|
<import_structure> <community identifier="123456789/1"> <name>Community Name</name> <description>Descriptive text</description> <intro>Introductory text</intro> <copyright>Special copyright notice</copyright> <sidebar>Sidebar text</sidebar> <community identifier="123456789/2"> <name>Sub Community Name</name> <community identifier="123456789/3"> ...[ad infinitum]... </community> </community> <collection identifier="123456789/4"> <name>Collection Name</name> <description>Descriptive text</description> <intro>Introductory text</intro> <copyright>Special copyright notice</copyright> <sidebar>Sidebar text</sidebar> <license>Special licence</license> <provenance>Provenance information</provenance> </collection> </community> </import_structure> |
تمنحك هذه الأداة القدرة على استيراد بنية المجتمع والحاوية مباشرةً من ملف XML مصدري. ويتم تنفيذه على النحو التالي:
|
[dspace]/bin/dspace structure-builder -f /path/to/source.xml -o path/to/output.xml -e admin@user.com |
سيؤدي ذلك إلى التحقق من محتويات ملف source.xml، واستيراد البنية إلى دي سبيس أثناء تسجيل الدخول كمدير للنظام، ثم إخراج نفس البنية إلى ملف الإخراج، ولكن بالتعامل مع كل مجتمع وحاوية تم استيرادها كسمة.
¶ مصدر بنية الحاويات والمجتمعات
تقوم أداة سطر الأوامر هذه بكتابة بنية المجتمع والمجتمع الحالي في مستند XML بالتنسيق الذي يمكن لأداة الاستيراد قراءته. انظر أعلاه للمزيد من التفاصيل حول التنسيق.
¶ الاستخدام
|
وصف الحجة |
الحجة: صيغ قصيرة وطويلة (إن وجدت): |
|---|---|
|
[dspace]/bin/dspace structure-builder [-h] [-?] -x -e <eperson> -o <output> |
|
|
تصدير البنية الحالية كـ XML. يؤدي وجود هذه الحجة إلى بدء وضع التصدير. |
-x, --export |
|
المستخدم الذي يتعامل مع بنية المستودع. مطلوب. تحدد حقوق هذا المستخدم الوصول إلى |
البريد الإلكتروني أو معرف شبكة -e, --eperson |
|
البنية التي تم تصديرها مكتوبة هنا. مطلوب. |
مسار ملف -o, --output |
|
مساعدة |
-h or -? |
¶ استيراد المواد عبر التنسيقات البيبلوغرافية الأساسية(Endnote و BibTex و RIS و TSV و CSV)والخدمات عبر الإنترنت(OAI و arXiv و PubMed و CrossRef و CiNii)
¶ مقدمة
تقدم هذه الوثائق شرحاً لميزات واستخدام إطار عمل أداة الاستيراد. تم بناء إطار عمل أداة الاستيراد في كل من واجهة برمجة تطبيقات REST وواجهة المستخدم. تشمل التنسيقات المدعومة حاليًا كل ما يلي:
- سحب وإفلات Endnote و BibTex و RIS و TSV و CSV و arXiv و PubMed. من صفحة رئيسيتي، سيؤدي سحب وإفلات أحد هذه الملفات إلى بدء تقديم جديد، واستخراج الميتاداتا من الملف.
- الاستيراد عبر أوركيد و PubMed ودورية شيربا وناشري شيربا. من صفحة رئيسيتي، يمكنك تحديد بدء تقديم جديد بالبحث عن مصدر خارجي.
¶ الميزات
- البحث عن منشورات من مصادر بعيدة.
- دعم تطبيقات متعددة.
¶ التقديم بدايةً من ملف مصادر خارجية
1. من صفحة رئيسيتي، يمكن بدء تقديم جديد ليس فقط باستخدام نموذج التقديم ولكن عن طريق ملء المتياداتا تلقائيًا كذلك، واستيرادها من العديد من الخدمات عبر الإنترنت.
2. بعد اختيار المصدر الخارجي للاستيراد منه وإدخال مصطلح في شريط البحث، سيقوم النظام بعرض قائمة النتائج المتطابقة.
3. عند تحديد مادة، سيقوم النظام بعرض الميتاداتا التي سيتم استيرادها، وفقًا للتعيين الذي تم تهيئته.
4. بالنقر على "بدء التقديم"، سيقوم النظام بعرض نماذج التقديم المملوءة بالميتاداتا التي تم استيرادها.
¶ التقديم بدايةً من ملف بيبلوغرافي
1. من صفحة رئيسيتي، قم بسحب وأفلت الملف البيبلوغرافي (مثل: bibtex ، endnote، وما إلى ذلك) في مربع إسقاط الملف
2. حدد الحاوية التي تريد التقديم إليها
3. سيتم إنشاء التقديم مع تحليل الميتاداتا من هذا الملف الببليوغرافي. كما سيتم إرفاق الملف البيبلوغرافي باعتباره تدفق بت (في حالة تعذر تحليل بعض الحقول بنجاح). يمكنك اختيار الاحتفاظ بها أو حذفها.
¶ المزيد من المعلومات
يمكن العثور على مزيد من المعلومات حول تهيئة تعيينات البيانات الأولية للعديد من تنسيقات وخدمات الاستيراد في وثائق الاستيراد المباشر من مصادر خارجية. راجع قسم "تحرير تعيين الميتاداتا".
¶ تسجيل تدفقات البت عبر تنسيق الأرشيف البسيط
¶ نظرة عامة
التسجيل هو وسيلة بديلة لدمج المواد، والميتاداتا الخاصة بها، وتدفقات البت الخاصة بها في دي سبيس من خلال الاستفادة من تدفقات البت الموجودة بالفعل في التخزين التي يمكن الوصول إليه من قبل دي سبيس. ومن الأمثلة على ذلك: وجود مستودع للأصول الرقمية الحالية. بدلاً من استخدام عملية الاستيعاب التفاعلية العادية أو الاستيراد بالدفعة لتزويد دي سبيس بالميتاداتا وتحميل تدفقات البت، يوفر التسجيل لدي سبيس الميتاداتا وموقع تدفقات البت. حيث يقوم دي سبيس باستخدام مجموعة متنوعة من أداة الاستيراد لإتمام التسجيل.
¶ التخزين القابل للوصول
لتسجيل مادة يجب أن يكون تدفق البت الخاص بها موجودًا على مساحة تخزين يمكن لدي سبيس الوصول إليها وبالتالي يُشار إليها برقم مخزن الأصول في dspace.cfg. حيث يقوم ملف التهيئة dspace.cfg بإنشاء مخزن واحد أو أكثر من مخازن الأصول عبر استخدام عدد صحيح لمتجر الأصول. يتعلق هذا العدد بدليل في نظام ملفات مضيف دي سبيس أو مجموعة من معلمات حساب SRB. ويتم وصف رقم مخزن الأصول في قسم ملف خصائص التهيئة dspace.cfg وفي ملف dspace.cfg نفسه. يجب ألا يكون رقم مخزن الأصول المستخدم للمواد المسجلة بشكل عام هو قيمة assetstore.incoming لأنه من غير المحتمل أن ترغب في دمج تدفقات البت الخاصة بالمواد المستلمة والمستوردة والمواد المسجلة بشكل طبيعي.
¶ تسجيل المواد باستخدام أداة استيراد المادة
يستخدم دي سبيس نفس أداة الاستيراد التي يتم استخدامها لاستيراد الدفعات فيما عدا أنه يتم استخدام العديد من التنويعات لدعم التسجيل.
لا يتضمن تنسيق أرشيف دي سبيس البسيط للتسجيل ملفات المحتوى الفعلية (تدفق البت) الجاري تسجيله. ومع ذلك، فإن التنسيق هو دليل مليء بالمواد المراد تسجيلها، مع دليل فرعي لكل مادة. ويحتوي كل دليل مادة على ملف ميتاداتا وصفية للمادة (dublin_core.xml) وملف يسرد ملفات محتوى المادة (المحتويات)، وليس ملفات المحتوى الفعلية نفسها.
ملف dublin_core.xml لتسجيل المادة هو نفسه تمامًا لاستيراد المادة العادي.
يقوم ملف المحتويات، مثل ملف الاستيراد العادي للمادة، بسرد ملفات محتوى المادة، بواقع ملف محتوى واحد في كل سطر، وبكل سطر أحد التنسيقات التالية:
|
-r -s n -f filepath -r -s n -f filepath\tbundle:bundlename -r -s n -f filepath\tbundle:bundlename\tpermissions: -[r|w] 'group name' -r -s n -f filepath\tbundle:bundlename\tpermissions: -[r|w] 'group name'\tdescription: some text |
حيث:
• يشير -r إلى أن هذا ملف سيتم تسجيله
• يشير -s n إلى رقم مخزن الأصول (n)
• يشير -f filepath إلى مسار واسم ملف المحتوى المراد تسجيله (filepath)
• \ t هو حرف جدولة
• الحزمة: bundlename هي اسم حزمة اختياري
• الصلاحيات: - [r | w] "اسم المجموعة" هي صلاحية قراءة أو كتابة اختيارية يمكن إرفاقها بتدفق البت
• الوصف: بعض النصوص عبارة عن حقل وصف اختياري لإضافته إلى الملف
تعتبر الحزمة، أي كل شيء بعد مسار الملف، اختيارية ولا يتم استخدامها عادةً.
سطر الأوامر للتسجيل مثله تمامًا للاستيراد المنتظم:
| [dspace]/bin/dspace import -a -e joe@user.com -c collectionID -s items_dir -m mapfile |
(أو باستخدام الصيغة الطويلة)
| [dspace]/bin/dspace import --add --eperson=joe@user.com --collection=collectionID --source=items_dir --map=mapfile |
ستعمل علامتا --workflow و --test كما هو موضح في استيراد المواد.
ستعمل علامة --delete كما هو موضح في استيراد المواد ولكن لن تتم إزالة ملفات المحتوى المسجلة من التخزين. انظر حذف المواد المسجلة.
ستعمل علامة --replace كما هو موضح في استيراد المواد ولكن يجب توخي الحذر عند النظر في الحالات والآثار المختلفة. مع تسجيل المواد القديمة والمواد الجديدة أو تناولها بشكل طبيعي، هناك أربع مجموعات أو حالات يجب مراعاتها. قبل كل شيء، عند حذف مادة مسجلة قديمة من دي سبيس باستخدام --replace لن يتم إزالتها من التخزين. انظر حذف المواد المسجلة. أين توجد. سيتم استيعاب مادة جديدة تمت إضافتها إلى دي سبيس باستخدام --replace بشكل طبيعي أو سيتم تسجيلها بناءً على ما إذا كان قد تم تمييزها في ملفات المحتويات بعلامة -r.
¶ التعريف الداخلي واسترجاع المواد المسجلة
بمجرد تسجيل مادة ما، لا يمكن تمييزها ظاهريًا عن المواد التي يتم تناولها بشكل تفاعلي أو عن طريق استيراد الدفعات. لكن هناك بعض الاختلافات داخليًا:
أولاً: لا يتم استخدام المعرف الداخلي الذي تم إنشاؤه عشوائيًا لأن دي سبيس لا يتحكم في مسار الملف واسم تدفق البت. بدلاً من ذلك، يكون مسار الملف واسمه هما المحددان في ملف المحتويات.
ثانيًا: يحتوي العمود store_number لصف قاعدة بيانات تدفق البت على رقم مخزن الأصول المحدد في ملف المحتويات.
ثالثًا: يحتوي العمود internal_id لصف قاعدة بيانات تدفق البت على علامة أولية (-R) متبوعة بمسار الملف المسجل واسمه. على سبيل المثال : -Rfilepath حيث filepath هو مسار الملف والاسم المرتبط بمخزن الأصول المطابق لرقم مخزن الأصول. يمكن أن يكون مخزن الأصول تخزينًا تقليديًا في نظام ملفات خادم دي سبيس أو حساب SRB.
رابعًا: يتم حساب مجموع اختباري MD5 عبر قراءة الملف المسجل إذا كان في التخزين المحلي.
يمكن استرداد المواد المسجلة وتدفقات البت الخاصة بها بشفافية تمامًا مثل المواد التي يتم استيعابها عادةً.
¶ تصدير المواد المسجلة
يمكن تصدير المواد المسجلة كما هو موضح في تصدير المواد. إذا كان الأمر كذلك، فسيحتوي دليل التصدير على نسخ فعلية للملفات التي يتم تصديرها ولكن الأسطر الموجودة في ملف المحتويات ستقوم بتعليم الملفات بعلامة مسجلة. مما يعني أنه إذا تم "تعثرت جولة" مواد دي سبيس (انظر نقل المواد بين حالات دي سبيس) باستخدام أداة التصدير وأداة الاستيراد، سيتم تسجيل الملفات المسجلة في دليل التصدير مرة أخرى في دي سبيس بدلاً من تحميلها واستيعابها بشكل طبيعي.
¶ حذف المواد المسجلة
إذا تم حذف مادة مسجلة من دي سبيس (إما بشكل تفاعلي أو باستخدام علامات --delete أو --replace الموضحة في استيراد وتصدير المواد عبر تنسيق الأرشيف البسيط) ستختفي المادة من دي سبيس لكن ملفات المحتوى المسجلة الخاصة بها ستبقى في مكانها تمامًا كما كانت قبل التسجيل. تدفقات البت غير المسجلة والتي تمت إضافته بواسطة دي سبيس كجزء من التسجيل، مثل ملفات License.txt، سيتم حذفها.
¶ استيراد وتصدير المواد عبر تنسيق الأرشيف البسيط
¶ أداة استيراد وتصدير المواد
يحتوي دي سبيس على مجموعة من أدوات سطر الأوامر لاستيراد وتصدير المواد على دفعات، باستخدام تنسيق أرشيف دي سبيس البسيط. بصرف النظر عن الوظيفة المعروضة، تعمل هذه الأدوات كمثال للمستخدمين الذين يهدفون إلى تنفيذ برنامج استيراد مواد خاص بهم.
تنسيق أرشيف دي سبيس البسيط
المفهوم الأساسي وراء تنسيق الأرشيف البسيط لدي سبيس هو إنشاء أرشيف، وهو دليل يحتوي على دليل فرعي واحد لكل مادة. يحتوي كل دليل مادة على ملف الميتاداتا الوصفية للمادة والملفات التي تتكون منها المادة.
|
archive_directory/ item_000/ dublin_core.xml -- qualified Dublin Core metadata for metadata fields belonging to the 'dc' schema. metadata_[prefix].xml -- metadata in another schema. The prefix is the name of the schema as registered with the metadata registry. contents -- text file containing one line per filename. collections -- (Optional) text file that contains the handles of the collections the item will belong to. Each handle in a row. -- Collection in first line will be the owning collection. relationships -- (Optional) If importing Entities, you can specify one or more relationships to create on import file_1.doc -- files to be added as bitstreams to the item. file_2.pdf item_001/ dublin_core.xml contents file_1.png ... |
¶ dublin_core.xml أم metadata_[prefix].xml
يحتوي ملف dublin_core.xml أو metadata_[prefix].xml على التنسيق التالي، حيث يكون لكل عنصر ميتاداتا إدخاله الخاص داخل مجموعة وسوم <dcvalue>. تتوفر حاليًا ثلاث سمات للوسوم في مجموعة الوسوم <dcvalue>:
• العنصر - عنصر دبلن كور
• المؤهل - مؤهل المادة
• اللغة - (اختياري) رمز لغة ISO للمادة
|
<dublin_core> <dcvalue element="title" qualifier="none">A Tale of Two Cities</dcvalue> <dcvalue element="date" qualifier="issued">1990</dcvalue> <dcvalue element="title" qualifier="alternative" language="fr">J'aime les Printemps</dcvalue> </dublin_core> |
• (لاحظ وسم علامة اللغة الاختيارية التي تعلم النظام بأن العنوان الاختياري باللغة الفرنسية.)
يجب تسجيل كل حقل ميتاداتا مستخدم عبر تسجيل الميتاداتا لتثبيت دي سبيس أولاً. انظر الميتاداتا وسجلات تنسيق تدفق البت.
¶ ملف المحتويات
يقوم ملف المحتويات ببساطة، ملف واحد في كل سطر، بتعديد أسماء ملفات تدفق البت. انظر المثال التالي:
|
file_1.doc file_2.pdf license |
يرجى ملاحظة أن الترخيص اختياري، وإذا كنت ترغب في إدراجه، فيمكنك وضع الملف في دليل .../item_001/ على سبيل المثال.
يمكن أن يتبع اسم تدفق البت اختياريًا أي مما يلي:
- \tbundle:BUNDLENAME
- \tpermissions:PERMISSIONS
- \tdescription:DESCRIPTION
- \tprimary:true
'BUNDLENAME' هو اسم الحزمة التي يجب إضافة تدفقات البت إليها. بدون تحديد الحزمة، ستنتقل المواد إلى الحزمة الافتراضية الأصلية.
'PERMISSIONS' نص بالتنسيق التالي-[r|w] 'group name'
'DESCRIPTION' هو نص وصف الملفات.
يستخدم Primary لتحديد تدفقات البت الأساسية.
¶ ملف العلاقات
يعدد ملف العلاقات الاختياري علاقات هذا الكيان بالكيانات الأخرى (سواء الموجودة بالفعل في النظام، أو المحددة أيضًا في دفعة استيراد SAF الخاصة بك). ويتيح ذلك ربط الكيانات بكيانات جديدة أو موجودة أثناء الاستيراد. يمكن ربط الكيانات بكيانات أخرى في دفعة الاستيراد هذه بالإشارة إلى اسم المجلد الفرعي للاستيراد. ونظرًا لأنه لا يمكن إنشاء العلاقات إلا للكيانات، فلا يمكن استخدامها إلا عند استيراد الكيانات القابلة للتهيئة.
يحتوي كل سطر في الملف على مفتاح نوع العلاقة ومعرف المادة بالتنسيق التالي:
| relation.<relation_key> <handle|uuid|folderName:import_item_folder|schema.element[.qualifier]:value> |
يجب أن يشير مجلد input_item_folder إلى اسم مجلد مادة أخرى في دفعة الاستيراد هذه. مثال:
|
relation.isAuthorOfPublication 5dace143-1238-4b4f-affb-ed559f9254bb relation.isAuthorOfPublication 123456789/1123 relation.isOrgUnitOfPublication folderName:item_001 relation.isProjectOfPublication project.identifier.id:123 relation.isProjectOfPublication project.identifier.name:A Name with Spaces |
أثناء الاستيراد الأولي، يتم تخزين المواد الجديدة في خريطة يتم تمييزها بواسطة اسم مجلد المادة. وبمجرد اكتمال الاستيراد الأولي، يقوم تمرير ثاني بالتحقق من ملف بيان 'العلاقات' في كل مجلد وإنشاء علاقة من النوع المحدد بالمادة المحددة.
لا تنس أن الكيانات تتطلب حقل ميتاداتا "dspace.entity.type"
وتذكر أنك إذا كنت تقوم بإنشاء كيانات جديدة عبر حزمة SAF، فيجب أن تقوم هذه الكيانات بتحديد حقل ميتاداتا "dspace.entity.type". نظرًا لوجود حقل الميتاداتا هذا في مخطط "dspace"، يجب تحديده في "metadata_dspace.xml"، على غرار:
metadata_dspace.xml
|
<dublin_core schema="relation"> <dcvalue element="isAuthorOfPublication">5dace143-1238-4b4f-affb-ed559f9254bb</dcvalue> </dublin_core> |
يعد ملف "العلاقات" بشكل أساسي من أجل إنشاء العلاقات بين الكيانات في نفس دفعة الاستيراد. بالطبع، يمكنك كذلك اختيار استخدام ملف "العلاقات" لإنشاء علاقات جديدة للكيانات الموجودة بدلاً من إنشاء أو تحديث ملف "metadata_relation.xml". الميزة الرئيسية لملف "metadata_relation.xml" هي أنه يتم استخدامه في كل من التصدير والاستيراد، بينما يتم استخدام ملف "العلاقات" عند الاستيراد فقط في الوقت الحالي.
¶ تهيئة metadata_[prefix].xml لمخطط مختلف
من الممكن استخدام مخطط آخر مثل EAD و VRA Core وما إلى ذلك. تأكد من أنك قمت بتعريف المخطط الجديد في سجل مخططات ميتاداتا دي سبيس.
1. قم بإنشاء ملف منفصل للمخطط الآخر المسمى metadata_[prefix].xml، حيث يتم استبدال [prefix] ببادئة المخطط.
2. داخل ملف xml، استخدم نفس صيغة دبلن كور، ولكن في عنصر <dublin_core> قم بإدراج السمة schema=[prefix].
3. فيما يلي مثال على ميتاداتا ETD ، والتي ستكون في ملف metadata_etd.xml:
|
<?xml version="1.0" encoding="UTF-8"?> <dublin_core schema="etd"> <dcvalue element="degree" qualifier="department">Computer Science</dcvalue> <dcvalue element="degree" qualifier="level">Masters</dcvalue> <dcvalue element="degree" qualifier="grantor">Michigan Institute of Technology</dcvalue> </dublin_core> |
¶ استيراد المواد
قبل تشغيل أداة استيراد المواد على المواد التي تم تصديرها مسبقًا من تثبيت دي سبيس، يرجى الرجوع أولاً إلى نقل العناصر بين تثبيتات دي سبيس.
| [dspace]/bin/dspace import | الأمر المستخدم |
| org.dspace.app.itemimport.ItemImport | طبقة جافا: |
| الوصف | الصيغ الطويلة والقصيرة للحجج |
| إضافة مواد إلى دي سبيس ‡ | -a or --add |
| استبدال المواد المدرجة في mapfile ‡ | -r or --replace |
| حذف المواد المدرجة في mapfile ‡ | -d or --delete |
| مصدر المواد (الدليل) | -s or --source |
| حاوية الوجهة بواسطة الهاندل أو معرّف قاعدة البيانات الخاص بها | -c or --collection |
| مكان العثور على ملف mapfile للمواد(الاسم والدليل) | -m or --mapfile |
| البريد الإلكتروني للشخص الالكتروني الذي يقوم بالاستيراد | -e or --eperson |
| إرسال تقديم عبر سير عمل الحاوية | -w or --workflow |
| إطلاق التنبيه بالبريد الإلكتروني للمواد لتي تم استيرادها | -n or --notify |
| التشغيل التجريبي، لا يقوم باستيراد المواد فعليًا | -t or --test |
| تطبيق قالب الحاوية | -p or --template |
| استئناف استيراد فاشل (يستخدم في الإضافة فقط) | -R or --resume |
| طلب المساعدة | -h or --help |
| اسم الملف المضغوط | -z or --zip |
‡ لا يعتمدان على بعضهما البعض
أداة استيراد المواد قادرة على استيراد عدد غير محدود من المواد لحاوية معينة باستخدام أمر CLI بسيط للغاية و 'حجج'.
¶ إضافة مواد إلى حاوية من دليل
لإضافة مواد إلى حاوية، عليك تجميع المعلومات التالية:
• الشخص الإلكتروني
• معرف الحاوية (إما الهاندل (على سبيل المثال: 123456789/14) أو المعرف العمومي الفريد
• دليل المصدر حيث توجد المواد
• Mapfile. بما أنه لا يوجد لديك واحداً، عليك تحديد مكانه (على سبيل المثال: /Import/Col_14/mapfile)
في سطر الأوامر:
| [dspace]/bin/dspace import --add --eperson=joe@user.com --collection=CollectionID --source=items_dir --mapfile=mapfile |
أو عن طريق استخدام الصيغة المختصرة:
| [dspace]/bin/dspace import -a -e joe@user.com -c CollectionID -s items_dir -m mapfile |
يقوم الأمر أعلاه بالتنقل بين مواد دليل الأرشيف، واستيرادها، ثم إنشاء ملف تخطيط يقوم بتخزين تخطيط أدلة المواد إلى هاندل المواد. قم بحفظ ملف التخطيط هذا. حيث يمكنك استخدامه لاستبدال أو حذف (إلغاء استيراد) المواد المخططة.
الاختبار. يمكنك إضافة –test أو (-t) إلى الأمر لمحاكاة عملية الاستيراد بأكملها دون القيام بالاستيراد بالفعل . يفيد ذلك للتحقق من ملفات الاستيراد قبل القيام بالاستيراد الفعلي.
¶ إضافة مواد إلى حاوية من ملف مصغوط
لإضافة مواد إلى حاوية، عليك تجميع المعلومات التالية:
• الشخص الإلكتروني
• معرف الحاوية (إما الهاندل (على سبيل المثال: 123456789/14) أو معرف قاغدة البيانات (على سبيل المثال: 2)
• الملف المضغوط
• Mapfile. بما أنه لا يوجد لديك واحداً، عليك تحديد مكانه (على سبيل المثال: /Import/Col_14/mapfile)
في سطر الأوامر:
| [dspace]/bin/dspace import --add --eperson=joe@user.com --collection=CollectionID --source=items_dir --zip=filename.zip --mapfile=mapfile |
أو عن طريق استخدام الصيغة المختصرة:
| [dspace]/bin/dspace import -a -e joe@user.com -c CollectionID -s items_dir -z filename.zip -m mapfile |
يقوم الأمر أعلاه بفك ضغط الملف المضغوط، والتنقل عبر مواد دليل الأرشيف، واستيرادها، ثم إنشاء ملف تخطيط يقوم بتخزين تخطيط أدلة المواد إلى هاندل المواد. قم بحفظ ملف التخطيط هذا. ويمكنك استخدامه لاستبدال أو حذف (إلغاء استيراد) المواد المخططة.
الاختبار. يمكنك إضافة –test أو (-t) إلى الأمر لمحاكاة عملية الاستيراد بأكملها دون القيام بالاستيراد بالفعل . يفيد ذلك للتحقق من ملفات الاستيراد قبل القيام بالاستيراد الفعلي.
¶ استبدال المواد في حاوية
استبدال المواد الموجودة سهل نسبيًا. هل تذكر ملف التخطيط الذي قمت بحفظه أعلاه؟ الآن سوف تستخدمه. الأمر (بصيغة مختصرة):
| [dspace]/bin/dspace import -r -e joe@user.com -c collectionID -s items_dir -m mapfile |
الصيغة الطويلة:
| [dspace]/bin/dspace import --replace --eperson=joe@user.com --collection=collectionID --source=items_dire --mapfile=mapfile |
¶ حذف أو إلغاء استيراد مواد في حاوية
يمكنك إلغاء استيراد المواد أو حذفها بشرط أن يكون لديك ملف التخطيط . هل تذكر ملف التخطيط الذي قمت بحفظه أعلاه؟ الأمر (بصيغة مختصرة):
| [dspace]/bin/dspace import -e joe@user.com -d -m mapfile |
بصيغة طويلة:
| [dspace]/bin/dspace import --eperson=joe@user.com --delete --mapfile mapfile |
¶ خيارات أخرى
سير العمل: تقوم أداة الاستيراد عادةً بتجاوز أي سير عمل معين لحاوية. لكن إضافة حجة --workflow (-w) ستقوم بتوجيه المواد المستوردة عبر نظام سير العمل.
القوالب: إذا كانت لديك قوالب تحتوي على بيانات ثابتة وترغب في تطبيق تلك البيانات أثناء الاستيراد بالدفعة، قم بإضافة الحجة --template (-p).
سيرة ذاتية: إذا حدث خطأ أثناء الاستيراد وتم إحباط الاستيراد، يمكنك استخدام وسم --resume (-R) لاستئناف الاستيراد من حيث توقفت بعد إصلاح الخطأ.
تحديد الحاوية المالكة على أساس كل مادة من أداة إدارة سطر الأوامر
إذا قمت بحذف الوسم -c، والتي يعتبر إلزامياً بخلاف ذلك، يقوم ItemImporter بالبحث عن ملف يسمى "الحاويات" في كل دليل مادة. يجب أن يحتوي هذا الملف على قائمة بالحاويات، واحدة لكل سطر، محددة إما من خلال الهاندل أو بواسطة معرف قاعدة البيانات الداخلي. سيقوم ItemImporter بعد ذلك بوضع المادة في كل حاوية من الحاويات المحددة. الحاوية المالكة هي الحاوية المحددة في السطر الأول من ملف الحاويات.
إذا تم تحديد كل من الوسم -c وكان ملف الحاويات موجودًا في دليل المواد، فسيتجاهل ItemImporter ملف الحاويات وسيضع المادة في الحاوية المحددة في سطر الأوامر.
ونظرًا لأن ملف الحاويات يمكن أن يختلف بين أدلة المواد، فإن ذلك يمنحك مزيدًا من التحكم الدقيق في عملية إضافة المواد إلى الحاويات.
¶ الاستيراد بالدفعة عبر واجهة المستخدم
يمكن أيضًا إجراء الاستيراد بالدفعة عبر واجهة المستخدم الإدارية. فيما يلي الخطوات التي يجب اتباعها:
أ. تحضير البيانات
1. يجب أن تكون المواد، أي الميتاداتا وتدفقات البت الخاصة بها، بتنسيق الأرشيف البسيط الموضح سابقًا في هذا الفصل. وبالتالي يجب أن يكون هناك دليل منفصل لكل مادة يحتوي على الملفات المقابلة للمادة المحددة.
2. علاوة على ذلك يمكن أن يكون هناك ملف آخر في كل دليل مادة يصف الحاوية أو الحاويات التي ستتم إضافة هذه المادة إليها. ويجب أن يكون اسم هذا الملف "حاويات" وهو اختياري. وأن يكون بالتنسيق التالي:
يحتوي كل سطر على هاندل الحاوية. الحاوية الموجودة في السطر الأول هي الحاوية المالكة بينما تمثل البقية الحاويات الأخرى التي يجب أن تنتمي إليها المادة.
3. ضغط أدلة المادة في ملف مضغوط. يرجى ملاحظة أنك بحاجة إلى ضغط أدلة المواد الفعلية وليس فقط الدليل الذي يحتوي على أدلة المادة. وبالتالي يجب أن يحتوي الملف المضغوط النهائي بشكل مباشر على أدلة المادة.
4. ضع الملف المضغوط في عنوان URL في نطاق عام، مثل دروب بوكس أو جوجل درايف أو في أي مكان يمكنك الوصول إليه للقيام بذلك. ونظرًا لأن مثل هذا الملف المضغوط يمكن أن يكون كبيرًا جدًا في الحجم، فإن واجهة مستخدم الاستيراد بالدفعة تحتاج إلى عنوان URL لتنزيله لموقع عام بدلاً من مجرد تحميله والحصول على استثناء المهلة.
ب. استيراد المواد عبر واجهة المستخدم
1. قم بتسجيل الدخول كمدير.
2. قم بالبحث عن القائمة في الجزء العلوي الأيمن من الصفحة، وتحديد خيار "أدر".
3. قم بتحديد خيار "استيراد بالدفعة" من قائمة "المحتوى" المنسدلة أعلى الصفحة.
4. قم بملء النموذج الذي يظهر على النحو التالي:
• الحقل رقم 1: قم بتحديد نوع بيانات الإدخال التي تريد استيرادها بالدفعة. وتأكد من تحديد "تنسيق الأرشيف البسيط" في هذه القائمة المنسدلة.
• الحقل رقم 2: قم بنسخ ولصق عنوان URL العام حيث يوجد الملف المضغوط المذكور سابقًا.
• الحقل رقم 3: قم بتحديد الحاوية المالكة للمواد التي تقوم باستيرادها. هذا الحقل اختياري، مما يعني أنه إذا تركته فارغًا، يجب عليك إدراج معلومات حاوية كل مادة (عبر ملف "الحاويات" المذكور سابقًا) في تنسيق الأرشيف البسيط.
• الحقل رقم 4: حدد الحاويات الأخرى التي تنتمي إليها المواد. يمكنك تحديد أكثر من حاوية بمجرد الضغط باستمرار على مفتاح Ctrl في لوحة المفاتيح. إذا حددت الحاوية المالكة في تحكم الإدخال متعدد التحديد، فسيتم تجاهلها في النهاية.
تعليقات:
1) إذا قمت بتحديد حاوية مالكة من هذا النموذج، فسيتم تجاهل ملف "الحاويات" الذي قد يتم إدراجه في المادة.
2) إذا لم تقم بتحديد حاوية مالكة، ولا يوجد ملف "حاويات" في دليل المادة، فلن يتم استيراد المادة في دي سبيس
وأخيرًا، عند تقديم النموذج، ستتلقى رسالة تخبرك بأن عملية الاستيراد قيد التنفيذ في الخلفية (حيث قد تستغرق وقتًا طويلاً). وفي النهاية، ستتلقى بريدًا إلكترونيًا بنجاح أو فشل العملية (إلى عنوان البريد الإلكتروني لحساب دي سبيس الخاص بك) لإعلامك بحالة الاستيراد.
ج. عرض الاستيرادات بالدفعة السابقة (التي تم إجراؤها عبر واجهة المستخدم)
1.قم بتسجيل الدخول.
2. قم بزيارة صفحة "ماي دي سبيس".
3. في الصفحة التالية، يمكنك مشاهدة سجل الاستيراد بالدفعة. حيث تتوفر المعلومات التالية لكل استيراد:
- حالة الاستيراد (نجاح أو فشل)
- عدد المواد التي حاول المستخدم استيرادها
- عدد المواد التي تم استيرادها بالفعل
علاوة على ذلك، يمكن للمستخدم القيام بالإجراءات التالية:
- تنزيل ملف التخطيط الذي تم إنتاجه أثناء الاستيراد. يحتوي هذا الملف على قائمة بالمواد التي تم استيرادها بالهاندل المقابل المخصص لها بواسطة دي سبيس.
- حذف المواد المستوردة. سيتم حذف كل ما تم استيراده (بما في ذلك دليل السجل الموجود في دليل "[dspace] / import")
- في حالة الفشل، يمكن للمستخدم "استئناف" الاستيراد. حيث يتم نقل المستخدم إلى نموذج التحميل مرة أخرى، لكن النظام يتعرف على الاستيراد الأولي (وملف التخطيط) لاستئناف الاستيراد القديم. توجد علامة حمراء في النموذج لإعلام المستخدم عن نموذج "استئناف".
¶ تصدير المواد
يمكن لأداة تصدير المادة تصدير مادة واحدة أو حاوية من المواد، وإنشاء أرشيف دي سبيس بسيط بالتنسيق المذكور أعلاه لكل مادة يتم تصديرها. يتم تصدير المواد بترتيب تسلسلي يتم استردادها به من قاعدة البيانات. ونتيجة لذلك، فإن أرقام التسلسل للأدلة الفرعية للمادة (item_000 ، item_001) لا تتعلق بمعرف دي سبيس أو معرفات المواد.
| [dspace]/bin/dspace export | الأمر المستخدم |
| org.dspace.app.itemexport.ItemExport | طبقة جافا |
| الوصف | الصيغ المختصرة والطويلة للحجج |
| نوع التصدير. سوف تقوم COLLECTION بإبلاغ البرنامج الذي تريده للحاوية بأكملها. سيكون ITEM هو المادة المحددة فقط. (ستقوم بالفعل بإدخال الكلمات الرئيسية بأحرف كبيرة. انظر الأمثلة أدناه.) | -t or --type |
| معرّف أو هاندل الحاوية أو المادة المراد تصديرها. | -i or --id |
| مسار الوجهة حيث تريد وضع ملف المواد. | -d or --dest |
| رقم التسلسل الذي سيبدأ به. مهما كان الرقم الذي تقدمه، فسيكون هذا هو اسم أول دليل تم إنشاؤه للتصدير. تخطيط دليل التصدير هو نفس التخطيط المستخدم للاستيراد. | -n or --number |
| تصدير المادة أو الحاوية للترحيل. سيؤدي هذا إلى إزالة الهاندل وأي ميتاداتا أخرى سيتم إعادة إنشائها في النسخة الجديدة من دي سبيس. | -m or --migrate |
| لا تقم بتصدير تدفقات البت. انظر سيناريو الاستخدام أدناه. | -x or --exclude-bitstreams |
| مساعدة مختصرة | -h or --help |
¶ تصدير حاوية
أمر CLI لتصدير مواد حاوية:
| [dspace]/bin/dspace export --type=COLLECTION --id=collectionID_or_handle --dest=/path/to/destination --number=seq_num |
الصيغة المختصرة:
| [dspace]/bin/dspace export -t COLLECTION -i collectionID_or_handle -d /path/to/destination -n seq_num |
تعني الكلمة المفتاحية COLLECTION أنك تنوي تصدير حاوية كاملة. يمكن أن يكون المعرف إما معرف قاعدة البيانات أو الهاندل. ستبدأ أداة التصدير في ترقيم الأرشيفات البسيطة برقم التسلسل الذي توفره.
¶ تصدير مادة واحدة
لتصدير مادة واحدة، استخدم الكلمة المفتاحية ITEM وقم بإعطاء معرف المادة كحجة:
| [dspace]/bin/dspace export --type=ITEM --id=itemID_or_handle --dest=/path/to/destination --number=seq_num |
الصيغة المختصرة:
| [dspace]/bin/dspace export -t ITEM -i itemID_or_handle -d /path/to/destination -n seq_num |
ستحتوي كل مادة تم تصديرها على ملف إضافي في دليلها، يسمى "handle". والذي سيحتوي على الهاندل الذي تم تعيينه للمادة، وسيتم قراءة هذا الملف بواسطة أداة الاستيراد بحيث تحتفظ المواد التي تم تصديرها ثم استيرادها إلى جهاز آخر بهاندل المادة الأصلي.
¶ استيراد وتصدير المحتوى من خلال الحزم
¶ أداة تصدير واستيراد الحزم
لإنشاء كائن دي سبيس جديد (مجتمع أو حاوية أو مادة)، أو نشر كائن دي سبيس كحزمة.
لمشاهدة جميع الخيارات، استدعها على النحو التالي:
| [dspace]/bin/dspace packager --help |
يقوم هذا الوضع أيضًا بعرض قائمة بأسماء البرامج المساعدة لاستيعاب الحزم والنشر المثبتة حاليًا في دي سبيس الخاص بك. قد يسمح كل برنامج مساعد من Packager أيضًا بخيارات مخصصة، والتي قد توفر لك مزيدًا من التحكم في كيفية استيراد الحزمة أو تصديرها. يمكنك رؤية قائمة بجميع خيارات الحزم المحددة عن طريق استدعاء --help (أو -h) مع الخيار --type (أو -t):
| [dspace]/bin/dspace packager --help --type METS |
سيعرض المثال أعلاه رسالة المساعدة العادية ، بينما يقوم أيضًا بسرد أي خيارات إضافية متاحة لبرنامج الحزمة المساعد "METS".
¶ الاستيعاب
¶ أوضاع وخيارات الاستيعاب
عند استيعاب الحزم، يدعم دي سبيس عدة "أوضاع" مختلفة. (يرجى ملاحظة أن البرامج المساعدة للحزم لا تدعم جميعها كل أوضاع العرض)
1. وضع الإرسال/الاستيعاب (خيار-s ، افتراضي) - إرسال الحزمة إلى دي سبيس من أجل إنشاء كائنات جديدة
2. وضع الاستعادة (خيار -r ) - استعادة كائنات موجودة مسبقًا في دي سبيس بناءً على الحزم. يحاول هذا الوضع أيضًا استعادة كل الهاندل والعلاقات (الكائنات الأصلية والفرعية). هذا نوع متخصص من "التقديم"، حيث يتم إنشاء الكائن بهاندل معروف وعلاقات معروفة.
3. استبدال الوضع (خيار -r -f ) - استعادة كائنات موجودة مسبقًا في دي سبيس بناءً على الحزم. يحاول هذا الوضع أيضًا استعادة كل الهاندل والعلاقات (الكائنات الأصلية والفرعية). هذا نوع متخصص من "الاستعادة" حيث يتم استبدال محتويات الكائنات الموجودة بالمحتويات الموجودة في حزم المعلومات الأرشيفية. افتراضياً إذا وجدت "استعادة" عادية أن الكائن موجود بالفعل، فسوف تتراجع (أي سيتم التراجع عن جميع التغييرات) والإبلاغ أن الكائن الموجود بالفعل.
¶ استيعاب حزمة واحدة
لاستيعاب حزمة واحدة من ملف، قم بإعطاء الأمر:
| [dspace]/bin/dspace packager -e [user-email] -p [parent-handle] -t [packager-name] /full/path/to/package |
حيث [user-email] هو عنوان البريد الإلكتروني للشخص الإلكتروني الذي يعمل هذا تحت صلاحيته؛ [parent-handle] هو هاندل الكائن الرئيسي الذي يتم إدخال الحزمة فيه، [packager-name] هو اسم البرنامج المساعد لأداة استيعاب الحزمة المراد استخدامه، و/full/path/to/package هو المسار إلى الملف للاستيعاب (أو "-" للقراءة من الإدخال القياسي).
فيما يلي مثال يقوم بتحميل ملف PDF بميتاداتا داخلية كحزمة:
| [dspace]/bin/dspace packager -e admin@myu.edu -p 4321/10 -t PDF thesis.pdf |
يأخذ هذا المثال نتيجة استرداد عنوان URL واستيعابه:
| wget -O - http://alum.mit.edu/jarandom/my-thesis.pdf | [dspace]/bin/dspace packager -e admin@myu.edu -p 4321/10 -t PDF - |
¶ استيعاب عدة حزم مرة واحدة
تدعم بعض برامج Packager المساعدة وظيفة الاستيعاب الكمي باستخدام علامة --all (أو -a). عند استخدام --all ، ستحاول أداة الحزمة استيعاب جميع الحزم الفرعية المشار إليها بواسطة الحزمة الأولية (والمتابعة بشكل متكرر). فيما يلي بعض الأمثلة:
- بالنسبة للحزمة المستندة إلى الموقع - من شأنها استيعاب جميع المجتمعات والحاويات والمواد بناءً على ملفات الحزمة الموجودة
- بالنسبة للحزمة المستندة إلى المجتمع - سيؤدي ذلك إلى استيعاب ذلك المجتمع وجميع المجتمعات الفرعية والحاويات والمواد استنادًا إلى ملفات الحزمة الموجودة
- بالنسبة للحاوية - سيؤدي ذلك إلى استيعاب تلك الحاوية وجميع المواد المضمنة بناءً على ملفات الحزمة الموجودة
- بالنسبة للمادة - يتم فقط استيعاب المادة (بما في ذلك جميع تدفقات البت والحزم) بناءً على ملف الحزمة.
فيما يلي مثال بسيط على نموذج أوامر "packager" للاستيعاب الكمي:
| [dspace]/bin/dspace packager -s -a -t AIP -e <eperson> -p <parent-handle> <file-path> |
على سبيل المثال:
| [dspace]/bin/dspace packager -s -a -t AIP -e admin@myu.edu -p 4321/12 collection-aip.zip |
سيقوم الأمر أعلاه باستيعاب الحزمة المسماة "collection-aip.zip" باعتبارها عنصرًا فرعيًا للكائن الأصلي المحدد (الهاندل = "4321/12"). يتم تعيين هاندل جديد للكائن الناتج (بما أن -s محددة). علاوة على ذلك، سيتم أيضًا استيعاب أي حزم فرعية يشار إليها مباشرة بواسطة "collection-aip.zip" بشكل متكرر (يتم أيضًا تعيين هاندل جديد لكل حزمة معلومات أرشيفية فرعية).
¶ لا تدعم كل أدوات الحزم الاستيعاب الكمي
نظرًا لأن برنامج أداة الحزم المساعد يجب أن يعرف كيفية تحديد موقع جميع الحزم الفرعية من ملف الحزمة الأولي، فلا يمكن لكل البرامج المساعدة دعم الاستيعاب الكمي. حاليًا في دي سبيس تقوم برامج Packager المساعدة التالية بدعم إمكانيات الاستيعاب الكمي:
- برنامج METS Packager المساعد
- برنامج AIP Packager المساعد