עדכון רשומה

ניתן לעדכן רשומה דרך ממשק ה API של מערכת Powerlink.

 

להגדרות שימוש ב HTTP REST API לחצו כאן

 

עדכון רשומה מתבצע עם פעולת Update.

 

Action: Update

Method: PUT

URLhttps://api.powerlink.co.il/api/record/{record}/{id}

 

מבנה גוף השאילתה:

{
“accountname” : “Arik”,
“telephone1” : “0528896656”,
“emailaddress1” : “support@powerlink.co.il”,
“originatingleadcode” : “3”
}

 

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

{
  "success": true,
  "data": "bfd35ff8-900e-407b-a935-8dd29522ecad",
  "message": ""
}


 

את ה {record} נחליף בשם המערכת של האוביקט בו נרצה ליצור רשומה חדשה.


את ה {id} נחליף ב id של הרשומה אותה נרצה לעדכן, נוכל לקבל את ה id על ידי שאילתא ( פעולת QUERY ).

דרך נוספת לאתר את מספר האובייקט היא דרך כתובת ה URL, בכניסה לכל אובייקט במערכת אחרי המילה oid. לדוגמא:

https://app.powerlink.co.il/_common/viewrecord.aspx?oid=1

 

 

דוגמה ל- id תקין: e0dd456d-3577-489b-9af8-02c70ba1c8f4


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

 

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

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

 

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

 

הערה חשובה:

במידה ומדובר בעדכון רשומה בשדה שערכו מכיל גרשיים ("), יש להוסיף מלפני ואחרי הערך '_' במקום "_".

לדוגמא- עדכון השדה Accountname בערך חברה בע"מ:

{

"Accountname" : 'חברה בע"מ'

}

 


לפני ההרצה חשוב לוודא שהמתודה שבחרנו הינה PUT.