| HTML |
|---|
<div id="google_translate_element"></div>
<script type="text/javascript">
function googleTranslateElementInit() {
new google.translate.TranslateElement({pageLanguage: 'en'}, 'google_translate_element');
}
</script>
<script type="text/javascript" src="//translate.google.com/translate_a/element.js?cb=googleTranslateElementInit"></script> |
Simple Upload / Import from CSV
The Upload / Import from CSV tool is used if you have a simple .csv file with IP block information, such as CIDR, Maskmask, ASN, RIR, etc. It It is accessed from the from the Data Import Tab from the Admin section of ProVisionTab from the Admin section.
To import your IP block information, follow the following steps:
...
Common normalization steps required for ProVision IP imports include:
- Remove any empty rows in the data range
- Remove any empty columns in the data range
- Remove stray data from inside and outside the data range, such as:
- notes, comments, and placeholder text as field values, when not set as their own data column
- nested secondary information located in additional rows under a primary record
- Ensure proper data formatting
- Check for data formatting errors - a common issue is leading zeros being dropped from a ZIP field when a file is opened. Re-specify format as needed.
- Ensure each field has consistent formatting for values
Note title Data Encoding Format To ensure correct importing of any special characters, make sure to use UTF-8 encoding for your CSV file!
...
| Note | ||
|---|---|---|
| ||
For IP Import from .csv, the following fields are REQUIRED:
All other fields are optional. |
...
Step 1: Create a new IP Import Job
Navigate to the Data Import Tab from the Admin Import Tab from the Admin button. Select "Upload / Import from CSV" under "IP Import".
Create a Job Name and Description for the import. This is especially useful to keep track of progress in cases the data arrives from multiple sources, or will require multiple stages of manual review.
Select the .csv file that you prepared above by selecting the "Choose File" button, and browsing to the correct file location. Then hit "Start Import".
| Note | ||
|---|---|---|
| ||
Although you cannot add new files to an existing job, for jobs with multiple sources for data (which may have different formatting), you can simply create separate jobs and descriptions for each source - no need to manually combine the data into one file before importing. The Import tool's mapping and editing functions will allow for the data to be reconciled in ProVision. For large data sets where multiple stages of manual review might be needed, you can create a new job using the same set of data files in order to work in parallel on a different portion of the data. |
...
After importing, the new job will appear under the "Existing Jobs" section. To continue working with this job, select it from the list (by clicking on the linkjob name) and the next step will appear on the page.
Step 2: Define Columns
Using the dropdown menu above each data field, select the appropriate definition for each of the imported columns.
- CIDR or IP/Maskmask fields must be provided
- Notes, Tags, and Regions may have multiple columns associated with the data.
- If you do not have a defined RIR column, you must select a default RIR to associated the blocks to.
Other columns which do not apply under the available definitions should be left as blank, and will be skipped during the upload process.
Make sure that you have defined all desired fields by using the scroll bar below your data to view additional columns.
When completed, hit "Next".
...
| Tip | ||
|---|---|---|
| ||
If your .csv has a header row as the first line, that row may give information that produces a missing reference notice - such as "Tag", "Region", "Block", and so forth. If this is the case, simply uncheck that item and add only the desired references. |
In this example, we get a notification that we are missing a tag named "Tags". However, we know by looking at our data that is simply an item that was part of the header line in the .csv, so we want to bypass this step.
...
If warnings or invalid entries are found, you may edit the data by clicking the "Edit" button.
Here you can edit the invalid field, or add /change information for any other available field.
After editing, hit "Save". If the edits are valid, the background color for the data row will be white.
Continue reviewing and editing data as desired. When done, proceed to Step 4.
Step 4: Execute Import
When the review step is completed, hit the "Execute Import" button. A progress bar will appear to show progress and note errors if they occur.
When the bar reaches 100%, the import is complete. The Data Review section will show which data rows were successfully imported.
Post Import Followup
...
If the IP Import was fully successful, and you do not wish to retain the job data, the Import Job may be deleted from the "Existing Jobs" list by clicking the delete icon button next to the job name.
| Warning |
|---|
Deleting an import job is permanent and non-recoverable! When working with large or sensitive import jobs, consider performing a backup of your instance before and after the import job as a safeguard. |
...