Conectarse a Azure DevOps desde Power Apps

Artigo
01/25/2024

O conector de Power Apps para Azure DevOps permítelle traballar coa instancia de Azure DevOps. Pode ver consultas, seleccionar elementos de traballo baseados en diferentes tipos de elementos de traballo e ver Azure DevOps ou editar detalles desde o interior dunha aplicación de lona á que se conecta Azure DevOps.

Suxestión

Para obter unha lista completa de todas as accións, consulte Accións de conector de Azure DevOps.

O obxectivo deste artigo é guialo na construción dunha aplicación de lona que poida conectarse para Azure DevOps recoller unha lista de consultas e interactuar cos elementos de traballo do proxecto.

Requisitos previos

Son necesarios os seguintes requisitos:

Una licenza de Power Apps. Se non ten licenza, utilice unha Proba de 30 días ou rexístrese nun plan de desenvolvedor para uso non produtivo.
Se é novo en Power Apps, familiarícese cos elementos básicos de Power Apps xerando unha aplicación e personalizando os controis, galería, formularios e tarxetas desa aplicación.
Unha aplicación de lenzo en branco para usar para conectarse Azure DevOps.
Para crear a aplicación que aparece neste artigo, necesitarás unha instancia que inclúa unha organización, un proxecto e unha Azure DevOps consulta compartida con algúns elementos de traballo de mostra dispoñibles para a edición.
A Azure DevOps instancia debe estar habilitada para o acceso á aplicación de terceiros a través de OAuth. Para máis información, consulte Xestionar políticas de acceso para Azure DevOps.

Paso 1 - Engadir Azure DevOps orixe de datos

Para conectarse a Azure DevOps, editar a aplicación de lenzo en branco e engadir a orixe de datos de Azure DevOps.

Conéctate a Azure DevOps.

Se non ten unha conexión de Azure DevOps xa, seleccione Conectar e siga as indicacións para proporcionar os seus datos e, a continuación, permita que a aplicación se conecte.

Paso 2 - Lista de consultas compartidas

Nesta sección, usaremos a acción ListQueriesInFolder para que o conector de Azure DevOps enumere as consultas dispoñibles.

No panel esquerdo, seleccione Inserir > Deseño > Galería vertical en branco.
Introduza a fórmula seguinte para a propiedade Items da galería, substituíndo os valores de parámetros de exemplo segundo corresponda.
```
AzureDevOps.ListQueriesInFolder("Project","Organization","Folder").value
```

Lista de consultas en cartafol usando a fórmula engadida á propiedade de Elementos da galería vertical.

Se o exemplo usa as variables "Proxecto", "Organización" e "Cartafol" e os valores reais están nas caixas de texto debaixo da barra de fórmulas (destacado). Podes atopar os valores do teu Proxecto e Organización desde a URL utilizada para conectarse a Azure Dev Ops. O cartafol normalmente será "Consultas compartidas" ou "As miñas consultas".

Localiza o nome do proxecto e da organización para a súa instancia Azure Dev Ops.

