Anhang verstehen

Alle neuen Funktionen und Erweiterungen für das Release finden Sie im What's New Viewer im SAP Help Portal.

Wenn Sie weitere Details zu einem Thema benötigen, gehen Sie wie folgt vor:

1. Navigieren Sie zum SAP Help Portal, und geben Sie in der Dropdown-Liste Search all SAP SuccessFactors Release Information ein.
2. Wählen Sie aus der Dropdown-Liste rechts neben dem Titel der SAP-SuccessFactors-Release-Informationen das entsprechende Release aus.
3. Wählen Sie Neuerungsübersicht.
4. Wählen Sie die erforderlichen Filter aus, um das Thema anzuzeigen.
5. Wenn das Thema weitere Informationen enthält, wählen Sie Mehr anzeigen.
6. Im Abschnitt Zugehörige Informationen finden Sie weitere Details zum Thema.

Dies ist ein OData-Funktionsimport getWorkflowPendingData, mit dem Kunden die ausstehenden Workflow-Daten für Personen- und Beschäftigungsentitäten extrahieren können. Bisher war sie nur als Beta verfügbar. Nun wird das Beta-API erweitert, um als öffentlich verfügbar zu sein. Ändern Sie für alle Kunden, die das Beta-API verwenden, die Endpunkt-URL. Dieses API bietet Zugriff auf ausstehende Daten für Workflow-Anfragen. Weitere Informationen über das API und seine Einschränkung finden Sie im Hilfedokument.

Dies ist ein neues API, mit dem Kunden und Partner auf die ausstehenden Workflow-Daten zugreifen können. Einige Anwendungsfälle sind: Dokumentgenerierung, Erweiterungs-App für Workflow-Genehmigungen mithilfe der Cloud-Plattform usw.

OData-Admin-Berechtigung lesen

Neben der Unterstützung für Entitäten wie PerEmail, PerPhone, PerAddressDEFLT und EmpJobRelations unterstützt das OData-API nun die folgenden Entitäten, um gelöschte Objekte für erweiterte Entitäten zu verarbeiten: PerNationalId, EmpPayCompNonRecurring, PerEmergencyContact und EmpWorkPermit.

Das Standardverhalten in Employee-Central-OData-API-Abfragen besteht darin, alle gelöschten Datensätze zu ignorieren. Mit der Behandlung gelöschter expandierter Entitäten haben Sie die Möglichkeit, das vollständig gelöschte Objekt in einer letzten Änderungsabfrage zu erfassen.

Schalter „Löschen erweiterter Entitäten als Änderung berücksichtigen" in „Employee-Central-Einstellungen verwalten" aktivieren

Sie können die benutzerdefinierten Zeichenfolgenfelder custom-string1, custom-string2 und custom-string3 filtern, wenn Sie die Employee-Central-OData-APIs PerPerson und EmpEmployment abfragen.

Wenn Sie diese benutzerdefinierten Zeichenfolgen zum Speichern der externen System-ID verwenden, können Sie die Entitätsdatensätze mit Filtern abfragen, anstatt alle Datensätze abzurufen, was möglicherweise Zeit während einer Datensynchronisierung zwischen SAP SuccessFactors HXM Suite und anderen Systemen spart.

Nun können Sie die Felder custom-string1, custom-string2 und custom-string3 filtern, wenn Sie diese Entitätsdatensätze abfragen.

Bisher waren die benutzerdefinierten Zeichenfolgenfelder in PerPerson und EmpEmployment nicht filterbar.

Keine

Sie können die datetime-Felder seniorityDate, originalStartDate und BenefitsEligibilityStartDate als Filter verwenden, wenn Sie die Employee-Central-OData-API EmpEmployment abfragen.

Mit diesen Datetime-Filtern können Sie die Entitätsdatensätze abfragen, die datumsbezogene Anforderungen erfüllen. Sie kann verwendet werden, um Mitarbeiter auszuwählen, die für Zusatzleistungen wie Auszeichnungen für lange Dienstzeiten zulässig sind.

Jetzt können Sie die Felder seniorityDate, originalStartDate und BenefitsEligibilityStartDate filtern, wenn Sie die Datensätze der Entität EmpEmployment abfragen.

Bisher waren die Datums-/Uhrzeitfelder in EmpEmployment nicht filterbar.

Keine

Nach der Migration des Servers nach UTC stellen die Datums-/Uhrzeitfelder lastModifiedOn und createdOn der Employee-Central-OData-Entitäten Datumsinformationen in UTC-Zeit dar.

Diese Funktion wurde entwickelt, um Datums- und Uhrzeitinformationen nach der Migration des Servers nach UTC konsistent zu halten.

In der aktuellen Version stellen die Felder lastModifiedOn und createdOn Datumsinformationen in UTC-Zeit dar.

In der vorherigen Version stellten die Felder Datumsinformationen in der Zeitzone des Servers dar.

