استخدم تخزين التطبيق لتخزين الملفات التي يستخدمها تطبيقك قيد التشغيل وتنظيمها وإدارتها، بما في ذلك الصور ومقاطع الفيديو والمستندات وعمليات رفع المستخدمين.

قبل استخدام تخزين التطبيق، قم بربط المشروع بـ سحابة Atoms. إذا لم يكن مرتبطًا، فاطلب من Agent ربط سحابة Atoms أو اتبع سحابة Atoms.

فهم تخزين التطبيق في سحابة Atoms

تخزين التطبيق يخزن الملفات التي يحتاج مشروعك إلى الاحتفاظ بها والوصول إليها. وهو منفصل عن البيانات المنظمة المخزنة في قاعدة البيانات الخاصة بك، والملفات التي تم رفعها في Chat، والملفات التي يتكون منها كود مشروعك.

مصطلحات أساسية

• Bucket: الحاوية الرئيسية المستخدمة لتخزين الملفات ذات الصلة وتجميعها. يمكنك التفكير في الـ bucket على أنها مساحة تخزين لفئة واحدة من الملفات. يتم تعيين كل bucket إما كـ Public أو Private، وهذا يحدد من يمكنه الوصول إلى الملفات الموجودة بداخلها.
• Folder: طريقة اختيارية لتنظيم الملفات داخل bucket. تعمل المجلدات مثل المجلدات الموجودة على جهاز الكمبيوتر الخاص بك، ويمكن أن تساعد في جعل المجموعات الأكبر من الملفات أسهل في الإدارة.
• Object: ملف فردي مخزن داخل bucket أو folder، مثل صورة أو مستند أو فيديو أو ملف آخر تم رفعه.
• Object key: المسار الفريد المستخدم لتحديد مكان تخزين الملف داخل bucket. على سبيل المثال، يمكن أن يكون images/profile/avatar.png هو object key لصورة مخزنة داخل مجلد images/profile.

اختر Public أو Private

اختر نوع bucket قبل إنشائه:

نوع bucket	استخدمه من أجل
Private	الملفات الحساسة أو الخاصة بالحساب أو التي يرفعها المستخدمون.
Public	الملفات غير الحساسة التي يكون من الآمن عمدًا إتاحتها للعامة.

استخدم Private للملفات الحساسة أو الخاصة بالمستخدم. إذا واجهت خطأ في الوصول، فلا تغيّر bucket إلى Public فقط لجعل الملف متاحًا. بدلًا من ذلك، تأكد من أن تطبيقك يتحقق من أن الشخص الذي يطلب الملف لديه إذن للوصول إليه.

افتح تخزين التطبيق في سحابة Atoms

1. افتح مشروعك على جهاز سطح مكتب.
2. في شريط أدوات مساحة العمل نفسه الذي يوجد فيه عارض التطبيقات ، حدد سحابة Atoms.
3. حدد تخزين التطبيق في الشريط الجانبي لـ سحابة Atoms.

الأذونات في تخزين التطبيق

يستخدم تخزين التطبيق دورك في مساحة العمل. يمكن لكل من Editors وworkspace owners إدارة التخزين للمشاريع التي يمكنهم فتحها. الأشخاص الذين ليسوا أعضاء في مساحة العمل لا يمكنهم فتح تخزين التطبيق الخاص بالمشروع أو إدارته.

إعداد Public أو Private الخاص بـ bucket لا يغيّر من يمكنه إدارته في سحابة Atoms. هذا الإعداد يتحكم في كيفية تمكين التطبيق قيد التشغيل من توفير الوصول إلى الملفات؛ أما أذونات مساحة العمل فتتحكم في من يمكنه إدارة التخزين من مساحة عمل سحابة Atoms.

إنشاء bucket

يمكن أن يحتوي التطبيق على ما يصل إلى 10 buckets. أنشئ buckets منفصلة عندما تحتاج مجموعات مختلفة من الملفات إلى إعدادات وصول مختلفة أو يجب إبقاؤها منفصلة لتسهيل التنظيم.

1. في صفحة تخزين التطبيق، حدد Create Bucket.
2. ضمن Bucket Name، أدخل اسمًا فريدًا للـ bucket. يجب أن يكون الاسم:
   • مكوّنًا من 3 إلى 63 حرفًا؛
   • ويستخدم فقط الأحرف الصغيرة والأرقام والشرطات؛ و
   • ويبدأ وينتهي بحرف أو رقم.
3. ضمن Bucket Type، اختر Private أو Public. يتم تحديد Public افتراضيًا، لذا تأكد من اختيار مستوى الوصول الذي تريده قبل المتابعة.
4. حدد Create.

يظهر bucket الجديد في صفحة تخزين التطبيق مع اسمه ونوعه وتاريخ إنشائه. حدد bucket لفتحه وعرض محتوياته.

حدد Create Bucket في تخزين التطبيق.

لا يمكن تغيير أسماء الـ bucket بعد الإنشاء، لذا اختر اسمًا واضحًا لن تحتاج إلى تغييره لاحقًا. إذا كان تطبيقك يحتوي بالفعل على 10 buckets، فلن يعود Create Bucket متاحًا.

رفع الملفات وتنظيمها

داخل bucket، يمكنك رفع الملفات مباشرة أو إنشاء مجلد فارغ دون رفع أي ملفات أولًا.

إنشاء مجلد جديد

1. افتح bucket أو folder الذي تريد إنشاء المجلد الجديد فيه.
2. حدد Add Folder.
3. أدخل اسمًا للمجلد، ثم حدد Create. يمكن أن تحتوي أسماء المجلدات على أحرف وأرقام ونقاط (.) وشرطات (-) وشرطات سفلية (_)، ولا يمكن أن تتجاوز 100 characters. لا يمكن تغيير أسماء المجلدات بعد الإنشاء.

