In einer Aktivität in Jitterbit Integration Studio definierte Schemata

Einführung

In einer Transformation verwendete Schemata werden entweder von Connector-Aktivitäten übernommen, die ursprünglich an eine Transformation angrenzen (wie auf dieser Seite beschrieben), oder sie werden in einer Transformation definiert (siehe Wie Schemata definiert werden in Schemaverwendung). In einer Aktivität definierte Schemata, die von einer benachbarten Transformation geerbt werden, werden nicht als Teil der Transformation betrachtet.

Ein in einer angrenzenden Aktivität (oder einer ursprünglich angrenzenden Aktivität, die inzwischen entfernt wurde) definiertes Schema hat Vorrang vor einem in einer Transformation definierten Schema.

Wenn in einer anderen Operation auf eine Transformation verwiesen wird, die ein Schema von einer Aktivität erbt, und die Aktivität, die das Schema bereitstellt, in der aktuellen Operation nicht benachbart ist, bleibt die Transformation unverändert und erbt weiterhin das Schema von der Aktivität, die nicht mehr benachbart ist (siehe Wiederverwendung von Transformation).

Wenn eine Aktivität gelöscht wird, die ein Schema für eine Transformation bereitstellt, wird dieses Schema Teil der Transformation und direkt in der Transformation definiert. Wenn die gelöschte Aktivität ein Schema für eine Transformation bereitstellt, wird diese Transformation ungültig, da einer Transformation mit einem Schema eine Aktivität vorangehen muss, die ein Schema bereitstellt. Weitere Regeln und Muster zum Erstellen einer gültigen Operation werden in Operationsgültigkeit behandelt.

Definieren eines Schema in einer Aktivität

Je nach Connector kann die Möglichkeit für einen Benutzer, ein Schema bereitzustellen, als Aktivitätskonfigurationsschritt enthalten sein. Die Schnittstelle zum Definieren von Schemas wird in der Dokumentation des jeweiligen Connectors beschrieben.

Einige Konnektoren, bei denen Schemata durch einen Benutzer definiert werden können, verfügen über eine gemeinsame Schnittstelle. Dazu gehören diese:

• API: Anfrage und Antwort Aktivitäten
• Dateifreigabe: Lesen und Schreiben Aktivitäten
• FTP: Lesen und Schreiben Aktivitäten
• HTTP: GET, PUT, POST, DELETE und benutzerdefinierte Aktivitäten
• HTTP v2: GET, SETZEN, POST, PATCH, LÖSCHEN, KOPF und OPTIONEN Aktivitäten
• Lokaler Speicher: Lesen und Schreiben Aktivitäten
• Temporärer Speicher: Lesen und Schreiben Aktivitäten
• Variable: Lesen und Schreiben Aktivitäten

Unten finden Sie ein Beispiel für die Definition eines Schema in einer File Share-Lese-Aktivität.

Während der Konfiguration der oben genannten Aktivitäten wählen Sie eine von drei Optionen in einem Abschnitt namens Antwortschema bereitstellen oder Anforderungsschema bereitstellen aus:

• Nein: Wählen Sie diese Option, um die Angabe eines Schema zu überspringen. Diese Option kann aus mehreren Gründen sinnvoll sein:

  • Wenn der Connector ein festes Schema bereitstellt, wenn kein benutzerdefiniertes Schema bereitgestellt wird.
  • Wenn Sie das Schema direkt in der Transformation definieren (siehe In einer Transformation definierte Schemata).
  • Wenn für Ihren Anwendungsfall kein Schema erforderlich ist (siehe Schemaverwendung).

