InsProductService:getRatedProducts

Sie befinden sich hier:

InsProductService:getRatedProducts

Verwenden Sie diesen Service, um ein Array von einem oder mehreren Produkten zu erhalten, deren Preise anhand der an diese Produkte angehängten Bewertungsverfahren festgelegt werden. Dieser Service enthält auch zusätzliche Funktionen wie Steuer- und Gebührenberechnungen, Filterung und Leistungsoptimierung.

Klasse: InsProductService

Methode: getRatedProducts

Wenn Sie diesen Service verwenden möchten, übergeben Sie ihm die Eingaben, die für das Bewertungsverfahren zum Bepreisen von Produkten erforderlich sind. Der Service gibt ein gefiltertes Array von Produkten und eine Ergebnis-JSON aus dem Bewertungsverfahren zurück.

Funktionsweise

Der Service durchsucht Salesforce, um eine Reihe aktiver Produkte abzurufen, die in das Start- und Enddatum des Inkrafttretens fallen. Weitere Informationen finden Sie unter effectiveDate unten.

Im Rahmen der Abfrage verwenden die Services die in der Filteroption übergebenen Kriterien, um einen ersten Satz an Produkten abzurufen. Die aus Salesforce abgerufenen Daten umfassen die Anspruchsregeln und das Bewertungsverfahren des Produkts, die Spezifikationen des Versichertenartikels, die Spezifikationen der Versicherten, die Abdeckungsspezifikationen, die Spezifikationen des Bewertungsfakts und alle seine Attribute.
Wertet jedes Produkt im ursprünglichen Satz anhand seiner Berechtigungsregeln aus, wodurch der Produktsatz weiter reduziert wird.
Sucht in der Eingabe-JSON nach dem userInputs-Schlüssel und ruft den Wert des Schlüssels ab. "userInputs" ist der Satz an Eingabedaten, den das Bewertungsverfahren verwendet, um den Produktpreis zu ermitteln. Der Service wertet dieses Objekt anhand der Produktbewertungseingabezuordnungen aus, um die für das Bewertungsverfahren erforderliche Eingabe-JSON zu erstellen.

Sie formatieren userInputs je nach Produktdefinition und Bewertungskonfiguration unterschiedlich. Filtern Sie zum Verhindern von Fehlern nach Produkten, die alle denselben userInputs verwenden.
Bewertet jedes Produkt in dem in Schritt 2 erstellten Satz. Es ruft das zugeordnete Bewertungsverfahren des Produkts mit der Eingabe-JSON aus Schritt 3 auf.
Gibt ein Array von Produktobjekten mit dem Gesamtpreis jedes Produkts und der Versicherungssumme zurück.

Jedes zurückgegebene Produktobjekt enthält auch die Ausgabe-JSON aus dem Bewertungsverfahren als Wert von CalculatedPriceData. Der Service legt auch price und totalSumInsured fest, wenn die Formeln für das Produkt festgelegt sind.

Beachten Sie Folgendes:
- Wenn ein einzelnes Attribut mit einer Attributregel vom Typ "Wert festlegen" und einer Attributregel vom Typ "Standardwert festlegen" eingerichtet ist, wendet getRatedProducts nur die Attributregel "Standardwert festlegen" an.
- Wenn Sie Attributregelausdrücke einrichten, sollten Sie als bewährte Vorgehensweise nicht auf Attributwerte in untergeordneten Strukturen verweisen.

Remote-Optionen