Keine

Die neue Eigenschaft effeLatestChange ist nun im OData-API EmpJob verfügbar.

Da EmpJob mehrere Änderungen pro Tag (MCPD) unterstützt, können Sie diese Eigenschaft verwenden, um den Datensatz zu filtern, der zuletzt an einem Tag in Datumsbereichsabfragen (mit den Parametern fromDate und toDate) aktualisiert wurde.

Diese Funktion wurde entwickelt, um Kunden bei der Suche nach den neuesten Datensätzen von MCPD-Entitäten in Datumsbereichsabfragen zu unterstützen.

In der aktuellen Version ist die Eigenschaft "valideLatestChange" im EmpJob-API verfügbar.

1234567891011121314
{
                "__metadata": {
                    "uri": "https://<api-server>/odata/v2/EmpJob(seqNumber=1L,startDate=datetime'2001-02-01T00:00:00',userId='rjones1')",
                    "type": "SFOData.EmpJob"
                },
                "userId": "rjones1",
                "startDate": "/Date(980985600000)/",
                "effectiveLatestChange": true,
                "createdBy": "admin",
                "lastModifiedBy": "admin",
                "event": "2289",
                "eventReason": "HIRNEW"
                ...
            }

In der vorherigen Version hatte EmpJob diese Eigenschaft nicht.

Die Eigenschaft entityOID wurde den OData-APIs FOCostCenter und FOCompany hinzugefügt, um die Objekt-ID des One Domain Model (ODM) der entsprechenden MDF-Objekte zu speichern.

Diese Erweiterung wurde vorgenommen, da entityOID als eindeutige ID für MDF-Datensätze in ODM erforderlich ist.

In der aktuellen Version können Sie entityOID in FOCostCenter und FOCompany abrufen.

12345678910111213
{
                "__metadata": {
                    "uri": "https://<api-server>/odata/v2/FOCompany(externalCode='1510',startDate=datetime'1970-01-01T00:00:00')",
                    "type": "SFOData.FOCompany"
                },
                "externalCode": "1510",
                "startDate": "/Date(0)/",
                "country": "JPN",
                "lastModifiedDateTime": "/Date(1628256460000+0000)/",
                "endDate": "/Date(253402214400000)/",
                "createdDateTime": "/Date(1577751493000+0000)/",
                "entityOID": "e18bcfdb-3bb8-482f-ba4a-74789cf66230",
                ...}

In der vorherigen Version war die Eigenschaft in FOCostCenter und FOCompany nicht verfügbar.

Das OData-API EmpEmployment wurde erweitert, um die Navigation zum MDF-OData-API OnboardingInfo zu ermöglichen. Diese Funktion wurde erstellt, um die Wiedereinstellung mit alten Beschäftigungsdetails zu unterstützen.

123456789101112131415161718192021222324252627
{
    "__metadata": {
      "uri": "https://<api-server>/odata/v2/EmpEmployment(perso‍nIdExternal='HQ0001',userId='HQ0001')",
      "type": "SFOData.EmpEmployment"
     },
     "personIdExternal": "HQ0001",
     "userId": "HQ0001",
     ...
     "onboardingInfoNav": {
          "__metadata":{
            "uri": "https://<api-server>/odata/v2/OnboardingInfo('06BD')",
            "type": "SFOData.OnboardingInfo"
          },
          "externalCode": "06BD",
          "processStatus": "NOT_CREATED",
          "processHireStatus": "NOT_STARTED",
          "targetDate": null,
          "onboardingStableId": null,
          "processSubType": "REHIRE_OLD_EMPLOYMENT",
          "processType": "ONBOARDING",
          "user": "HQ0001",
          "userNav": {
            "__deferred":{
              "uri": "https://<api-server>/odata/v2/OnboardingInfo('06BD')/userNav"}
            },
      },
}

Die Eigenschaft mdfSystemRecordId wurde einigen OData-APIs des Metadata Framework (MDF) Foundation Objects (FO) hinzugefügt. MDF-FAs, auch migrierte FAs genannt, beziehen sich auf die Employee-Central-FAs, die in MDF migriert wurden. Diese Funktion wurde erstellt, um MDF-FO-OData-APIs an MDF-OData-APIs anzupassen, da alle MDF-OData-APIs diese Eigenschaft enthalten.

Die betroffenen MDF-FO-OData-APIs lauten wie folgt:

FOBusinessUnit, FOCompany, FOCostCenter, FODepartment, FODivision, FOJobCode, FOJobFunction, FOPayGroup

In der aktuellen Version können Sie entityOID in FOCostCenter und FOCompany abrufen.

123456789101112
{
                "__metadata": {
                    "uri": "https://<api-server>/odata/v2/FOCompany(externalCode='1510',startDate=datetime'1970-01-01T00:00:00')",
                    "type": "SFOData.FOCompany"
                },
                "externalCode": "1510",
                "startDate": "/Date(0)/",
                "country": "JPN",
                "lastModifiedDateTime": "/Date(1628256460000+0000)/",
                "lastModifiedBy": "v4admin",
                "mdfSystemRecordId": "4DE9547935524902A1B016C8C36A7A68",
                ...}

