Zu Hauptinhalt springen Zu ergänzendem Inhalt springen

Bearbeiten der semantischen Typen im Sandbox-Status mithilfe der API

Legen Sie den Typ Ihres semantischen Typs fest.

  • Der Typ DICT basiert auf einer offenen oder geschlossenen Werteliste.
  • Der Typ REGEX vergleicht Ihre Daten mit einem im Vorfeld ausgewählten regulären Ausdruck.
  • Der Typ COMPOUND ermöglicht Ihnen die Gruppierung verschiedener, bereits vorhandener semantischer Typen.

Prozedur

  1. Sofern Sie noch nicht über ein persönliches Zugriffstoken verfügen, erzeugen Sie eines. Weitere Informationen finden Sie unter „Generieren persönlicher Zugriffstoken“.
  2. Öffnen Sie Talend API Tester in Ihrem Browser.
  3. Wählen Sie auf der Registerkarte Repository die Methode Pqtch in der Dropdown-Liste Method (Methode) aus.
  4. Geben Sie folgende URL ein: https://tds.{region}.cloud.talend.com/semanticservice/categories/{{categoryID}}}.

    Eine Liste der für die verschiedenen Rechenzentren zu verwendenden URLs finden Sie unter Zugriff auf Talend Cloud-Anwendungen.

    {{categoryID}} entspricht der nach der Erstellung des semantischen Typs zurückgegebenen Kennung. Beispiel: 5f80848e51b6b16703a4318d.

  5. Klicken Sie auf die Schaltfläche Add header (Header hinzufügen) und geben Sie Authorization (Autorisierung) in das Feld name (Name) und Bearer, gefolgt von einem Leerzeichen und Ihrem Token in das Feld value (Wert) ein.
  6. Klicken Sie auf die Schaltfläche Add header (Header hinzufügen), geben Sie Cookie in das Feld name (Name) ein und lassen Sie das Feld value (Wert) leer.
  7. Nehmen Sie in das Feld Body die Details des semantischen Typs in JSON auf.
    • Um den semantischen Typ als DICT festzulegen, geben Sie Folgendes ein:
      {
    "name": "{{DICT_NAME}}",
    "label": "{{DICT_LABEL}}",
    "type": "DICT",
    "validationMode": "{{VALIDATION_MODE}}"
}

      Hierbei gilt:

      • {{DICT_NAME}} entspricht dem technischen Namen des semantischen Typs.
      • {{DICT_LABEL}} ist der in Anwendungen angezeigte Name des semantischen Typs.
      • DICT ist der Typ.
      • {{VALIDATION_MODE}} kann Folgendes sein:
        • SIMPLIFIED - Satzzeichen, Leerzeichen, Groß-/Kleinschreibung und Akzente werden bei der Validierung ignoriert und die Daten als gültig eingestuft.
        • EXACT - Die Daten werden nur als gültig betrachtet, wenn eine exakte Übereinstimmung mit dem Wert gegeben ist.
        • EXACT_IGNORE_CASE_AND_ACCENT - Groß-/Kleinschreibung und Akzente werden bei der Validierung ignoriert und die Daten als gültig eingestuft.
    • Um den semantischen Typ als REGEX festzulegen, geben Sie Folgendes ein:
      {
    "name": "{{REGEX_NAME}}",
    "label": "{{REGEX_NAME}}",
    "type": "REGEX",
    "validationMode": "{{VALIDATION_MODE}}",
    "regEx": {
        "mainCategory": "{{MAIN_CATEGORY}}",
        "validator": {
            "patternString": "{{REGEX_SYNTAX}}"
        }
    }
}

      Hierbei gilt:

      • {{REGEX_NAME}} entspricht dem technischen Namen des semantischen Typs.
      • {{REGEX_LABEL}} ist der in Anwendungen angezeigte Name des semantischen Typs.
      • REGEX ist der Typ.
      • {{VALIDATION_MODE}} kann Folgendes sein:
        • SIMPLIFIED - Satzzeichen, Leerzeichen, Groß-/Kleinschreibung und Akzente werden bei der Validierung ignoriert und die Daten als gültig eingestuft.
        • EXACT - Die Daten werden nur als gültig betrachtet, wenn eine exakte Übereinstimmung mit dem Wert gegeben ist.
        • EXACT_IGNORE_CASE_AND_ACCENT - Groß-/Kleinschreibung und Akzente werden bei der Validierung ignoriert und die Daten als gültig eingestuft.
      • regEx definiert den regulären Ausdruck:
        • {{MAIN_CATEGORY}} kann Alpha, AlphaNumeric, Numeric, BLANK oder NULL sein.
        • {{REGEX_SYNTAX}} verweist auf die Syntax des regulären Ausdrucks. Beispiel: ^(?!01000|99999)(0[1-9]\\d{3}|[1-9]\\d{4})$.
    • Um den semantischen Typ als COMPOUND festzulegen, geben Sie Folgendes ein:
      {
    "name": "COMPOUND_NAME",
    "label": "COMPOUND_LABEL",
    "type": "COMPOUND",
    "children": [
        "{{childCategoryID}}"
    ]
}

      Hierbei gilt:

      • COMPOUND_NAME entspricht dem technischen Namen des semantischen Typs.
      • COMPOUND_LABEL ist der in Anwendungen angezeigte Name des semantischen Typs.
      • COMPOUND ist der Typ.
      • {{childCategoryID}} entspricht der Kennung der unter dem von Ihnen erstellten Typ gruppierten semantischen Typen.

    Example

    {
    "name": "CODICE_FISCALE_CREATED_VIA_API",
    "label": "Codice Fiscale (created via API)",
    "type": "REGEX",
    "validationMode": "SIMPLIFIED",
    "regEx": {
        "mainCategory": "AlphaNumeric",
        "validator": {
            "patternString": "^[A-Z]{6}[0-9]{2}[A-Z][0-9]{2}[A-Z][0-9]{3}[A-Z]$"
        }
    }
}
  8. Klicken Sie auf Send (Senden).

