# Configuration

The '*Data pipelines*' menu allows an admin of the **Exivity** solution to manage **USE** '*Extractors*'. **USE** has its own language reference, which is fully covered in a separate chapter of this documentation.

As described in the [USE documentation](https://olddocs.exivity.io/3.5.4/data-pipelines/extract/..#introduction), you are free to use your editor of choice to create and modify **USE Extractors**. However, the GUI also comes with a built-in **USE Extractor**-editor.

## Creating Extractors

To create a new **USE Extractor**, follow these steps:

![](https://2905039365-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LHEKskLK6aXinV75Knl%2F-LbTAhV6CPJ-5g8VZg6L%2F-LbTNsoNMcAfu63uWcNb%2FcreateExtractor.gif?alt=media\&token=a3514281-96b1-4053-bd75-8e4ac093f52d)

1. From the menu on the left, select "*Data  pipelines*" > '*Extractors*'
2. To create a new **USE Extractor** where you want pull usage or lookup data from, click the '*Add Extractors*' button
3. When your Exivity instance has access to the Internet, it will pull in the latest set of *Extraction Templates* from our [Github](https://github.com/exivity/templates) account. These templates are then presented to you, and you can pick one from the list to start Extracting. If you don't have access to the internet, you can download them directly from Github. You are also free to start creating your own Extractor from scratch.
4. Provide a meaningful name for your **USE Extractor**. In the above example we're creating an **USE Extractor** for VMware vCenter 6.5 and higher. Therefore we call this **USE Extractor** : '*vCenter 6.5*'
5. When you're done creating your **USE Extractor**, click the '*Insert*' at the bottom of the screen

## Edit and Delete Extractors

When you want to change or delete an existing **USE Extractor**, first select one from the list of **USE Extractors** that you want to change:

1. **After** you select your **USE Extractor**, you can change its variable values at the '*Variables*' tab.
2. At the "Editor" tab you can make more advanced changes or delete the original **USE**-script. Such as:
   * changing existing API calls
   * changing csv output format

{% hint style="info" %}
Don't forget to save any changes with the "SAVE" button.
{% endhint %}

## Run and Schedule Extractors

To test your **USE Extractor**, you can execute or schedule it directly from the **Glass** interface:

![Run USE Extractors](https://2905039365-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LHEKskLK6aXinV75Knl%2F-LHF0G1lYWN8xZtENgii%2F-LHF0O7AkOKwS42uycJP%2Frun_extractor.gif?generation=1531424644094667\&alt=media)

1. After you have selected the **USE Extractor** that you would like to run, click to the '*Run*' tab next to the '*Editor*' tab
2. Most **Extractors** require one or more parameters, usually in a date format such as *20171231*. In  this example, the **USE Extractor** requires two parameters: a *from* and *to* date
3. When you've provided the required run parameters, click '*Run Now*' to execute the **USE Extractor**. After the **USE Extractor** has completed running, you will receive some success or failed message, after which you might need to make additional changes to your **USE Extractor**
4. Once you're happy with your output, you can schedule the **USE Extractor** via the '*Schedule*' tab, which is located next to the '*Run*' tab at the top of the screen.
5. **USE Extractors** can be scheduled to run once a day at a specific time. Also you should provide a **from** and (optionally) **to** date, which are provided by using an offset value. For example, if you want to use the day before yesterday as a **from** date, you should use the down pointing arrows on the right, to select a value of *-2*. If the **to** date should always correspond with yesterdays date, you should provide a value there of *-1*.
6. If your **Use Extractor** requires additional parameters, you may provide these as well in the '*Schedule with these arguments*' text field.
7. When you're done with the schedule configuration, you may click the '*Schedule*' button. In case you want to change or remove this schedule afterwards, click the '*Unschedule*' button.

{% hint style="warning" %}
As of version 1.6, it is recommend to use the **Workflow** function instead of the Extractor schedule
{% endhint %}