سمِّ المجلد، ثم حدد Create.

رفع الملفات

1. افتح bucket أو folder الذي تريد تخزين الملفات فيه.
2. حدد Upload، ثم اختر ملفًا واحدًا أو أكثر من جهازك. يمكن أن يصل حجم كل ملف إلى 100 MB.
3. انتظر حتى يكتمل الرفع، ثم تحقق من ظهور الملفات في القائمة.

تعرض قائمة الملفات Name وType وSize وتاريخ Last Modified وActions المتاحة لكل عنصر. إذا كنت بحاجة إلى إعادة تحميل محتويات المجلد الحالي، فحدد زر refresh.

ارفع الملفات إلى bucket أو folder المحدد.

معاينة الملفات وإدارتها

حدد ملفًا لفتح File Details. يمكن معاينة الصور ومقاطع الفيديو المدعومة في اللوحة. تعرض أنواع الملفات الأخرى تفاصيلها المتاحة، ولا يزال بالإمكان تنزيلها. إذا تم استخدام كل الرصيد، فسيعرض File Details حالة نفاد الرصيد، وسيوجهك Download لملف واحد إلى ترقية بدلًا من التنزيل.

إدارة ملف واحد

افتح ... في عمود Actions الخاص بالملف، ثم اختر:

• Download لحفظ نسخة محلية عند توفر الرصيد. إذا تم استخدام كل الرصيد، فسيوجهك هذا الإجراء إلى ترقية بدلًا من ذلك.
• Rename لتغيير اسم الملف. يمكن أن يستخدم الاسم الجديد أحرفًا وأرقامًا ونقاطًا وشرطات وشرطات سفلية.
• Delete لإزالة الملف بعد التأكيد.

استخدم قائمة إجراءات الملف لتنزيله أو إعادة تسميته أو حذفه.

إدارة عدة ملفات

1. حدد مربع الاختيار بجانب كل ملف. لا يتم تضمين المجلدات في التحديد الجماعي.
2. حدد Download لتنزيل الملفات المحددة معًا، أو حدد Delete.
3. إذا كنت تحذف، فراجع عدد الملفات المحددة وأكد Delete.

لا يمكن التراجع عن الحذف من تخزين التطبيق. قبل إعادة تسمية ملف أو حذفه، تحقق مما إذا كان التطبيق لا يزال يستخدم object key الخاص به. حدّث أي مراجع مخزنة بعد ذلك حتى لا يستمر التطبيق في طلب المفتاح القديم.

استخدم ملفًا مخزنًا في تطبيقك

يحدد تطبيقك كل ملف مخزن باستخدام bucket name وobject key الخاصين به. يوضح object key مكان الملف داخل bucket. على سبيل المثال، يمكن أن يكون images/profile/avatar.png هو object key لصورة مخزنة داخل مجلد images/profile.

قم بتخزين bucket name وobject key في قاعدة بيانات تطبيقك حتى يتمكن التطبيق من تحديد موقع الملف لاحقًا. عندما يحتاج تطبيقك إلى عرض الملف أو تنزيله، يمكنه استخدام هذه التفاصيل لطلب عنوان URL للوصول.

قد تكون عناوين URL الخاصة بالوصول مؤقتة. لا تحفظها كبيانات دائمة للتطبيق، ولا تضعها بشكل hardcode داخل تطبيقك، ولا تشاركها في Chat أو لقطات الشاشة أو السجلات أو رسائل الدعم. بدلًا من ذلك، خزّن object key واطلب عنوان URL جديدًا للوصول عندما تكون هناك حاجة للوصول إلى الملف.

لا تخزن مفاتيح API أو كلمات المرور أو بيانات الاعتماد الأخرى في تخزين التطبيق. خزّن بيانات اعتماد وقت التشغيل الخاصة في المفاتيح والأسرار. لا يمكن إلا لمالك مساحة العمل إدارة بيانات اعتماد وقت التشغيل الخاصة هناك. إذا كنت Editor، فاطلب من مالك مساحة العمل إضافة بيانات الاعتماد أو تحديثها.

الحدود الحالية

الحد	القيمة الحالية
عدد الـ buckets لكل تطبيق	10
حجم كل ملف تم رفعه	100 MB

للاطلاع على معلومات استخدام السحابة والسعة الحالية، راجع Cloud & AI Wallet.

الأسئلة الشائعة

مساحة القرص لدي ممتلئة. كيف يمكنني تحرير مساحة تخزين؟

1. تحقق من استخدام التخزين الحالي وحدد أكبر المحادثات أو المشاريع أو الملفات.
2. نزّل أو انسخ احتياطيًا أي شيء قد تحتاج إليه لاحقًا.
3. احذف فقط العناصر التي لم تعد بحاجة إليها. إذا كان حذف محادثة يعرض خيارًا لإزالة بيانات القرص المرتبطة بها، فحدده فقط بعد التأكد من إمكانية الاستغناء عن تلك البيانات.
4. أزل الملفات الكبيرة غير الضرورية، ثم حدّث وتحقق من المساحة المتاحة مرة أخرى.

قد يكون الحذف دائمًا ويمكن أن يؤثر في مشروع يشير إلى الملف الذي تمت إزالته. إذا لم ينخفض الاستخدام بعد التنظيف، فاتصل بالدعم مع لقطة شاشة للتخزين وباقتك والحساب أو مساحة العمل المتأثرة. لا ترسل محتويات الملفات إلا إذا طُلب منك ذلك عبر قناة معتمدة.