Relação entre ASMS e DevOps

Para realizar a integração, é necessário relacionar os campos da tarefa ASMS Aranda aos campos da tarefa DevOps por meio da seção “tarefa” do arquivo de configuração.

Estrutura JSON

{
  "task": [
    {
      "reference": "",
      "definition": {
        "idByProject": {
          "type": "",
          "key": ""
        },
        "subject": {
          "type": "",
          "key": ""
        },
        "description": {
          "type": "",
          "key": ""
        },
        "responsible": {
          "type": "",
          "key": "",
          "SearchBy": [""]
        },
        "responsibleGroup": {
          "key": "",
          "type": "",
          "defaultValue": {
            "id": 0,
            "value": ""
          }
        },
        "duration": {
          "type": "",
          "key": ""
        },
        "enddate": {
          "type": "",
          "key": ""
        },
        "startdate": {
          "type": "",
          "key": ""
        }
      },
      "model": {
        "id": 0,
        "additionalFields": [
          {
            "id": 0,
            "type": "",
            "field": {
              "key": ""
            },
            "mapping": [
              {
                "id": 0,
                "value": ""
              },
              {
                "id": 0,
                "value": ""
              },
              {
                "id": 0,
                "value": ""
              }
            ]
          }
        ],
        "state": [
          {
            "id": 0,
            "value": "",
            "reason": 0,
            "commentary": {
              "key": "",
              "value": ""
            }
          }
        ]
      }
    }
  ]
}

Propriedades :

Definição

Para realizar a integração, é necessário relacionar os campos de caso no Aranda ASMS com o WorkItem do DevOps através da seção “definition” do arquivo de configuração; essas propriedades no ASMS podem ser associadas a campos de lista ou string no DevOps, excluindo as propriedades de sujeito e descrição.

Propriedades:

Descrição:

A descrição da tarefa no DevOps pode estar relacionada ao tipo adicional de campo “Parágrafo” de tarefas ASMS.

Tarefa no ASMS: Ilustração de referência, informações básicas de tarefas na plataforma ASMS

tarea en DevOps: Ilustración de referencia, información básica de la tarea en la plataforma DevOps

Propiedades internas

{
  "key": "",
  "type": "",
  "searchBy": ["Email"],
  "defaultValue": {
    "id": 0,
    "value": ""
  }
}

Onde:

Propriedade “Key”

A integração permite relacionar propriedades de tarefas com propriedades de tarefa no DevOps

1. Para obter o nome dos imóveis pode consultar: Propriedades de DevOps

2. Relacionar Caminho da área em DevOps * A nomenclatura da Área do Caminho tem as seguintes restrições: Ver. * A integração criará a Área do Caminho caso ela não exista. * Se o valor atribuído no ASMS for nulo ou vazio no DevOps, a área de caminho padrão que corresponde ao nome do projeto será atribuída. * Se o valor atribuído no DevOps for a área do caminho, por padrão (nome do projeto) no ASMS, o campo será atribuído vazio ou nulo. * Se o valor atribuído na propriedade ASMS OU DevOps for nulo ou vazio e no arquivo de configuração a propriedade for atribuída defaultValue, as plataformas terão o valor registrado em defaultValue. * Quando os campos estão relacionados a “System.AreaPath”, somente os tipos de relação “Mapper” ou “FieldValue” são permitidos. * Para relacionar o Ids das propriedades ASMS com o Caminho da Área, NÃO digite o nome que é adicionado por padrão na Área do Caminho (nome do projeto), adicione apenas o Caminho.

<center><img src="/aic/pt/assets/images/devops/areapath_definition.jpg"></center>


* No se permite relacionar más de un campo con la propiedad "System.AreaPath".
* Se relacionan los siguientes tipos de campos adicionales de la tarea con el "Area Path"
    * Short Text  
    * List
    * Catalog (List)
    * Catalog (Tree)    
* Para los campos adicionales no se permite agregar la propiedad **"value"** si se relaciona con "System.AreaPath".

⚐ Nota: O suporte para campos adicionais é validado em tempo de execução.

Propriedade “defaultValue”

1. A propriedade defaultValue permite adicionar valores padrão, se você adicionar essa propriedade com o valor de defaultValue.id para o caso em Aranda ou valorPadrão.valor para o WorkItem no DevOps, o sistema adiciona o valor padrão à plataforma que define o valor.

2. Para os campos “assunto”, “Descrição”, “idByProject”, você não pode adicionar um valor padrão porque eles são valores gravados pelo usuário e não há suporte para uma relação de valor.

3. Você só poderá adicionar um valor padrão se o tipo de mapeamento for “Mapeador” ou “ValorDoCampo”.

