# @sap-ux/annotation-converter

Provides a way to convert a raw metadata document object into a convenient structure where path are resolved already for you.

The goal of this module is to provide an object that is ready to use and should cover most of the needs one can have when it comes to manipulating an odata service and its annotation.

All the object defined by this will be compatible with the @sap-ux/vocabularies-types providing an easy way to evaluate annotations.

## Installation
npm
`npm install --save-dev @sap-ux/annotation-converter`

yarn
`yarn add @sap-ux/annotation-converter --dev`

pnpm
`pnpm add @sap-ux/annotation-converter --dev`

## Usage

Import the `convert` method from the module

`import { convert } from '@sap-ux/annotation-converter';`

Use it on a raw metadata generated from `@sap-ux/edmx-parser` or complying to the same structure

```typescript
const myRawMetadata = ... 

const myConvertedMetadata = convert(myRawMetadata);
const isDraftEnabled = myConvertedMetadata.entityTypes[0].annotations.Common?.DraftRoot || myConvertedMetadata.entityTypes[0].annotations.Common?.DraftNode;
const myLabel = myConvertedMetadata.entityTypes[0].properties[0].annotations?.Common?.Text?.$target?.name // Property name of the text annotation if it exists
```

## Keywords
Annotation Converter