Se obtén o seguinte erro na fórmula anterior, activa o acceso da aplicación de terceiros usando OAuth na súa Azure DevOps organización e téntao de novo.
"AzureDevOps.ListQueriesInFolder fallou:"status":401,"message":"TF400813:{O usuario 'GUID' non está autorizado para acceder a este recurso".}

Seleccione o Deseño da galería en Título e subtítulo.
Escolla os campos axeitados para Azure Dev Ops como Nome e FolderOptions para o título e subtítulos.

Campos de galería para consultas de listas.

Paso 3 - Lista de elementos de traballo

Agora usamos a acción GetQueryResultsV2 para o Azure DevOps conector para listar todos os elementos de traballo para a consulta seleccionada. Isto une a galería ao orixe de datos.

Insira outra galería vertical en branco e colóquea no lado dereito da galería existente.
Introduza a fórmula seguinte para a propiedade Items da galería, substituíndo os valores de parámetros de exemplo segundo corresponda. Substitúa os nomes do proxecto e da organización segundo corresponda.
```
AzureDevOps.GetQueryResultsV2("Project", Text(Gallery1.Selected.Id),"Organization").value
```

Obtén resultados de consulta en función da galería existente en función da consulta seleccionada..

Esta fórmula usa a acción GetQueryResultsV2 co nome do proxecto, o ID da consulta e o nome da organización. O ID de consulta neste exemplo (Gallery2.Selected.Id) fai referencia á consulta seleccionada da lista de consultas dispoñibles a través da galería engadida anteriormente. Substitúa o nome da galería segundo corresponda.

Engadir valores de retorno non tipificados á túa galería

O resultado devolto de GetQueryResultsV2 é dinámico. E os valores son, polo tanto, non tipificados tamén.

Mostrar campos de elementos de traballo de título, tipo de elemento de traballo.

Non obstante, podes acceder a algúns dos valores. Azure Dev Ops devolve un conxunto básico de valores para todos os elementos que se escriben. Seleccione a tarxeta de datos na galería e insira dúas etiquetas de texto. Establece a propiedade do texto das etiquetas do seguinte xeito:

    ThisItem.Value.'System.WorkItemType'
    ThisItem.Value.'System.Title'

Paso 4 - Mostrar elementos de traballo

A aplicación mostra unha lista de todas as consultas e a lista de elementos de traballo para a consulta seleccionada. Agora podemos engadir un formulario de edición que usaremos para simplemente mostrar datos.

Organiza as dúas galerías en pantalla para dar cabida ao formulario de edición que engadimos movendo ambas galerías á esquerda da pantalla.
Engada Editar formulario na pantalla e logo móvao ao lado dereito das galerías.

Engadir formulario de edición.

Establece a propiedade de DataSource do formulario AzureDevOps.GetQueryResultsV2("Project", Text(Gallery1.Selected.Id),"Organization").value de edición. Substitúa os nomes do proxecto e da organización segundo corresponda.
Estableza a propiedade Item do formulario de edición en Gallery2.Selected.

Esta fórmula establece a propiedade Item para o formulario de edición ao elemento de traballo que está seleccionado na lista de elementos de traballo.
Seleccione Editar campos no panel de propiedades da dereita da pantalla.
Seleccionar ... (elipse) > Engadir unha tarxeta personalizada.
Reorganice a tarxeta de datos dentro do formulario de edición da parte superior.
Mantendo seleccionada a tarxeta personalizada, insira un control de Entrada de texto. Unha vez seleccionado, o control engádese dentro da tarxeta personalizada.
Aumente o tamaño do control de entrada de texto.

Control de entrada de texto dentro da tarxeta personalizada.

Establece a propiedade predeterminada do control Text(ThisItem.Value.'System.Title') de entrada de texto. O texto funciona "tipos" o retorno como Texto.

Este é o control de entrada de texto referido ao título do elemento de traballo.

Esta fórmula establece o texto predeterminado dentro do control de entrada de texto no campo Título do elemento de traballo de Azure DevOps seleccionado.

Suxestión

Se o seu proxecto usa Azure DevOps o campo Descrición con HTML ou texto rico, tamén pode usar o Control de entrada do editor de texto rico en lugar da entrada de texto ou os controis da etiqueta. Usando o control do Editor de texto enriquecido neste caso tamén axuda a resolver calquera problema, como a descrición que se mostra con código HTML en lugar de texto simple ou enriquecido.

Repita os pasos anteriores para engadir outra tarxeta personalizada, cun control de entrada de texto dentro co conxunto de propiedades por defecto Text(ThisItem.Value.'System.State').

Esta fórmula establece o texto predeterminado dentro do control de entrada de texto ao campo Estado desde o elemento de traballo seleccionado Azure DevOps .
Reorganice as tarxetas de datos dentro do formulario de edición para crear un espazo onde engadiremos a icona de gardar.

Engadir valores de retorno non éticos e dinámicos aos teus formularios

Ata agora estivemos usando o formulario Editar que simplifica a historia de acceso a datos proporcionando unha propiedade común de DataSource e Item coa que todas as tarxetas de datos do formulario poden funcionar. Se utilizas o formulario Editar, para acceder aos valores non etiquetados asegúrate de que configuras tanto o orixe de datos como as propiedades do elemento do seguinte xeito: (Substituíndo os teus valores por Organización e Proxecto.)

   AzureDevOps.GetWorkItemDetails(Gallery2.Selected.Value.'System.Id',Organization, Project, Gallery2.Selected.Value.'System.WorkItemType')

Cando pasa a propiedade de texto "WorkItemType", por exemplo, "Feature", permítelle cambiar de elementos como características e elementos de traballo. Dado que o conxunto de campos para estes elementos difiren entre si, o tipo de devolución desta chamada é dinámico.

Pode acceder a valores específicos usando o método común Texto (ThisItem.Value.' System.Id'). Alternativamente, pode acceder a eles a través da resposta dinámica máis xeral usando Text(ThisItem.fields.System_Id). Estes nomes de valores dinámicos non están tipicamente documentados. Para atopar os nomes correctos destes campos, incluídos os campos non estándar, abre a ferramenta de monitor e examina a resposta de datos para a chamada GetWorkItemDetails. Consulte a imaxe de abaixo para unha maior orientación.

Se non está a utilizar un formulario de edición, senón que usa un contedor, entón pode recuperar estes valores usando unha fórmula como a de abaixo, que recupera información dun campo de equipo personalizado.

Text(AzureDevOps.GetWorkItemDetails(Gallery2.Selected.Value.'System.Id',Organization, Project, Gallery2.Selected.Value.'System.WorkItemType').fields.One_custom_CustomField1)

Control de entrada de texto que fai referencia ao título do elemento de obra.

Actualización de valores en Azure DevOps

Para actualizar un valor en Azure Dev ops use o UpdateWorkItem no botón OnSelect dun botón.

AzureDevOps.UpdateWorkItem(
    Gallery2.Selected.Value.'System.Id', 
    Organization, 
    {   description: "This is a new description", 
        dynamicFields: ParseJSON(JSON({'Custom Field 1': "This is new custom text" })) 
    }
);

A fórmula engade novo texto de mostra, pero tamén pode usar unha expresión de PowerFx.

Asegúrese de que a fórmula usa minúsculas para os nomes de campo non personalizados ou incorporados. Por exemplo, cando se refire ao campo "Descrición", use description: "This is a new description" no canto de Description:"This is a new description". A carcasa incorrecta pode dar lugar ao erro "400 Parámetro necesario que falta para a operación solicitada: 'UpdateWorkItem'". Para valores personalizados / dinámicos, pode usar a carcasa normal do campo de visualización. Por exemplo, o nome do campo para o campo personalizado é só o nome de visualización "Campo personalizado 1". Esta convención de nomes dos valores de retorno é específica e Azure DevOps pode diferir doutros servizos.

Pasos seguintes

Reproduza a aplicación. Seleccione unha consulta da lista de consultas. A continuación, escolla un elemento de traballo do que queira actualizar o título ou a descrición. Faga un cambio e, a continuación, seleccione o botón Gardar. Os cambios gárdanse no elemento de traballo Azure DevOps. Cambie a outra consulta e volva para ver os cambios que aparecen dentro da aplicación.

Do mesmo xeito, personalice aínda máis a aplicación ou cree unha aplicación con tarxetas de datos adicionais nos formularios. Tamén pode usar o formulario de visualización en lugar do formulario de edición para mostrar só os datos dentro de diferentes tarxetas de datos. Cando use o formulario de visualización, asegúrese de usar o control Etiqueta de texto para mostrar texto. Cando se usa texto enriquecido ou o formato HTML (como o campo Descrición en Azure DevOps), use o control Texto HTML. Para obter máis información sobre como personalizar esa aplicación, consulte controis, galería, formatos e tarxetas.

Consulte tamén

Traballar con orixes de datos de esquema dinámico en Power Apps (experimental)

Nota

Pode indicarnos as súas preferencias para o idioma da documentación? Realice unha enquisa breve. (teña en conta que esa enquisa está en inglés)

Esta enquisa durará sete minutos aproximadamente. Non se recompilarán datos persoais (declaración de privacidade).

Share via