Exemplo:

1. Defina o valor “incidente” como o Referência.

2. Na definição de Tarefa Assuma a propriedade responsável (responsável).

3. “type”: Atribua o tipo de associação como Valor do campo.

4. “key”: atribua o nome da propriedade no DevOps como assigned_to (Propriedades de DevOps).

5. “defaultValue”: atribua o defaultValue.

{
  "task": [
    {
      "reference": "incident",
      "definition": {
        "responsible": {
          "key": "assigned_to",
          "type": "FieldValue",
          "defaultValue": {
             "id": 222,
             "value": "id_usuario_devops"
          }
        }
      }
    }
  ]
}

Pesquisar Propriedade

A propriedade searchBy é OPCIONAL, é válido apenas para o tipo “FieldValue” e para o campo responsável.

Essa tag permite definir a propriedade pela qual a pesquisa do usuário será realizada nas plataformas ASMS e DevOps; a propriedade suportada é “Email” e, por padrão, pesquisará a propriedade “name” se a tag “searchBy” não for adicionada.

Caso de uso

Para o uso adequado da propriedade de busca “Email”, os usuários das duas plataformas devem ter o mesmo e-mail por usuário. A seguir está um exemplo de propriedade responsável com a opção de busca “E-mail”.

{
  "responsible": {
      "type": "FieldValue",
      "key": "assigned_to",
      "searchBy": [ "Email" ]
      }
}

Tipos de relacionamento ou associação de campos

Os tipos de associação a seguir determinam como os valores das propriedades do ticket serão obtidos.

⚐ Nota: Para os campos “assunto”, “Descrição”, “idByProject”, permite apenas o tipo de associação: Valor do campo

Exemplo de tipo Valor

1. Defina o valor “incidente” como o Referência.

2. Na definição de Tarefa Assuma a propriedade responsável (responsável) e atribua o tipo de associação como Valor.

{
  "task": [
    {
      "reference": "incident",
      "definition": {
        "responsible": {
          "type": "Value"
        }
      }
    }
  ]
}

3. A relação implica que um valor deve ser atribuído de forma comum para todos os Tarefas, isso é alcançado usando a propriedade “responsável”, conforme mostrado abaixo:

{
  "task": [
    {
      "reference": "incident",
      "definition": {
        "responsible": {
          "type": "Value"
        }
      }
    }
  ],
  "responsible": [
    {
      "reference": "",
      "id": 10
    }
  ]
}

4. Atribuir um valor à propriedade “responsável.reference”:

{
  "task": [
    {
      "reference": "incident",
      "definition": {
        "responsible": {
          "type": "Value"
        }
      }
    }
  ],
  "responsible": [
    {
      "reference": "incident",
      "id": 10
    }
  ]
}

⚐ Nota: O Tarefas associado ao “incidente de referência” e no ASMS, eles receberão a pessoa responsável com ID 10.***

Exemplo de tipo Mapeador

1. Defina o valor “incidente” como o Referência.

2. Na definição do Tarefa Assuma a propriedade responsável (responsável).

3. “type”: Atribua o tipo de associação como Mapeador.

4. “key”: atribua o nome da propriedade no DevOps como applicant_id_devops (Propriedades de DevOps).

{
  "task": [
    {
      "reference": "incident",
      "definition": {

        "responsible": {
          "type": "Mapper",
          "key": "applicant_id_devops"
        }
      }
    }
  ]
}

5. A relação implica que você deve associar o gerente de mesa Aranda (ASMS) aos gerentes DevOps, recomenda-se escrever o Id do requerente a ser relacionado, conforme mostrado abaixo:

{
  "task": [
    {
      "reference": "incident",
      "definition": {

        "responsible": {
          "type": "Mapper"
        }
      }
    }
  ],
  "responsible": [
    {
      "reference": "incident",
      "mapping": [
        {
          "id": 5,
          "value": "id_solicitante_devops"
        }
      ]
    }
  ]
}

⚐ Nota: A pessoa responsável com o Id “5” da tabela Aranda (ASMS) está relacionada à pessoa responsável “id_solicitante_devops” no DevOps***

Exemplo de tipo Valor do campo

1. Defina o valor “incidente” como o mesa.

2. Na definição do Tarefa Assuma Propriedade Responsável (responsável).

3. “type”: Atribua o tipo de associação como Valor do campo.

4. “key”: atribua o nome da propriedade no DevOps como applicant_id_devops (Propriedades de DevOps).

{
  "task": [
    {
      "reference": "incident",
      "definition": {
        "responsible": {
          "type": "FieldValue",
          "key": "applicant_id_devops"
        }
      }
    }
  ]
}    

↩ Voltar às configurações