Métodos de servicio de organización
Publicado: noviembre de 2016
Se aplica a: Dynamics CRM 2015
Importante
Algunos vínculos a los métodos en esta SDK no funcionan. Puede obtener la documentación de los métodos del servicio web en la siguiente página: IOrganizationService.
El servicio web de IOrganizationService proporciona un conjunto de métodos utilizados para realizar las operaciones más frecuentes en las entidades personalizadas y del sistema y en los metadatos de la organización. Estas operaciones también se pueden realizar mediante IOrganizationService. Método de Execute y mensaje correspondiente.
Crear
Use IOrganizationService. Método de Create para crear una instancia (registro) de cualquier entidad compatible con el mensaje Crear, incluidas las entidades personalizadas.
Recuperar
Use IOrganizationService. Método deRetrieve para recuperar una instancia (registro) de una entidad.
RetrieveMultiple
Use IOrganizationService. Método de RetrieveMultiple para recuperar una recopilación de registros. La consulta se puede especificar con una consulta de expresión o de XML de búsqueda.
Actualización
Use IOrganizationService. Método de Update para actualizar un registro existente.
Eliminar
Use IOrganizationService. Método de Delete para eliminar un registro existente.
Asociar
Use IOrganizationService. Método de Associate para crear un enlace entre dos registros que participan en una relación.
Desasociar
Use IOrganizationService. Método de Disassociate para eliminar el vínculo entre los dos registros.
Ejecutar
Use IOrganizationService. Método de Execute para ejecutar un mensaje. Esto incluye un procesamiento común, como crear y eliminar registros de datos y metadatos o un procesamiento especializado como importar o detectar duplicados.
Ejemplo
El siguiente código muestra cómo usar Create, Retrieve y los métodos de Update con los tipos seguros.
//Define the account for which we will add letters
Account accountToCreate = new Account
{
Name = "Example Account"
};
//Define the IDs of the related letters we will create
_letterIds = new[] { Guid.NewGuid(), Guid.NewGuid(), Guid.NewGuid() };
//This acts as a container for each letter we create. Note that we haven't
//define the relationship between the letter and account yet.
EntityCollection relatedLettersToCreate = new EntityCollection
{
EntityName = Letter.EntityLogicalName,
Entities =
{
new Letter{Subject = "Letter 1", ActivityId = _letterIds[0]},
new Letter{Subject = "Letter 2", ActivityId = _letterIds[1]},
new Letter{Subject = "Letter 3", ActivityId = _letterIds[2]}
}
};
//Creates the reference between which relationship between Letter and
//Account we would like to use.
Relationship letterRelationship = new Relationship("Account_Letters");
//Adds the letters to the account under the specified relationship
accountToCreate.RelatedEntities.Add(letterRelationship, relatedLettersToCreate);
//Passes the Account (which contains the letters)
_accountId = _service.Create(accountToCreate);
Console.WriteLine("An account and {0} letters were created.", _letterIds.Length);
//Now we run through many of the same steps as the above "Create" example
Account accountToUpdate = new Account
{
Name = "Example Account - Updated",
AccountId = _accountId
};
EntityCollection relatedLettersToUpdate = new EntityCollection
{
EntityName = Letter.EntityLogicalName,
Entities =
{
new Letter{Subject = "Letter 1 - Updated", ActivityId = _letterIds[0]},
new Letter{Subject = "Letter 2 - Updated", ActivityId = _letterIds[1]},
new Letter{Subject = "Letter 3 - Updated", ActivityId = _letterIds[2]}
}
};
accountToUpdate.RelatedEntities.Add(letterRelationship, relatedLettersToUpdate);
//This will update the account as well as all of the related letters
_service.Update(accountToUpdate);
Console.WriteLine("An account and {0} letters were updated.", _letterIds.Length);
Ver también
IOrganizationService
Usar el servicio web IOrganizationService para leer y escribir datos o metadatos
Usar mensajes (clases de respuesta y solicitud) con el método Execute
Usar ExecuteMultiple para mejorar el rendimiento de la carga masiva de datos
Mensajes de xRM en el servicio de organización
Mensajes de CRM en el servicio de organización
Autenticar usuarios con los servicios web de Microsoft Dynamics CRM 2015
Ejemplo: crear, recuperar, actualizar y eliminar registros (enlace en tiempo de compilación)
Ejemplo: crear, recuperar, actualizar y eliminar (enlace en tiempo de ejecución)
© 2017 Microsoft. Todos los derechos reservados. Copyright