Skip to main content
Documentatie
Documentatie
Administrator Guide
Laatst bijgewerkt: 2023-06-23
Beschrijf de CSV-brongegevens

Beschrijf de CSV-brongegevens

Voor de component
PrismAnalytics
 van Workday Studio is een omschrijving van de CSV-brongegevens vereist. U kunt de JSON-tekst maken in de tool van uw keuze en deze later in Studio gebruiken. Voorbeeld: plak deze in een sms-bericht op het tabblad
Berichtopbouwfunctie
 van een
schrijfstap
 .
  1. Maak JSON-tekst met twee hoofdknooppunten:
    • parseOptions
      : informatie over de indeling van de CSV-gegevens, inclusief de tekenset en het scheidingsteken.
    • fields
      : informatie over elk veld in de CSV-gegevens, inclusief het gegevenstype en de opmaak.
  2. In de
    parseOptions
     knooppunt, kunt u de volgende velden definiëren:
    Veldnaam
    Type
    Vereist
    Omschrijving
    charsetName
    Object:
    Ja
    De tekenset van het CSV-gegevensbestand. Voorbeeld: 
    "charset": {
              "id": "Encoding=UTF-8"
            }
    Workday ondersteunt momenteel alleen de coderingsindeling UTF-8. De gegevens worden uiteindelijk opgeslagen in Unicode-indeling. Tekens zonder Unicode-equivalent worden opgeslagen als vervangend Unicode-teken, een vraagteken op een zwarte ruitachtergrond.
    fieldsEnclosedBy
    String
    Nee
    Het teken dat wordt gebruikt om velden in de CSV-gegevens in te sluiten. De standaardwaarde is dubbele aanhalingstekens. Als in een veld een dubbel aanhalingsteken wordt gebruikt, moet u het veld vooraf laten gaan door een ander dubbel aanhalingsteken. Voorbeeld:
    "fieldsEnclosedBy": "\""
    fieldsDelimitedBy
    String
    Ja
    Het teken dat wordt gebruikt om veldwaarden in de CSV-gegevens te scheiden. Voorbeeld:
    "fieldsDelimitedBy": ","
    headerLinesToIgnore
    Getal
    Nee
    Het aantal regels dat de parser als kop moet negeren. Instellen op
    0
     als de CSV-gegevens geen koptekst hebben. Voorbeeld:
    "headerLinesToIgnore": 1
    type
    Object:
    Ja
    Het type van het invoerbestand. Momenteel ondersteunt Workday alleen bestanden met scheidingstekens. Voorbeeld:
    "type": {
      "id": "Schema_File_Type=Delimited"
    }
    Deze waarde is hoofdlettergevoelig. Let op de hoofdletter D in Gescheiden.
  3. In de
    fields
     knooppunt, kunt u de volgende velden definiëren:
    Veldnaam
    Type
    Vereist
    Omschrijving
    ordinal
    Getal
    Ja
    De volgorde van het veld in de CSV-gegevensset (index). De ordinale waarden:
    • Moet beginnen met 1.
    • Moet aaneengesloten zijn.
    • U kunt geen enkel getal overslaan.
    • Maximaal 1000 hebben.
    name
    String
    Ja
    De naam van het CSV-gegevenssetveld. Veldnamen:
    • Moet uniek zijn in de gegevensset.
    • Kan maximaal 255 tekens bevatten.
    • Kan alleen alfanumerieke tekens en onderstrepingstekens bevatten.
    • Moet beginnen met een letter.
    • Mag niet eindigen met een onderstrepingsteken.
    • Kan niet beginnen met WPA_.
    description
    String
    Nee
    De omschrijving van het veld. Maximaal 1000 tekens. Voorbeeld:
    "description": "The worker's full name."
    type
    Object:
    Ja
    Het veldtype. Opties zijn:
    • Tekst
    • Numeriek
    • Boole-waarde
    • Datum
    Voorbeeld:
    "type": {
"id":"Schema_Field_Type=Date"}
    parseFormat
    String
    Ja (voor datumtypen)
    De datumnotatie. Voorbeeld:
    "parseFormat": "dd-MM-yy HH24:mm:ss"
    precision
    Getal
    Ja (voor numerieke typen)
    Het maximum aantal cijfers in een numerieke waarde. Omvat alle getallen links en rechts van een decimaalteken, maar niet het decimaalteken zelf. De maximumwaarde is 38. Voorbeeld:
    "precision": 38
    scale
    Getal
    Ja (voor numerieke typen)
    Het aantal cijfers rechts van de komma in een numerieke waarde. Moet kleiner zijn dan
    precision
     waarde. Voorbeeld:
    "scale": 2
    defaultValue
    Tekst
    Nee
    De standaardwaarde voor een veld als er geen is opgegeven in het uploadbestand.
    Druk een standaardtekstwaarde uit tussen dubbele aanhalingstekens. Voorbeeld:
    “N/A”
    .
    Standaard numerieke waarden moeten overeenkomen met de opgegeven waarden
    precision
     and
    scale
    .
    Standaarddatumwaarden moeten de volgende notatie hebben: yyyy-MM-dd'T'UU:mm:ss'Z'.
    required
    Boole-waarde
    Nee
    Hiermee wordt aangegeven of een veld een waarde moet bevatten. Instellen op
    True
     als een veld vereist is, anders instellen op:
    False
    . Als een veld vereist is, mag de waarde ervan niet null zijn in gegevens invoegen, bijwerken en upsert-bewerkingen.
    externalID
    Boole-waarde
    Ja (om te profiteren van bijwerk-, invoeg- en verwijderbewerkingen).
    Hiermee wordt aangegeven of een veld een externe ID vertegenwoordigt. Instellen op
    True
     om een veld een externe ID toe te wijzen, anders ingesteld op:
    False
    .
    Omdat velden voor externe ID's niet null kunnen zijn, moet u opgeven dat elk veld voor externe ID's vereist is. U kunt slechts één veld als externe ID opgeven.
    Geef een externe ID op in nieuwe tabellen als u wilt profiteren van de functies voor bijwerken, invoegen en verwijderen.
    Als u de functionaliteit voor bijwerken, invoegen en verwijderen wilt gebruiken voor een bestaande tabel, moet u deze wijzigen zodat deze over één veld beschikt dat is aangewezen als externe ID. De openbare Prism-API biedt geen ondersteuning voor het wijzigen van een tabel die gegevens bevat. Breng in dergelijke gevallen de wijziging aan in Workday.