Bewertungsoptionen
Option	Beschreibung
`aggByKey`	`PRODUCT.instanceKey` Wenn `aggByKey` festgelegt ist, wird sein Wert in die `aggregationResult` des Berechnungsverfahrens aufgenommen, sofern `aggregationResult` nicht leer ist. (Der `aggregationResult` wird in der Regel ausgefüllt, wenn für ein Berechnungsverfahren Aggregationsschritte konfiguriert sind.) Beispielsweise muss für eine Kfz-Versicherung, bei der mehrere Fahrer für mehrere Fahrzeuge versichert sind, eine `aggByKey` an das Berechnungsverfahren übergeben werden.
`alwaysCreateInstance`	Legen Sie diese Option für Produkte mit mehreren untergeordneten Spezifikationen in einer bestimmten Hierarchieebene, ohne untergeordnete Spezifikationen und nur einem Bewertungsverfahren auf Stammebene auf `true` fest. Lassen Sie diese Option für Produkte aus, die nicht alle diese Kriterien erfüllen. Informationen zum Formatieren von `userInputs` für diesen Produkttyp finden Sie unter Ein Bewertungsverfahren pro Produkt für getRatedProducts.
`includeInputKeys`	Eine Zeichenfolge kommagetrennter Eingabeschlüssel, die in das Ausgabeproduktobjekt im `CalculatedPriceData`-Objekt aufgenommen werden soll. Nur Eingabeschlüssel, die vom Berechnungsverfahren verwendet werden, weisen einen Wert in den Ergebnissen auf.
`rateType`	`Age` oder `Composite` Verwenden Sie diese Option für die Kleingruppenbewertung.
`searchText`	PartOfAProductName Wenn diese Option verwendet wird, erhält der Service nur Produkte mit Namen, die den von Ihnen angegebenen Wert enthalten.
`sortBy`	productField1, productField2. Sortiert die Produkte, die der Service erhält, in der von Ihnen angegebenen Reihenfolge. Sie können `DESC` mit dieser Option verwenden, um Produkte in absteigender Reihenfolge zu sortieren. Sie können das erste Element angeben, von dem abgestiegen werden soll. Wenn Sie keinen Startort angeben, wird standardmäßig in alphabetischer Reihenfolge `DESC`. Wenn Sie für diese Option keinen Wert angeben, sortiert der Service die zurückgegebenen Produkte nach Namen in aufsteigender alphabetischer Reihenfolge.

Filteroptionen
Option	Beschreibung
`attributeFilters`	Eine Karte mit `attributeCode` und Werten Gibt nur Produkte zurück, die die im Filter angegebenen Attributwerte erfüllen.
`effectiveDate`	`“YYYY-MM-DD HH:MM:SS”` oder `%OmniScriptDataElement%` Standardmäßig wird das heutige Datum verwendet. Der Service ruft Produkte mit einer `effectiveDate` zwischen `EffectiveDate__c` und `EndDate__c` und `IsActive` ab. Der Service verwendet die `effectiveDate` auch, um die richtige Version des Berechnungsverfahrens auszuwählen, mit dem das Produkt bewertet wird.
`filters`	`Product2FieldName:Value` `Product2FieldName:%ElementName%` Verwenden Sie den API-Namen mit einem Doppelpunkt gefolgt von einem Wert oder einer Variablen. Beispielsweise kann eine Variable in einem OmniScript ein Name eines Elements sein, beispielsweise eine Eingabeauswahlliste. Trennen Sie mehrere Filterparameter durch Kommas: `ProductCode:Value,ProductCode:%ElementName%` Filter können jedes Feld im `Product2`-Objekt enthalten.
`includeFilterAttrValues`	`true` oder `false` Standardmäßig wird `false` verwendet. In der Ausgabe-JSON wird zusammen mit dem Array der Produkte das Objekt "`filterAttrValues`" hinzugefügt. Dieses Objekt enthält die als filterbar markierten Stammproduktattribute mit der möglichen Liste der Werte. Diese Liste wird von einigen Benutzeroberflächenvorlagen zum Filtern großer Produktgruppen verwendet. Untergeordnete Produktattribute sind nicht enthalten.
`whereClause`	Geben Sie eine gültige Salesforce SOQL-Anweisung als Wert für diese Option ein. Verwenden Sie diese Option, wenn dieser Service Mehrfachauswahllistenfelder bei der Suche nach Produkten anzeigen soll. Die Anweisung `vlocity_ins_marketsegment_c includes ('Small Group')` nimmt beispielsweise Produkte auf, die über Marktsegmente "Kleine Gruppe" und entweder mehr oder keine Marktsegmente in der Mehrfachauswahlliste verfügen. Wichtig Entfernen Sie alle Verweise auf die Felder im `whereClause` aus Ihrem Filterschlüssel. Wenn beispielsweise `vlocity_ins_marketsegment_c:Small Group` im Filter vorhanden sind und ein `whereClause` einen Verweis auf dasselbe Feld enthält, kollidieren sie und stehen in Konflikt, was zu unvorhersehbaren Ergebnissen führt.

