آموزش SAP SuccessFactors Odata و SFAPI API: راهنمای جامع کار با آن‌ها - آخرین آپدیت

سرفصل ها و درس ها

مقدمه Introduction

• مقدمه‌ای بر دوره Introductory to the Course

SFAPI: موفقیت عامل OData URI و SFAPI URI و wsdl SFAPI : Successfactors OData URI and SFAPI URI and wsdl

• URL مرکز داده چیست؟ What is the Data Center URL

SFAPI: URL مرکز داده برای فراخوانی‌های SFAPI رمزگشایی شده است SFAPI : Data Center URL decoded for SFAPI calls

• اهمیت URL مرکز داده Data Center URL significance

• جمع‌آوری URL مرکز داده Gathering Data Center URL

• ادامه جمع‌آوری URL مرکز داده Gathering Data Center URL continuation

• جمع‌آوری URL مرکز داده – افزونه بامزه کوچک Gathering Data Center URL - Cute lil extension

• گام‌های بعدی، URL SFAPI و موارد دیگر Further Steps , SFAPI URL and others

• فرمولاسیون URL SFAPI Formulation of SFAPI URL

• SFAPI wsdl SFAPI wsdl

API OData: مقدمه و URL مرکز داده رمزگشایی شده OData API: Introduction and Data Center URL decoded

• URI OData: مقدمه و نحوه جمع‌آوری URI ریشه سرویس برای فراخوانی‌های OData OData URI : Introduction and How to gather the service root uri for Odata calls

• جمع‌آوری URL مرکز داده – افزونه بامزه کوچک Gathering Data Center URL - Cute lil extension

راه‌اندازی Soap UI Soap UI Set Up

• دانلود و نصب SOAP UI SOAP UI Download and Install

• تغییرات پیکربندی SOAP UI، با توجه به غیرفعال شدن TLS v1.0 در Successfactors SOAP UI Configuration changes, in view of Successfactors' TLS v1.0 disablement

OData: ابزارهایی برای انجام فراخوانی OData OData : Tools to make the OData call

• راه‌اندازی Postman Postman Set Up

• SOAPUI: انجام فراخوانی‌های Rest از SoapUI SOAPUI : Making Rest Calls from SoapUI

• کلاینت پیشرفته Rest از Chrome Advanced Rest Client from Chrome

• مرورگر Chrome/FireFox Chrome/FireFox Browser

مبانی OData Successfactors – چه اشیائی و با چه ویژگی‌هایی در دسترس هستند؟ Successfactors Odata Basics - What all objects are exposed and their properties?

• مقدمه OData و اجزای ساختار Odata Introduction and Structure Components

• مبانی OData: سند سرویس در مقابل سند ابرداده سرویس OData Basics : Service Document vs. Service Metadata Document

• مبانی OData: سند ابرداده موجودیت – مقایسه با اسناد دیگر OData Basics : Entity Metadata Document -comparison with other documents

• مبانی OData: نحوه جمع‌آوری سند سرویس، اسناد ابرداده سرویس و موجودیت OData Basics : How to gather Service Document , Service and Entity Metadata Docs

• مبانی OData: درک سند ابرداده سرویس – مجموعه‌های موجودیت (EntitySets)، نوع موجودیت (EntityType) OData Basics : Understanding Service Metadata Document - EntitySets , EntityType

• مبانی OData: درک سند ابرداده سرویس – مجموعه انجمن (AssociationSet) و نوع (Type) OData Basics : Understanding Service Metadata Document - AssociationSet and Type

• مبانی OData: درک سند ابرداده سرویس – ویژگی ناوبری (Navigation Property) OData Basics : Understanding Service Metadata Document - Navigation Property

• مبانی OData: درک سند ابرداده سرویس – وارد کردن تابع (Function Imports) OData Basics : Understanding Service Metadata Document - Function Imports

• مبانی OData: درک سند ابرداده موجودیت OData Basics : Understanding Entity Metadata Document

