הכלי הדיגיטלי למאבק בגזענות, הדרכה והנחיות שימוש

הכלי הדיגיטלי למאבק בגזענות ממסדית

הדרכה והנחיות שימוש

על המערכת, בקטנה תכונות ויתרונות המערכת פניה ראשונה למערכת שיחה ראשונה בין נציג/ה לפונה ניהול משימות להמשך טיפול בפניה סקירת הפניות במערכת עריכת תסריטי שימוש תרגום ושימוש בשפות נוספות

המערכת נועדה לסייע לנפגעות ונפגעי תופעות של גזענות ואפליה באופנים הבאים:

איסוף ותיעוד מידע מנפגע/ת אירוע גזענות ואפליה.
הכרות הזכויות והפעולות בהן הנפגע/ת יכול/ה לנקוט.
יצירת קשר עם גופים רלוונטים במגזר הציבורי.
שיתוף המידע וקבלת סיוע מארגוני מגזר השלישי רלוונטיים.

המערכת מלווה את התהליך בשלבים הבאים:

פניה ראשונית, של אזרח/ית או תושב/ת המדווחים על ארוע על רקע גזעני. הפנייה הראשונית מתבצעת באופן עצמאי, בעזרת צ’ט בוט.
שיחת המשך בין הפונה לנציג/ת הארגון שמטפל בפנייה. בזמן השיחה יעזרו נציג/ת הארגון בצ’ט בוט שינחה אותם בשאלות שיש לברר ובאופן תיעוד הפרטים.
נציג/ת הארגון ימשיכו בטיפול במקרה לאחר השיחה. המערכת תציג בפניהם את משימות ההמשך ותאפשר להם לתעד את שלבי הטיפול השונים.

למערכת החיה (בשימוש האגודה לזכויות האזרח): עברית / ערבית

הפניה הראשונית יכולה להתרחש בכל יום ובכל שעה, מכל מכשיר עם חיבור לאינטרנט (טלפון נייד או מחשב נייח). אין צורך בהתקנת אפליקציה מיוחדת, רק בגלישה עם כל דפדפן סטנדרטי, לאתר המערכת.

קישור לקוד, צד הפונה (Github)

שיחת ההמשך בין הפונה לנציג/ת הארגון תתקיים באמצעי התקשורת שבחר/ה הפונה.
בזמן השיחה, תלווה המערכת את נציג/ת הארגון בהנחיה כיצד להוביל את השיחה ותסייע לתעד את התשובות בצורה פשוטה ומסודרת.

קישור לקוד, צד מוקדנ/ית (Github)

בתום שיחת ההמשך בין הפונה לנציג/ת הארגון תוצג לנציג/ת הארגון רשימת משימות שנוצרה בהתאם לפרטי המקרה שנאספו בשיחה. נציג/ת הארגון יוכלו להוסיף משימות נוספות ולתעד את הטיפול וההתקדמות בביצוע המשימות.

קישור לקוד, צד מוקדנ/ית (Github)

חברי הצוות והמנהלים יכולים לעקוב אחרי מספר הפניות הכללי במסך מרכזי

קישור לקוד, צד מוקדנ/ית (Github)

קישור קוד תסריטי השימוש (Github)

מהם תסריטי השימוש

אחד מיתרונותיה של המערכת היא האפשרות לעדכן ולהתאים את השימוש למצבים משתנים ותחומים רחבים. תסריטי השימוש הם האופן בו מוגדרת התנהלות השיחה.

תסריטי השימוש נכתבים במבנה שנקרא YAML. היתרונות שלו הם שקל לבני אדם לקרוא ולערוך אותו, ושקל יחסית להמיר אותו בהמשך לקוד שהמחשב מבצע.

תסריטי השימוש נמצאים בפרוייקט הקוד שבקישור https://github.com/hasadna/reportit-scripts. הרעיון הוא שגם אנשים ללא מיומנויות פיתוח ותכנות, יוכלו תוכלו לפתוח את הקובץ, לסקור את מהלכי השיחה הקיימים, ולבצע שינויים או התאמות קלים. כל מה שנותר לבקש מהמפתח/ת שיעדכנו את תסריט המעודכן במערכת.

