Métodos de servicio de organización

 

Publicado: enero de 2017

Se aplica a: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online

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 de organización 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 Dynamics 365 en el servicio de la organización
Autenticar usuarios en Microsoft Dynamics 365
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)

Microsoft Dynamics 365

© 2017 Microsoft. Todos los derechos reservados. Copyright