URI OData OData URI

• URI OData: URI و اجزای آن – تمام اجزا OData URI : URI and its components - All components

• URI OData: URI و اجزای آن – مسیر منبع (Resource Path) – بخش اول OData URI : URI and its components - Resource Path -part I

• URI OData: URI و اجزای آن – مسیر منبع (Resource Path) – بخش دوم OData URI : URI and its components - Resource Path -part II

• URI OData: URI و اجزای آن – گزینه‌های پرس و جو (Query Options) OData URI : URI and its components - Query Options

گزینه‌های پرس و جو OData OData Query Options

• گزینه‌های پرس و جو OData: $orderby OData Query Options: $orderby

• گزینه‌های پرس و جو OData: $top و $skip OData Query Options: $top and $skip

• گزینه‌های پرس و جو OData: $top + $skip همراه با $orderby OData Query Options: $top + $skip combined with $orderby

• گزینه‌های پرس و جو OData: $filter – مقدمه OData Query Options: $filter - Introduction

• گزینه‌های پرس و جو OData: عملگرهای منطقی پشتیبانی شده $filter OData Query Options: $filter-supported Logical Operators

• گزینه‌های پرس و جو OData: عملگرهای حسابی پشتیبانی شده $filter OData Query Options: $filter-supported Arithematic Operators

• گزینه‌های پرس و جو OData: $filter – عملگرهای گروه‌بندی، سفارشی و رشته‌ای پشتیبانی شده OData Query Options: $filter-supported Grouping ,Customized & String Operators

• فیلدهای نوع داده DateTime و DateTimeOffset DateTime and DateTimeOffset DataType fields

• گزینه‌های پرس و جو OData: عملگرهای DateTime پشتیبانی شده $filter – بخش اول OData Query Options: $filter-supported DateTime Operators -Part I

• فیلدهای نوع داده Time Time DataType fields

• گزینه‌های پرس و جو OData: عملگرهای DateTime پشتیبانی شده $filter – بخش دوم OData Query Options: $filter-supported DateTime Operators -Part II

• گزینه‌های پرس و جو OData: انواع داده عددی پشتیبانی شده $filter OData Query Options: $filter-supported Numeric Datatypes

• گزینه‌های پرس و جو OData: نوع داده بولی پشتیبانی شده $filter OData Query Options: $filter-supported Boolean Datatype

• گزینه‌های پرس و جو OData: $expand OData Query Options: $expand

• گزینه‌های پرس و جو OData: $format OData Query Options: $format

• گزینه‌های پرس و جو OData: $select OData Query Options: $select

• گزینه‌های پرس و جو OData: $inlinecount OData Query Options: $inlinecount

مجوزهای کاربر OData API OData API User Permissions

• OData: ایجاد یک کاربر API و تعیین رمز عبور OData : creating an API user and assigning the password

موجودیت‌های تاریخ موثر Effective Dated Entities

• موجودیت‌های تاریخ موثر – آن‌ها چه هستند؟ Effective Dated Entities - What are They?

• موجودیت‌های تاریخ موثر – چگونه تعریف می‌شوند؟ Effective Dated Entities - How are they defined?

• موجودیت‌های تاریخ موثر – مفهوم Effective Dated Entities - The Concept

• موجودیت‌های تاریخ موثر – مفهوم پیشرفته Effective Dated Entities - Advanced Concept

• حالت‌های مختلف ورود داده در Successfactors Different Modes in which Data can be entered in Successfactors

• مفهوم fromDate, toDate و asOfDate برای موجودیت‌های تاریخ موثر Concept of fromDate, toDate and asOfDate for Effective Dated Entities

• مفهوم fromDate, toDate و asOfDate برای موجودیت‌های تاریخ موثر پیشرفته Concept of fromDate, toDate and asOfDate for Advanced Effective Dated Entities

• ورود داده اولیه: تأثیر بر اشیاء تاریخ موثر Initial data entry : Impact on effective dated objects

