Questa pagina è stata tradotta dall'API Cloud Translation.

Origine batch SAP SuccessFactors

Questa pagina descrive come estrarre i dati da qualsiasi entità all'interno del modulo SAP SuccessFactors Employee Central in Google Cloud con Cloud Data Fusion.

Per ulteriori informazioni, consulta la panoramica di SAP su Google Cloud.

Prima di iniziare

Configura i seguenti sistemi e servizi utilizzati dal plug-in SAP SuccessFactors:

Configura il sistema SAP SuccessFactors. Devi configurare le autorizzazioni nel tuo sistema SAP.
Esegui il deployment del plug-in SAP SuccessFactors in con Cloud Data Fusion. Devi eseguire il deployment di una versione del plug-in compatibile con la versione di Cloud Data Fusion.
- Se esegui l'upgrade della versione di Cloud Data Fusion o plug-in, valuta l'impatto delle modifiche le prestazioni e l'ambito funzionale della pipeline.
Stabilire connettività tra Cloud Data Fusion e SAP Fattori di successo.
- Assicurati che la comunicazione sia abilitata tra dell'istanza Cloud Data Fusion e dell'istanza SAP SuccessFactors.
- Per le istanze private, configura il peering di rete VPC.

Configura il plug-in

Vai all'interfaccia web di Cloud Data Fusion e fai clic su Studio.
Verifica che sia selezionata l'opzione Pipeline di dati - Batch (non In tempo reale).
Nel menu Origine, fai clic su SuccessFactors. SAP SuccessFactors nella pipeline.
Per configurare l'origine, vai al nodo SAP SuccessFactors e fai clic su Properties (Proprietà).
Inserisci le seguenti proprietà. Per un elenco completo, consulta Proprietà.
1. Inserisci un'etichetta per il nodo SAP SuccessFactors, ad esempio SAP SuccessFactors tables.
2. Inserisci i dettagli della connessione. Puoi configurare una nuova connessione una tantum o una connessione esistente riutilizzabile.
  Connessione una tantum
  Per aggiungere una connessione una tantum a SAP:
  1. Mantieni disattivata l'opzione Usa connessione.
  2. Nella sezione Connessione, inserisci le seguenti informazioni dell'account SAP in questi campi:
    
    Fornisci le credenziali SAP.
    
    Nel campo SAP SuccessFactors Base URL (URL base SAP SuccessFactors), inserisci l'URL base del tuo account SAP SuccessFactors.
    
    Nel campo Nome riferimento, inserisci un nome per che identifica l'origine per la derivazione.
    
    Nel campo Nome entità, inserisci il nome dell'entità. che stai estraendo, ad esempio people.
    
    Per generare uno schema basato sui metadati di SAP che mappa i tipi di dati SAP ai tipi di dati Cloud Data Fusion corrispondenti, fai clic su Genera schema. Per ulteriori informazioni, consulta Mappature dei tipi di dati.
    
    Nel campo URL proxy, inserisci l'URL del proxy, inclusi protocollo, indirizzo e porta.
    
    (Facoltativo) Per ottimizzare il carico di importazione da SAP, inserisci le seguenti informazioni:
    
    Per estrarre i record in base alle condizioni di selezione, fai clic su Opzioni filtro e Seleziona campi.
    
    In Espandi campi, inserisci un elenco di campi di navigazione da espandere nei dati di output estratti. Ad esempio: customManager.
    
    In Parametri di ricerca aggiuntivi, inserisci i parametri da aggiungere. all'URL, ad esempio fromDate=2023-01-01&toDate=2023-01-31.
    
    Nel campo Nome entità associata, inserisci il nome dell'entità dell'entità da estrarre, ad esempio EmpCompensationCalculated.
    
    Nel campo Tipo di paginazione, inserisci un tipo, ad esempio Server-side pagination.
  Connessione riutilizzabile
  Per riutilizzare una connessione esistente:
  1. Attiva l'opzione Usa connessione.
  2. Fai clic su Browse connections (Sfoglia connessioni).
  3. Fai clic sul nome della connessione.
    
    Nota: per ulteriori informazioni su come aggiungere, importare e modificare le connessioni visualizzate quando le sfogli, consulta Gestire le connessioni.
  Se non esiste una connessione, creane una riutilizzabile seguendo questi passaggi:
  1. Fai clic su Aggiungi connessione > SAP SuccessFactors.
  2. Nella pagina Crea una connessione SAP SuccessFactors che si apre, inserisci un nome e una descrizione per la connessione.
  3. Fornisci le credenziali SAP. Puoi chiedere all'amministratore SAP i valori del nome utente e della password di accesso SAP.
  4. Nel campo URL del proxy, inserisci l'URL del proxy, che includa la protocollo, indirizzo e porta.
  5. Fai clic su Crea.

