UKG

מחבר UKG מאפשר לכם לבצע פעולות שונות על נתוני UKG.

לפני שמתחילים

לפני שמשתמשים במחבר UKG, צריך לבצע את המשימות הבאות:

• בפרויקט שלכם ב-Google Cloud:
  • מוודאים שהגדרתם חיבור לרשת. מידע על תבניות רשת זמין במאמר קישוריות לרשת.
  • נותנים למשתמש שמגדיר את המחבר את תפקיד ה-IAM‏ roles/connectors.admin.
  • מקצים לחשבון השירות שרוצים להשתמש בו עבור המחבר את תפקידי ה-IAM הבאים:
    • roles/secretmanager.viewer
    • roles/secretmanager.secretAccessor

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

  • מפעילים את השירותים הבאים:
    • ‫secretmanager.googleapis.com (Secret Manager API)
    • ‫connectors.googleapis.com (Connectors API)

    במאמר הפעלת שירותים מוסבר איך להפעיל שירותים.

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

הגדרת המחבר

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

1. במסוף Cloud, עוברים לדף Integration Connectors > Connections ובוחרים או יוצרים פרויקט בענן.

   כניסה לדף Connections

2. לוחצים על + יצירת חיבור חדש כדי לפתוח את הדף יצירת חיבור.
3. בקטע מיקום, בוחרים את המיקום של החיבור.
   1. אזור: בוחרים מיקום מהרשימה הנפתחת.

      רשימה של כל האזורים הנתמכים מופיעה במאמר מיקומים.

   2. לוחצים על הבא.
4. בקטע פרטי החיבור, ממלאים את הפרטים הבאים:
   1. Connector (מחבר): בוחרים באפשרות UKG מהרשימה הנפתחת של מחברים זמינים.
   2. גרסת כלי החיבור: בוחרים את גרסת כלי החיבור מהרשימה הנפתחת של הגרסאות הזמינות.
   3. בשדה Connection Name (שם החיבור), מזינים שם למופע החיבור.

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

      • שמות החיבורים יכולים לכלול אותיות, מספרים או מקפים.
      • האותיות צריכות להיות קטנות.
      • שמות החיבורים צריכים להתחיל באות ולהסתיים באות או במספר.
      • שמות החיבורים לא יכולים לכלול יותר מ-49 תווים.
   4. אופציונלי: מזינים תיאור למופע החיבור.
   5. אופציונלי: מפעילים את Cloud Logging ואז בוחרים רמת יומן. כברירת מחדל, רמת היומן מוגדרת כ-Error.
   6. חשבון שירות: בוחרים חשבון שירות שיש לו את התפקידים הנדרשים.
   7. Service/Module: בוחרים את המודול של UKG.
   8. אופציונלי: מגדירים את ההגדרות של צומת החיבור:
      • מספר מינימלי של צמתים: מזינים את המספר המינימלי של צמתי חיבור.
      • מספר הצמתים המקסימלי: מזינים את מספר צמתי החיבור המקסימלי.

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

   הערה: אפשר להתאים אישית את הערכים של צומת החיבור רק אם אתם לקוחות עם תשלום לפי שימוש.
   9. אופציונלי: לוחצים על + הוספת תווית כדי להוסיף תווית לקישור בצורה של צמד מפתח/ערך.
   10. לוחצים על הבא.
5. בקטע יעדים, מזינים את הפרטים של המארח המרוחק (מערכת העורף) שאליו רוצים להתחבר.
   1. סוג היעד: בוחרים סוג יעד.
      • כדי לציין את שם המארח או את כתובת ה-IP של היעד, בוחרים באפשרות כתובת המארח ומזינים את הכתובת בשדה מארח 1.
      • כדי ליצור חיבור פרטי, בוחרים באפשרות Endpoint attachment (צירוף נקודת קצה). ברשימה Endpoint Attachment, בוחרים את קובץ ה-Endpoint Attachment שנוצר עבור מערכת ה-Backend.
      הערה: מידע על יצירת צירוף של נקודת קצה זמין במאמר קישוריות לרשת פרטית. אחרי שיוצרים את ההצמדה של נקודת הקצה, היא מופיעה ברשימה Endpoint Attachment.

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

      כדי להזין יעדים נוספים, לוחצים על +הוספת יעד.

   2. לוחצים על הבא.
