Loading
Расширение Salesforce с помощью кликов, а не кода
Понимание требований к схеме GraphQL

Понимание требований к схеме GraphQL

Адаптер Salesforce Connect для GraphQL требует, чтобы схема GraphQL соответствовала определенному формату.

Требуемые версии

Доступно в версиях: Salesforce Classic и Lightning Experience (не для внешних объектов большого объема данных)

Доступно в версиях: Developer Edition.

Доступно за дополнительную плату в версиях: Enterprise Edition, Performance Edition и Unlimited Edition.

Сюда знакомствоgt-а схема с выделением способа создания схемы, работающей с Salesforce Connect. Уведомления для понимания схемы представителя:

  • ObjName: Данный объект определяет имя объекта GraphQL.
  • Жирный текст: Представляет схему для выполнения для каждого объекта.
  • Нежирный текст: Представляет общий код, не характерный для объектов.
type Query {
    objName(
        limit: Int,
        offset: Int,
        orderBy: [ObjName_OrderByInput],
        where: ObjName_FilterInput,
        first: Int,
        after: String
    ): ObjName_Connection
        <additional object queries...>
        node(id: ID!): Node
}

type Mutation {
    create_ObjName(input: ObjName_CreateInput!): ObjName
    <additional create mutations>
    ...
    delete_ObjName(id: ID!): ObjName
    <additional delete mutations>
    ...
    update_ObjName(input: ObjName_UpdateInput!): ObjName
    <additional update mutations>
    ...
}

type ObjName implements Node {
    id: ID!
    <fieldName: fieldType>
    ...
}

type ObjName_Connection {
    edges: [ObjName_Edge]
    pageInfo: PageInfo!
}

input ObjName_CreateInput {
        <fieldName: fieldType>
        ...
}

input ObjName_UpdateInput {
    id: ID!
    <fieldName: fieldType>
    ...
}

type ObjName_Edge {
    cursor: String!
    node: ObjName
}

input ObjName_FilterInput {
    and: [ObjName_FilterInput]
    not: ObjName_FilterInput
    or: [ObjName_FilterInput]
    id: IDOperator
    <fieldName: fieldTypeOperator>
    ...
}

input ObjName_OrderByInput {
    id: OrderByClause
    <fieldName >: OrderByClause
    ...
}

interface Node {
    id: ID!
}

enum NullsOrder {
    NULLS_FIRST
    NULLS_LAST
}

input OrderByClause {
    direction: Direction
    nulls: NullsOrder
}

type PageInfo {
    endCursor: String
    hasNextPage: Boolean!
    hasPreviousPage: Boolean!
    startCursor: String
}

input StringOperator {
    eq: String
    gt: String
    ge: String
    in: [String]
    like: String
    lt: String
    le: String
    ne: String
    nin: [String]
}

input AWSDateOperator {
    eq: AWSDate
    gt: AWSDate
    ge: AWSDate
    in: [AWSDate]
    like: AWSDate
    lt: AWSDate
    le: AWSDate
    ne: AWSDate
    nin: [AWSDate]
}

input AWSDateTimeOperator {
    eq: AWSDateTime
    gt: AWSDateTime
    ge: AWSDateTime
    in: [AWSDateTime]
    like: AWSDateTime
    lt: AWSDateTime
    le: AWSDateTime
    ne: AWSDateTime
    nin: [AWSDateTime]
}

input AWSJSONOperator {
    eq: AWSJSON
    gt: AWSJSON
    ge: AWSJSON
    in: [AWSJSON]
    like: AWSJSON
    lt: AWSJSON
    le: AWSJSON
    ne: AWSJSON
    nin: [AWSJSON]
}

input AWSTimeOperator {
    eq: AWSTime
    gt: AWSTime
    ge: AWSTime
    in: [AWSTime]
    like: AWSTime
    lt: AWSTime
    le: AWSTime
    ne: AWSTime
    nin: [AWSTime]
}

input BooleanOperator {
    eq: Boolean
    gt: Boolean
    gebolded: Boolean
    in: [Boolean]
    like: Boolean
    lt: Boolean
    le: Boolean
    ne: Boolean
    nin: [Boolean]
}

enum Direction {
    ASC
    DESC
}

input FloatOperator {
    eq: Float
    gt: Float
    ge: Float
    in: [Float]
    like: Float
    lt: Float
    le: Float
    ne: Float
    nin: [Float]
}

input IDOperator {
    eq: ID
    gt: ID
    ge: ID
    in: [ID]
    like: ID
    lt: ID
    le: ID
    ne: ID
    nin: [ID]
}

input IntOperator {
    eq: Int
    gt: Int
    ge: Int
    in: [Int]
    like: Int
    lt: Int
    le: Int
    ne: Int
    nin: [Int]
}

Каждый объект должен иметь глобально уникальное поле ID!, и этот глобальный код должен быть одинаковым во всех объектах. При наличии нескольких полей типа ID! и отсутствии поля с значением id в качестве имени поля используйте определитель keyColumns для указания глобального кода. См. Параметры определителя.

Если взаимосвязь внешнего поиска представляет взаимосвязь поиска, существующую между объектами GraphQL, помните о следующих рекомендациях. Поле внешнего кода родительского внешнего объекта должно соответствовать формату поля внешнего поиска дочернего внешнего объекта. В случае несовпадения используйте определители для управления одним из следующих:

  • Манипулируйте внешним кодом родительского внешнего объекта для соответствия дочернему внешнему поиску.
  • Создайте виртуальный столбец в дочернем внешнем объекте для соответствия родительскому внешнему коду.

Важно, что глобальный код GraphQL и внешний код Salesforce могут быть вычисляемыми друг от друга. Возможной способ структурирования глобального кода — использование префикса для пространства имен, сохраняя его уникальным образом. Если основной ключ объекта состоит из нескольких полей ключей, используйте разделитель для разделения префикса и кода. Если любое значение полей ключей содержит разделитель, обязательно используйте экранирование разделителя.

В данном примере ObjName| является префиксом, а - - разделителем. Использование | после ObjName помогает анализировать префикс из компоновки ключа.

id: ObjName|KEY1\-123-KEY2\-456
key1: KEY1-123
key2: KEY2-456
 
Загрузка
Salesforce Help | Article