In den Beispiel-Anforderungen in diesem Abschnitt der Hilfe wird die Curl-Syntax verwendet, um alle erforderlichen Informationen, einschließlich Anforderungsheadern, Methoden, Endpunkten und Daten, sowie alle obligatorischen und optionalen Parameter darzustellen: Zusätzlich werden für jede Anforderung dieselben Header-Informationen in einem separaten Block angezeigt, die Sie bei der Verbindung mit der Data360 Govern-API über einen API-Client verwenden können.
1. Identifizieren der Beziehungstyp-UID
- Navigieren Sie zur Seite .
- Suchen Sie die Beziehung im Bereich Beziehungstypen, und klicken Sie auf das Informationssymbol, um den UID-Wert „Überschneidungstyp“ anzuzeigen.
In diesem Beispiel ist die Beziehung „Berichte referenzieren Investitionen“, und der UID-Wert ist 918d2b69-0275-48e0-8012-481b63c8f7d6.
2. Ermitteln des Beziehungssubjekts und des Objekts
Wenn Sie über die API eine neue Beziehung erstellen, müssen Sie die UID des Subjekts und die UID des Objekts in Ihre Anforderung aufnehmen.
- Navigieren Sie zur Detailseite des Bericht-Assets, das Subjekt der Beziehung sein soll, und kopieren Sie den UID-Wert.
- Navigieren Sie zur Detailseite des Investition-Assets, das Objekt der Beziehung sein soll, und kopieren Sie den UID-Wert.
Beispiel:
- Subjekt (Bericht-Asset-„Investitionsbericht“) -
8dab72ca-5679-4144-8395-b1850ff39278 - Objekt (Investitions-Asset „Investor 3“) -
52ea5336-3377-46e8-837a-03f4ab9a5142
3. Neue Beziehung posten
Verwenden Sie den Endpunkt POST POST /api/v2/relationships/{intersectTypeUid} , um eine neue Beziehung zwischen den angegebenen Assets hinzuzufügen.
Beispielanforderung
Die intersectTypeUID ist der UID-Wert des Beziehungstyps, den Sie in Schritt 1 abgerufen haben.
curl -X POST --header 'Content-Type: application/json' --header 'Accept: application/json' -d '[ \ { \ "SubjectAssetUid": "8dab72ca-5679-4144-8395-b1850ff39278", \ "ObjectAssetUid": "52ea5336-3377-46e8-837a-03f4ab9a5142", \ "Fields": {} \ } \ ]' 'https://example.data3sixty.com/api/v2/relationships/918d2b69-0275-48e0-8012-481b63c8f7d6?triggerWorkflow=true'Im folgenden Beispiel werden die Header-Informationen für dieselbe Anforderung angezeigt, die bei der Verbindung mit der Data360 Govern-API über einen API-Client verwendet wird:
POST https://example.data3sixty.com/api/v2/dataquality/relationships/918d2b69-0275-48e0-8012-481b63c8f7d6?triggerWorkflow=true HTTP/1.1 Authorization: <API Key>;<API Secret> Content-Type: application/json Accept: application/jsonAnforderungstext:
[ { "SubjectAssetUid": "8dab72ca-5679-4144-8395-b1850ff39278", "ObjectAssetUid": "52ea5336-3377-46e8-837a-03f4ab9a5142", "Fields": {} } ]https://example.data3sixty.com/api/v2/dataquality/relationships/918d2b69-0275-48e0-8012-481b63c8f7d6?triggerWorkflow=true Dies bedeutet, dass das Hinzufügen einer neuen Beziehung einen Workflow auslöst, wenn bereits Workflows für das Hinzufügen oder Bearbeiten einer Beziehung vorhanden sind und wenn alle anderen Bedingungen des Workflows erfüllt sind.Beispielantwort
[ { "ItemNumber": 1, "IntersectID": 6537, "Success": true, "IsNew": true, "uid": "63b5f8bf-a31a-4afe-ba58-2201fa38f5e4" } ]Die neu hinzugefügte Beziehung wird auf der Registerkarte Beziehungen angezeigt, wenn die Detailseite des Beziehungssubjekts oder -objekts angezeigt wird.