Compartilhar via


Exemplo: operações de arquivo de anexo e anotação usando a API Web do Dataverse

Este exemplo .NET 6.0 demonstra como executar operações usando dados de arquivo com tipos de entidade activitymimeattachment e annotation usando a API Web do Dataverse.

Este exemplo usa o código auxiliar comum no projeto de exemplo da biblioteca de classes WebAPIService (C# ).

Pré-requisitos

  • Microsoft Visual Studio 2022
  • Acesso ao Dataverse com privilégios de administrador do sistema ou personalizador de sistema.

Como executar o exemplo

  1. Clone ou baixe o repositório PowerApps-Samples .

  2. Abra o arquivo PowerApps-Samples\dataverse\webapi\C#-NETx\AttachmentAndAnnotationOperations\AttachmentAndAnnotationOperations.sln usando Visual Studio 2022.

    Esta solução contém dois projetos que incluem exemplos:

    • ActivityMimeAttachmentOperations: demonstra o uso de anexos.
    • AnnotationOperations: demonstra o uso de anotações.

    Observação: o projeto WebAPIService está incluído para que cada um dos outros projetos possa depender do código auxiliar comum fornecido pelo serviço. Os exemplos usam várias classes na WebAPIService/Messages pasta.

    Em Solution Explorer, clique com o botão direito do mouse no projeto que você deseja executar e escolha Set como Projeto de Inicialização.

  3. Em qualquer projeto, edite o appsettings.json arquivo para definir os seguintes valores de propriedade:

    Propriedade Instruções
    Url A URL do seu ambiente. Substitua o valor do espaço reservado https://yourorg.api.crm.dynamics.com pelo valor correspondente ao seu ambiente. Veja Exibir recursos do desenvolvedor para encontrar isso.
    UserPrincipalName Substitua o marcador you@yourorg.onmicrosoft.com pelo valor UPN que você utiliza para acessar o ambiente.
    Password Substitua o valor do placeholder yourPassword pela senha que você utiliza.
  4. Salve o arquivo appsettings.json.

    Observação: ambos os projetos se referem ao mesmo appsettings.json arquivo, portanto, você só precisa fazer isso uma vez para executar qualquer projeto.

  5. Pressione F5 para executar o exemplo.

Demonstrações

Este exemplo é uma solução com dois projetos. Consulte os respectivos arquivos README para obter detalhes sobre cada projeto.

Classe utilitária

Ambos os projetos usam uma classe compartilhada Utility para executar operações comuns. Essa classe contém três métodos estáticos:

GetMimeType

Com base em um parâmetro FileInfo , essa função usa Microsoft.AspNetCore.StaticFiles.FileExtensionContentTypeProvider para tentar obter o mimetype do arquivo. Se isso não puder ser determinado, ele retornará application/octet-stream

GetMaxUploadFileSize

Usando o parâmetro WebAPIServiceServiceservice , essa função retorna o maxuploadfilesize valor inteiro da organization tabela.

SetMaxUploadFileSize

Usando o parâmetro WebAPIServiceServiceservice , essa função define o maxuploadfilesize valor inteiro da organization tabela para o valor do parâmetro inteiro maxUploadFileSizeInBytes .

Consulte também

Usar dados de arquivo com registros de Anexo e Anotação
Sample: operações de arquivo com anexos e anotações usando o SDK do Dataverse para .NET