مرجع توسعه‌دهندگان

مستندات API و یکپارچه‌سازی.

برای حفظ دقت نام endpointها، پارامترها و نمونه‌کدها، مرجع تفصیلی API به زبان انگلیسی ارائه می‌شود.

آنچه باید بدانید

اتصال به پلتفرم

پیش از پیاده‌سازی، روش احراز هویت، مجوزهای لازم و قرارداد رابط را در مرجع بررسی کنید.

نمونه‌کدها و قرارداد داده

نام فیلدها و مسیرهای فنی را مطابق مستندات اصلی استفاده کنید؛ آن‌ها به فارسی ترجمه نمی‌شوند.

مستندات تفصیلی به زبان انگلیسی

مرجع اصلی شامل جزئیات فنی و نمونه‌هاست. با انتخاب لینک زیر وارد نسخه انگلیسی می‌شوید.

مطالعه مرجع انگلیسی

راهنمای تفصیلی راهکار

جزئیات تصمیم‌گیری، پیاده‌سازی و استفاده

یکپارچه‌سازی؛ اتصال سند به سامانه‌های کسب‌وکار

ارزش پلتفرم محتوا زمانی بیشتر می‌شود که سند با پرونده و فرایند سامانه‌های دیگر ارتباط داشته باشد.

یکپارچه‌سازی می‌تواند شامل دریافت فایل از سامانه موجود، ثبت اطلاعات توصیفی، بازیابی محتوای مجاز یا تبادل وضعیت فرایند باشد. نقطه شروع باید یک سناریوی روشن باشد؛ برای مثال، نگهداری پیوست‌های یک سفارش یا دسترسی به اسناد یک مشتری. صرف وجود API، به معنی آماده بودن اتصال به هر ERP یا CRM نیست؛ هر اتصال به بررسی قرارداد داده و دامنه کار نیاز دارد.

در طراحی اتصال، شناسه مشترک پرونده اهمیت زیادی دارد. اگر دو سامانه شماره‌ها یا نام‌های متفاوتی برای یک موضوع داشته باشند، رابطه اسناد به‌تدریج نامعتبر می‌شود. روش احراز هویت، نقش حساب یکپارچه‌سازی، محدودیت دسترسی و نحوه نگهداری کلیدها نیز باید مشخص شوند. دسترسی فنی سرویس نباید از نیاز واقعی فرایند گسترده‌تر باشد.

خطا و تکرار درخواست بخش طبیعی ارتباط میان سامانه‌هاست. طراحی باید روشن کند اگر بارگذاری انجام شد ولی ثبت فراداده شکست خورد چه اتفاقی می‌افتد، تکرار یک درخواست چگونه تشخیص داده می‌شود و مسئول رسیدگی به خطا کدام تیم است. این تصمیم‌ها باید پیش از بهره‌برداری مستند و با سناریوهای قطع ارتباط و بازیابی آزموده شوند.

یک سناریوی کاربردی

سامانه مالی می‌تواند شناسه سفارش را به سند خرید مرتبط کند تا کاربر از همان زمینه کسب‌وکار به مدارک مجاز برسد. جزئیات ایجاد، دریافت و همگام‌سازی باید در پروژه اتصال مشخص شوند.

امنیت چندلایه؛ از هویت کاربر تا عملیات زیرساخت

حفاظت از اسناد تنها با یک گذرواژه یا یک سطح دسترسی عمومی حاصل نمی‌شود.

نخستین لایه، هویت قابل اتکای کاربر است. اتصال مدیریت هویت و استفاده از روش‌های احراز هویت مناسب، نقطه شروع کنترل دسترسی است. سپس باید مجوزها با نقش واقعی افراد هماهنگ شوند؛ کارشناس، مدیر واحد و مدیر سامانه الزاماً به یک دامنه محتوا نیاز ندارند. اصل حداقل دسترسی، مبنای مناسبی برای طراحی اولیه است.

