אינטגרציית Bitrix24-YouTrack: סנכרון משימות דו-כיווני
לקוח שולח דיווח באג לתמיכה; המנהל יוצר משימה ב-Bitrix24, ואז נכנס ל-YouTrack ומשכפל את התקלה. המפתח סוגר את התקלה, אבל המנהל לא יודע על כך — הלקוח מקבל תשובה "עדיין בעבודה" על בעיה שכבר נפתרה. שני טרקרים ללא קישוריות משמעותם עבודה כפולה ופערי מידע מתמידים. אנו מתכננים תווך (middleware) שמאזין לאירועים בשתי המערכות וממיר אותם לישויות של המערכת השנייה, ובכך מבטל העברה ידנית ועיכובים. למהנדסים שלנו יש ניסיון של למעלה מחמש שנים עם YouTrack ו-Bitrix24, כך שאנו מכירים את כל המלכודות ומבטיחים פתרון יציב. אנו מספקים תיעוד, הדרכת עובדים ותמיכה לאחר ההשקה. התוצאה היא מרחב מידע אחיד למפתחים ומנהלים, חוסך עד 30 שעות בחודש לכל עובד.
הבעיה: זרימת עבודה שבורה ומאמצים כפולים
שכפול ידני של משימות בין Bitrix24 ל-YouTrack מוביל ל:
- סטטוסים מיושנים — מפתחים מסמנים תקלה כסגורה, אבל מנהל הפרויקט עדיין רואה אותה כ"בתהליך".
- מידע שאבד — תגובות ויומני זמן מפוזרים בין מערכות.
- הזנת נתונים כפולה — בזבוז שעות על יצירה ותחזוקה של רשומות מקבילות.
התווך שלנו פותר בעיות אלה על ידי יצירת קישור דו-כיווני בין שני הטרקרים.
כיצד אנו מגדירים את האינטגרציה
שלב 1: השגת אסימוני API
- YouTrack: צור אסימון קבוע (Profile → Authentication → New Token). זוהי שיטת האימות המומלצת לאינטגרציות שרת לפי תיעוד ה-API של YouTrack REST.
-
Bitrix24: קבל אסימון OAuth עם הרשאות
middleware: youtrack: token: "perm:YOUR_TOKEN" base_url: "https://yourcompany.youtrack.cloud" bitrix24: webhook_url: "https://yourdomain.bitrix24.ru/rest/1/TOKEN/" mapping: fields: - b24: TITLE yt: summary - b24: DESCRIPTION yt: description transform: "html_to_md" statuses: - b24: 2 yt: Open - b24: 3 yt: "In Progress"ו-Б24 (событие задачи) → Webhook → Middleware → YouTrack REST API → Issue YouTrack (workflow/webhook) → Middleware → Б24 REST API → Задача.
שלב 2: פריסת התווך
אנו מספקים תמונת Docker שאתה מריץ על השרת שלך (מומלץ VPS עם לינוקס). התווך פועל כגשר בין שתי המערכות.
שלב 3: הגדרת מיפוי שדות
הגדר התאמות עבור כותרת, תיאור, אחראי, סטטוס ופרויקט. דוגמת תצורה:
תצורת תווך לדוגמה
middleware: youtrack: token: "perm:YOUR_TOKEN" base_url: "https://yourcompany.youtrack.cloud" bitrix24: webhook_url: "https://yourdomain.bitrix24.ru/rest/1/TOKEN/" mapping: fields: - b24: TITLE yt: summary - b24: DESCRIPTION yt: description transform: "html_to_md" statuses: - b24: 2 yt: Open - b24: 3 yt: "In Progress" שלב 4: הגדרת Webhooks
- ב-YouTrack: Settings → Webhooks → Add webhook לשליחת אירועים לתווך.
- ב-Bitrix24: הגדר webhooks יוצאים לאירועי משימות (לדוגמה,
issue.updated).
שלב 5: בדיקה ומעבר לייצור
אנו מריצים בדיקות בסביבת staging, ואז פורסים לייצור עם ניטור.
ארכיטקטורת הסנכרון
האינטגרציה משתמשת ב-API של שתי המערכות. YouTrack מציע API מלא עבור תקלות, פרויקטים, לוחות agile ומעקב זמן. ה-REST API של Bitrix24 מטפל במשימות, משתמשים ושדות מותאמים אישית. התווך מעבד אירועים דו-כיוונית:
Б24 (событие задачи) → Webhook → Middleware → YouTrack REST API → Issue YouTrack (workflow/webhook) → Middleware → Б24 REST API → Задача YouTrack תומך בשני מנגנוני התראה: Webhooks (פשוטים יותר) ו-Workflows (סקריפטים ב-JavaScript לשליטה מדויקת). Workflows מאפשרים סינון לפי שדה, פרויקט או סוג תקלה — ומעניקים גמישות רבה יותר.
פרטי מיפוי שדות
| שדה Bitrix24 (tasks.task) | שדה YouTrack (issue) | הערות |
|---|---|---|
| TITLE | summary | מיפוי ישיר |
| DESCRIPTION | description | HTML של Bitrix24 → Markdown של YouTrack |
| RESPONSIBLE_ID | Assignee | באמצעות טבלת מיפוי משתמשים |
| CREATED_BY | Reporter | כנ"ל |
| DEADLINE | Due Date | פורמט ISO 8601 בשתי המערכות |
| PRIORITY | Priority | מיפוי ערכים (ראה להלן) |
| STATUS | State | תצורה נפרדת |
| GROUP_ID | Project (shortName) | טבלת מיפוי |
| UF_* (מותאם אישית) | שדות מותאמים אישית | הגדרה לפי לקוח |
המרת תיאור: Bitrix24 מאחסן HTML; YouTrack משתמש ב-Markdown (עם הרחבות). התווך ממיר באמצעות AST ביניים.
מיפוי סטטוסים
YouTrack משתמש במכונת מצבים — לכל פרויקט יש קבוצת מצבים משלו. התווך שלנו תומך במיפוי ניתן להגדרה:
| סטטוס Bitrix24 | מצב YouTrack | כיוון |
|---|---|---|
| חדש (2) | Open | ↔ |
| בתהליך (3) | In Progress | ↔ |
| ממתין לבדיקה (4) | To Verify | ↔ |
| הושלם (5) | Fixed / Done | ↔ |
| בהמתנה (6) | Wait | ↔ |
| — | Duplicate | YT → B24 (תגובה) |
| — | Won't Fix | YT → B24 (סגירה + תגובה) |
עבור מצבים שאינם קיימים ב-Bitrix24, התווך מוסיף תגובה המסבירה את הסטטוס ובאופן אופציונלי סוגר או משהה את המשימה.
סנכרון מעקב זמן
גם YouTrack וגם Bitrix24 תומכים ביומני זמן. התווך ממזג רשומות:
-
YouTrack → Bitrix24: כאשר מתווסף פריט עבודה ב-YouTrack (אירוע
workItems, שדהtask.elapseditem.add), התווך יוצר יומן זמן ב-Bitrix24 דרךONTASKELAPSEDTIMEADD. משך, תאריך ותגובה מועברים. -
Bitrix24 → YouTrack: כאשר מתווסף יומן זמן ב-Bitrix24 (אירוע
POST /api/issues/{id}/timeTracking/workItems), התווך יוצר פריט עבודה ב-YouTrack דרךsync_id.
כדי למנוע כפילויות, התווך מנהל טבלת מיפוי של רשומות זמן, כל אחת עם UF_SPRINT ייחודי.
אינטגרציית לוחות Agile
לוחות Agile של YouTrack מציגים תקלות בלוחות Kanban/Scrum. ל-Bitrix24 יש Kanban משלו. התווך אינו מסנכרן את הפריסה החזותית אך מבטיח:
- גרירת תקלה בלוח YouTrack (שינוי State) מעדכנת את סטטוס המשימה ב-Bitrix24.
- שינוי שלב בלוח Kanban של Bitrix24 מעדכן את מצב התקלה ב-YouTrack.
- ניתן למפות ספרינטים של YouTrack לקבוצות משימות ב-Bitrix24 או לשדה
task,userמותאם אישית.
מניעת לולאות סנכרון
התווך מתייג את מקור כל עדכון בשדה מותאם אישית בשתי המערכות. כאשר מגיע webhook, הוא בודק את התג — אם העדכון מקורו בתווך עצמו, העיבוד מדולג.
אימות
- YouTrack: אסימון קבוע (Profile → Authentication → New Token). עובד עבור Cloud ו-Server. האסימון יורש את ההרשאות של המשתמש המנפיק.
-
Bitrix24: OAuth 2.0 עם היקף
task,user. - הנתונים זורמים רק דרך התווך — ללא גישה ישירה בין המערכות.
מה כלול בעבודה
| פעולה | תיאור |
|---|---|
| ניתוח תהליכים | אנו לומדים את זרימות העבודה הנוכחיות ואת הדרישות לסנכרון |
| הגדרת התווך | פיתוח ותצורה של רכיב ההחלפה הדו-כיווני |
| מיפוי נתונים | הגדרת התאמות שדות, סטטוסים, משתמשים ופרויקטים |
| בדיקות | אימות נכונות הסנכרון בסביבת staging ומדידת מדדים |
| פריסה ותמיכה | פריסה לייצור, מתן תיעוד והדרכה |
אנו מעריכים את הפרויקט שלך באופן אישי. לוחות זמנים נעים בין 2 ל-5 ימי עסקים בהתאם למורכבות. העלות נקבעת לאחר ניתוח. צור קשר לייעוץ. אנו מבטיחים סנכרון יציב 24/7. הניסיון שלנו כולל למעלה מחמש שנים עם Bitrix ו-YouTrack ועשרות אינטגרציות מוצלחות. מהנדסים מוסמכים מבטיחים אמינות. הזמן הגדרת אינטגרציה — חסל שכפול משימות ובזבוז זמן. פנה אלינו לקבלת הצעת מחיר.