• Ja, gespeichertes Schema verwenden: Wählen Sie diese Option, um ein vorhandenes Schema auszuwählen, das zuvor im aktuellen Projekt definiert wurde. Wenn diese Option ausgewählt ist, wird dieser Abschnitt verfügbar:

  

  • Gespeicherte Schemas: Verwenden Sie die Dropdown-Liste, um ein vorhandenes Schema zur Wiederverwendung auszuwählen.

  • Schema anzeigen: Nachdem ein vorhandenes hochgeladenes Schema ausgewählt wurde, können Sie das Schema direkt im Textbereich unter der Dropdown-Liste anzeigen. Um das Schema in einem größeren Bereich anzuzeigen, klicken Sie auf das Popout-Symbol (nachdem Sie diesen Bereich geöffnet haben, klicken Sie auf das Zurück-Symbol, um zu diesem Bildschirm zurückzukehren).
    

    Obwohl ein gespeichertes Schema nicht editierbar ist, kann dieser Textbereich kopiert werden mit Control+C (Windows oder Linux) oder Command+C (macOS).
    

    Dieser Textbereich dient nur zur Anzeige vorhandener hochgeladener Schemata und zeigt keine flat, hierarchisch oder gespiegelt benutzerdefinierte Schemata.

  • Validierung: Validierungsinformationen werden unterhalb des Textbereichs bereitgestellt und basieren auf der Dateierweiterung des gespeicherten Schema.