در کنار کنترل‌های برنامه، امنیت استقرار نیز اهمیت دارد. تنظیم TLS، مدیریت اسرار، محدود کردن دسترسی مدیریتی، به‌روزرسانی سرویس‌ها و پایش خطاها باید در طرح عملیاتی دیده شوند. مسئولیت این بخش‌ها در استقرار ابری و استقرار در محل متفاوت است و لازم است مرز مسئولیت تیم ویکسلو و تیم زیرساخت مشتری روشن باشد.

پشتیبان‌گیری بدون آزمون بازیابی، اطمینان کافی ایجاد نمی‌کند. سازمان باید زمان قابل قبول بازگردانی سرویس و میزان قابل قبول از دست رفتن داده را مشخص کند و متناسب با آن، روش پشتیبان‌گیری و تمرین بازیابی را طراحی کند. جزئیات رمزنگاری، محل داده، الزامات امنیتی و سطح خدمت باید در بررسی فنی و قرارداد نهایی تأیید شوند.

یک سناریوی کاربردی

دسترسی یک کاربر منابع انسانی باید به پرونده‌های مجاز محدود باشد؛ دسترسی مدیریتی به زیرساخت نیز نباید بدون بررسی، معادل مجوز استفاده کسب‌وکاری از همه اسناد تلقی شود.

پرسش‌های متداول

پیش از انتخاب پلتفرم چه بدانیم؟

تفاوت مدیریت اسناد و پلتفرم خدمات محتوا چیست؟

مدیریت اسناد بر سازمان‌دهی، نسخه‌بندی، دسترسی و بازیابی فایل‌ها تمرکز دارد. پلتفرم خدمات محتوا این پایه را به فرایندها و سامانه‌های دیگر متصل می‌کند و می‌تواند پردازش هوشمند و خودکارسازی را نیز در مسیر محتوا قرار دهد. انتخاب باید بر اساس مسئله واقعی سازمان باشد، نه صرفاً نام دسته محصول.

آیا می‌توان با یک واحد سازمانی شروع کرد؟

بله؛ شروع با یک نوع سند، یک گروه کاربر و یک مسیر بررسی مشخص، روش مناسبی برای ارزیابی است. ساختار فراداده، دسترسی و معیار موفقیت در اجرای آزمایشی بررسی می‌شوند و سپس دامنه پروژه گسترش پیدا می‌کند.

آیا استقرار در محل سازمان امکان‌پذیر است؟

استقرار روی زیرساخت سازمان یکی از گزینه‌های مطرح ویکسلو است. ظرفیت مورد نیاز، محل داده، پشتیبان‌گیری، به‌روزرسانی و مرز مسئولیت عملیات باید در بررسی فنی و پیشنهاد نهایی مشخص شوند.

آیا دقت پردازش فارسی برای همه اسناد یکسان است؟

خیر. زبان، وضوح تصویر، قالب فایل و پیچیدگی جدول یا متن بر نتیجه اثر می‌گذارند. کیفیت پردازش باید با نمونه‌های واقعی سازمان سنجیده شود و برای اطلاعات حساس مسیر بازبینی انسانی در نظر گرفته شود.

آیا اتصال آماده به هر سامانه مالی یا CRM وجود دارد؟

نباید چنین فرضی کرد. وجود API امکان طراحی اتصال را فراهم می‌کند، اما آماده بودن اتصال، دامنه تبادل داده و هزینه پیاده‌سازی باید برای هر سامانه مشخص بررسی و تأیید شوند.

برای دریافت پیشنهاد چه اطلاعاتی لازم است؟

نوع اسناد، تعداد تقریبی کاربران، حجم فعلی و رشد محتوا، فرایندهای مورد نظر، سامانه‌های قابل اتصال و الزامات محل داده را آماده کنید. بر اساس این اطلاعات می‌توان دامنه اجرا، شیوه استقرار و معیارهای ارزیابی را مشخص کرد.

برای بررسی نیاز اختصاصی سازمان خود، با تیم ویکسلو گفت‌وگو کنید.

راهکار مناسب سازمان خود را پیدا کنید.

برای بررسی نیازها و شیوه استقرار با تیم ویکسلو گفت‌وگو کنید.