Este tópico fornece orientações sobre como utilizar filtros nos atributos do tipo Relacionamento de Seleção Única disponíveis para todos os objetos do sistema, exceto eventos do módulo Workflow. Os atributos do tipo Relacionamento podem ser filtrados pelo campo Id ou pelo campo Caption. Para obter a lista de formatos dos campos Id e Caption, veja o tópico Apêndice 2: Formato de preenchimento dos atributos.
Para filtrar pelo Id, utilize o filtro:
{RMUrl}/api/objects/objeto?$filter=single_relationship/Id eq guid'id interno (guid)'
Para filtrar pelo Caption, utilize o filtro:
{RMUrl}/api/objects/objeto?$filter=single_relationship/Caption eq 'nome ou caminho do objeto'
Para exemplificar os filtros de atributos, considere um atributo do tipo Relacionamento de Seleção Única para uma pessoa associado a um ativo preenchido conforme o exemplo abaixo.
"relacionamentosimplespessoa":{"Id":"006f35-8468-11ec-9a6e-000d3a9d21b2"}
ou
"relacionamentosimplespessoa":{"Caption":"Alexandre Ferreira"}
EXEMPLOS:
Filtrar por atributos do tipo Relacionamento com Id "006f35-8468-11ec-9a6e-000d3a9d21b2":
{RMUrl}/api/Organization/assets?$filter=single_relationship/Id eq guid'006f35-8468-11ec-9a6e-000d3a9d21b2'
Filtrar por atributos do tipo Relacionamento com Caption igual a "Alexandre Ferreira'":
{RMUrl}/api/Organization/assets?$filter=single_relationship/Caption eq 'Alexandre Ferreira'
Filtrar por atributos do tipo Relacionamento que contenham o Caption "Alexandre":
{{RMUrl}/api/Organization/assets?$filter=substringof('Alexandre', single_relationship/Caption)