הפנייה הראשונה, בה מתקשר/ת הפונה עם הצ’ט בוט, מתוארת בקובץ בשם src/user/script.yaml.
שיחת ההמשך, שינהלו נציגי הארגון שלכם הפונה, מתוארת בקובץ בשם src/agent/script.yaml.

לאחר עדכון תסריט השימוש יש לבצע המרה שלו לקוד התוכנה – תוכלו לבקש מאיש/אשת הפיתוח שלכם להריץ את הממיר שנמצא בכתובת tool/yaml_to_json.py.

אם תהליך ההמרה עבר בשלום, אפשר לעדכן את האתר באמצעות הרצת הקובץ tools/deploy.sh.

חלקי השיחה (snippets)

יש שני כללים שחשוב להבין ולזכור כשכותבים או קוראים קבצי YAML:

הקובץ בנוי בצורה של הגדרה/פקודה + “:” + ערך.
ההגדרה או הפקודה נכתבים באנגלית, והערך יכולה להיכתב בכל שפה שנרצה.
ההזחה (indentation), כלומר – מספר הרווחים שמופיעים לפני השורה, חשובה.

עוד רגע נראה כמה דוגמאות.

קובץ של תסריט שימוש נפתח בשורות הבאות:

- description: תסריט לניהול שיחות מצד הפונה
  name: פונה

השורות הללו נותנות שם לתסריט שלפנינו ותיאור קצר, שיקלו על מי שיערכו ויעבדו איתו בהמשך להבין במה מדובר.הרבה פעמים אנחנו רוצים לשאול שאלות זהות בהקשרים שונים. למשל, לפעמים נרצה לבקש מהמשתמש להעלות קבצים אחרי שאלה מסויימת, ולפעמים נרצה לאפשר זאת בסוף השיחה. במקום לכתוב שוב ושוב את אותן השאלות, תסריטי השימוש מחולקים לרכיבי שיחה, או בלוקים, שאפשר להפנות אליהם או לעשות בהם שימוש חוזר.

לכן, ההגדרה הראשונה של קובץ התסריט היא snippets.

לדוגמה, בקובץ תסריט השימוש של הפניה הראשונית במערכת תמצאו שני סוגים של רכיבי שיחה:

א. רכיבי שיחה שמשותפים לכל סוג של פניה או תלונה:

snippets:
- name: default
  steps:
   [ תוכן הבלוק]
- name: "פרטי התקשרות: בחירת אמצעי יצירת קשר"
  steps:
   [ תוכן הבלוק]
- name: "תלונה: בחירת תחום/גורם"
  steps:
   [ תוכן הבלוק]
- name: "העלאת קבצים: האם להעלות קבצים?"
  steps:
   [ תוכן הבלוק]
- name: "תלונה: הוספת מידע נוסף"
  steps:
   [ תוכן הבלוק]

ב. רכיבי שיחה שקשורים לפניות, על פי הגורם כלפי מוגשת התלונה, או סוג התלונה:

- name: "בריאות: בחירת הגורם הפוגע"
  steps:
      [ תוכן הבלוק]
- name: "חינוך: בחירת מסגרת חינוכית"
  steps:
      [תוכן הבלוק]
- name: "חינוך: בחירת זרם חינוכי של המסגרת"
     [ תוכן הבלוק]
- name: "חינוך: בירור הרקע לאפליה"
     [ תוכן הבלוק]
- name: "משטרה: בחירת סוג התלונה"
     [ תוכן הבלוק]
- name: "מאבטח/ת: בחירת סוג התלונה"
     [ תוכן הבלוק]
- name: "דיור: בחירת סוג התלונה"
     [ תוכן הבלוק]
- name: "אחר: בירור פרטי הגורם הפוגע"
     [ תוכן הבלוק]

רכיב השיחה הראשון שיש להגדיר בכל תסריט שימוש הוא “default”, כמו בדוגמה.
הסיבה היא שזהו הבלוק הראשון שהמערכת תחפש בתחילת כל אחת מהשיחות, וממנה אפשר להמשיך בכתיבת התסריט, כפי שנתאר בהמשך.