Optimierungsoptionen
Option	Beschreibung
`includeOptionalCovSelectFlag`	`true` oder `false` Standardmäßig wird `false` verwendet. Legen Sie diese Option auf `true` fest, damit der Service optionale Abdeckungsregeln auswertet, bevor Bewertungseingaben an Berechnungsverfahren weitergegeben werden. Wenn Produkte keine optionalen Abdeckungen verwenden, verwenden Sie die Standardeinstellung "`false`". Das Abrufen und Hinzufügen optionaler Abdeckungsdaten zur Bewertungseingabe erfordert zusätzliche Verarbeitung und kann diesen Service verlangsamen.
`includeRawCalculationResult`	`true` oder `false` Standardmäßig wird `false` verwendet. Enthält die gesamten Ergebnisse des Berechnungsverfahrens im `RawPriceData`.
`isBatchMode`	`true` oder `false` Wenn er auf `true` festgelegt ist, gibt der Service eine vereinfachte Produkt-JSON zurück, die keine Attributkategorien, aber durch Attribute ausgewählte Werte und Regeln enthält. Wenn er auf `false` festgelegt ist, gibt der Service die vollständige Produkt-JSON zurück. Diese Option ist nützlich, wenn keine Benutzeroberfläche die Ergebnisse des Service verwendet. Wenn Sie beispielsweise ein Integrationsverfahren im Batch-Modus ausführen, das diesen Service enthält.
`mergeList`	`true` oder `false` Standardmäßig wird `false` verwendet. Optimiert Bewertungsanrufe, indem Anrufe von Bewertungsverfahren nach Produkten mit demselben Bewertungsverfahren gruppiert werden. Es führt einen Bewertungsaufruf mit einem Array von Eingabeobjekten durch. Dies ist nützlich, wenn Sie eine große Liste von Produkten abrufen. Mehrere Bewertungsaufrufe können SQL-Obergrenzen erreichen. Die Architektur des Bewertungsverfahrens ist für die Verarbeitung einer Reihe von Eingabeobjekten optimiert und minimiert die Anzahl der erforderlichen SQL-Abfragen.
`omitChildren`	`true` oder `false` Legen Sie diese Option nur dann auf true fest, wenn Sie `omitRating` auch auf `true` festlegen. Dadurch werden Produkte ohne Preise zurückgegeben.
`omitRating`	`true` oder `false` Wenn "true" angegeben ist, gibt der Service Produkte ohne Preise zurück.
`productClasses`	`“ProductClassName1,ProductClassName2”` Kommagetrennte Liste der Produktklassennamen. Beschränkt die Liste der Produkte auf diese Produktklassen.
`rootPricingOnly`	`true` oder `false` Standardmäßig wird `false` verwendet. Diese Option verbessert die Leistung durch Reduzieren der Heap-Größen. Wenn das verwendete Bewertungsverfahren nur auf Stammproduktebene definiert ist, können Sie diese Option auf `true` festlegen, um die Leistung zu verbessern.

Optionen für Regeln
Option	Beschreibung
`evalOptionalCoverageRelationship`	`true` oder `false`Wenn er auf `true` festgelegt ist, führt der Service optionale Regeln für die Abdeckungsbeziehung aus.
`omitEligibility`	`true` oder `false` Standardmäßig wird `false` verwendet. Wenn er auf `true` festgelegt ist, fragt der Service keine berechtigten Produkte ab. Stattdessen müssen Sie eine Listenprodukt-ID unter den wichtigsten `products` in der Eingabekarte oder Optionskarte angeben. Sowohl eine Liste der Produkt-IDs als auch eine Zeichenfolge kommagetrennter Produkt-IDs sind zulässige Werte für `products`.
`ruleAttributeSetValues`	`true` oder `false` Wenn er auf `false` festgelegt ist, führt der Service keine Attributsatzwertregeln aus. Wenn er auf `true` festgelegt ist, führt der Service die Regeln für Attributsatzwerte aus.
`validateCoverageSelection`	`true` oder `false` Legen Sie diese Option auf `true` fest, wenn Sie über Validierungsregeln verfügen, die der Service ausführen soll.

