Zum Hauptinhalt springen

GetRtEntitiesByWellKnownName@1

Der Node GetRtEntitiesByWellKnownName@1 dient dazu, Runtime-Entitäten anhand ihrer Well-Known-Namen aus dem OctoMesh Asset Repository zu extrahieren.

Well-Known-Namen sind eindeutige Bezeichner, die Runtime-Entitäten im OctoMesh Asset Repository zugewiesen werden. Über diese Namen können bestimmte Entitäten anhand ihrer eindeutigen Bezeichner aus dem Repository abgerufen werden.

Secret-Attribute

Attribute vom Werttyp Secret werden nur als Ist-gesetzt-Markierung zurückgegeben, niemals mit ihrem Wert. Um ein Secret in einer Pipeline zu verwenden, lesen Sie es mit RevealSecret@1.

Adapter-Voraussetzungen​

Node-Konfiguration​

Zum Feld path siehe Überblick. Die Felder targetPath, targetValueWriteMode und targetValueKind werden in diesem Node nicht verwendet.

transformations:
  - type: GetRtEntitiesByWellKnownName@1 # Get the runtime entities by well-known name
    path: $.subPath # The path to an object or array of objects containing the well-known names as properties.
    ckTypeId: "OctoSdkDemo/Customer" # The type of the runtime entities
    skip: 0 # The number of records to skip
    take: 10 # The number of records to take, the default is 10
    wellKnownNamePath: $.wellKnownName # The path to the well-known name in the payload
    rtIdTargetPath: $.rtId # The path where the runtime entity ID should be stored in the payload
    ckTypeIdTargetPath: $.ckTypeId # The path where the CK type ID should be stored in the payload
    modOperationPath: $.modOperation # The path where the mod operation should be stored in the payload
    generateInsertOperation: true # Generate insert operation for the runtime entity if true otherwise false (that means entity not found in the repository)

Anwendungsbeispiel​

Hier ein Beispiel, wie Sie den Node GetRtEntitiesByWellKnownName@1 in einer Transformations-Pipeline verwenden könnten. In diesem Beispiel ruft der Node Runtime-Entitäten anhand ihrer Well-Known-Namen ab und speichert die Runtime-Entitäts-ID, die CK-Typ-ID und die Änderungsoperation in der Payload.

triggers:
  - type: FromPipelineDataEvent@1
    description: Retrieve from distributed event hub message
transformations:
    # Create a unique string for order items
  - type: Concat@1
    path: $.orders[*]
    concatSubPath: $.orderItemId
    parts:
      - valuePath: $.Header.OrderNumber
      - value: _
      - valuePath: $.Operation.SequenceNumber
    # search for existing orders and order items
  - type: GetRtEntitiesByWellKnownName@1
    ckTypeId: "Demo/Order"
    path: $.orders[*]
    rtIdTargetPath: $.order.rtId
    ckTypeIdTargetPath: $.order.ckTypeId
    modOperationPath: $.order.modOperation
    wellKnownNamePath: $.Header.OrderNumber
    generateInsertOperation: true
  - type: GetRtEntitiesByWellKnownName@1
    ckTypeId: "Demo/OrderItem"
    path: $.orders[*]
    rtIdTargetPath: $.orderItem.rtId
    ckTypeIdTargetPath: $.orderItem.ckTypeId
    modOperationPath: $.orderItem.modOperation
    wellKnownNamePath: $.orderItemId   
    generateInsertOperation: true