תחת ההגדרה snippets, מוצגים כל חלקי השיחה המתוכננים, אלו שנפנה אליהם באופן ישיר או עקיף מהרכיב “default”.

לכל אחד מהרכיבים או החלקים בשיחה, חשוב להגדיר שני חלקים:

שם רכיב השיחה, שמוגדר בעזרת הפקודה [שם ]: name.
כדאי לבחור שם ברור, שיתאר את הרכיב.
הפעולות ושנרצה לבצע בתוך הרכיב, לפי הסדר לביצוע.
הפקודה steps, כוללת תחתיה למעשה את כל הפעולות הללו, כפי שנראה בחלק הבא.

המעבר בין חלקי שיחה מתבצע באמצעות הפקודה [שם חלק השיחה]: goto

 - goto: "פרטי התקשרות: בחירת אמצעי יצירת קשר"

הצגת הודעה למשתמש/ת (say)

בתוך כל אחד מחלקי השיחה (snippets) ניתן להריץ פקודות ולבצע פעולות שונות. הפעולה הבסיסית ביותר היא הצגת הודעה או מסר למשתמש/ת. כדי לשלב אותה בתוך מבנה השיחה בצורה נכונה, חשוב להקפיד ליצור את הרווחים שימחישו שהיא אמורה לרוץ כפעולה בסדר הפעולות בתוך הרכיב המבקש.

כך, למשל, זה נראה בקובץ תסריט השימוש של הפנייה הראשונית במערכת – שימו לב לרווחים בתחילת השורות:

- description: תסריט לניהול שיחות מצד הפונה
  name: פונה
  snippets:
  - name: default
    steps:
    - say: שלום, הגעת למוקד סיוע לנפגעי גזענות ואפליה.

וכך זה יראה למשתמש/ת במערכת:

הפקודה say

על מנת לגרום למעבר שורה בגוף ההודעה המוצגת יש לכתוב

המתנה לתשובת המשתמש/ת (wait)

הפקודה wait מסמנת למערכת לעצור את השיחה ולחכות לתגובת המשתמש.

במערכת מוגדרים כיום שני סוגי שאלות:

שאלה פתוחה
שאלת בחירה

שאלה פתוחה (wait)

שאלות פתוחות הן שאלות שבהן המשתמש/ת מתבקש/ת להקליד את התשובה.

ההגדרה הבסיסית של שאלות כאלה כוללת שלושה חלקים:

השאלה שתוצג למשתמש/ת, באמצעות פקודת say
פקודת wait, שמשמעותה היא שהמערכת תמתין לתשובת המשתמש/ת
שם המשתנה שישמור את ערך התשובה, אם יהיה לנו צורך לעשות בו שימוש בהמשך תסריט השימוש, באמצעות ההגדרה variable. השמירה של התשובה בתוך שם של משתנה יכולה לסייע בהתאמת המשך השיחה לתשובות של המשתמש.חשוב: בנוסף לשימוש הזה, שם המשתמש הוא הגדרה שנועדה לסייע למתכנתים לשמור את התשובה בבסיס הנתונים או כדי לסייע לכם לבנות שאלות מורכבות יותר. מוטב להתייעץ עמם לפני שמשנים שם של משתמש קיים, או להניח להם להתמודד עם נושא זה.
הגדרות נוספות לגבי אופי התשובה המצופה. נציג אותן עוד רגע.

הנה דוגמה לשאלה פתוחה מתסריט השימוש הקיים:

 - say: מה השם שלך? אם את/ה רוצ/ה להישאר אנונימי/ת בשלב זה כתבו "אנונימי"
 - wait:
       variable: full_name

וכך זה יראה למשתמש/ת:

הגדרות נוספות לגבי אופי התשובה המצופה בשאלה פתוחה:

ניתן להוסיף הגדרות נוספות לשאלות פתוחות:

- אפשרות לתשובה ארוכה, עם כמה שורות: long
- בחירה באפשרות זו תאפשר למשתמש/ת ללחוץ על מקש ה-Enter בעת המענה. במקרה כזה, במקום לשלוח את התשובה, הסמן יעבור לשורה חדשה והם יוכלו להמשיך להקליד את תשובתם. משלוח התשובה יתבצע באמצעות לחיצה על כפתור. הנה דוגמה לשאלה פתוחה מתסריט השימוש הקיים:

