העברת פורטל Drupal 7 לפורטל המשולב

אתם צופים במסמכי העזרה של Apigee Edge.
כניסה למסמכי העזרה של Apigee X.
info

בקטע הזה מוסבר איך לתכנן ולבצע את ההעברה של נכסי הפורטל מ-Drupal 7 לפורטל המשולב.

שלב 1: יצירת פורטל משולב

לפני העברת נכסי הפורטל של Drupal 7, צריך ליצור פורטל משולב.

כדי ליצור פורטל משולב:

  1. מוודאים שיש לכם את תפקיני הפורטל המתאימים לניהול פורטל משולב.
  2. יצירת פורטל משולב.

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

שלב 2: פיתוח הפורטל המשולב

יוצרים את הפורטל המשולב, כפי שמתואר במאמר שלבים ליצירת הפורטל.

לכל הפחות, תצטרכו לבצע את השלבים שמפורטים בטבלה הבאה.

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

אתם יכולים ליצור דפים, ולאחר מכן להעתיק ולהדביק את תוכן הדף ישירות מהפורטל הקיים שלכם ב-Drupal 7.

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

הערה: בשלב הזה, אי אפשר להגדיר התראות באימייל בפורטלים המשולבים של Apigee Hybrid.

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

הערה: בשלב הזה, התכונה הזו לא זמינה בפורטלים המשולבים ההיברידיים של Apigee.

שלב 3: מגדירים את ספק הזהויות

מגדירים את ספק הזהויות בפורטל המשולב בהתאם לסוג האימות, כפי שמתואר בטבלה הבאה.

אימות תיאור
ספק זהויות מובנה (שם משתמש/סיסמה) מגדירים את ספק הזהויות המובנה בפורטל המשולב.
כניסה יחידה (SSO) באמצעות SAML מגדירים את ספק הזהויות ב-SAML (בטא) בפורטל המשולב.

הערות:

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

שלב 4: שליטה בגישה למשאבים באמצעות קהלים

אם אתם משתמשים בתפקידים ב-Drupal 7 כדי לשלוט בגישה לקבוצת משאבים, כמו מסמכי תיעוד של API או יצירת מפתח API למוצר API, אתם יכולים להשיג את אותה פונקציונליות באמצעות קהלים בפורטל המשולב.

באופן ספציפי, אפשר לשלוט בגישה למשאבים הבאים בפורטל המשולב באמצעות קהלים:

  • דפים בפורטל
  • מוצרי API שפורסמו

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

כדי לפשט את ההעברה, כדאי להיעזר בטיפים הבאים:

  • נותנים את השמות לקהלים לפי התפקידים ב-Drupal שהם מחליפים.
  • ניהול החברות בקהל באמצעות צוותי מפתחים. מפתחים יוצרים צוותים כדי לשתף את האחריות על האפליקציות שלהם ולנהל את חברי הצוות.

שלב 5: פרסום ממשקי ה-API

כדי לפרסם ממשקי API וליצור באופן אוטומטי מסמכי עזרה של ממשקי API באמצעות SmartDocs בפורטל המשולב, צריכה להיות לכם גישה למפרט OpenAPI שמשויך ל-API.

יכול להיות שהשתמשתם במפרט OpenAPI כדי ליצור באופן אוטומטי את מסמכי SmartDocs ב-Drupal 7, אבל בסופו של דבר התוכן מאוחסן בפורמט פנימי בלי שיוך למפרט OpenAPI המקורי. צוותי API שמשתמשים ב-Apigee Edge שומרים בדרך כלל את מפרטי OpenAPI בחנות המפרטים של Apigee Edge.

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

  • מציינים את מפרט OpenAPI שישמש כמקור למסמכי התיעוד, מחנות המפרטים, מהספרייה המקומית או מכתובת URL
  • הגדרת הרשאות הגישה למסמכים (גלוי לכולם, משתמשים מאומתים או קהלים נבחרים)
  • הגדרת כתובת URL לקריאה חוזרת (callback), אם יש צורך
  • אם רוצים, מוסיפים תמונה לתצוגה בקטלוג ה-API.

שלב 6: שיתוף האחריות על אפליקציה באמצעות צוותי מפתחים

אם המפתחים שלכם משתמשים באפליקציות של החברה ב-Drupal 7 כדי לחלוק אחריות על אפליקציה, הם יכולים להשיג את אותה הפונקציונליות באמצעות צוותי מפתחים בפורטל המשולב.

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

כדאי להסביר לקהילת המפתחים שלכם על צוותי הפיתוח, ולעודד אותם להעביר את האפליקציות שלהם לשימוש בצוותים של מפתחים כדי לחלוק את האחריות, ולעבור לשימוש במפתחות ה-API החדשים. לאחר מכן, תוכלו להסיר את כל האפליקציות של החברה ואת הארטיפקטים הקשורים באמצעות Edge APIs.

לחלופין, אפשר להעביר אפליקציות של החברה לאפליקציות של צוות הפיתוח, כפי שמתואר במאמר הקהילה הבא: העברת אפליקציות בבעלות החברה לצוותים של מפתחים.

שלב 7: הכנה להשקת הפורטל המשולב

לפני שמפעילים את הפורטל המשולב בסביבת הייצור, מומלץ לבצע את השלבים שמפורטים בטבלה הבאה.

שלב תיאור
התאמה אישית של הדומיין מזינים שם דומיין מותאם אישית משלכם כדי להתאים אישית את האתר.

הערה: בשלב הזה, התכונה הזו לא זמינה בפורטלים המשולבים ההיברידיים של Apigee.

הגדרת מעקב ניתוח נתונים מגדירים מעקב ניתוח נתונים באמצעות Google Analytics או שירות מעקב ניתוח נתונים בהתאמה אישית.
יצירת דף חיפוש בהתאמה אישית יצירת דף חיפוש מותאם אישית והטמעת מנוע חיפוש מותאם אישית של Google.