• ورود داده حالت تصحیح: تأثیر بر اشیاء تاریخ موثر Correction Mode data entry : Impact on effective dated objects

• ورود داده حالت ویرایش: تأثیر بر اشیاء تاریخ موثر Edit Mode data entry : Impact on effective dated objects

• ورود داده حالت درج و حذف: تأثیر بر اشیاء تاریخ موثر Insert and Delete Mode data entry : Impact on effective dated objects

رفتار موجودیت‌های تاریخ موثر با ناوبری Effective Dated Entities behavior with Navigation

• رفتار موجودیت‌های تاریخ موثر با ناوبری: قوانین Effective Dated Entities behavior with Navigation : Rules

• رفتار موجودیت‌های تاریخ موثر با ناوبری: مفاهیم ناوبری پیشرفته Effective Dated Entities behavior with Navigation : Advanced navigation concepts

موجودیت‌های تاریخ موثر: چگونه می‌توان آن‌ها را پرس و جو کرد Effective Dated Entities : How can they be queried

• موجودیت‌های تاریخ موثر: پارامترهای متعددی برای پرس و جوی آن‌ها در دسترس است Effective Date Entities: multiple parameters available to query 'em

• موجودیت‌های تاریخ موثر: پرس و جو شامل from/to/asOfDate Effective Dated Entities: Querying involving from/to/asOfDate

• موجودیت‌های تاریخ موثر: پرس و جو شامل start/endDate Effective Dated Entities: Querying involving start/endDate

• موجودیت‌های تاریخ موثر: سیستمی که هنگام حضور from/to/asOfDate دنبال می‌کند Effective Dated Entities: Logic system follows when from/to/asOfDate are present

• موجودیت‌های تاریخ موثر: پارامترهای lastModifiedOn/DateTime قوانین Effective Dated Entities: lastModifiedOn\DateTime parameters Rules

• موجودیت‌های تاریخ موثر – فیلتر بر اساس سناریوهای lastModifiedDateTime بخش اول Effective Dated Entities-filter by lastModifiedDateTime scenarios Part-I

• موجودیت‌های تاریخ موثر – فیلتر بر اساس سناریوهای lastModifiedDateTime بخش دوم Effective Dated Entities-filter by lastModifiedDateTime scenarios Part-II

• موجودیت‌های تاریخ موثر – فیلتر بر اساس سناریوهای lastModifiedDateTime بخش سوم Effective Dated Entities-filter by lastModifiedDateTime scenarios Part-III

• موجودیت‌های تاریخ موثر – فیلتر بر اساس الگوریتم نهایی lastModifiedDateTime Effective Date Entities-filter by lastModifiedDateTime - Final Algorithm

موجودیت‌های تاریخ موثر – رفتار با $expand Effective Date Entities - Behavior with $expand

• رفتار موجودیت‌های تاریخ موثر با $expand: قوانین Effective Dated Entities behavior with $expand - Rules

• رفتار موجودیت‌های تاریخ موثر با $expand: درک بیشتر – بخش اول Effective Dated Entities behavior with $expand - Further understanding - partI

• رفتار موجودیت‌های تاریخ موثر با $expand: درک بیشتر – بخش دوم Effective Dated Entities behavior with $expand - Further understanding - partII

APIهای OData: عملیات Push OData APIs : Push Operations

• APIهای OData: عملیات Push: نمای کلی OData APIs : Push Operations : Overview

APIهای OData: عملیات Push: INSERT OData APIs : Push Operations : INSERT

• مرور کلی بخش: APIهای OData: INSERT Section Overview : OData APIs : INSERT

• INSERT: آیا عملیات توسط موجودیت، فیلدهای مورد نیاز، URI، HTTP Verb پشتیبانی می‌شود؟ INSERT : Is the operation supported by entity, required fields, URI, HTTP Verb