Add-On-Funktionsoptionen
Option	Beschreibung
`calculateTaxesAndFees`	Optional `true` oder `false` Wenn dieser Wert auf `true` festgelegt ist, werden Steuern und Gebühren für das Zielprodukt berechnet.
`includeFullProductJson`	`true` oder `false` Diese Option steuert das Vorhandensein zusätzlicher untergeordneter Knoten als Reaktion auf die API anhand der Eingabe-JSON. Wenn die JSON-Ausgabe auf true festgelegt ist, gibt es zwei Änderungen: Wenn der Typ des untergeordneten Elements "Versicherte Person" lautet, enthält der übergeordnete JSON-Knoten zwei zusätzliche untergeordnete Knoten: "Primärpartei" und "Andere". Diese beiden neuen Knoten werden basierend darauf ausgefüllt, ob die `isPrimary` Kennzeichnung für den untergeordneten Knoten festgelegt ist. Wenn der Typ des untergeordneten Elements "Versicherter Posten" lautet, sind diese beiden Knoten (Primärpartei und andere Parteien) in der Antwort-API nicht vorhanden. Die in der Eingabe-JSON enthaltenen untergeordneten Elemente sind mit dem richtigen übergeordneten Knoten in der Ausgabe-JSON der API verknüpft. Für die Abwärtskompatibilität lautet die Standardeinstellung `false`.
`jurisdictionIds`	Typ: Verstärkte Liste der IDs Wird in Verbindung mit der Option `calculateTaxesAndFees` verwendet. Berechnet nur die Steuern und Gebühren, die mit den angegebenen Rechtsordnungen verbunden sind.
`taxAndFeeEffectiveDate`	Das Datum des Inkrafttretens, an dem dieser Service Steuern und Gebühren berechnet. Diese Option ist von der `effectiveDate` getrennt, die zum Bepreisen des Produkts verwendet wird. Wenn ein Wert angegeben wird, verwendet der Service diesen Wert. Wenn kein Wert angegeben ist und es sich bei der Produkt-JSON nicht um eine Richtlinie handelt, wird der Service standardmäßig auf das heutige Datum festgelegt.
`withTaxFeeRounding`	Optional Bei "true" werden die berechneten Steuer- und Gebührenbeträge mithilfe der Methode der halben gleichmäßigen Rundung auf zwei Dezimalstellen gerundet. Die `withTaxFeeRounding` ist nur wirksam, wenn die `calculateTaxesAndFees` auch wahr ist. Bei false ist die Rundung deaktiviert. Der Standardwert ist false.

Benutzeroberflächenoptionen
Option	Beschreibung
`lastRecordId`	Gibt die letzte Produkt-ID an, die der Service auf der Benutzeroberfläche abgerufen hat. Verwenden Sie diese Option mit der Option "`pageSize`".
`pageSize`	Bestimmen Sie, wie viele Produkte der Service in einem Aufruf an die Benutzeroberfläche zurückgibt.

Input JSON

InsProductService: getRatedProducts sucht in der Eingabe-JSON nach einem userInputs. Verwenden Sie je nach Produktdefinition und Bewertungskonfiguration das entsprechende userInputs. Der Service akzeptiert jeweils nur einen Typ des Formats userInputs.

Ein Bewertungsverfahren pro Produkt für getRatedProducts

Formatieren Sie userInputs für Produkte, die ein einzelnes Bewertungsverfahren pro Stammprodukt verwenden.
Mehrere Bewertungsverfahren pro Produkt oder mehrere Spezifikationen auf einer beliebigen Ebene für getRatedProducts

