העלאה והורדה של אינטגרציות

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

היתרונות של שילוב מלא בפורמט קובץ:
  • אתם יכולים להעתיק את השילוב מפרויקט אחד לפרויקט אחר בלי להתאמץ יותר מדי.
  • אפשר לעדכן את קובץ השילוב באופן אוטומטי לשינויים חוזרים, כמו שינוי שם של משימות או שינוי דינמי של שמות משתנים.

הורדת שילוב

כדי להוריד שילוב, בוחרים באחת מהאפשרויות הבאות:

המסוף

  1. במסוף Google Cloud, עוברים לדף Application Integration.

    מעבר אל Application Integration

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

    קובץ INTEGRATION_NAME.json נשמר אוטומטית בתיקיית ההורדות שמוגדרת כברירת מחדל בדפדפן האינטרנט.

API

כדי להוריד שילוב, שולחים בקשת GET אל ה-API הבא: GET https://integrations.googleapis.com/v1/projects/*/locations/*/integrations/*/versions/*:download 
https://integrations.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/integrations/INTEGRATION_NAME/versions/INTEGRATION_VERSION:download

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

curl -v -s \
-H "Content-Type: application/json" -H "Authorization: Bearer $TOKEN" \
-H "X-GFE-SSL: yes" \
-X GET "https://integrations.googleapis.com/v1/projects/demo-project/locations/us-east1/integrations/test-integration/versions/0e90d453-5fcf-4aae-b164-2e8344d1ac11:download"

מידע נוסף זמין במאמר projects.locations.integrations.versions.download.

העלאת שילוב

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

אם אין לכם שילוב קיים שאליו אתם יכולים להעלות קובץ, אתם צריכים קודם ליצור שילוב חדש ואז להעלות את הקובץ. במקרה כזה, השילוב החדש שתיצרו יהיה בגרסה 1 והשילוב שהעליתם יהיה בגרסה 2.

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

המסוף

  1. במסוף Google Cloud, עוברים לדף Application Integration.

    מעבר אל Application Integration

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

    אם יוצרים שילוב חדש:

    1. מזינים שם ותיאור בתיבת הדו-שיח יצירת שילוב.
    2. בוחרים אזור לשילוב.
    3. לוחצים על יצירה.

    השילוב ייפתח בכלי לעריכת שילובים.

  4. בסרגל הכלים של כלי העיצוב, לוחצים על (תפריט פעולות) ובוחרים באפשרות העלאה.
  5. בתיבת הדו-שיח של סייר הקבצים, בוחרים את הקובץ שרוצים להעלות ולוחצים על פתיחה.

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

API

כדי להעלות שילוב, שולחים בקשת POST אל ה-API הבא: 
  https://integrations.googleapis.com/v1/projects/$YOUR_GOOGLE_PROJECT_ID/locations/$PROJECT_LOCATION/integrations $INTEGRATION_NAME/versions/$INTEGRATION_VERSION}:upload

בדוגמה הבאה אפשר לראות איך מעלים שילוב:

  curl -v -s -H "Content-Type: application/json"  -H "Authorization: Bearer $TOKEN"  \
  -X POST -d '{"content": 
    "{\"name\":\"projects/450954726404/locations/us-east1/integrations/test-workflow/versions/0e90d453-5fcf-4aae-b164-2e8344d1ac11\",
    \"origin\":\"UI\",
    \"snapshotNumber\":\"3\",
    \"updateTime\":\"2022-01-06T04:26:58.137Z\",
    \"lockHolder\":\"abc@test.com\",
    \"createTime\":\"2022-01-06T04:26:42.734Z\",
    \"lastModifierEmail\":\"abc@test.com\",
    \"state\":\"DRAFT\",
    \"triggerConfigs\":[{\"label\":\"API Trigger\",\"startTasks\":[{\"taskId\":\"1\"}],
    \"properties\":{\"Trigger name\":\"rj-test-workflow_API_1\"},\"triggerType\":\"API\",\"triggerNumber\":\"1\",\"triggerId\":\"api_trigger/rj-test-workflow_API_1\"}],\"taskConfigs\":[{\"task\":\"EmailTask\",\"taskId\":\"1\",\"taskExecutionStrategy\":\"WHEN_ALL_SUCCEED\",\"displayName\":\"Send Email\"}]}"}' 
    \https://integrations.googleapis.com/v1/projects/demo-project/locations/us-east1/integrations/test-integration/versions:upload

מידע נוסף זמין במאמר projects.locations.integrations.versions.upload.

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