Beispiele für Objekttypzuordnungen

Eine Objekttyp-Zuordnung, die ein Profil generiert

Das folgende Beispiel zeigt Daten, die das Standardprofil füllen.

Es folgt das eingehende Objekt:

{
  "account": 1234,
  "email": "[e-mail]",
  "address": {
     "address1": "Street",
     "zip": "Zip",
     "city": "City"
  },
  "firstName": "John",
  "lastName": "Doe"
}                   
                

Der folgende Code zeigt die Zuordnung des eingehenden Objekts zu einem Standardprofilobjekt und die Indexierung PersonalEmailAddressfullName, undaccountId, was ein eindeutiger Schlüssel ist.

{
    "Fields": {
        "accountId": {
            "Source": "_source.account",
            "Target": "_profile.AccountNumber",
            "ContentType": "NUMBER"
        },
        "shippingAddress.address1": {
            "Source": "_source.address.address1",
            "Target": "_profile.ShippingAddress.Address1"
        },
        "shippingAddress.postalCode": {
            "Source": "_source.address.zip",
            "Target": "_profile.ShippingAddress.PostalCode"
        },
        "shippingAddress.city": {
            "Source": "_source.address.city",
            "Target": "_profile.ShippingAddress.City"
        },
        "personalEmailAddress": {
            "Source": "_source.email",
            "Target": "_profile.PersonalEmailAddress",
            "ContentType": "EMAIL_ADDRESS"
        },
        "fullName": {
            "Source": "{{_source.firstName}} {{_source.lastName}}"
        },
        "firstName": {
            "Source": "_source.firstName",
            "Target": "_profile.FirstName"
        },
        "lastName": {
            "Source": "_source.lastName",
            "Target": "_profile.LastName"
        }
    },
    "Keys": {
        "_email": [
            {
                "FieldNames": ["personalEmailAddress"]
            }
        ],
        "_fullName": [
            {
                "FieldNames": ["fullName"]
            }
        ],
        "_account": [
            {
                "StandardIdentifiers": ["PROFILE","UNIQUE"],
                "FieldNames": ["accountId"]
            }
        ]
    }
}  

Beachten Sie, dass email und zwar zwar indexiert fullname sind, aber nicht für die Suche nach dem Profil verwendet werden. Das Konto ist der eindeutige Schlüssel. Es ist erforderlich, das Objekt zu spezifizieren. Jedes Mal, wenn ein Objekt mit derselben Konto-ID aufgenommen wird, überschreibt es das vorherige Objekt mit derselben Konto-ID.

Im Standardprofilobjekt werden mehrere Felder aufgefüllt (siehe die Felder, die Target definiert wurden).

Eine Objekttyp-Zuordnung, die das Standardprofil nicht auffüllt

Dieses Beispiel zeigt einen komplizierteren Anwendungsfall. Es nimmt Daten auf, die sich auf ein Profil beziehen, füllt aber nicht unbedingt das Standardprofilobjekt auf.

Es folgt das eingehende Objekt:

{
  "email": "[e-mail]",
  "timestamp": "2010-01-01T12:34:56Z",
  "subject": "Whatever this is about",
  "body": "Body of ticket"
}

Im Folgenden finden Sie eine Möglichkeit, diese Daten zuzuordnen:

{
    "Fields": {
        "email": {
            "Source": "_source.email",
            "ContentType": "EMAIL_ADDRESS"
        },
        "timestamp": {
            "Source": "_source.timestamp"
        }
    },
    "Keys": {
        "_email": [
            {
                "StandardIdentifiers": ["PROFILE","LOOKUP_ONLY"],
                "FieldNames": ["email"]
            }
        ],
        "ticketEmail": [
            {
                "StandardIdentifiers": ["PROFILE","SECONDARY","NEW_ONLY"],
                "FieldNames": ["email"]
            }
        ],
        "uniqueTicket": [
            {
                "StandardIdentifiers": ["UNIQUE"],
                "FieldNames": ["email","timestamp"]
            }
        ]
    }
}

In diesem Beispiel werden die Daten und bei der ersten Suche die E-Mail-Adresse aufgenommen.

• Wenn die E-Mail-Adresse einem einzelnen Profil entspricht, wird sie verwendet, um die Daten an dieses spezifische Profil anzuhängen. Die eindeutige Kennung für das Ticket besteht aus der E-Mail und dem Zeitstempel, da keine andere eindeutige Kennung existiert.

• Wenn mit der angegebenen E-Mail-Adresse kein Profil vorhanden ist, wird ein neues Profil erstellt, bei dem das einzige Feld EmailAddress ausgefüllt ist. Das aufgenommene Objekt wird an dieses neue abgeleitete Profil angehängt. Die beiden durchsuchbaren Schlüssel, mit denen das Profil gefunden werden kann, sind und. _email uniqueTicket

• Wenn mehr als ein Profil mit der angegebenen E-Mail-Adresse vorhanden ist, wird ein neues Profil erstellt, bei dem das einzige Feld EmailAddress ausgefüllt ist, und das Objekt wird an dieses neue Profil angehängt. Dieses Profil wird mit dem definierten ticketEmail Schlüssel zusätzlich zu _email und erstelltuniqueTicket. Alle nachfolgenden Tickets aus dieser E-Mail werden diesem neuen abgeleiteten Profil zugewiesen. Der Grund dafür ist, dass sich der _email Schlüssel auf drei Profile bezieht und somit verworfen wird. Der ticketEmail Schlüssel bezieht sich jedoch nur auf ein einzelnes Profil (das neue abgeleitete) und ist immer noch gültig.

• In Fällen, in denen ein neues abgeleitetes Profil erstellt wird, wird das EmailAddress Feld anhand des ersten Objekts gefüllt, das es erstellt hat.