Definir un resolver personalizado

Create a New Custom Resolver

En la interfaz de usuario de App Services, haga clic en GraphQL en la barra lateral de navegación y luego seleccione la pestaña Custom Resolvers.

Haga clic en el botón Add a Custom Resolver para abrir la pantalla de configuración de un nuevo solucionador personalizado.

Definir el nombre del campo de resolución

Specify App Servicese name for the resolver in the GraphQL Field Name input. App Services exposes the custom resolver in its parent type using this name, so the name should describe what the resolver does in a way that is useful to developers who work with the GraphQL API.

Define the Parent Type

App Services exposes every custom resolver as a field on a parent type. The parent type can be a root-level query, mutation, or a generated document type.

En el menú desplegable Parent Type, selecciona una de las siguientes opciones:

type Query {
  myCustomQuery: DefaultPayload
  ...
}

type Mutation {
  myCustomMutation: DefaultPayload
  ...
}

type Task {
  myCustomTaskProperty: DefaultPayload
  ...
}

Definir el tipo de entrada

A custom resolver can accept input parameters from the incoming query or mutation. You can use an existing generated input type or define a new custom input type specifically for the resolver.

If you specify an input type, App Services exposes the input parameter in the custom resolver's generated GraphQL schema definition as an optional parameter that accepts the specified input type. If you don't specify an input type, the custom resolver does not accept any arguments.

En el menú desplegable Input Type, selecciona una de las siguientes opciones:

Opción	Descripción
None	El resolver no acepta ninguna entrada. Ejemplo Un resolvedor personalizado llamado myCustomQuery que no acepta una entrada tiene el siguiente esquema generado: type Query { myCustomQuery: DefaultPayload ... }
Scalar	The resolver uses an existing scalar type from the generated GraphQL schema. En el segundo campo desplegable, elige un único escalar o un arreglo de múltiples escalares del mismo tipo. Ejemplo Un solucionador personalizado llamado myCustomQuery que usa la opción Scalar Type para especificar un tipo de entrada de DateTiem tiene el siguiente esquema generado: type Query { myCustomQuery(input: DateTime): DefaultPayload ... }
Existing Type	El solucionador utiliza un tipo de entrada existente del esquema GraphQL generado. En la segunda entrada desplegable, seleccione un solo objeto de entrada o una matriz de múltiples objetos de entrada del mismo tipo. Ejemplo Un solucionador personalizado llamado myCustomQuery que usa la opción Existing Type para especificar un tipo de entrada de TaskInsertInput tiene el siguiente esquema generado: type Query { myCustomQuery(input: TaskInsertInput): DefaultPayload ... }
Custom Type	App Services genera un nuevo tipo de entrada específicamente para el solucionador, basándose en un esquema definido por el usuario. El esquema debe ser un object que contenga al menos una propiedad y un title campo que defina un nombre único para el tipo de entrada generado. Ejemplo Un solucionador personalizado llamado myCustomQuery que usa la opción Custom Type con un tipo de entrada llamado MyCustomQueryInput tiene el siguiente esquema generado: input MyCustomQueryInput { someArgument: String; } type Query { myCustomQuery(input: MyCustomQueryInput): DefaultPayload ... }

Definir el tipo de carga útil

Todos los resolvedores GraphQL deben devolver una carga útil que se ajuste a un tipo específico del esquema. Para un resolvedor personalizado, puede usar un tipo de documento generado previamente, definir un nuevo tipo de carga útil personalizado específicamente para el resolvedor o usar una carga útil predeterminada. App Services incluye el tipo de carga útil especificado en la definición del esquema GraphQL generada por el resolvedor personalizado.

En el menú desplegable Payload Type, selecciona una de las siguientes opciones:

Opción	Descripción
DefaultPayload	El solucionador devuelve el tipo DefaultPayload generado automáticamente que tiene la siguiente firma: type DefaultPayload { status: String! } El campo status siempre se resolverá en "complete", independientemente del valor que devuelva la función resolutora. { status: "complete" } Ejemplo A custom resolver named myCustomQuery that uses the DefaultPayload option has the following generated schema: type Query { myCustomQuery: DefaultPayload ... }
Scalar	The resolver uses an existing scalar type from the generated GraphQL schema. En el segundo campo desplegable, elige un único escalar o un arreglo de múltiples escalares del mismo tipo. Ejemplo Un resolver personalizado llamado myCustomQuery que utiliza la opción Scalar Type para especificar un tipo de carga útil de DateTime tiene el siguiente esquema generado: type Query { myCustomQuery: DateTime ... }
Existing Type	El solucionador devuelve un tipo de documento existente del esquema GraphQL generado. In the second dropdown input, select either a single document type or an array of multiple documents of the same type. Ejemplo Un solucionador personalizado llamado myCustomQuery que usa la opción Existing Type para especificar un tipo de entrada de TaskInsertInput tiene el siguiente esquema generado: Un resolver personalizado llamado myCustomQuery que utiliza la opción Existing Type para especificar un tipo de carga útil de [Task] tiene el siguiente esquema generado: type Query { myCustomQuery: [Task] ... }
Custom Type	App Services genera un nuevo tipo de payload específicamente para el resolver según un esquema que tú defines. El esquema debe ser un object que contenga al menos una propiedad y un campo title que defina un nombre único para el tipo de entrada generado. Ejemplo A custom resolver named myCustomQuery that uses the Custom Type option with a payload type named MyCustomQueryPayload has the following generated schema: input MyCustomQueryPayload { someValue: String; } type Query { myCustomQuery: MyCustomQueryPayload ... }

Define the Resolver Function

Cuando un usuario llama a un resolvedor personalizado, App Services ejecuta la función resolvedora y devuelve el resultado, que debe cumplir con el Payload Type del resolvedor.

aplicación Services pasa la función cualquier dato de entrada proveniente de la operación, si corresponde. Si el solucionador es una propiedad calculada en un tipo de documento, aplicación Services pasa la función el documento específico en el que se llamó al solucionador.

Una función de resolución personalizada tiene una de dos firmas posibles, dependiendo de si acepta o no una entrada:

exports = function myCustomResolver(input, source) {
  // The `input` parameter that contains any input data provided to the resolver.
  // The type and shape of this object matches the resolver's input type.
  const { someArgument } = input;
  // If the resolver is a computed property, `source` is the parent document.
  // Otherwise `source` is undefined.
  const { _id, name } = source;
  // The return value must conform to the resolver's configured payload type
  return {
    "someValue": "abc123",
  };
}

exports = function myCustomResolver(source) {
  // If the resolver is a computed property, `source` is the parent document.
  // Otherwise `source` is undefined.
  const { _id, name } = parent;
  // The return value must conform to the resolver's configured payload type
  return {
    "someValue": "abc123",
  };
}

Para definir la función del resolver, haz clic en el menú desplegable Function y selecciona una función existente o crea una nueva.

Guardar e implementar el solucionador

Una vez configurado el resolver, haga clic en Save e implemente su aplicación. Una vez implementada, puede llamar al resolver personalizado a través de la API de GraphQL.