Proprietà

Proprietà	Macro attivata	Proprietà obbligatoria	Descrizione
Etichetta	No	Sì	Il nome del nodo nella pipeline di dati.
Utilizzare la connessione	No	No	Utilizza una connessione riutilizzabile. Se viene utilizzata una connessione, non è necessario fornire le credenziali. Per saperne di più, consulta Gestire le connessioni.
Nome	No	Sì	Il nome della connessione riutilizzabile.
Nome riferimento	No	Sì	Identifica in modo univoco l'origine per la derivazione e annota i metadati.
URL di base SAP SuccessFactors	Sì	Sì	L'URL di base dell'API SuccessFactors.
Nome entità	Sì	Sì	Il nome dell'entità da estrarre. Non supporta entità che hanno proprietà con il tipo di dati binari o grandi volumi di dati. Ad esempio, `UserBadges` e `BadgeTemplates` non sono supportati.
Nome utente SAP SuccessFactors	Sì	Sì	L'ID utente per l'autenticazione, simile a `USER_ID@COMPANY_ID`. Ad esempio: `sfadmin@cymbalgroup`.
Password SAP SuccessFactors	Sì	Sì	La password SAP SuccessFactors per l'autenticazione degli utenti.
Opzioni di filtro	Sì	No	La condizione di filtro che limita il volume dei dati in uscita, ad esempio `Price gt 200`. Consulta le opzioni di filtro supportate.
Seleziona campi	Sì	No	Campi da conservare nei dati estratti. Ad esempio, `Category`, `Price`, `Name`, `Address`. Se il campo viene lasciato vuoto, vengono generati tutti i campi i campi non di navigazione verranno conservati nei dati estratti. Tutti i campi devono essere separati da virgole (,).
Espandi campi	Sì	No	Elenco dei campi di navigazione da espandere nei dati di output estratti. Ad esempio, `customManager`. Se un'entità ha gerarchici, l'origine genera un record per ogni riga nella l'entità che legge, e ogni record contiene un campo aggiuntivo contiene il valore della proprietà di navigazione specificata nella sezione Campi
Nome entità associata	Sì	No	Nome dell'entità associata che viene estratto. Ad esempio, `EmpCompensationCalculated`.
Tipo di impaginazione	Sì	Sì	Il tipo di impaginazione da utilizzare. La paginazione lato server utilizza la paginazione basata su istantanee. Se viene tentata la paginazione basata su istantanee su un'entità che non supporta la funzionalità, il server forza automaticamente la paginazione con offset client sulla query. Esempi di entità che supportano solo l'impaginazione lato server: `BadgeTemplates`, `UserBadges` e `EPCustomBackgroundPortlet`. Nessun record viene trasferito se l'impaginazione lato client viene scelta su queste entità, in quanto si basa l'API Count, che restituisce `-1` come risposta. L'impostazione predefinita è impaginazione lato server.

Sono supportati i seguenti operatori:

Operatore	Descrizione	Esempio
Operatori logici
`Eq`	Uguale	`/EmpGlobalAssignment?$filter=assignmentClass eq 'GA'`
`Ne`	Non uguale	`/RecurringDeductionItem?$filter=amount ne 18`
`Gt`	Maggiore di	`/RecurringDeductionItem?$filter=amount gt 4`
`Ge`	Maggiore o uguale a	`/RecurringDeductionItem?$filter=amount ge 18`
`Lt`	Minore di	`/RecurringDeductionItem?$filter=amount lt 18`
`Le`	Minore o uguale	`/RecurringDeductionItem?$filter=amount le 20`
`And`	E logico	`/RecurringDeductionItem?$filter=amount le 20 and amount gt 4`
`Or`	O logico	`/RecurringDeductionItem?$filter=amount le 20 or amount gt 4`
`Not`	Negazione logica	`/RecurringDeductionItem?$filter=not endswith(payComponentType, 'SUPSPEE_US')`
Operatori aritmetici
`Add`	Addizione	`/RecurringDeductionItem?$filter=amount add 5 gt 18`
`Sub`	Sottrazione	`/RecurringDeductionItem?$filter=amount sub 5 gt 18`
`Mul`	Moltiplicazione	`/RecurringDeductionItem?$filter=amount mul 2 gt 18`
`Div`	Divisione	`/RecurringDeductionItem?$filter=amount div 2 gt 18`
`Mod`	Modulo	`/RecurringDeductionItem?$filter=amount mod 2 eq 0`
Raggruppare gli operatori
`( )`	Raggruppamento per priorità	`/RecurringDeductionItem?$filter=(amount sub 5) gt 8`

Mappature dei tipi di dati

La tabella seguente è un elenco dei tipi di dati SAP con le corrispondenti tipi di Cloud Data Fusion.

Tipo di dati SuccessFactors	Tipo di dati dello schema di Cloud Data Fusion
`Binary`	`Bytes`
`Boolean`	`Boolean`
`Byte`	`Bytes`
`DateTime`	`DateTime`
`DateTimeOffset`	`Timestamp_Micros`
`Decimal`	`Decimal`
`Double`	`Double`
`Float`	`Float`
`Int16`	`Integer`
`Int32`	`Integer`
`Int64`	`Long`
`SByte`	`Integer`
`String`	`String`
`Time`	`Time_Micros`

Casi d'uso

Il seguente caso d'uso di esempio riguarda i dati di un singolo dipendente di EmployeePayrollRunResults:

Proprietà di esempio	Valore di esempio
externalCode	SAP_EC_PAYROLL_1000_0101201501312015_456_416
ID persona	456
Utente	user-1
ID impiego	416
ID fornitore buste paga	SAP_EC_PAYROLL
Inizio del periodo di pagamento effettivo	1/01/2015
Fine del periodo di pagamento effettivo	31/01/2015
ID azienda	BestRun Germania (1000)
Pagamento	28/01/2015
Valuta	Euro (EUR)
Tipo di elaborazione della paga	Regolare (REGOLARE)
ID sistema	X0B

L'esempio mostra i risultati di un dipendente in EmployeePayrollRunResults:

`EmployeePayrollRunResults_externalCod` g	`EmployeePayrollRunResults_mdfSystemEffectiveStartDate`	`amount`	`createdBy`	`createdDate`
`SAP_EC_PAYROLL_2800_0101201901312019_305_265`	`1/31/2019 0:00:00`	`70923.9`	`sfadmin`	`12/10/2019 15:32:20`
`SAP_EC_PAYROLL_2800_0101201901312019_310_270`	`1/31/2019 0:00:00`	`64500`	`sfadmin`	`12/10/2019 15:32:20`
`SAP_EC_PAYROLL_2800_0201201902282019_305_265`	`2/28/2019 0:00:00`	`70923.9`	`sfadmin`	`12/10/2019 15:32:20`
`SAP_EC_PAYROLL_2800_0201201902282019_310_270`	`2/28/2019 0:00:00`	`64500`	`sfadmin`	`12/10/2019 15:32:20`
`SAP_EC_PAYROLL_2800_0301201903312019_305_265`	`3/31/2019 0:00:00`	`70923.9`	`sfadmin`	`12/10/2019 15:32:20`