Formatieren Sie userInputs für Produkte, die mehrere Bewertungsverfahren in der Produkthierarchie oder mehrere untergeordnete Spezifikationen in einer beliebigen Hierarchieebene verwenden.

Ausgabe-JSON

Der Service gibt ein Array mit einem oder mehreren Produktobjekten zurück. Weitere Informationen zu diesem Objekt finden Sie im Product JSON Structure Model.

Alle zugeordneten userInputs aus der Eingabe-JSON werden dem Produktobjekt als userValues der einzelnen Instanz des Attributs hinzugefügt, dem es zugeordnet wurde.

Für jedes Produkt wird die Ausgabe-JSON aus der Berechnung des Bewertungsverfahrens dem Produkt mit dem CalculatedPriceData-Schlüssel hinzugefügt. Wenn die Preisformel für das Produkt festgelegt ist, wird der Wert von Price auf den berechneten Wert festgelegt. Wenn für das Produkt die Versicherungsgesamtformel festgelegt ist, wird der TotalInsured auf den berechneten Wert festgelegt.

In diesem Beispiel wird die Preisformel für das Produkt festgelegt, die versicherte Gesamtformel jedoch nicht. Der CalculatedPriceData wird den Ergebnissen aus dem Bewertungsverfahren hinzugefügt und der Preis wird anhand der Formel berechnet. Die insgesamt versicherte Formel wird in den Daten nicht angezeigt, ebenso wenig wie TotalInsured.