6. בקטע אימות, מזינים את פרטי האימות.
   1. בוחרים סוג אימות ומזינים את הפרטים הרלוונטיים.

      החיבור ל-UKG תומך בסוגי האימות הבאים:

      • אימות בסיסי
      • ‫OAUTH 2.0 – קוד הרשאה

      כדי להבין איך להגדיר את סוגי האימות האלה, אפשר לעיין במאמר בנושא הגדרת אימות.

      • לוחצים על הבא.
7. בדיקה: בודקים את פרטי החיבור והאימות.
8. לוחצים על יצירה.

הגדרת אימות

מזינים את הפרטים בהתאם לאימות שבו רוצים להשתמש.

• Basic Authentication
  • שם משתמש: שם המשתמש שמשמש לאימות המחבר.
  • סיסמה: סוד ב-Secret Manager שמכיל את הסיסמה שמשויכת למחבר.
OAUTH 2.0 - קוד הרשאה
• Client ID: מזהה הלקוח שמשמש לבקשת אסימוני גישה.
• ‫Scopes:רשימה מופרדת בפסיקים של ההיקפים הרצויים.
• סוד לקוח: סוד ב-Secret Manager שמכיל את סוד הלקוח של האפליקציה המקושרת שיצרתם.
• הפעלת PKCE: בוחרים באפשרות הזו אם רוצים להפעיל את התכונה Proof Key of Code Exchange (PKCE).
• כתובת URL לאישור: כתובת ה-URL לאישור של האפליקציה. תופנו לדף הזה כדי להתחבר לאפליקציה.
• כתובת אתר של טוקן גישה: כתובת ה-URL שתשמש להחלפת טוקן גישה. צריך לציין כתובת URL מלאה, כולל הסכימה.

דוגמאות להגדרת חיבור

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

OAUTH 2.0 – סוג החיבור של קוד ההרשאה

שם השדה	פרטים
מיקום	us-central1
מחבר	UKG
גרסת המחבר	1
שם החיבור	gcp-ukg-oauth-conn
הפעלת Cloud Logging	כן
רמת הרישום ביומן	שגיאה
חשבון השירות	[e-mail]
מודול Open API spec	ניהול זמן
רמת הפירוט	5
מספר הצמתים המינימלי	2
מספר הצמתים המקסימלי	50
סוג היעד	כתובת המארח
כתובת המארח	https://google-connect-dev.cfn.mykronos.com
מזהה לקוח	ZG******-****-****-****-*********uDN
סוד לקוח	סוד
Secret Version	1
כתובת אתר להרשאה	https://google-connect-dev.cfn.mykronos.com/oauth2/authorize
כתובת אתר של טוקן גישה	https://google-connect-dev.cfn.mykronos.com/api/authentication/access_token

הערה: אפשר להעביר את כתובת ה-URL הבאה בתור שם המארח, שהוא כתובת המארח שמוגדרת כברירת מחדל: https://login.UKG.com. אם הארגון שלכם משתמש בנקודת קצה מותאמת אישית לכניסה, אתם צריכים להשתמש בכתובת מארח אחרת.

מגבלות המערכת

המחבר של UKG יכול לעבד 30 טרנזקציות בשנייה, לכל צומת, ומגביל טרנזקציות שחורגות מהמגבלה הזו. כברירת מחדל, Integration Connectors מקצה 2 צמתים (לזמינות טובה יותר) לחיבור.

מידע על המגבלות שחלות על Integration Connectors זמין במאמר מגבלות.

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

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

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

פעולות

המחבר הזה מאפשר לכם לבצע פעולות שונות בנתוני UKG.

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

הפעולה RetrieveAllEmployeeGroupsOrByName

מאחזר את כל קבוצות העובדים לפי שם.

פרמטרים של קלט לפעולה RetrieveAllEmployeeGroupsOrByName

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

דוגמה להגדרת הפעולה RetrieveAllEmployeeGroupsOrByName מופיעה במאמר דוגמאות.

יצירת פעולה של קוד תשלום

יוצרת קוד תשלום.

פרמטרים של קלט לפעולה Create PayCode

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

דוגמה להגדרת הפעולה CreatePayCode מופיעה במאמר דוגמאות.

פעולת DeletePayCodebyId

מחיקת קוד תשלום לפי המזהה.

פרמטרים של קלט לפעולה DeletePayCodebyId

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

דוגמה להגדרת הפעולה DeletePayCodebyId מופיעה במאמר דוגמאות.

פעולה לעדכון כלל עבודה לפי מזהה