Uw CSV-bronbestand beschrijft deze tabel:
Werknemer
Werknemers-ID
Functietitel
Aanstellingsdatum
Jaarsalaris
Logan McNeil
21001
Vicepresident Human Resources
1/1/2010
213298,00
Oliver Reynolds
21003
Chief Information Officer
1/1/2010
394935,00
Maximilian Schneider
21004
Chief Operating Officer
1/1/2010
255373.00
Teresa Serrano
21005
Controller
1/1/2010
291785.00
U beschrijft het als volgt met behulp van JSON:
{
  "parseOptions": {
    "fieldsDelimitedBy": ",",
    "fieldsEnclosedBy": "\"",
    "headerLinesToIgnore": 1,
    "charset": {
      "id": "Encoding=UTF-8"
    },
    "type": {
      "id": "Schema_File_Type=Delimited"
    }
  },
  "fields": [
    {
      "ordinal": 1,
      "name": "Employee",
      "description": "Employee",
      "precision": 255,
      "scale": 0,
      "parseFormat": null,
 "type": {
        "id": "Schema_Field_Type=Text"
      }
    },
    {
      "ordinal": 2,
      "name": "Employee_ID",
      "description": "Employee ID",
      "precision": 38,
      "scale": 0,
      "parseFormat": null,
      "type": {
        "id": "Schema_Field_Type=Numeric"
      }
    },
    {
      "ordinal": 3,
      "name": "Job_Title",
      "description": "Job Title",
      "precision": 255,
      "scale": 0,
      "parseFormat": null,
      "type": {
        "id": "Schema_Field_Type=Text"
      }
    },
    {
      "ordinal": 4,
      "name": "Hire_Date",
      "description": "Hire Date",
      "precision": 0,
      "scale": 0,
      "parseFormat": "MM/dd/yy",
      "type": {
        "id": "Schema_Field_Type=Date"
      }
    },
    {
      "ordinal": 5,
   "name": "Annual_Salary",
      "description": "Annual Salary",
      "precision": 38,
      "scale": 2,
      "type": {
        "id": "Schema_Field_Type=Numeric"
      }
    }
  ],
  "schemaVersion": {
    "id": "Schema_Version=1.0"
  }
}