Pipeline di esempio

Consulta le configurazioni di esempio nel seguente file JSON:

  {
      "artifact": {
          "name": "data-pipeline-1",
          "version": "DATA_FUSION_VERSION",
          "scope": "SYSTEM"
      },
      "description": "",
      "name": "Demo_SuccessFactors_BatchSource",
      "config": {
          "resources": {
              "memoryMB": 2048,
              "virtualCores": 1
          },
          "driverResources": {
              "memoryMB": 2048,
              "virtualCores": 1
          },
          "connections": [
              {
                  "from": "SAP SuccessFactors",
                  "to": "BigQuery"
              }
          ],
          "comments": [],
          "postActions": [],
          "properties": {},
          "processTimingEnabled": true,
          "stageLoggingEnabled": false,
          "stages": [
              {
                  "name": "SAP SuccessFactors",
                  "plugin": {
                      "name": "SuccessFactors",
                      "type": "batchsource",
                      "label": "SAP SuccessFactors",
                      "artifact": {
                          "name": "successfactors-plugins",
                          "version": "PLUGIN_VERSION",
                          "scope": "USER"
                      },
                      "properties": {
                        "useConnection": "false",
                        "username": "${username}",
                        "password": "${password}",
                        "baseURL": "${baseUrl}",
                        "referenceName": "test",
                        "entityName": "${EmpCompensation}",
                        "proxyUrl": "${ProxyUrl}",
                        "paginationType": "serverSide",
                        "initialRetryDuration": "2",
                        "maxRetryDuration": "300",
                        "maxRetryCount": "3",
                        "retryMultiplier": "2",
                        "proxyUsername": "${Proxyusername}",
                        "proxyPassword": "${Proxypassword}"
                      }
                  },
                  "outputSchema": [
                      {
                          "name": "etlSchemaBody",
                          "schema": ""
                      }
                  ],
                  "id": "SAP-SuccessFactors"
              },
              {
                  "name": "BigQuery",
                  "plugin": {
                      "name": "BigQueryTable",
                      "type": "batchsink",
                      "label": "BigQuery",
                      "artifact": {
                          "name": "google-cloud",
                          "version": "BIGQUERY_PLUGIN_VERSION",
                          "scope": "SYSTEM"
                      },
                      "properties": {
                        "useConnection": "false",
                        "project": "auto-detect",
                        "serviceAccountType": "filePath",
                        "serviceFilePath": "auto-detect",
                        "referenceName": "Reff",
                        "dataset": "SF_Aug",
                        "table": "testdata_proxy",
                        "operation": "insert",
                        "truncateTable": "true",
                        "allowSchemaRelaxation": "true",
                        "location": "US",
                        "createPartitionedTable": "false",
                        "partitioningType": "TIME",
                        "partitionFilterRequired": "false"
                      }
                  },
                  "outputSchema": [
                      {
                          "name": "etlSchemaBody",
                          "schema": ""
                      }
                  ],
                  "inputSchema": [
                      {
                          "name": "SAP SuccessFactors",
                          "schema": ""
                      }
                  ],
                  "id": "BigQuery"
              }
          ],
           "schedule": "0 1 */1 * *",
        "engine": "spark",
        "numOfRecordsPreview": 100,
        "rangeRecordsPreview": {
            "min": 1,
            "max": "5000"
        },
        "description": "Data Pipeline Application",
        "maxConcurrentRuns": 1,
        "pushdownEnabled": false,
        "transformationPushdown": {}
      }
  }

Note di rilascio

Passaggi successivi

Scopri di più su SAP su Google Cloud.