- say: מה השם שלך? אם את/ה רוצ/ה להישאר אנונימי/ת בשלב זה כתבו "אנונימי"
- wait:
  variable: full_name

וכך זה יראה למשתמש/ת:

- ממלא מקום, לפני מענה: placeholder
  מדובר בהגדרת רשות, לטקסט שתרצו שיוצג למשתמשים באזור ההזנה, לפי שיתחילו להקליד את תשובתם. בדוגמה הבא, למשל, תוכלו לראות שנעזרנו בהגדרה הזו כדי להציג למשתמשים מהו הערך שאנחנו מצפים לקבל בתשובה לשאלה מהו מספר הטלפון שלהם (05x-xxx-xxxx).
  אם לא מוסיפים את ההגדרה הזו המערכת תציג הנחיה כללית: “הקלידו הודעה…”.
- וידוא ערך שמוזן: validation
  ניתן להגדיר בקובץ צורה או סדרה של ערכים מותרים. נדרשת לשם כך עזרה של מפתח/ת (שיודעים להגדיר Regular Expressions), אבל מדובר בתוספת קטנה ומהירה למימוש. כך, למשל, אנחנו מוודאים שהתשובה שיזינו המשתמשים בתשובה לשאלה מה מספר הטלפון שלהם תהיה באמת מספר תקין:

- say: מה מספר הטלפון שלך?
- wait:
     variable: phone
     placeholder: 05x-xxx-yyyy
     validation: "[-.0-9()/+]{9,16}"

שאלת בחירה (wait, options)

שאלת בחירה היא שאלה בה מוצגות למשתמש/ת מספר אפשרויות, מתוכן ניתנת האפשרות לבחור תשובה אחת.

עבור כל שאלת בחירה יש להגדיר:

תוכן השאלה שתוצג למשתמש/ת לפני רשימת האפשרויות, באמצעות ההגדרה say.
שם המשתנה שישמור את ערך התשובה, אם יהיה לנו צורך לעשות בו שימוש בהמשך תסריט השימוש, באמצעות ההגדרה variable. השמירה של התשובה בתוך שם של משתנה יכולה לסייע בהתאמת המשך השיחה לתשובות של המשתמש.חשוב: בנוסף לשימוש הזה, שם המשתמש הוא הגדרה שנועדה לסייע למתכנתים לשמור את התשובה בבסיס הנתונים או כדי לסייע לכם לבנות שאלות מורכבות יותר. מוטב להתייעץ עמם לפני שמשנים שם של משתמש קיים, או להניח להם להתמודד עם נושא זה.
מהן האפשרויות שיוצגו למשתמש/ת:
עבור כל אחת מן האפשרויות ניתן להגדיר את הרכיבים הבאים:

- הטקסט שיוצג למשתמש/ת על לחצן הבחירה, באמצעות ההגדרה show
- הערך שיש לשמור מאחורי הקלעים, באמצעות ההגדרה value.
  חשוב: המחשב קצת חלש בעברית, ולכן חשוב שהערך שנשמר מאחורי הקלעים ייכתב באנגלית, גם אם לא נעשה בו שימוש בהמשך.
- סדרת הפעולות שיש לבצע במידה והמשתמש/ת בחר באפשרות זו. מדובר בפקודת ה-steps שכבר פגשנו. הפעם, סדר הפעולות שיוגדר יבוצע רק אם תיבחר אחת האפשרויות על ידי המשתמש/ת.ניתן לבחור שלא להשתמש באפשרות הזו, ואז תסריט השימוש ימשיך הלאה, ללא לבצע שום פעולה שקשורה בתשובה שנבחרה. עושים זאת באמצעות הזנת הערך [], כפי שתראו בדוגמה הבאה.

הנה דוגמה לשאלת בחירה מתוך תסריט השיחה של הפניה הראשונית:

 - say: האם תרצה/תרצי שננסה ליצור איתך קשר באמצעי קשר נוספים?
 - wait:
   variable: more_contact
   options:
   - show: כן
     value: yes
     steps:
     - goto: "פרטי התקשרות: בחירת אמצעי יצירת קשר"
   - show: לא
     value: no
     steps: []