• INSERT: بدنه درخواست: آیا تمام فیلدها برای عملیات پشتیبانی می‌شوند؟ INSERT : Request Body : Are all fields supported for the operation?

• INSERT: مقادیر مجاز فیلد – انواع داده و حداکثر طول INSERT : Allowable Field Values - Data Types and MaxLength

• INSERT: مقادیر مجاز فیلد – لیست انتخاب (PickLists) INSERT : Allowable Field Values - PickLists

• INSERT: مقادیر مجاز فیلد – اشیاء MDF INSERT : Allowable Field Values - MDF Objects

• INSERT: مقادیر مجاز فیلد – لینک‌های ناوبری INSERT : Allowable Field Values - Navigation Links

• INSERT: مقادیر مجاز فیلد – OptionId یا ExternalCode (مقادیر لیست انتخاب) INSERT : Allowable Field Values - OptionId or ExternalCode (PickList values)

• INSERT: انجام درج در موجودیت از طریق OData API INSERT : Perform Insert on the Entity via OData API

• INSERT: آیا می‌توان چندین فراخوانی را در یک فراخوانی OData ارسال کرد؟ INSERT : Can Multiple Calls be posted in one OData Call

APIهای OData: عملیات بر روی لینک‌ها OData APIs : Operations on Links

• APIهای OData: نمای کلی لینک‌ها OData APIs : Links Overview

• APIهای OData: عملیات پرس و جو بر روی لینک‌ها/ناوبری OData APIs : Query Operation On Links/Navigation

• APIهای OData: عملیات ایجاد بر روی لینک‌ها OData APIs : Create Operation on Links

• APIهای OData: عملیات حذف بر روی لینک‌ها OData APIs : Delete Operation On Links

• APIهای OData: عملیات به‌روزرسانی بر روی لینک‌ها OData APIs : Update Operation On Links

APIهای OData: عملیات Push: UPDATE OData APIs : Push Operations : UPDATE

• UPDATE: انجام به‌روزرسانی بر روی موجودیت از طریق OData API UPDATE : Perform Update on the Entity via OData API

• UPDATE: انجام عملیات Replace UPDATE : Perform a Replace Operation

• UPDATE: انجام عملیات Merge UPDATE : Perform a Merge Operation

• UPDATE: برخی تفاوت‌های اضافی بین عملیات Replace و Update UPDATE : Some additional differences between Replace and Update Operation

APIهای OData: عملیات Push: UPSERT OData APIs : Push Operations : UPSERT

• UPSERT: مقدمه و فراخوانی اولیه UPSERT : Introduction and initial call

• UPSERT: رمزگشایی رابطه کاربر و PerPerson – چالشی خاص UPSERT : Demystifying User and PerPerson relationship - a specific challenge

• UPSERT: بحث بیشتر درباره Upsert UPSERT : Further discussion over Upsert

• UPSERT: پردازش پارامتر purgeType (کامل) UPSERT : processing parameter purgeType (full)

• UPSERT: کدام موجودیت‌ها purgeType=full را پشتیبانی می‌کنند؟ UPSERT : Which all entities support purgeType=full

• UPSERT: پردازش پارامتر purgeType (افزایشی) UPSERT : processing parameter purgeType (incremental)

• رفتار purgeType با ویژگی NO_OVERWRITE موجودیت UPSERT : purgeType behavior with NO_OVERWRITE property of Entity

• UPSERT: درک شیء EmpGlobalAssignment UPSERT : Understanding the EmpGlobalAssignment Object

• UPSERT: پردازش پارامتر suppressUpdateOfIdenticalData UPSERT : processing parameter suppressUpdateOfIdenticalData

• UPSERT: پردازش پارامتر fileLocale UPSERT : processing parameter fileLocale

• UPSERT: چندین درخواست در یک فراخوانی UPSERT : Multiple Requests in one call

• UPSERT: چندین نوع موجودیت داخلی در یک فراخوانی – بخش اول UPSERT : Multiple Inline Entity Types in one call -Part 1