Ergebnisse

Die API gibt den HTTP-Code 204 zurück, um Sie darüber zu informieren, dass der Request erfolgreich war.
Über die Operation GET https://tds.{region}.cloud.talend.com/semanticservice/categories?state=SANDBOX können Sie alle semantischen Typen auflisten, die den Sandbox-Status aufweisen. Die Antwort enthält Ihren semantischen Typ mit den von Ihnen vorgenommenen Änderungen. Beispiel:
    {
        "id": "5f80848e51b6b16703a4318d",
        "name": "CODICE_FISCALE_CREATED_VIA_API",
        "label": "Codice Fiscale (created via API)",
        "type": "REGEX",
        "creator": "6be3b335-05c9-4a3b-92d6-c5821f398bac",
        "creatorName": "John Doe",
        "createdAt": 1602258062631,
        "regEx": {
            "mainCategory": "AlphaNumeric",
            "validator": {
                "patternString": "^[A-Z]{6}[0-9]{2}[A-Z][0-9]{2}[A-Z][0-9]{3}[A-Z]$",
                "caseInsensitive": true,
                "re2jCompliant": true,
                "generexCompliant": true
            }
        },
        "modifiedAt": 1602262635946,
        "lastModifier": "6be3b335-05c9-4a3b-92d6-c5821f398bac",
        "lastModifierName": "John Doe",
        "completeness": false,
        "validationMode": "SIMPLIFIED",
        "state": "SANDBOX"
    }

Hat diese Seite Ihnen geholfen?

Wenn Sie ein Problem mit dieser Seite oder ihrem Inhalt feststellen, sei es ein Tippfehler, ein ausgelassener Schritt oder ein technischer Fehler, informieren Sie uns bitte!

Geben Sie hier Ihr Feedback ab