שאלת בחירה בצ'ט

ביצוע פעולות לפי תנאי (switch)

ישנם מקרים בהם אנחנו רוצים להתאים את תסריט השימוש לתשובה קודמת שניתנה לנו על ידי המשתמש/ת או לפרטי המקרה. אם ישנו משתנה (variable) שיכול לסייע בקבלת ההחלטה, ניתן להיעזר בפקודה switch לצורך הביצוע.

למשל, יתכן שבתחילת השיחה שאלנו את הפונה האם הוא גבר או אישה, ושמרנו את התשובה במשתנה בשם sex:

- say: מהו מינך?
- wait:
  variable: sex
  options:
   - show: גבר
     value: male
   - show: אישה
     value: female

נניח שנרצה להציג לפונה הודעה שתואמת למין של הפונה: כלומר, נוסח שמותאם למשתמש (זכר) או למשתמשת (נקבה), בהתאם לתשובה שהשיבו.

חשוב: בעזרת הפקודה wait + options שהכרנו מוקדם יותר, ניתן גם כן להגדיר שאלה עוקבת, שתותאם למין הפונה. אפשרות זו רלוונטית רק כשפיצול או התאמת תסריט השימוש מתרחשת בצמוד לשאלת הבחירה. פקודת ה-Switch, לעומת זאת, מאפשרת ליצור פיצול בתסריט או השימוש, או התאמה שלו, לפי כל ערך משתנה זמין, בכל שלב של השיחה.

הפקודה switch מאפשרת לנו, בעזרת הערך ששמור במשתנה sex כדי לנסח את השאלה המשך, או משפט סיום מותאם למין הפונה:

- switch:
    arg: sex
    cases:
       - match: male
         steps:
         - say: היה נחמד לפגוש אותך, אולי תתקשר גם מחר?
       - match: female
         steps:
         - say: היה נחמד לפגוש אותך, אולי תתקשרי גם מחר?

ערך המשתנה הנבדק: arg
המקרים שיש לבדוק: cases
בחלק זה מוגדרות כל האפשרויות לפיהן תימשך השיחה, בהתאם לטקסט ששמור במשתנה
- התאמה לערך מוגדר: match
  הגדרת הפעולות שיש לבצע עם ערך המשתנה זהה למחרוזת טקסט מסויימת.
- התנהגות ברירת המחדל: default: true
  סדר הפעולות שיש לבצע במידה והטקסט ששמור במשתנה שונה מכל אפשרויות ה-match שהוגדרו
- התנהגות במידה ולא קיים משתנה: undefined: true
  סדר הפעולות שיש לבצע אם המשתנה לא קיים או שהוא חסר ערך (null)

ביצוע פונקציות

ישנם מצבים שדורשים בדיקות או פעולות מתוחכות, שלא ניתן לייצג בתסריט שימוש רגיל.

במקרים כאלו ניעזר במפתח/ת שיכתבו פונקציה, ונבקש מהם לשלב אותה במסגרת תסריט השיחה.

שילוב פונקציות בתסריט השימוש נעשה בעזרת הפקודה do. לפקודה זו שלושה רכיבים:

cmd: זהו שם הפונקציה להרצה
variable: שם המשתנה שבו ישמרו התוצאה או הפלט של הפונקציה, במידת הצורך.
params: הפרמטרים שהפונקציה מצפה לקבל על מנת לרוץ ולבצע את פעולתה.

לדוגמה, הפונקציה הבאה בודקת האם השעה בה מתקיימת השיחה הראשונית היא ביום ושעה שמוגדרים כשעות עבודה, זאת, כדי להציג בהמשך השיחה הודעה מותאמת למועד, בנוגע להמשך הטיפול

        - do:
            cmd: isWorkingTime
            variable: _is_working_time

צד המוקדנ/ית: כרטיסי מידע

כרטיסיות המידע הן אחד מכלי העזר שעומדים לרשותנו בהנחיית המוקדנ/ית בשיחות ההמשך וביצוע המשימות.

