כרגע מוצג התיעוד של Apigee Edge.
כניסה למסמכי התיעוד של
Apigee X. מידע
כדי שמשתמשים יוכלו להתחיל לעבוד עם פורטל השירותים למפתחים, צריך להוסיף אותם למערכת. כברירת מחדל, כל משתמש יכול להירשם בפורטל למפתחים על ידי לחיצה על הקישור 'רישום' בתפריט הפורטל. חשבון המשתמש מאומת באופן אוטומטי, ומקצים לו את תפקיד המשתמש המאומת.
ניתן להתאים אישית את הפורטל למפתחים כך שרק משתמשים עם הרשאת אדמין יוכלו להוסיף חשבונות משתמשים. במקרה כזה, מנהל מערכת צריך להוסיף חשבונות משתמש באופן ידני. יכול להיות שאדמין יצטרך גם להוסיף חשבונות משתמשים באופן ידני עבור מפתחים פנימיים או להוסיף מפתחים בשם לקוח.
אחרי שמוסיפים חשבון משתמש, אדמין יכול להקצות לחשבון המשתמש תפקיד ולשייך את ההרשאות של אותו תפקיד לחשבון. בנוסף, אדמין יכול לנהל חשבון משתמש קיים, כולל עריכת פרופיל המשתמש, מחיקת החשבון, חסימה או ביטול חסימה של החשבון והקצאת תפקיד חדש לחשבון. האדמין יכול גם לציין מה יקרה לחשבון המשתמש ולתוכן שמשויך אליו (למשל, פוסטים בבלוגים ופוסטים בפורומים) אחרי ביטול החשבון.
הפורטל למפתחים יכול לשלוח הודעות אימייל למשתמשים באופן אוטומטי כשמתרחשים אירועים. לדוגמה, הפורטל יכול לשלוח אימייל כשנוסף משתמש, נחסם חשבון או מבוטל חשבון. כחלק מניהול המשתמשים, יש לך אפשרות לשלוט בתוכן ובפורמט של הודעות האימייל האלה. למידע נוסף, ראו הגדרת אימייל.
בסרטון הבא מוסבר איך לנהל תהליכי עבודה של רישום, להתאים אישית אימיילים לרישום, לחסום את אפשרות ההרשמה לכתובות IP, וגם ליצור, לנהל ולחסום חשבונות משתמשים.
שליטה על מי שיכול לרשום חשבונות
כברירת מחדל, כל משתמש יכול ליצור חשבון מפורטל המפתחים באמצעות לחיצה על הקישור ל'רישום'.
כדי לקבוע מי יוכל לרשום חשבונות:
- אתם יכולים להתחבר לפורטל שלכם כמשתמשים עם הרשאות אדמין או יצירת תוכן.
- בתפריט הניהול של Drupal, צריך לבחור באפשרות תצורה > אנשים > הגדרות חשבון. הדף 'הגדרות חשבון' ייפתח.
- לוחצים על אפשרות הרישום המתאימה בקטע מי יכול לרשום חשבונות בקטע 'רישום וביטול'. האפשרויות הן:
- אדמינים בלבד: רק אדמינים יכולים לרשום חשבונות משתמשים.
- מבקרים: כל אחד יכול להירשם. (זוהי ברירת המחדל)
- מבקרים, אבל נדרש אישור אדמין: כל אחד יכול להירשם, אבל אדמין צריך הרשאה לחשבון.
- מסמנים את התיבה דרישה לאימות אימייל כאשר מבקר יוצר חשבון או מבטלים את הסימון שלה. אם האפשרות לא מסומנת, המפתח מחובר מיד לפורטל לאחר הרישום. כשהאפשרות מסומנת, המשתמש מקבל אימייל שמשמש לאימות כתובת האימייל לפני ההתחברות.
- לוחצים על Save configuration (שמירת ההגדרות האישיות).
הוספת חשבון משתמש
בהתאם להגדרות של הפורטל, האדמינים יצטרכו להוסיף משתמשים באופן ידני. לחלופין, הם יוכלו להוסיף את עצמם על ידי לחיצה על הקישור להרשמה בפורטל למפתחים.
הוספה ידנית של חשבון משתמש
כדי להוסיף חשבון משתמש באופן ידני:
- אתם יכולים להתחבר לפורטל שלכם כמשתמשים עם הרשאות אדמין או יצירת תוכן.
- בוחרים באפשרות אנשים > הוספת משתמש בתפריט הניהול של Drupal.
- מזינים את התוכן של המשתמש בשדות 'שם פרטי', 'שם משפחה', 'שם משתמש', 'כתובת אימייל' ו'סיסמה', ומאשרים את הסכם המשתמש.
- אפשר להגדיר את הסטטוס והתפקידים עבור המשתמש.
- צריך לבחור באפשרות הודעה למשתמש על חשבון חדש כדי ליצור אימייל אוטומטי שיישלח אליו.
- לוחצים על יצירת חשבון.
רישום משתמש מהפורטל למפתחים
כדי לרשום משתמש מפורטל המפתחים:
- המשתמש בוחר באפשרות הרשמה בדף הבית של פורטל המפתחים.
- דף ההרשמה יופיע.
- המשתמש מזין את המידע הנדרש ובוחר באפשרות Create new account (יצירת חשבון חדש).
בהתאם להגדרות הרישום החדשות של החשבון, לאחר יצירת החשבון החדש, למשתמש נשלח אימייל אוטומטי לאחר ההצטרפות.
אוטומציה של התראה של מנהל מערכת כאשר משתמש חדש נרשם
כברירת מחדל, כשמשתמש חדש נרשם לפורטל, הוא מקבל אימייל. למידע נוסף: הגדרת אימייל.
עם זאת, מנהלי הפורטל לא מקבלים הודעה כברירת מחדל כאשר משתמש חדש נרשם. לדוגמה, אם הגדרתם את הפורטל כך שמשתמשים חדשים יצטרכו לקבל אישור אדמין כדי להפעיל את החשבון שלהם, כדאי לוודא שהאדמינים יקבלו התראה בכל פעם שהחשבון החדש ייווצר. אחרת, חשבון המשתמש יישאר לא פעיל.
כדי להודיע לאדמינים כשמשתמש חדש נרשם חשבון:
- אתם יכולים להתחבר לפורטל שלכם כמשתמשים עם הרשאות אדמין או יצירת תוכן.
- בתפריט הניהול של Drupal, צריך לבחור באפשרות הגדרה > אנשים > התראות אדמין.
- בקטע התראות משתמשים, מציינים מי יקבל את האימייל. אפשר לנתב אותו אל:
- שליחה לכתובת אימייל מותאמת אישית
- לשלוח לתפקיד ספציפי. אם בחרת באפשרות הזו, כדאי ליצור תפקיד חדש. אחרת, אם בוחרים בתפקיד כמו אדמין, כל האדמינים יקבלו את האימייל ויכול להיות שהוא לא רלוונטי לכל האדמינים.
- שניהם
- עורכים את הנושא ואת גוף ההודעה.
- בוחרים מתי תישלח ההודעה:
- קבלת אימייל עם יצירת המשתמש.
- קבלת אימייל עם יצירה ועדכון של משתמש.
- לוחצים על Save configuration (שמירת ההגדרות האישיות).
ניהול חשבון משתמש
מנהלי מערכת יכולים לנהל את חשבונות המשתמשים, להגדיר פרטי משתמשים, לאפס סיסמאות, להפעיל חשבונות, לבטל או להשעות חשבונות ולבצע משימות אחרות.
כדי לערוך את פרופיל המשתמש של חשבון משתמש:
- אתם יכולים להתחבר לפורטל שלכם כמשתמשים עם הרשאות אדמין או יצירת תוכן.
- בוחרים באפשרות אנשים בתפריט הניהול של Drupal.
- אפשר להשתמש באזור הסינון שבחלק העליון של הדף כדי לסנן את התצוגה של המשתמשים לפי שם משתמש, כתובת אימייל, סטטוס או הרשאה ספציפיים. כברירת מחדל, האפשרות 'כלשהו' מסומנת למסננים האלה. במקרה כזה, כל המשתמשים רשומים בדף.
- לוחצים על עריכה בשורה 'שם משתמש' של חשבון המשתמש. תיפתח תצוגה ניתנת לעריכה של פרופיל המשתמש.
- משנים את הנתונים בפרופיל המשתמש לפי הצורך.
- לוחצים על שמירה.
הוספת CAPTCHA
כדי להוסיף אתגר CAPTCHA לדף ההתחברות ולדפים אחרים, הפעלת המודולים CAPTCHA ו-reCAPTCHA ב-Drupal. מודול ה-reCAPTCHA מוסיף תמיכה בשירות Google reCAPTCHA החינמי.
Drupal תומך במודולים אחרים של CAPTCHA, כמו CAPTCHA בתמונה, שתוכלו להשתמש בהם גם בפורטל.
סרטון: אפשר לצפות בסרטון קצר על הפעלת CAPTCHA בפורטל למפתחים.
כדי להפעיל reCAPTCHA:
- אתם יכולים להתחבר לפורטל שלכם כמשתמשים עם הרשאות אדמין או יצירת תוכן.
- בוחרים באפשרות מודולים בתפריט Drupal.
- מפעילים גם את המודולים CAPTCHA וגם reCAPTCHA.
- ניתן להירשם לקבלת מפתחות reCAPTCHA מ-Google בכתובת https://www.google.com/recaptcha/intro/index.html.
- בתפריט Drupal, בוחרים באפשרות הגדרה > אנשים > CAPTCHA > reCAPTCHA.
- מזינים את המפתח הציבורי (מפתח האתר של Google) ואת המפתח הפרטי (המפתח הסודי של Google). אפשר להשאיר את ערכי ברירת המחדל בשאר ההגדרות.
- צריך לבחור באפשרות הגדרות אישיות > אנשים > CAPTCHA כדי להגדיר את המיקום שבו רוצים להציג את טופס ה-reCAPTCHA. כברירת מחדל, היא מופיעה בטפסים ההתחברות ובטופס ההרשמה של המשתמשים.
- בדף הזה, מגדירים את סוג האימות לכל טופס.
- שומרים את השינויים.
הוספת דף תנאים והגבלות
אפשר להוסיף לפורטל המפתחים דף 'תנאים והגבלות' שהמשתמשים יצטרכו לאשר כשהם מתחברים כדי לקבל גישה לפורטל. אם מאוחר יותר יתבצע שינוי בדף התנאים וההגבלות, המשתמשים יתבקשו לאשר את התנאים וההגבלות המעודכנים בפעם הבאה שהם ייכנסו.
כדי להטמיע את דף התנאים וההגבלות, נעשה שימוש במודול המשפטי של Drupal. המודול הזה מספק דרך גמישה ליצירת דף תנאים והגבלות, למעקב אחר היסטוריית גרסאות של התנאים וההגבלות ולמעקב אחר משתמשים שהסכימו לתנאים ולהגבלות.
לאחר יצירת דף התנאים וההגבלות, כתובת ה-URL שלו תהיה
<siteURL>/legal
.
כדי להפעיל את המודול 'משפטית':
- עליך להתחבר לפורטל שלך כמשתמש עם הרשאות אדמין.
- בוחרים באפשרות מודולים בתפריט הניהול של Drupal. תופיע רשימה של כל המודולים המותקנים של Drupal.
- גוללים למטה בדף ומסמנים את התיבה שליד המודול המשפטי.
- לוחצים על Save configuration (שמירת ההגדרות האישיות).
כך יוצרים דף תנאים והגבלות:
- עליך להתחבר לפורטל שלך כמשתמש עם הרשאות אדמין.
- בתפריט הניהול של Drupal, בוחרים באפשרות Configuration > משתתפים > Legal (הגדרות אישיות) > Legal (נושאים משפטיים).
האפשרות הזו בתפריט מופיעה רק כשהמודול המשפטי מופעל. התיבה העליונה בדף, בקטע 'הגרסה האחרונה או הגרסה האחרונה', מציגה את התנאים וההגבלות הנוכחיים. אם לא הוגדרו תנאים והגבלות, האזור הזה מוגדר כקו מפריד. אפשר ליצור גרסה חדשה בקטע 'תנאים והגבלות' שבקטע 'יצירת גרסה חדשה/תרגום חדש'. - מזינים את התנאים וההגבלות באזור 'תנאים והגבלות'.
- בוחרים איך רוצים להציג את התנאים וההגבלות בדף: Scroll Box, Scroll Box (CSS) , טקסט HTML או Page Link.
- אם רוצים, אפשר להוסיף עוד תיבות סימון ואזור טקסט שמתאר את השינויים האחרונים.
- בוחרים באפשרות Preview (תצוגה מקדימה) כדי לראות תצוגה מקדימה של התנאים וההגבלות בקטע 'תנאים והגבלות לשימוש' בקטע 'הגרסה האחרונה או הגרסה האחרונה', או לוחצים על שמירה כדי לשמור אותם.
כדי לעקוב אחר השינויים בתנאים וההגבלות והאישור שלהם:
- עליך להתחבר לפורטל שלך כמשתמש עם הרשאות אדמין.
- בתפריט הניהול של Drupal, בוחרים באפשרות Configuration > משתתפים > Legal (הגדרות אישיות) > Legal (נושאים משפטיים).
- בוחרים את הכרטיסייה היסטוריית התנאים וההגבלות כדי לראות את היסטוריית הגרסאות של התנאים וההגבלות.
- לוחצים על הכרטיסייה Approved (אישור) כדי לראות את רשימת המשתמשים שהסכימו לכל גרסה של התנאים וההגבלות.
הפניה אוטומטית של משתמש בהתחברות
כברירת מחדל, כשמשתמש מתחבר לפורטל הוא מופנה לדף שמציג את הפרטים שלו, כמו השם הפרטי ושם המשפחה. לחלופין, אפשר להשתמש במודול Drupal Rules כדי להוסיף כלל שיפנה את המשתמש לדף אחר באופן אוטומטי. לדוגמה, ניתן להפנות את המשתמשים לדף שמפרט את כל האפליקציות שלו, או לדף הבית של הפורטל.
כדי ליצור כלל להפניה אוטומטית, צריך לוודא שכל המודולים הנדרשים של Drupal מופעלים.
מפעילים את המודולים הנדרשים של Drupal:
- עליך להתחבר לפורטל שלך כמשתמש עם הרשאות אדמין.
- בוחרים באפשרות מודולים בתפריט הניהול של Drupal.
- מפעילים את המודולים הבאים אם הם עדיין לא מופעלים:
- כינויים מסוג 'אני' (מופיע בראש רשימת המודולים, לא במיקום האלפביתי שלו, כמו גם בכל המודולים האחרים)
- LoginToboggan
- כללים
- ממשק המשתמש של הכללים
- לוחצים על Save configuration (שמירת ההגדרות האישיות).
יכול להיות שמודולים נדרשים אחרים יופעלו באופן אוטומטי.
יוצרים כלל הפניה אוטומטית להתחברות:
- עליך להתחבר לפורטל שלך כמשתמש עם הרשאות אדמין.
- בתפריט הניהול של Drupal, בוחרים באפשרות Configuration > Workflow > Rules
- בוחרים באפשרות + הוספת כלל חדש בדף 'כללים'.
- מציינים את שם הכלל: הפניה אוטומטית להתחברות.
- אפשר לציין תג בתור פרטי התחברות.
- בתיבה הנפתחת 'תגובה לאירוע', בוחרים באפשרות User (משתמש) > 'משתמש מחובר'.
- בוחרים באפשרות שמירה
יופיע הדף של כלל התגובה לעריכה. כבר הגדרת את האירוע בשלב הקודם, לכן אמור להופיע הכיתוב 'המשתמש התחבר' בקטע 'אירוע'. יש להשאיר את השדות 'תנאים' ריקים עבור הכלל הזה. - בקטע 'פעולות', בוחרים באפשרות + הוספת פעולה.
- בוחרים באפשרות מערכת > הפניית דף בתפריט הנפתח.
הדף 'הוספת פעולה חדשה' משנה את הפריסה שלו כדי לאפשר לכם לציין את כתובת ה-URL להפניה אוטומטית. - בקטע 'ערך', מציינים user/[account:uid]/apps.
[account:uid] הוא תבנית חלופית שתואמת למזהה הפורטל של המשתמש. כדי להציג את הרשימה המלאה של התבניות להחלפה, בוחרים באפשרות 'תבניות החלפה' מתחת לתיבת הקלט 'ערך'. - לוחצים על שמירה כדי לחזור לדף של כללי העריכה לתגובות. הדף אמור
להופיע כמו שמוצג למטה:
- לוחצים על שמירת שינויים.
כדי לערוך את הכלל מאוחר יותר, יש לבחור באפשרות 'כללים' בדף 'הגדרה' ואז לבחור באפשרות 'הפניה אוטומטית להתחברות' מרשימת הכללים.
עכשיו, כשהמשתמש יתחבר לחשבון, הוא יופנה לדף שבו מפורטות כל האפליקציות שלו. אם במקום זאת היית רוצה להפנות אותם לדף הבית של הפורטל, צריך לערוך את הערך שהגדרת למעלה בשלב 11 כדי לציין את כתובת ה-URL של דף הבית של הפורטל. לדוגמה, http://dev-myCompany.devportal.apigee.io/.
הגדרת תפקידים והרשאות של משתמשים
תפקיד מגדיר קבוצה ספציפית של הרשאות שמאפשרות למשתמש לבצע פעילויות מסוימות. אפשר להעניק הרשאות למשתמש או לקבוצת משתמשים על ידי הקצאה של תפקיד עם ההרשאות הדרושות. אדמינים מנהלים תפקידים בפורטל למפתחים, כולל הגדרת הרשאות לתפקידים.
כברירת מחדל, Drupal יוצר שני תפקידים:
- משתמש אנונימי - התפקיד של כל משתמש שלא התחבר. משתמשים אנונימיים לא יכולים לבצע את רוב הפעולות.
- authenticated user – תפקיד ברירת המחדל שהוקצה לכל המשתמשים. אפשר להקצות למשתמשים תפקידים נוספים, אבל תמיד הם מוקצים לתפקיד הזה.
בנוסף, Apigee הוסיפה את התפקיד של אדמין. כדי להקצות הרשאות ניהול לפורטל, צריך להקצות למשתמשים את תפקיד האדמין.
בדרך כלל מוסיפים תפקידים לפורטל כדי להגדיר הרשאות שונות על סמך סוגי משתמשים שונים. משתמש יכול להיות בתפקיד אחד או בכמה תפקידים. כל המשתמשים מוקצים לתפקיד משתמש מאומת, אבל אם רוצים להקצות משתמש לתפקידים נוספים, צריך להוסיף לוגיקה לפורטל או להקצות את התפקידים באופן ידני.
כדי להציג את כל התפקידים וההרשאות:
- אתם יכולים להתחבר לפורטל שלכם כמשתמשים עם הרשאות אדמין או יצירת תוכן.
- בתפריט הניהול של Drupal, בוחרים באפשרות אנשים > הרשאות > תפקידים.
כדי להוסיף תפקיד חדש:
- בוחרים באפשרות אנשים > הרשאות > תפקידים.
- מזינים שם לתפקיד חדש בתיבת הטקסט שמעל ללחצן 'הוספת תפקיד' בדף 'אנשים'.
- לוחצים על הוספת תפקיד.
כדי לערוך תפקיד:
- בוחרים באפשרות אנשים > הרשאות > תפקידים.
- לוחצים על עריכת התפקיד בשורה של התפקיד המתאים בדף 'אנשים'.
- משנים את שם התפקיד לפי הצורך.
- לוחצים על שמירה.
כדי למחוק תפקיד:
- בוחרים באפשרות אנשים > הרשאות > תפקידים.
- לוחצים על עריכת התפקיד בשורה של התפקיד המתאים בדף 'אנשים'.
- לוחצים על מחיקת התפקיד.
כדי להוסיף משתמש לתפקיד:
- אתם יכולים להתחבר לפורטל שלכם כמשתמשים עם הרשאות אדמין או יצירת תוכן.
- בוחרים באפשרות אנשים בתפריט הניהול של Drupal.
- לוחצים על עריכה בשורה 'שם משתמש' של חשבון המשתמש. תיפתח תצוגה ניתנת לעריכה של פרופיל המשתמש.
- בוחרים את כל התפקידים של המשתמש לפי הצורך.
- לוחצים על שמירה.
כדי לשנות את ההרשאות של התפקיד:
- בוחרים באפשרות אנשים > הרשאות > תפקידים.
- לוחצים על הכרטיסייה הרשאה בדף 'אנשים'.
תוצג טבלה של התפקידים וההרשאות. סימני וי בטבלה מציינים אילו הרשאות מוקצות לכל תפקידים.
- כדי להעניק או לבטל את ההרשאה המשויכת לתפקיד, צריך לסמן את התיבה או לבטל את הסימון שלה,
בהתאמה.
לדוגמה, כדי למנוע ממשתמשים את האפשרות ליצור או למחוק אפליקציות, גוללים למטה אל הקטע DevConnet Developer Apps בטבלת ההרשאות ומבטלים את הסימון בתיבות של Create Developer Apps (יצירת אפליקציות למפתחים) ו-Delete Developer Apps (מחיקת אפליקציות למפתחים) שבקטע משתמשים מאומתים. - לוחצים על שמירת ההרשאות.
התאמה אישית של שדות הטופס שמשמשים לרישום משתמשים
כשהמשתמש נרשם לחשבון בפורטל, מוצג בפורטל דף ההרשמה שמוגדר כברירת מחדל עם השדות 'שם פרטי', 'שם משפחה', 'שם משתמש', 'כתובת אימייל' ו'סיסמה'. בתור ספק API, כדאי לשנות את הטופס הזה כדי לבקש מהמשתמש לספק מידע נוסף כמו שם חברה, כתובת למשלוח דואר או מידע אחר. בפורטל אפשר להוסיף שדות חדשים לטופס הזה. השדות האלה יכולים להיות:
- נדרש או אופציונלי
- מוצג באמצעות רכיבי HTML שונים, כגון תיבות טקסט, לחצני בחירה, תיבות סימון ועוד
- ניתן להגדיר להופיע בכל מקום בטופס
בסרטון הבא מוסבר איך להתאים אישית את טופס ההרשמה של המשתמשים דרך הפורטל למפתחים.
לדוגמה, אפשר להוסיף שדה חובה עבור Company Name (שם חברה), או שדה אופציונלי עבור Phone Number (מספר טלפון). לחלופין, ניתן להוסיף כמה שדות, גם אופציונליים וגם שדות חובה.
בתמונה הבאה מוצג שדה חובה עבור 'שם חברה' שנוסף לטופס:
כאדמינים של פורטלים, אתם יכולים לראות ולערוך את פרטי המשתמש, כולל שדות מותאמים אישית, על ידי:
- בוחרים באפשרות אנשים בתפריט הניהול של Drupal בפורטל.
- בוחרים באפשרות עריכה בשורה שתואמת לשם המשתמש.
זוהי הדרך העיקרית שבה אתם, כמנהלים, ניגשים לפרטי משתמשים.
כברירת מחדל, כשמוסיפים שדות חדשים לטופס, ערכי השדות לא מועלים ל-Edge. עם זאת, אפשר להגדיר את הפורטל כך שיעלה את הערכים האלה כשהמשתמש שולח את הטופס. המשמעות היא שאפשר להציג את השדות האלה ב-Edge, או להשתמש בממשק ה-API לניהול Edge כדי לגשת לשדות האלה מסקריפט.
לדוגמה, אפשר להציג את שדות הטופס החדשים בממשק המשתמש לניהול Edge דרך פרסום > מפתחים ובחירה בשם המשתמש. ערכי השדות החדשים יופיעו באזור 'מאפיינים מותאמים אישית' של הדף, עם שם שתואם לשם הפנימי של השדה:
כדי להוסיף שדה לטופס ההרשמה של המשתמשים:
- אתם יכולים להתחבר לפורטל שלכם כמשתמשים עם הרשאות אדמין או יצירת תוכן.
- בתפריט הניהול של Drupal, צריך לבחור באפשרות תצורה > אנשים > הגדרות חשבון.
- לוחצים על הלחצן Manage fields בחלק העליון של הדף.
- גוללים למטה בדף לאזור 'הוספת שדה חדש':
- מגדירים את השדה. לדוגמה, בשדה 'שם החברה' שמוצג למעלה, צריך להשתמש בהגדרות הבאות:
- לוחצים על שמירה.
- מאחר שמדובר בשדה טקסט, תתבקשו לציין את האורך המקסימלי של השדה.
- מזינים את האורך המקסימלי ובוחרים באפשרות שמירת הגדרות השדה.
- מופיע דף חדש שמאפשר לציין פרטים נוספים בשדה, כולל:
- תיבת סימון כדי להגדיר זאת כשדה חובה.
- תיבת סימון שמאפשרת להציג את השדה.
- טקסט עזרה אופציונלי שמופיע בחלון קופץ בטופס.
- הגדרות אחרות.
- צריך לסמן את התיבה כדי להפוך את השדה הזה לשדה חובה.
- אם תערכו שינויים בדף הזה, יש לשמור את ההגדרות.
יכול להיות שתצטרכו לנקות את המטמון של הדפדפן כדי שהשדה החדש יופיע בטופס.
כדי לשנות את הסדר של המאפיינים בטופס:
כברירת מחדל, שדות חובה חדשים מופיעים בטופס אחרי השדה 'שם משפחה'. השדות האופציונליים מופיעים בתחתית הטופס, אחרי שדות הסיסמה.
- אתם יכולים להתחבר לפורטל שלכם כמשתמשים עם הרשאות אדמין או יצירת תוכן.
- בתפריט הניהול של Drupal, צריך לבחור באפשרות הגדרה > אנשים > הגדרות חשבון.
- לוחצים על הלחצן ניהול שדות בחלק העליון של הדף.
- לוחצים על סמל הפלוס + בעמודה 'תווית' וגוררים את השדה למיקום שבו רוצים להציג אותו בטופס.
- שומרים את השינויים.
שמירת ערכים של שדות בטופס כמאפייני מפתח בהתאמה אישית ב-Edge
אפשר לשמור ערכים של שדות בטופס במאפיינים מותאמים אישית של מפתח ב-Edge. אפשר להציג ולנהל מאפיינים מותאמים אישית של מפתח, כפי שמתואר במאמר ניהול מפתחי אפליקציות.
אחרי שמירת המאפיינים המותאמים אישית של המפתח, אפשר להשתמש במדיניות הגישה לישות, לדוגמה, כדי להפעיל התנהגות דינמית שמבוססת על ערכי המאפיינים המותאמים אישית.
בסרטון הזה מוסבר איך לשמור ערכים של שדות בטופס כמאפייני מפתח בהתאמה אישית.
כדי לשמור את ערכי השדות כמאפייני מפתח בהתאמה אישית ב-Edge:
- אתם יכולים להתחבר לפורטל שלכם כמשתמשים עם הרשאות אדמין או יצירת תוכן.
- בתפריט הניהול של Drupal, בוחרים באפשרות Configuration > Dev Portal > מאפיינים למפתחים.
תוצג רשימה של השדות הזמינים. - צריך לבחור את השדה שרוצים להשאיר כמאפיין ב-Edge, כמו Company Name.
- מגדירים את תיבת הסימון Persist this field as מאפיין ב-Edge.
- מציינים את שם המאפיין Edge. זהו השם שמופיע בעמודה 'שם' בטבלה 'מאפיינים מותאמים אישית' עבור המשתמש.
- צריך לציין את ההתנהגות בשדה ריק/
- צריך לבחור את המחרוזת Convert value ל-true|false אם רוצים להמיר את הערך כבוליאני ולהמיר אותו למחרוזת true או false לפני השליחה ל-Edge.
- לוחצים על Save configuration (שמירת ההגדרות האישיות).
עכשיו המאפיין המותאם אישית יועלה ל-Edge כשהמשתמש ישלח את הטופס. אם אתם אדמינים ואתם רוצים לשנות את הערך של שדה בהתאמה אישית, עליכם לעשות זאת מהפורטל ולא מ-Edge.
יצירת אפליקציית ברירת מחדל כשמשתמש רושם חשבון חדש
אפשר ליצור אפליקציית ברירת מחדל באופן אוטומטי כשמשתמש רושם חשבון פורטל חדש. כשהמשתמש מתחבר בפעם הראשונה, האפליקציה מופיעה בדף 'האפליקציות שלי'. בהתאם להרשאות שהוקצו לתפקיד של המשתמש, אפשר לאפשר למשתמש להוסיף עוד אפליקציות, או שזו האפליקציה היחידה שזמינה למשתמש.
יש לכם שליטה מלאה על המאפיינים של אפליקציית ברירת המחדל, כולל:
- מוצרי ה-API שהאפליקציה כוללת
- מצב האפליקציה: 'בהמתנה' או 'אושרה'
- כתובת ה-URL לקריאה חוזרת (callback), אם יש צורך
- פרמטרים מותאמים אישית שהוחלו על האפליקציה
הדרך שבה שולטים ביצירת אפליקציית ברירת מחדל היא ליצור כלל באמצעות המודול 'כללי Drupal'. כלל מאפשר להגדיר פעולה שמתרחשת בתגובה לאירוע בפורטל. בתרחיש הזה, האירוע הוא משתמש שנרשם לחשבון בפורטל. הפעולה היא ליצור אפליקציה כברירת מחדל עבור המשתמש.
בקטע התאמה אישית של שדות הטופס שמשמשים לרישום אפליקציה מוסבר איך להוסיף מאפיינים מותאמים אישית שמשמשים להגדרת אפליקציה. המאפיינים האלה יכולים להיות אופציונליים או נדרשים, בהתאם לאופן שבו מגדירים אותם. אם יצרת מאפיינים מותאמים אישית של אפליקציה, תוכל להגדיר אותם בעת ההגדרה של אפליקציית ברירת מחדל.
מפעילים את המודולים של כללי Drupal:
- עליך להתחבר לפורטל שלך כמשתמש עם הרשאות אדמין.
- בוחרים באפשרות מודולים בתפריט הניהול של Drupal
- מפעילים את המודולים הבאים אם הם עדיין לא מופעלים:
- כינויים מסוג 'אני' (מופיע בראש רשימת המודולים, לא במיקום האלפביתי שלו, כמו גם בכל המודולים האחרים)
- LoginToboggan
- כללים
- ממשק המשתמש של הכללים
- לוחצים על Save configuration (שמירת ההגדרות האישיות).
יכול להיות שמודולים נדרשים אחרים יופעלו באופן אוטומטי.
יוצרים כלל להוספה של אפליקציית ברירת מחדל:
- עליך להתחבר לפורטל שלך כמשתמש עם הרשאות אדמין.
- בתפריט הניהול של Drupal, בוחרים באפשרות Configuration > Workflow > Rules (כללים)
- לוחצים על הלחצן +הוספת כלל חדש.
- מציינים את שם הכלל.
- אפשר לציין פרטי התחברות בשדה Tags, או כל תג אחר שרוצים להשתמש בו כדי לסווג את הכלל.
- בתיבה הנפתחת תגובה לאירוע, בוחרים באפשרות משתמש > אחרי שמירת חשבון משתמש חדש.
- לוחצים על שמירה.
מופיע הדף של עריכת הכלל. כבר הגדרתם את האירוע בשלב הקודם, ולכן בקטע 'אירוע' אמור להופיע הכיתוב 'לאחר שמירת חשבון משתמש חדש'. - משאירים את השדה תנאים ריק לכלל הזה.
- בקטע פעולות, בוחרים באפשרות + הוספת פעולה.
- בתפריט הנפתח, בוחרים באפשרות Devconnect > 'יצירת אפליקציה למפתחים'.
הדף 'הוספת פעולה חדשה' משנה את הפריסה שלו כדי לאפשר לכם להגדיר את האפליקציה. - בקטע API Name מציינים את השם של אפליקציית ברירת המחדל. לדוגמה, משתמשים ב-[account:field_last_name]
Application.
הערך [account:field_last_name] הוא תבנית חלופית שתואמת לשם המשפחה של המשתמש. כדי להציג את הרשימה המלאה של התבניות החלופיות, צריך לבחור את התבניות החלפה בתיבת הקלט Value (ערך). - מגדירים את UID של המפתח בתור [account:uid]. הערך הזה נדרש כדי לשייך את המשתמש לאפליקציה.
- משנים את סטטוס האפליקציה לבהמתנה או אושרה. אם האדמין עדיין צריך לאשר את האפליקציה לפני שהמשתמש יכול להשתמש בה כדי לגשת לממשקי ה-API, אפשר להעביר אותה למצב בהמתנה.
- אם צריך, מגדירים את כתובת ה-URL לקריאה חוזרת (callback) של האפליקציה. השדה הזה מופיע רק אם הגדרתם לאפליקציות לחייב כתובת URL לקריאה חוזרת (callback). למידע נוסף על הגדרת כתובות URL לקריאה חוזרת, אפשר לעיין במאמר הגדרת טיפול בכתובות URL של קריאה חוזרת.
- אם הגדרת מאפיינים מותאמים אישית של אפליקציות, אופציונליים או נדרשים, יש להגדיר אותם. אפשר לקרוא מידע נוסף במאמר התאמה אישית של שדות הטופס שמשמשים לרישום אפליקציה.
- מציינים את מוצרי ה-API שכלולים באפליקציה.
באזור הטקסט ערך צריך להופיע כל מוצר של ה-API בשורה נפרדת, ללא פסיקים או מפרידים אחרים. רשימת המוצרים הזמינים של ה-API מוצגת מעל אזור הטקסט ערך. - לוחצים על Save כדי לחזור לדף Edit rule.
- לוחצים על שמירת שינויים.
- כדי לערוך את הכלל מאוחר יותר, צריך לבחור באפשרות הגדרה > תהליך עבודה > כללים בתפריט הניהול של Drupal ואז לבחור את הכלל מרשימת הכללים.
כשמשתמש חדש מתחבר לפורטל בפעם הראשונה ולוחץ על הקישור 'האפליקציות שלי' בתפריט, הוא רואה עכשיו אפליקציה בשם lastName Application, כאשר lastName הוא שם המשפחה שבו נעשה שימוש כשהמשתמש רשם את החשבון.
ניהול אפליקציות של משתמשים
אדמינים של פורטלים יכולים להשתמש בדוח האפליקציות למפתחים כדי לנהל את אפליקציות המשתמשים ישירות מהפורטל. מתוך הדוח הזה, אדמין יכול להציג מידע על אפליקציה של משתמש, לשנות את האפליקציה או למחוק את האפליקציה. לדוגמה, אדמין של פורטל יכול לשנות את האפליקציה כך: להוסיף או להסיר מוצרי API, לשנות את כתובת ה-URL לקריאה חוזרת (callback) או לבצע שינויים אחרים.
כדי לנהל אפליקציה של משתמש:
- עליך להתחבר לפורטל שלך כמשתמש עם הרשאות אדמין.
- בתפריט הניהול של Drupal, בוחרים באפשרות דוחות > אפליקציות למפתחים. תופיע רשימה של אפליקציות משתמש שניתן למיין.
- בכל אפליקציה ברשימה:
- בוחרים בקישור עריכה כדי לערוך את נכסי האפליקציה.
- בוחרים בקישור מחיקה כדי למחוק את האפליקציה.
ביטול חשבון משתמש
מנהל פורטל יכול לבטל חשבון משתמש. מנהל המערכת יכול לבטל חשבון יחיד, או לבטל מספר חשבונות בבת אחת.
כדי לבטל חשבונות של משתמשים ספציפיים:
- עליך להתחבר לפורטל שלך כמשתמש עם הרשאות אדמין.
- בוחרים באפשרות אנשים בתפריט הניהול של Drupal.
- בעמודה Actions (פעולות) בטבלת המשתמשים, לוחצים על Cancel account (ביטול החשבון).
- לוחצים על אפשרות הביטול המתאימה בקטע 'בעת ביטול חשבון משתמש'. האפשרויות הן:
- השבתת החשבון ושמירת התוכן שלו: (ברירת המחדל) חשבון המשתמש והתוכן הקשור אליו נשמרים. עם זאת, הגישה למשאבי ה-API של חשבון המשתמש תיחסם. (זוהי ברירת המחדל) בהמשך, אדמין יוכל לבטל את החסימה של חשבון המשתמש.
- השבתת החשבון וביטול הפרסום של התוכן שלו: חשבון המשתמש יישמר. עם זאת, התוכן שמשויך לחשבון המשתמש יוסר. הגישה של חשבון המשתמש למשאבי ה-API תיחסם. בהמשך, אדמין יוכל לבטל את החסימה של חשבון המשתמש.
- למחוק את החשבון, אבל לקבוע שהתוכן שלו יהיה שייך למשתמש האנונימי: חשבון המשתמש יימחק. התוכן שמשויך לחשבון המשתמש נשמר, אבל הוא משויך לחשבון המשתמש ה "אנונימי", כלומר לחשבון שלא אומת. אי אפשר להפעיל מחדש את חשבון המשתמש. המשתמש צריך להירשם מחדש וצריך לאמת את חשבון המשתמש לפני שהוא ניגש למשאבי ה-API.
- מחיקת החשבון והתוכן שלו: חשבון המשתמש והתוכן הקשור אליו יימחקו. אי אפשר להפעיל מחדש את חשבון המשתמש. המשתמש צריך להירשם מחדש וצריך לאמת את חשבון המשתמש לפני שהוא ניגש למשאבי API.
- כדי שהמשתמש יקבל אימייל עם בקשה לאשר את הביטול, צריך לבחור באפשרות
'נדרש אישור באימייל כדי לבטל את החשבון'.
אם בוחרים באפשרות הזו, לחשבון של המשתמש צריכות להיות ההרשאות המתאימות כדי לאפשר את הביטול. בוחרים באפשרות אנשים > הרשאות ומוודאים שלתפקיד משתמש מאומת מוגדרת ההרשאה ביטול חשבון המשתמש האישי. - לוחצים על ביטול החשבון.
כדי לבטל כמה חשבונות משתמשים:
- עליך להתחבר לפורטל שלך כמשתמש עם הרשאות אדמין.
- בוחרים באפשרות אנשים בתפריט הניהול של Drupal.
- בקטע Actions (פעולות), בוחרים באפשרות Cancel user account (ביטול חשבון המשתמש) בתפריט הנפתח.
- מסמנים את התיבה לצד כל משתמש שרוצים לבטל את החשבון שלו.
- לוחצים על הלחצן Execute.
- לוחצים על אפשרות הביטול המתאימה בקטע 'בעת ביטול חשבון משתמש'. האפשרויות הן:
- השבתת החשבון ושמירת התוכן שלו.
- להשבית את החשבון ולבטל את פרסום התוכן שלו.
- למחוק את החשבון, אבל לקבוע שהתוכן שלו יהיה שייך למשתמש האנונימי.
- למחוק את החשבון ואת התוכן שלו.
- לוחצים על הבא.
- לוחצים על אישור.
הגדרה של פעולת ברירת המחדל כשחשבון מבוטל
האדמינים של פורטל המפתחים יכולים להגדיר את פעולת ברירת המחדל של הפורטל כשחשבון משתמש מבוטל.
כדי להגדיר את פעולת ברירת המחדל כשחשבון מבוטל:
- אתם יכולים להתחבר לפורטל שלכם כמשתמשים עם הרשאות אדמין או יצירת תוכן.
- בוחרים באפשרות הגדרה בתפריט הניהול של Drupal.
- בוחרים באפשרות הגדרות חשבון.
- לוחצים על אפשרות הביטול המתאימה בקטע 'בעת ביטול חשבון משתמש'
בקטע 'רישום וביטול'. האפשרויות הן:
- השבתת החשבון ושמירת התוכן שלו.
- להשבית את החשבון ולבטל את פרסום התוכן שלו.
- למחוק את החשבון, אבל לקבוע שהתוכן שלו יהיה שייך למשתמש האנונימי.
- למחוק את החשבון ואת התוכן שלו.
- לוחצים על Save (שמירת ההגדרות האישיות).