• Ja, neues Schema angeben: Wählen Sie diese Option, um ein neues Schema zu definieren, indem Sie eines von einer URL laden, eine Datei hochladen oder manuell in den Textbereich eingeben. Wenn diese Option ausgewählt ist, wird dieser Abschnitt verfügbar:

  

  • Schemaname: Geben Sie in das obere Textfeld einen Namen für das Schema ein, einschließlich der Dateierweiterung (.csv, .json, .xml, .xsd, oder .zip). Wenn keine Dateierweiterung angegeben ist, wird der Inhalt analysiert, um den für die Validierung zu verwendenden Dateityp automatisch zu erkennen. Wenn Sie das Schema von einer URL laden oder eine Datei hochladen, können Sie dieses Feld leer lassen, da der Name nach dem Laden der Datei eingetragen wird.

  • URL laden: Klicken Sie hier, um ein Dialogfeld zu öffnen, in dem Sie ein Schema von einer URL laden können:

    

    • Dateityp: Verwenden Sie das Dropdown-Menü, um aus den unterstützten Dateitypen auszuwählen, darunter CSV, JSON, XML, XSD und ZIP. Beachten Sie:

      • XSD: Ein per URL bereitgestelltes XSD kann andere XSD- URLs per Referenz importieren/einschließen.

      • ZIP: Ein ZIP-Archiv kann eine Sammlung von XSDs enthalten, die sich gegenseitig per Referenz importieren/einschließen können. Alle Nicht-XSD-Dateien im Archiv werden ignoriert. Mehrere Verzeichnisebenen werden unterstützt.

    • URL: Geben Sie eine URL ein, die ohne Authentifizierung zugänglich ist. Es können Dateien bis zu einer Größe von 5 MB hochgeladen werden.

    • Laden: Klicken Sie hier, um das Schema von der URL zu laden. Beachten Sie, dass die Datei nur einmal zur Schema abgerufen wird. Beachten Sie außerdem, dass einige Daten während der Verarbeitung konvertiert werden können, wie unter Schemaverarbeitung beschrieben.

      Hinweis

      Beim Hochladen einer XSD-Datei, die mehrere Elemente der obersten Ebene enthält, werden Sie beim Klicken auf Weiter, um zum nächsten Schritt zu gelangen, aufgefordert, den gewünschten Stammknoten auszuwählen. Wählen Sie das gewünschte Element aus und klicken Sie dann auf Fertig, um die Datei hochzuladen:

      

    • Abbrechen: Klicken Sie hier, um das Dialogfeld Schema-URL hochladen ohne Speichern zu schließen.

  • Datei hochladen: Klicken Sie hier, um ein Dialogfeld zu öffnen, in dem Sie ein Schema aus einer Datei laden können, auf die vom aktuellen Computer aus zugegriffen werden kann:

    

    • Dateityp: Verwenden Sie das Dropdown-Menü, um aus den unterstützten Dateitypen auszuwählen, darunter CSV, JSON, XML, XSD und ZIP.

      Hinweis

      Ein ZIP-Archiv kann eine Sammlung von XSDs enthalten, die sich gegenseitig per Referenz importieren/einbinden können. Alle Nicht-XSD-Dateien im Archiv werden ignoriert. Mehrere Verzeichnisebenen werden unterstützt.

    • Datei: Navigieren Sie mit der Schaltfläche Durchsuchen rechts zu einer Datei, die im aktuellen Projekt noch nicht verwendet wurde. Es können Dateien mit einer Größe von bis zu 5 MB hochgeladen werden.

      Warnung

      Wenn Sie versuchen, eine Datei mit demselben Namen wie eine vorhandene Datei hochzuladen, die bereits im Projekt definiert ist, werden Sie beim Klicken auf Weiter, um zum nächsten Schritt zu gelangen, in einem Dialogfeld gefragt, ob Sie die vorhandene Datei überschreiben möchten. Wenn Sie auf Fortfahren klicken, wird die Datei an allen Stellen, an denen sie im Projekt verwendet wird, durch die neue Datei mit demselben Namen ersetzt. Wenn Sie die Datei nicht überschreiben möchten, klicken Sie auf Abbrechen. Ändern Sie die Datei dann manuell, sodass sie einen eindeutigen Namen hat, und versuchen Sie dann erneut, sie hochzuladen.

      

    • Laden: Klicken Sie hier, um das Schema aus der Datei zu laden. Beachten Sie, dass einige Daten während der Verarbeitung konvertiert werden können, wie unter Schemaverarbeitung beschrieben.

      Hinweis

      Beim Hochladen einer XSD-Datei, die mehrere Elemente der obersten Ebene enthält, werden Sie aufgefordert, den gewünschten Stammknoten auszuwählen. Wählen Sie das gewünschte Element aus und klicken Sie dann auf Fertig, um die Datei hochzuladen:

      

    • Abbrechen: Klicken Sie hier, um das Dialogfeld Schemadatei hochladen ohne Speichern zu schließen.

  • Schema anzeigen/bearbeiten: Wenn Sie kein Schema hochladen, können Sie eines manuell in den Textbereich unter den Schaltflächen URL laden und Datei hochladen eingeben. Andernfalls können Sie nach dem Hochladen eines Schema das Schema direkt in diesem Textbereich anzeigen oder bearbeiten.

    Um das Schema in einem größeren Bereich anzuzeigen oder zu bearbeiten, klicken Sie auf das Popout-Symbol (nachdem Sie diesen Bereich geöffnet haben, klicken Sie auf das Zurück-Symbol, um zu diesem Bildschirm zurückzukehren).

    Dieser Textbereich kann auch kopiert werden mit Control+C (Windows oder Linux) oder Command+C (macOS).

  • Validierung: Wenn Sie ein Schema bearbeiten, werden Validierungsinformationen unterhalb des Textbereichs bereitgestellt, wobei alle Fehler zeilenweise gemeldet werden. Das heißt, nach der Behebung eines Fehlers in einer Zeile werden möglicherweise weitere zu behebende Syntaxfehler für nachfolgende Zeilen gemeldet. Die Validierung basiert auf der Dateierweiterung des bereitgestellten Schema.

Aktionsmenü „Schemaaktionen“

Nachdem ein Schema in einer Aktivität definiert wurde, können Sie auf zusätzliche Menüoptionen zugreifen, die für alle Schemata verfügbar sind.

Dazu gehören Löschen, Umbenennen, Abhängigkeiten anzeigen, Bereitstellen, Konfigurierbare Bereitstellung und Zur Gruppe hinzufügen sowie Schema bearbeiten und Schema löschen. Einzelheiten zu diesen Aktionen finden Sie unter Aktionsmenü Schemaaktionen.