{
  "totalSize": 2,
  "records": [{
      "displaySequence": -1,
      "CalculatedPriceData": {
        "ID": "1",
        "basePremium": 719,
        "premGenlLiab": "356"
      },
      "Id": "01t6A000000FshIQAS",
      "Name": "Economy Business",
      "Family": "Commercial Lines",
      "ProductCode": "bop-ECON",
      "LineOfBusiness__c": "Property & Casualty",
      "Type__c": "BusinessOwners",
      "IsRecommended__c": false,
      "RecordTypeName__c": "Product",
      "IsConfigurable__c": true,
      "PricingFormula__c": "basePremium + premGenlLiab",
      "Term__c": "Annual",
      "productId": "01t6A000000FshIQAS",
      "Price": 1075,
      "childProducts": {
        ...
      },
      "attributeCategories": {
        ...
      }
    },
    {
      ...
    }
  }

filterAttrValues Key

Mit der Option includeFilterAttrValues wird das Produktarray in einem ratedProducts platziert und ein filterAttrValues hinzugefügt.

{
  "result": {
    "filterAttrValues": {
      "covType": {
        "listOfValues": [
          "Superior",
          "Economy"
        ],
        "valueDataType": "Text",
        "attributeName": "Type",
        "categoryName": "Policy Terms"
      },
      "covDeductible": {
        "listOfValues": [
          "1000",
          "250"
        ],
        "valueDataType": "Currency",
        "attributeName": "Deductible",
        "categoryName": "Policy Terms"
      }
    },
    "ratedProducts": {
      "totalSize": 2,
      "records": [{
          "displaySequence": -1,
          "CalculatedPriceData": {
            "ID": "1",
            "basePremium": 719,
            "premGenlLiab": "356"
          },
          "Id": "01t6A000000FshIQAS",
          "Name": "Economy Business",
          "Family": "Commercial Lines",
          "ProductCode": "bop-ECON",
          ...,
          "Price": 1075,
          "childProducts": {
            ...
          },
          "attributeCategories": {
            ...
          }
        },
        {
          ...
        }
      }
    }
  }

Jedes filterbare Attribut wird dem Objekt mit dem Schlüsselsatz für den Attributcode hinzugefügt. Der Wert jedes Filterattributs ist ein Objekt, das Folgendes enthält:

Schlüssel	Wert
`attributeName`	Der Name des Attributs.
`categoryName`	Der Name der Kategorie.
`listOfValues`	Die Liste der möglichen Werte aus dem Produkt im Array.
`valueDataType`	Der Datentyp des Attributs, beispielsweise Text oder Währung.

Steuern und Gebühren

Wenn Steuern und Gebühren den Service verwenden, werden berechnete Steuern und Gebühren in einem JSON-Datensatz auf drei verschiedene Arten angezeigt:

Wenn der Datensatz Steuern und Gebühren berechnet hat, werden sie als Liste im taxesAndFees gespeichert.

{
  "taxesAndFees": [{
    "Id": 1,
    "calculatedAmount": 10,
    "Type__c": "Tax"
  }, {
    "Id": 2,
    "calculatedAmount": 15,
    "Type__c": "Fee"
  }]
}

Wenn der Datensatz Steuern für sich selbst oder seine untergeordneten Elemente berechnet hat, wird die Summe der berechneten Steuern für sich selbst und seine untergeordneten Elemente im taxAmount gespeichert.
```
{  "taxAmount”: 25 // 10 from self, 15 from children}
```
Wenn der Datensatz Gebühren für sich selbst oder seine untergeordneten Elemente berechnet hat, wird die Summe der berechneten Gebühren für sich selbst und seine untergeordneten Elemente im feeAmount gespeichert.
```
{  "feeAmount”: 30 // 15 from self, 15 from children}
```

Eine JSON-Beispielausgabe mit Steuern und Gebühren für die untergeordneten Datensätze sowie den Stamm sieht etwa wie folgt aus:

{
  "Id": 1,
  "productName": "Product",
  "taxesAndFees": [{
    "Id": 1,
    "calculatedAmount": 10,
    "Type__c": "Tax"
  }, {
    "Id": 2,
    "calculatedAmount": 15,
    "Type__c": "Fee"
  }],
  "taxAmount": 25
  "feeAmount": 30
  "childProducts": {
    "records": [{
      "Id": 2,
      "productName": "Insured Item",
      "taxesAndFees": [{
        "Id": 3,
        "calculatedAmount": 15,
        "Type__c": "Tax"
      }],
      "taxAmount": 15
    }, {
      "Id": 3,
      "productName": "Coverage",
      "taxesAndFees": [{
        "Id": 4,
        "calculatedAmount": 15,
        "Type__c": "Fee"
      }],
      "feeAmount": 15
    }]
  }
}

Sternebewertung

Sie können die attributeFilters verwenden, um Produkte anhand von Bewertungen zu filtern, die von einem Produktmodellierer als Attribute erstellt wurden.

Ein Bewertungsverfahren pro Produkt für getRatedProducts
Formatieren Sie InsProductService:getRatedProducts userInputs für Produkte, die ein einzelnes Bewertungsverfahren pro Stammprodukt verwenden.
Mehrere Bewertungsverfahren pro Produkt oder mehrere Spezifikationen auf einer beliebigen Ebene für getRatedProducts
Formatieren Sie InsProductService:getRatedProducts userInputs für Produkte, die mehrere Bewertungsverfahren in der Produkthierarchie oder mehrere untergeordnete Spezifikationen in einer beliebigen Hierarchieebene verwenden.

Konnten Sie Ihr Problem mithilfe dieses Artikels lösen?

Geben Sie uns Feedback, damit wir uns verbessern können.

Dieser Text wurde mit dem maschinellen Übersetzungssystem von Salesforce übersetzt. Weitere Details finden Sie hier.

InsProductService:getRatedProducts

Funktionsweise

Remote-Optionen

Input JSON

Ausgabe-JSON

Steuern und Gebühren

Sternebewertung

General Information

Required Cookies

Functional Cookies

Advertising Cookies

General Information

Required Cookies

Functional Cookies

Advertising Cookies

Cookie List

Dieser Text wurde mit dem maschinellen Übersetzungssystem von Salesforce übersetzt. Weitere Details finden Sie hier.Zu Englisch wechselnNicht jetzt

Produktbereich

Auswirkungen auf Funktionen

Edition

Erfahrung

InsProductService:getRatedProducts

Funktionsweise

Remote-Optionen

Input JSON

Ausgabe-JSON

Steuern und Gebühren

Sternebewertung

Dieser Text wurde mit dem maschinellen Übersetzungssystem von Salesforce übersetzt. Weitere Details finden Sie hier.