Die Eigenschaft EmploymentId wurde dem OData-API EmpEmployment hinzugefügt, um einen Beschäftigungsdatensatz zu identifizieren.

Wir haben diese Erweiterung vorgenommen, um Ihnen eine neue Art der Nutzung von Daten in EmpEmployment anzubieten.

In der aktuellen Version ist die Eigenschaft EmploymentId im OData-API EmpEmployment verfügbar.

12345678910111213141516171819202122232425
{
    "d": {
        "results": [
            {
                "__metadata": {
                    "uri": "https://<api-server>/odata/v2/EmpEmployment(personIdExternal='HQ0001',userId='HQ0001')",
                    "type": "SFOData.EmpEmployment"
                },
                "personIdExternal": "HQ0001",
                "userId": "HQ0001",
                "hiringNotCompleted": false,
                "isECRecord": true,
                "lastModifiedDateTime": "/Date(1582694474000+0000)/",
                "serviceDate": null,
                "endDate": null,
                "bonusPayExpirationDate": null,
                "createdDateTime": "/Date(1582694468000+0000)/",
                "employmentId": "115",
                ...
            }
        ]
    }
}

 

Sie können nun die Eigenschaft isEarning als Filter verwenden, wenn Sie das OData-API FOPayComponent abfragen.

Wir haben isEarning filterbar gemacht, sodass Sie nur eine Liste der Verdienste oder Abzüge erhalten können.

In der aktuellen Version ist die Eigenschaft isEarning filterbar. Sie können beispielsweise eine Liste der Verdienstdatensätze über diese Anfrage abrufen: https://<api-server>/odata/v2/FOPayComponent?$filter=isEarning eq true&$format=json.

In der vorherigen Version war die Eigenschaft isEarning nicht filterbar.

Die Eigenschaft issueDate wurde zum Teil des zusammengesetzten Geschäftsschlüssels im OData-API EmpWorkPermit gemacht.

Mit dieser Erweiterung hat EmpWorkPermit nun die folgenden Schlüsseleigenschaften:

• Land
• documentType
• documentNumber
• Benutzer-ID
• IssueDate

Wenn Sie nun eine Arbeitserlaubnis nach Geschäftsschlüssel abfragen möchten, müssen Sie issueDate in das Schlüsselprädikat aufnehmen. Beispiel: https://<api-server>/odata/v2/EmpWorkPermit(country='44',documentNumber='DF112345DD-A',documentType='9944',issueDate=datetime'2014-05-12T00:00:00',userId='HuJoyce').

Überprüfen Sie die Verwendung des OData-APIs EmpWorkPermit in Ihrer Organisation, und nehmen Sie die entsprechenden Anpassungen vor.

Wenn Sie die Übernahme dieser Funktion verzögern möchten, können Sie zu allen ursprünglichen Verhaltensweisen zurückkehren (mit Ausnahme des im folgenden Hinweis angegebenen Verhaltens), indem Sie Ausstellungsdatum aus Geschäftsschlüsseln der Arbeitserlaubnis ausschließen im OData-API EmpWorkPermit unter Admin-Center Unternehmensweite System- und Logo-Einstellungen auswählen. Nachdem Sie diese Option geändert haben, denken Sie daran, die OData-API-Metadaten zu aktualisieren, bevor Sie EmpWorkPermit verwenden.

Sie können nun Auswahllisten und Auswahllistenwerte mithilfe einer OData-Abfrage aus Employee Central in das SAP-S/4HANA-System importieren.

Das neue Integrationspaket SAP SuccessFactors Employee Central Integration with SAP ERP or SAP S/4HANA: Generic Data in SAP Cloud Integration wird bereitgestellt. Dieses Paket enthält den Integration-Flow Replicate Generic Data from SAP SuccessFactors Employee Central to SAP ERP or SAP S/4HANA Using the OData API, mit dem Sie Entitäten wie Auswahllisten aus Employee Central in das SAP-S/4HANA-System replizieren können. Ein neuer Report im SAP-S/4HANA-System ist nun verfügbar, um diesen Integration-Flow zu verwenden und die Auswahllisten und Auswahllistenwerte aus Employee Central in das SAP-S/4HANA-System zu importieren. Sie können die importierten Auswahllisten und Auswahllistenwerte in SAP S∕4HANA beim Definieren von Wertezuordnungen im Customizing verwenden, um Employee-Central-Feldwerte den Werten von SAP-S/4HANA-Feldern zuzuordnen.

Support Package 02 des Add-Ons SFSF EC S4 HCM INTEGRATION (ECS4HCM) muss in Ihrem SAP-S/4HANA-System installiert sein.