הצגת כרטיסיית המידע למוקדנ/ית, אפשרית בכל שלב בתסריט השימוש, בעזרת השימוש בפונקציה showInfoCard. הפונקציה המיוחדת הזו מקבל פרמטר יחיד תחת params. הפרמטר הזה הוא השם או הכינוי (slug) של הכרטיסייה להצגה.

כך, למשל מוצגת למוקדנ/ית כרטיסיית המידע עם מידע רלוונטי במסגרת טיפול בתלונה על מקרה של גזענות במערכת הבריאות:

- do:
     cmd: showInfoCard
     params:
      - health_ministry_contacts

כל כרטיסיות המידע מורכזות בקובץ src/atasets/infocards.datapackage.tx.json. זהו הפריט עם המידע שיוצג למוקדנ/ית:

   {
     "slug": "health_ministry_contacts",
     "title": {
            ".tx": {
                     "_": "עמוד פניות ותלונות באתר משרד הבריאות",
                   }
            },
     "content": {
        ".tx": {
              "_": "[קישור](https://www.health.gov.il/PniyotHazibur/Pages/Complaints.aspx)",
      }
  }

מהדוגמה הזו ניתן ללמוד גם על המבנה שיאפשר למתכנת/ת שלכם להוסיף כרטיסיות מידע נוספות, או לערוך את המידע הקיים. בכל כרטיסיה מוגדרים שלושה חלקים:

הכינוי של הכרטיסיה (slug), שיאפשר לקרוא לה לתצוגה (ראו בהמשך איך עושים את זה).
הכותרת של כרטיסיית המידע (title)
תוכן הכרטיס (content), שיכול לכלול גם קישורים (בשימוש בצורה [טקסט](כתובת הקישור))

סוג מיוחד של כרטיסיות מידע הוא מידע על ארגונים, שיכולים להיות רלוונטים בסיוע למוקדנ/ית או לפונה בהמשך הטיפול במקרה. פרטי הארגונים שמורים בקובץ src/datasets/organizations.datapackage.tx.json. דוגמה לרשומת ארגון:

 {
   "slug": "acri", 
   "contactPerson1": null,
   "contactPerson2": null,
   "description": "האגודה פועלת למען החברה בישראל וכחלק ממנה, כדי להגן ולקדם את הזכויות של כולן וכולם, ללא קשר ותנאי למעמדם בישראל: אזרחים, תושבים, פליטים ומבקשי מקלט, מהגרי עבודה, תושבי ירושלים המזרחית ותושבי השטחים הכבושים; נשים וגברים, דתיים וחילונים, יהודים ופלסטינים, בעלי דעות פוליטיות מהימין ומן השמאל.\n\nצוות פניות הציבור מטפל בתלונות על פגיעה בזכויות אדם על ידי המדינה ורשויותיה או מי שפועל בשם הרשויות (ובמקרים של אפליה ופרנסה, גם על ידי גורמים פרטיים). הארגון מקבל פניות מכל אדם, ללא קשר למעמדו/ה בישראל",
   "email1": "[email protected]",
   "email2": null,
   "fax": null,
   "mailAddress": "האגודה לזכויות האזרח, רח' נחלת בנימין 75 תל-אביב 6515417. ",
   "organizationName": "אגודה לזכויות האזרח",
   "organizationType": "ארגון חברה אזרחית",
   "phoneNumber1": "03-5608185",
   "phoneNumber2": "073-7050752",
   "phoneResponseDetails": "כל יום בשעות 10:30-17:00. בשעות שבהן אין מענה אפשר להשאיר הודעה ברורה במשיבון ואנו נחזור אליכם.",
   "receptionDetails": null,
   "websiteLabel1": "אתר הארגון",
   "websiteLabel2": "פרטי יצירת קשר וטופס מקוון",
   "websiteUrl1": "https://www.acri.org.il/",
   "websiteUrl2": "https://www.acri.org.il/contact-us"
   }

וכך יוצג המידע למוקדנ/ית, תוך כדי השיחה ולצד המשימות הרלוונטיות:

כרטיסיית מידע, האגודה לזכויות האזרח

צד המוקדנ/ית: תבניות משימה

כרטיסיות המשימה הן אחד מכלי העזר שעומדים לרשותנו בטיפול בפניה. תסריטי השימוש מאפשרים לנו להציף כרטיסיות משימה לביצוע תוך כדי שיחת ההמשך בין נציג/ת הארגון לפונה ולעקוב אחר ביצוען בהמשך תהליך הטיפול בפנייה.

הצגת כרטיסיית המשימה למוקדנ/ית, אפשרית בכל שלב בתסריט השימוש, בעזרת השימוש בפונקציה showInfoCard. הפונקציה המיוחדת הזו מקבל פרמטר יחיד תחת params. הפרמטר הזה הוא השם או הכינוי (slug) של הכרטיסייה להצגה.

כך, למשל, בתסריט השימוש למוקדנ/ית, אם הפונה מאשר/ת לנציג/ת הארגון להעביר את פרטי המידע ליחידה למאבק בגזענות במשרד המשפטים – הפקודה הבאה תוסיף כרטיסיית המשימה לשיתוף פרטי המקרה:

- do:
     cmd: addTask
     params:
         - record
         - share_full_details_with_justice_ministry

כל תבניות המדימה שמורות בקובץ src/datasets/taskTemplates.datapackage.tx.json. בכל אחת מתבניות המשימה מוגדרים ארבעה רכיבים:

שם או כינוי תבנית המשימה (slug), בו נעזרים כדי להצביע על תבנית המשימה בתסריט השימוש
כותרת שתוצג בראש כרטיסיית המשימה: title
המלל שיוצג במשימה, ויכול לכלול גם קישור, בצורת [טקסט שיוצג](כתובת הקישור)
כרטיסיה, או כרטיסיות מידע נוסף, שתוצמד למשימה: infocardSlugs

כך נראית, למשל תבנית המשימה מהדוגמה הקודמת:

    "slug": "share_full_details_with_justice_ministry",
    "title": "שיתוף פרטי המקרה עם היחידה לתיאום המאבק בגזענות במשרד המשפטים"
    "description": "יש לשלוח את פרטי המקרה במלואם ליחידה לתיאום המאבק בגזענות במשרד המשפטים ולוודא את קבלת החומר.\n\nשלח/י את פרטי המקרה ליחידה לתיאום המאבק בגזענות במשרד המשפטים.\nהפונה אישר/ה העברת הפרטים במלואם.\n
\nיש לשלוח את פרטי המקרה במלואם ליחידה לתיאום המאבק בגזענות במשרד המשפטים ולוודא את קבלת החומר.\n

\n יש לתעד בכרטיס המשימה את התקשורת עם הארגון ואת העדכונים שעברו אל הפונה ושהגיעו מהפונה. ניתן לסמן משימה זו כהושלמה רק לאחר שהושלמה התקשורת עם הארגון בנוגע לפניה זו.",
    "infocardSlugs": "justice_ministry_anti_racism_unit",
},

כרטיסיית משימה ומידע נוסף

המערכת מואמת לעבודה בסביבה מרובת שפות. כל חלקי המערכת ניתנים לתרגום לכל שפה מוכרת. ניתן לתרגם את כולם, או חלקים, לפי הצורך. התרגום מתבסס על שימוש באתר Transifex, בעל ממשק נח וקל לתפעול:

צילום מסך, מערכת transifex

מערכת התרגום מאפשר שילוב מספר אנשי צוות כמתרגמים ו/או תהליך מסודר של תרגום והגהה ותיקונים. השימוש במערכת דורש פעולה פשוטה של מתן הרשאות וגישה למשאבי המערכת.

לאחר השלמת תהליך התרגום, נדרש/ת המפתח להריץ תהליך ממוכן וכעבור מספר דקות תוצג השפה החדשה, בכתובת הקבועה וקיצור שם השפה לאחריה, לדוגמה

equality.org.il/he או equality.org.il/ar או equality.org.il/en.

המערכת בגרסתה הראשונה מותאמת לשפות העברית והערבית, ולא נערכו התאמות עיצוביות לשפות משמאל-לימין (Left to Right). תיקונים אלו יהיו פשוטים ומהירים לביצוע, בגרסאות עתידיות.