• UPSERT: چندین نوع موجودیت داخلی در یک فراخوانی – بخش دوم UPSERT : Multiple Inline Entity Types in one call -Part 2

• UPSERT: راهی برای بهبود عملکرد فراخوانی Upsert UPSERT : Avenue for Performance Improvement of Upsert call

APIهای OData: عملیات: DELETE OData APIs : Operation : DELETE

• DELETE: حذف موجودیت‌ها DELETE : Deleting the entities

پاداش Bonus

• مورد استفاده: ایجاد و پرس و جوی ورودی‌های لیست انتخاب Use Case : Creating and Querying PickList entries

• مورد استفاده: وارد کردن تابع: افزودن یا حذف کاربران از گروه ثابت Use Case : Function Import : Add or remove users from the Static Group

بخش SFAPI – آیا SFAPI از طریق Provisioning در نمونه SFSF فعال است؟ SFAPI Section - Whether SFAPI is enabled in the SFSF Instance via Provisioning

• آیا SFAPI فعال است؟ SFAPI Enabled?

ایجاد شناسه کاربری API برای فراخوانی SFAPI Creating an API User ID to make SFAPI call

• ایجاد شناسه کاربری برای فراخوانی‌های SFAPI Creating an User ID for the SFAPI calls

• ایجاد شناسه کاربری از طریق گزینه ۱ (Provisioning) Creating User IDs via Option 1(Provisioning)

• ایجاد شناسه کاربری API از طریق گزینه ۲.۱ (رابط کاربری برنامه Successfactors) Creating API User IDs via Option 2.1 (Successfactors Application UI)

• ایجاد شناسه کاربری API گزینه ۲.۲ (وارد کردن کارمند از طریق رابط کاربری برنامه SFSF) Creating API User IDs Option 2.2 (Import Employee via SFSF Application UI )

تنظیم رمز عبور برای کاربر API Setting the Password for the API User

• تنظیم رمزهای عبور برای شناسه کاربری API ایجاد شده در بالا Setting the Passwords for the API User IDs created above

• تنظیم رمز عبور برای کاربر API – گزینه ۱.۱ Setting the Password for the API User - Option 1.1

• تنظیم رمز عبور برای کاربر API – گزینه ۱.۲ Setting the Password for the API User - Option 1.2

• تنظیم رمز عبور برای کاربر API – گزینه ۲ Setting the Password for the API User - Option 2

• تنظیم رمز عبور برای کاربر – گزینه‌های ۳ و ۴ Setting Password for the User - Option 3 and 4

• ملاحظات هنگام فعال بودن SSO Considerations when SSO is enabled

• ملاحظات برای SSO – فعال کردن فیلد loginMethod Considerations for SSO - Enabling the loginMethod field

• اولین فراخوانی SFAPI! Making First SFAPI call !

روش‌ها و پارامترهای SFAPI SFAPI Methods And Parameters

• روش‌های SFAPI SFAPI Methods

• درک SFAPI wsdl Understanding SFAPI wsdl

• آمادگی برای جلسات عملی (Hands ON) در مورد فراخوانی‌های API Preparation for the Hands ON Sessions on API calls

• تنظیم استثنای ورود کاربر API Setting API User login exception

• انجام فراخوانی به SFSF برای دریافت لیست SFAPI SFObjects Making the call to SFSF to retrieve the List of the SFAPI SFObjects

• انجام فراخوانی SFAPI برای روش‌های مدیریت جلسه و بازرسی فراداده Making the SFAPI Call for Session Management and MetaData Inspection methods

• فراخوانی SFAPI برای دسته بندی پرس و جوی داده (query و queryMore) SFAPI call for Data Query Category (query and queryMore)

• فراخوانی SFAPI برای دسته بندی دستکاری داده (فراخوانی upsert) SFAPI call for Data Manipulation Category (upsert call)

• فراخوانی SFAPI برای عملیات ناهمزمان SFAPI Call for Asynchronous Operations