עדכון כלל עבודה באמצעות מזהה.

פרמטרים של קלט לפעולה Update Work Rule by ID (עדכון כלל עבודה לפי מזהה)

שם הפרמטר	סוג הנתונים	חובה	תיאור
workRuleId	מספר שלם	נכון	מזהה כלל העבודה
workRuleVersion	json	נכון	הגרסה של כלל העבודה שמשויכת לכלל עבודה.
name	מחרוזת	נכון	השם של כלל עבודה.
גרסה	מספר שלם	נכון	גרסת כלל העבודה.

דוגמה להגדרת הפעולה Update Work Rule by ID מופיעה במאמר דוגמאות.

דוגמאות לפעולות

דוגמה – RetrieveAllEmployeeGroupsOrByName

בדוגמה הזו מאחזרים קבוצות של עובדים.

1. בתיבת הדו-שיח Configure connector task, לוחצים על actions.
2. בוחרים את הפעולה RetrieveAllEmployeeGroupsOrByName ולוחצים על סיום.
3. בקטע מיפוי נתונים Open Data Mapping Editor ואז מזינים ערך דומה לערך הבא בשדה Input:

    {
     "Query parameters": {
       "all_details": true
     }
   } 
    If the action is successful, the
     RetrieveAllEmployeeGroupsOrByName task's connectorOutputPayload response
     parameter will have a value similar to the following:
     
    
     [{
       "ResponseBody": "[{\"name\":\"$U-South Region\",\"id\":1401,\"orgMapGroupRef\":{\"id\":2452,\"qualifier\":\"$U-South Region\"},\"version\":0,\"updateDtm\":\"2020-03-04T16:06:46\",\"persistentId\":\"$U-South#Region\"},{\"name\":\"$U-Canada Region\",\"id\":1451,\"orgMapGroupRef\":{\"id\":2453,\"qualifier\":\"$U-Canada Region\"},\"version\":0,\"updateDtm\":\"2020-03-04T16:07:21\",\"persistentId\":\"}]
     
     

דוגמה – יצירת קוד תשלום

בדוגמה הזו נוצר קוד תשלום.

1. בתיבת הדו-שיח Configure connector task, לוחצים על actions.
2. בוחרים את הפעולה Create PayCode ולוחצים על סיום.
3. בקטע מיפוי נתונים, לוחצים על Open Data Mapping Editor ואז מזינים ערך דומה לערך הבא בשדה Input:

     {
       "RequestBody": {
         "type": "Regular",
         "unit": "HOUR",
         "visibleToTimecardSchedule": true,
         "name": "2nd Meal Premium qaazxse",
         "shortName": "2MP",
         "combined": false,
         "money": false,
         "totals": true,
         "excusedAbsence": false,
         "wageMultiplier": 1.0,
         "wageAddition": 0.0,
         "addToTimecardTotal": true,
         "visibleToUser": true,
         "visibleToReports": true,
         "checkAvailability": 0.0,
         "codeNumber": 7663.0,
         "cascadingDuration": false,
         "processDurationAsSeparateShift": false,
         "editCountsTowardsOvertimeLimits": false,
         "editCountsTowardsConsecutiveDayOT": false,
         "repeating": false,
         "payrollOnly": false,
         "timekeepingOnly": false,
         "netDown": false
       },
       "Headers": {
         "Content-Type": "application/json"
       }
     }
     
     
     

אם הפעולה מצליחה, לפרמטר התגובה CreatePayCode של המשימה connectorOutputPayload יהיה ערך שדומה לזה:

 
  [{
    "type": "Regular",
    "unit": "HOUR",
    "visibleToTimecardSchedule": true,
    "id": 5904.0,
    "name": "2nd Meal Premium qaazxse",
    "shortName": "2MP",
    "combined": false,
    "money": false,
    "totals": true,
    "excusedAbsence": false,
    "wageMultiplier": 1.0,
    "wageAddition": 0.0,
    "addToTimecardTotal": true,
    "visibleToUser": true,
    "visibleToReports": true,
    "checkAvailability": 0.0,
    "codeNumber": 7663.0,
    "cascadingDuration": false,
    "processDurationAsSeparateShift": false,
    "editCountsTowardsOvertimeLimits": false,
    "editCountsTowardsConsecutiveDayOT": false,
    "repeating": false,
    "payrollOnly": false,
    "timekeepingOnly": false,
    "netDown": false
  }]

דוגמה – DeletePayCodebyId

בדוגמה הזו נמחק קוד תשלום על סמך המזהה.

1. בתיבת הדו-שיח Configure connector task, לוחצים על actions.
2. בוחרים את הפעולה DeletePayCodebyId ולוחצים על סיום.
3. בקטע מיפוי נתונים Open Data Mapping Editor ואז מזינים ערך דומה לערך הבא בשדה Input:

     {
     "Path parameters": {
       "id": 6002.0
     }
   } 

אם הפעולה מצליחה, לפרמטר התגובה DeletePayCodebyId של המשימה connectorOutputPayload יהיה ערך שדומה לזה:

 
 [{
  "ResponseBody": "",
  "StatusCode": 200.0
}] 

דוגמה – עדכון של כלל עבודה לפי מזהה

בדוגמה הזו מתבצע עדכון של כלל העבודה.

1. בתיבת הדו-שיח Configure connector task, לוחצים על actions.
2. בוחרים את הפעולה Update Work Rule by ID ולוחצים על סיום.
3. בקטע מיפוי נתונים Open Data Mapping Editor ואז מזינים ערך דומה לערך הבא בשדה Input:

    {
     "Path parameters": {
       "id": 3701.0
     },
     "Headers": {
       "Content-Type": "application/json"
     },
     "RequestBody": {
       "version": 1.0,
       "workRuleId": 3701.0,
       "name": "$AU Call Back Sasori",
       "workRuleVersion": [{
         "effectiveWorkRuleId": 3801.0,
         "effectiveDateTime": "1853-01-01T00:00:00",
         "updateThisVersion": true,
         "expirationDateTime": "4000-01-01T00:00:00",
         "general": {
           "breaks": [],
           "coreHours": [],
           "includeMinimumWagesAdjustment": false,
           "deductions": [{
             "id": 651.0,
             "qualifier": "$AU Oncall Allowance",
             "name": "$AU Oncall Allowance"
           }]
         },
         "workRulePayCodeDistribution": {
           "payCodeDistributionName": "$AU Oncall",
           "deviations": [],
           "overtimes": [],
           "zones": [],
           "majorities": []
         },
         "workRuleAutoBreakPlacement": {
           "minimumTimeBetweenStartOfShiftAndFirstBreak": "0:0",
           "minimumTimeBetweenEndOfBreakAndShiftEnd": "0:0",
           "minimumTimeBetweenBreaks": "0:0",
           "shiftLengthsToExclude": [],
           "newShiftLengths": []
         },
         "version": 1.0
       }],
       "ivrAlias": "1234567890"
     }
   }

אם הפעולה מצליחה, לפרמטר התגובה Update Work Rule by ID של המשימה connectorOutputPayload יהיה ערך שדומה לזה:

 
 [{
  "workRuleId": 3701.0,
  "name": "$AU Call Back Sasori",
  "ivrAlias": "1234567890",
  "workRuleVersion": [{
    "effectiveWorkRuleId": 3801.0,
    "effectiveDateTime": "1753-01-01T00:00:00",
    "updateThisVersion": false,
    "expirationDateTime": "3000-01-01T00:00:00",
    "general": {
      "breaks": [],
      "coreHours": [],
      "includeMinimumWagesAdjustment": false,
      "deductions": [{
        "id": 651.0,
        "qualifier": "$AU Oncall Allowance",
        "name": "$AU Oncall Allowance"
      }]
    },
    "workRulePayCodeDistribution": {
      "payCodeDistributionName": "$AU Oncall",
      "deviations": [],
      "overtimes": [],
      "zones": [],
      "majorities": []
    },
    "workRuleAutoBreakPlacement": {
      "minimumTimeBetweenStartOfShiftAndFirstBreak": "0:0",
      "minimumTimeBetweenEndOfBreakAndShiftEnd": "0:0",
      "minimumTimeBetweenBreaks": "0:0",
      "shiftLengthsToExclude": [],
      "newShiftLengths": []
    },
    "version": 3.0
  }],
  "version": 3.0
}]

דוגמה – מחיקת כלל קבוע לפי מזהה

בדוגמה הזו נמחק כלל קבוע ספציפי.

1. בתיבת הדו-שיח Configure connector task, לוחצים על actions.
2. בוחרים את הפעולה Delete Fixed Rule by ID ולוחצים על סיום.
3. בקטע מיפוי נתונים Open Data Mapping Editor ואז מזינים ערך דומה לערך הבא בשדה Input:

    {
     "Path parameters": {
       "id": 1152.0
     }
   } 

אם הפעולה מצליחה, לפרמטר התגובה connectorOutputPayload של המשימה Delete Fixed Rule by ID יהיה ערך שדומה לזה:

 
 [{
  "ResponseBody": "",
  "StatusCode": 204.0
}] 

דוגמה – אחזור של קודי צבירה

בדוגמה הזו מאחזרים קודי צבירה.

1. בתיבת הדו-שיח Configure connector task, לוחצים על actions.
2. בוחרים את הפעולה Retrieve Accrual Codes ולוחצים על סיום.
3. בקטע מיפוי נתונים Open Data Mapping Editor ואז מזינים ערך דומה לערך הבא בשדה Input:

    {
     "Query parameters": {
       "id": 1303.0
     }
   } 

אם הפעולה מצליחה, לפרמטר התגובה Retrieve Accrual Codes של המשימה connectorOutputPayload יהיה ערך שדומה לזה:

 
 [{
  "ResponseBody": "[{\"id\":1303,\"typeId\":2,\"hoursPerDayInSeconds\":28800,\"name\":\"$LC Dia Familia\",\"shortName\":\"$LC Dia Familia\",\"typeName\":\"Day\",\"allowEdit\":true}]",
  "StatusCode": 200.0
}]

דוגמה – יצירת שעות פעילות

בדוגמה הזו נוצרות שעות פעילות.

1. בתיבת הדו-שיח Configure connector task, לוחצים על actions.
2. בוחרים את הפעולה Create Hours of Operation ולוחצים על סיום.
3. בקטע מיפוי נתונים Open Data Mapping Editor ואז מזינים ערך דומה לערך הבא בשדה Input:

    {
     "Headers": {
       "Content-Type": "application/json"
     },
     "RequestBody": {
       "name": "$E-HoO Store 501 dummy3",
       "active": true,
       "effectiveVersions": [{
         "effectiveSpan": {
           "startDate": "1900-01-01",
           "endDate": "3000-01-01"
         },
         "unrestrictedEdit": true,
         "items": [{
           "openTime": "09:00:00",
           "closeTime": "21:00:00",
           "closed": false,
           "holiday": false,
           "weekDay": {
             "id": -1.0,
             "qualifier": "EVERY_DAY"
           }
         }, {
           "openTime": "10:00:00",
           "closeTime": "17:00:00",
           "closed": false,
           "holiday": false,
           "weekDay": {
             "id": 1.0,
             "qualifier": "SUNDAY"
           }
         }, {
           "openTime": "10:00:00",
           "closeTime": "18:00:00",
           "closed": false,
           "holiday": false,
           "weekDay": {
             "id": 7.0,
             "qualifier": "SATURDAY"
           }
         }]
       }]
     }
   }

אם הפעולה מצליחה, לפרמטר התגובה Create Hours of Operation של המשימה connectorOutputPayload יהיה ערך שדומה לזה:

 
[{
  "id": 851.0,
  "name": "$E-HoO Store 501 dummy3",
  "active": true,
  "version": 1.0,
  "effectiveVersions": [{
    "effectiveSpan": {
      "startDate": "1900-01-01",
      "endDate": "3000-01-01"
    },
    "unrestrictedEdit": true,
    "items": [{
      "id": 1051.0,
      "openTime": "09:00:00",
      "closeTime": "21:00:00",
      "closed": false,
      "holiday": false,
      "weekDay": {
        "id": -1.0,
        "qualifier": "EVERY_DAY"
      }
    }, {
      "id": 1052.0,
      "openTime": "10:00:00",
      "closeTime": "17:00:00",
      "closed": false,
      "holiday": false,
      "weekDay": {
        "id": 1.0,
        "qualifier": "SUNDAY"
      }
    }, {
      "id": 1053.0,
      "openTime": "10:00:00",
      "closeTime": "18:00:00",
      "closed": false,
      "holiday": false,
      "weekDay": {
        "id": 7.0,
        "qualifier": "SATURDAY"
      }
    }]
  }]
}]

דוגמה – עדכון הגדרת כרטיס נוכחות לפי מזהה

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

1. בתיבת הדו-שיח Configure connector task, לוחצים על actions.
2. בוחרים את הפעולה Update Timecard Setting by ID ולוחצים על סיום.
3. בקטע מיפוי נתונים Open Data Mapping Editor ואז מזינים ערך דומה לערך הבא בשדה Input:

    {
     "Path parameters": {
       "id": 3872335.0
     },
     "RequestBody": {
       "id": 3872335.0,
       "name": "Hourly Timecard -Employee Sharp",
       "label": "Hourly Timecard - Employee View",
       "description": "Hourly Timecard - Employee View",
       "timecardType": {
         "id": "HourlyEmployee",
         "name": "Hourly Employee"
       },
       "canEditFutureTimecard": false,
       "numberOfFutureDays": 0.0,
       "includeOvertimes": true,
       "fourPunchRow": false,
       "columnsOrder": [{
         "id": "Date",
         "name": "Date"
       }, {
         "id": "Schedule",
         "name": "Schedule"
       }, {
         "id": "Absence",
         "name": "Absence"
       }, {
         "id": "In",
         "name": "In"
       }, {
         "id": "Transfer",
         "name": "Transfer"
       }, {
         "id": "Out",
         "name": "Out"
       }, {
         "id": "PayCode",
         "name": "Pay Code"
       }, {
         "id": "Amount",
         "name": "Amount"
       }, {
         "id": "Shift",
         "name": "Shift"
       }, {
         "id": "Daily",
         "name": "Daily"
       }, {
         "id": "Period",
         "name": "Period"
       }],
       "includeActivityEvent": false,
       "includeActivityAllocation": false,
       "includeActivityTotalActual": false,
       "includeActivityTotalAllocated": false,
       "includeActivityTotalVariance": false,
       "hidePaidCorrection": false}

אם הפעולה מצליחה, לפרמטר התגובה Update Timecard Setting by ID של המשימה connectorOutputPayload יהיה ערך שדומה לזה:

 
  [{
  "id": 3872335.0,
  "name": "Hourly Timecard -Employee Sharp",
  "label": "Hourly Timecard - Employee View",
  "description": "Hourly Timecard - Employee View",
  "timecardType": {
    "id": "HourlyEmployee",
    "name": "Hourly Employee"
  },
  "canEditFutureTimecard": false,
  "numberOfFutureDays": 0.0,
  "includeOvertimes": true,
  "fourPunchRow": false,
  "columnsOrder": [{
    "id": "Date",
    "name": "Date"
  }, {
    "id": "Schedule",
    "name": "Schedule"
  }, {
    "id": "Absence",
    "name": "Absence"
  }, {
    "id": "In",
    "name": "In"
  }, {
    "id": "Transfer",
    "name": "Transfer"
  }, {
    "id": "Out",
    "name": "Out"
  }, {
    "id": "PayCode",
    "name": "Pay Code"
  }, {
    "id": "Amount",
    "name": "Amount"
  }, {
    "id": "Shift",
    "name": "Shift"
  }, {
    "id": "Daily",
    "name": "Daily"
  }, {
    "id": "Period",
    "name": "Period"
  }],
  "includeActivityEvent": false,
  "includeActivityAllocation": false,
  "includeActivityTotalActual": false,
  "includeActivityTotalAllocated": false,
  "includeActivityTotalVariance": false,
  "hidePaidCorrection": false,
  "paidCorrectionFilterEnabled": true}] 

דוגמה – אחזור פרופילים של אנשים

בדוגמה הזו מאחזרים פרופילים של אנשים.

1. בתיבת הדו-שיח Configure connector task, לוחצים על actions.
2. בוחרים את הפעולה Retrieve People Information Profiles ולוחצים על סיום.
3. בקטע מיפוי נתונים Open Data Mapping Editor ואז מזינים ערך דומה לערך הבא בשדה Input:

     {
     "Headers": {
       "Content-Type": "application/json"
     },
     "RequestBody": {
       "where": {
         "ids": [-1.0, 651.0]
       }
     }
   }

אם הפעולה מצליחה, לפרמטר התגובה Retrieve People Information Profiles של המשימה connectorOutputPayload יהיה ערך שדומה לזה:

 
   [{
  "ResponseBody": "[{\"id\":-1,\"description\":\"Default People Information Profile with Default People Information Settings\",\"name\":\"Default People Information Profile\",\"peopleInfoSetting\":{\"id\":-1,\"description\":\"Default People Information Profile with All Hyperfind Query\",\"hfquery\":{\"id\":1,\"hfName\":\"&Person.All_Home\",\"name\":\"All Home\"},\"name\":\"Default People Information Profile\"}},{\"id\":651,\"description\":\"All Home Employees\",\"name\":\"$R-All Home\",\"peopleInfoSetting\":{\"id\":649,\"description\":\"All Home Employees\",\"hfquery\":{\"id\":1,\"hfName\":\"&Person.All_Home\",\"name\":\"All Home\"},\"name\":\"$R-All Home\"}}]",
  "StatusCode": 200.0
}]

דוגמה – אחזור של כל תנאי ההעסקה

בדוגמה הזו מאחזרים את כל תנאי ההעסקה.

1. בתיבת הדו-שיח Configure connector task, לוחצים על actions.
2. בוחרים את הפעולה Retrieve All Employment Terms ולוחצים על סיום.
3. בקטע מיפוי נתונים Open Data Mapping Editor ואז מזינים ערך דומה לערך הבא בשדה Input:

      {
     "Query parameters": {
       "id": 2202.0
     }
   } 

אם הפעולה מצליחה, לפרמטר התגובה Retrieve All Employment Terms של המשימה connectorOutputPayload יהיה ערך שדומה לזה:

 
  [{
  "ResponseBody": "[{\"allowsInheritance\":false,\"isActive\":true,\"name\":\"$AU-Casual\",\"id\":2202,\"processType\":\"ENFORCE_END_DATE\",\"versions\":{\"employmentTermVersion\":[{\"id\":702,\"accrualProfile\":{\"id\":1402,\"qualifier\":\"$AU-Casual\",\"name\":\"$AU-Casual\"},\"endDate\":\"3000-01-01\",\"holidayProfile\":{\"id\":152,\"qualifier\":\"AU Casual Holiday Profile\",\"name\":\"AU Casual Holiday Profile\"},\"startDate\":\"1900-01-01\",\"minimumWage\":{}}]},\"persistentId\":\"$AU-Casual\"}]",
  "StatusCode": 200.0
}]

דוגמה – יצירת פרופילים של אימות (attestation)

בדוגמה הזו נוצרים פרופילי האימות.

1. בתיבת הדו-שיח Configure connector task, לוחצים על actions.
2. בוחרים את הפעולה Create Attestation Profiles ולוחצים על סיום.
3. בקטע מיפוי נתונים Open Data Mapping Editor ואז מזינים ערך דומה לערך הבא בשדה Input:

    {
     "Headers": {
       "Content-Type": "application/json"
     },
     "RequestBody": {
       "versionCount": 0.0,
       "name": "Empty Profile 3",
       "deleted": false,
       "attestationAssignments": []
     }
   }

אם הפעולה מצליחה, לפרמטר התגובה Create Attestation Profiles של המשימה connectorOutputPayload יהיה ערך שדומה לזה:

 
[{
  "id": 434.0,
  "versionCount": 0.0,
  "name": "Empty Profile 3",
  "deleted": false
}]

דוגמה – אחזור פרופיל חופשה לפי מזהה

בדוגמה הזו מאחזרים פרופיל חופשה על סמך המזהה.

1. בתיבת הדו-שיח Configure connector task, לוחצים על actions.
2. בוחרים את הפעולה Retrieve Leave Profile by Id ולוחצים על סיום.
3. בקטע מיפוי נתונים Open Data Mapping Editor ואז מזינים ערך דומה לערך הבא בשדה Input:

    {
     "Path parameters": {
       "id": 3.0
     }
   } 

אם הפעולה מצליחה, לפרמטר התגובה Retrieve Leave Profile by Id של המשימה connectorOutputPayload יהיה ערך שדומה לזה:

 
 [{
  "id": 3.0,
  "isActive": true,
  "leaveProfileCategory": [{
    "id": 1.0,
    "qualifier": "Military",
    "leaveProfileCategoryConfigurableData": [{
      "configurableData": {
        "id": 1.0,
        "qualifier": "Active Duty Period"
      }
    }],
    "leaveProfileCategoryRule": [],
    "leaveProfileCategoryType": [{
      "leaveType": [{
        "id": 21.0,
        "qualifier": "Military Duty Leave Tracking"
      }]
    }, {
      "leaveType": [{
        "id": 53.0,
        "qualifier": "Personal Leave"
      }]
    }, {
      "leaveType": [{
        "id": 59.0,
        "qualifier": "Vacation Leave"
      }]
    }]
  }, {
    "id": 2.0,
    "qualifier": "Self",
    "leaveProfileCategoryConfigurableData": [{
      "configurableData": {
        "id": 2.0,
        "qualifier": "Amount Paid"
      }
    }, {
      "configurableData": {
        "id": 4.0,
        "qualifier": "Disability Case Number"
      }
}]

דוגמה – אחזור של כללים זמינים

בדוגמה הזו מאחזרים את הכללים הזמינים.

1. בתיבת הדו-שיח Configure connector task, לוחצים על actions.
2. בוחרים את הפעולה Retrieve Available Rules ולוחצים על סיום.
3. בקטע מיפוי נתונים Open Data Mapping Editor ואז מזינים ערך דומה לערך הבא בשדה Input:

    {
     "Query parameters": {
       "leave_case_id": 189.0
     }
   } 

אם הפעולה מצליחה, לפרמטר התגובה Retrieve Available Rules של המשימה connectorOutputPayload יהיה ערך שדומה לזה:

 
 [{
  "leaveCase": {
    "id": 189.0,
    "qualifier": "Physical Therapy",
    "name": "Physical Therapy"
  },
  "availableLeaveRules": [{
    "id": 20.0,
    "availableLeaveTypes": [{
      "id": 1.0,
      "paid": false,
      "enabled": true,
      "payCode": {
        "id": 107.0,
        "qualifier": "LV-ADAA Leave",
        "name": "LV-ADAA Leave"
      },
      "accrualCode": {
        "id": 2.0,
        "qualifier": "LV-ADA Leave",
        "name": "LV-ADA Leave"
      },
      "qualifier": "ADA Leave",
      "name": "ADA Leave"
    }, {
      "id": 11.0,
      "paid": false,
      "enabled": true,
      "presentedInLeaveRule": true,
      "payCode": {
        "id": 134.0,
        "qualifier": "LV-FMLA Injury Illness",
        "name": "LV-FMLA Injury Illness"
      },
      "accrualCode": {
        "id": 12.0,
        "qualifier": "LV-FMLA",
        "name": "LV-FMLA"
      },
      "qualifier": "FMLA Illness Injury",
      "name": "FMLA Illness Injury"
    }, {
      "id": 31.0,
      "paid": false,
      "enabled": true,
      "presentedInLeaveRule": true,
      "payCode": {
        "id": 165.0,
        "qualifier": "LV-Non FMLA Tracking",
        "name": "LV-Non FMLA Tracking"
      },
      "accrualCode": {
        "id": 24.0,
        "qualifier": "LV-Tracking",
        "name": "LV-Tracking"
      },
      "qualifier": "Non-FMLA Illness Injury",
      "name": "Non-FMLA Illness Injury"
    }
}]

יצירת חיבורים באמצעות Terraform

אפשר להשתמש במשאב של Terraform כדי ליצור חיבור חדש.

כדי ללמוד איך להחיל הגדרות ב-Terraform או להסיר אותן, ראו פקודות בסיסיות ב-Terraform.

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

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

שם הפרמטר	סוג נתונים	חובה	תיאור
proxy_enabled	בוליאני	לא נכון	מסמנים את תיבת הסימון הזו כדי להגדיר שרת Proxy לחיבור.
proxy_auth_scheme	ENUM	לא נכון	סוג האימות שבו יש להשתמש כדי לבצע אימות לשרת ה-proxy‏ ProxyServer. הערכים הנתמכים הם: BASIC, ‏ DIGEST, ‏ NONE
proxy_user	מחרוזת	לא נכון	שם משתמש שישמש לאימות בשרת ה-proxy ‏ProxyServer.
proxy_password	SECRET	לא נכון	סיסמה שתשמש לאימות בשרת ה-proxy‏ ProxyServer.

שימוש בחיבור UKG בשילוב

אחרי שיוצרים את החיבור, הוא זמין גם ב-Apigee Integration וגם ב-Application Integration. אפשר להשתמש בחיבור בשילוב באמצעות המשימה Connectors.

• כדי להבין איך ליצור ולהשתמש במשימה Connectors ב-Apigee Integration, אפשר לעיין במאמר משימת Connectors.
• מידע על יצירה ושימוש במשימת מחברים ב-Application Integration זמין במאמר משימת מחברים.

קבלת עזרה מקהילת Google Cloud

אתם יכולים לפרסם את השאלות שלכם ולדון במחבר הזה בקהילת Google Cloud בפורומים של Cloud.

המאמרים הבאים

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