Skip to content

Commit b8ebfda

Browse files
author
HannahatBasisTech
authored
Images Added
1 parent cfa3516 commit b8ebfda

File tree

1 file changed

+14
-14
lines changed

1 file changed

+14
-14
lines changed

QuickStartGuide-NameTranslation.md

Lines changed: 14 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -8,37 +8,37 @@ Rosette for Excel is currently available for Windows OS only. The present beta r
88

99
Under **Downloads** click **RosetteForExcel.msi**
1010

11-
![](rosette-for-excel/Image1.png?raw=true)
11+
![](https://github.com/rosette-api-community/rosette-for-excel/blob/screenshots/Image1.png)
1212

1313
Once the .msi file downloads onto your machine, double-click to install. The installation is "per user” so no elevated permissions should be required.
1414

1515
Open Excel. You should see a new tab called **ROSETTE**, as well as a Rosette icon and menu in the **Formulas** tab:
1616

17-
! Image 2
17+
![](https://github.com/rosette-api-community/rosette-for-excel/blob/screenshots/Image2.png)
1818

1919
## Getting Started
2020
Before you can actually start using the plug-in, you’ll need an active Rosette API key. If you already have a Rosette developer account, you can enter your information using the dialog found in the **ROSETTE** tab.
2121

22-
! Image 3
22+
![](https://github.com/rosette-api-community/rosette-for-excel/blob/screenshots/Image3.png)
2323

2424
If you don’t already have a Rosette account, click the **Sign Up** button or head to developer.rosette.com to get your free Rosette API key (no credit card required).
2525

26-
! Image 4
26+
![](https://github.com/rosette-api-community/rosette-for-excel/blob/screenshots/Image4.png)
2727

2828
Once you’ve completed the signup and activation process, enter your key in the **API Key** dialog in the **ROSETTE** tab. Click the **Check Key** button to make sure your connection is working. If a green check appears, you’re good to go!
2929

30-
! Image 5
30+
![](https://github.com/rosette-api-community/rosette-for-excel/blob/screenshots/Image5.png)
3131

3232
## Translating Names
3333
The Rosette for Excel plugin supports a wide range of features using formulas and ribbon functions. In this guide we’ll look at both applied to a quick name translation use-case.
3434
### Technique 1: Formulas
3535
Say I have a list of Japanese names written in Kana and Kanji characters that I would like to translate into English. In this case they happen to be Japanese baseball players. Perhaps I work in baseball recruiting and I’ve found a list of the top-mentioned Japanese baseball players on social media. I’d like to know the players’ names in English. In my Excel sheet I’ve made two new columns to hold the English translations of the players’ first and last names (though Rosette also supports combined first/last name translations as well as locations and organizations).
3636

37-
! Image 6
37+
![](https://github.com/rosette-api-community/rosette-for-excel/blob/screenshots/Image6.png)
3838

3939
In the first cell where I’d like to have a translation, I select **Translate Names** from the Rosette drop down menu in the **Formulas** tab. A dialog box appears with several options, or parameters.
4040

41-
! Image 7
41+
![](https://github.com/rosette-api-community/rosette-for-excel/blob/screenshots/Image7.png)
4242

4343
A few important things to know about the parameters:
4444
1. `Name`: The cell that contains the name you’re trying to translate. If your name is part of a larger string of words, you’ll need to use the entity extraction ribbon function to pull out the names individually first, or your results won’t be accurate (see the second half of this guide).
@@ -54,36 +54,36 @@ Note: Parameters can also be set using cell data. If you regularly process lists
5454

5555
Once you’ve set the appropriate parameters, click **OK**, and the translated name will appear in the selected cell. If you get a `#VALUE!` error, check your language codes and script abbreviations.
5656

57-
! Image 8
57+
![](https://github.com/rosette-api-community/rosette-for-excel/blob/screenshots/Image8.png)
5858

5959
If you’d like to apply the same settings to a whole list of names, select the cell with the formula and drag down, just as you would with a mathematical Excel formula. The translated names will appear in the cells as you go.
6060

61-
! Image 9
61+
![](https://github.com/rosette-api-community/rosette-for-excel/blob/screenshots/Image9.png)
6262

6363
### Technique 2: Ribbon Functions
6464
Say instead of having a list of names, I have an Excel sheet populated with sentences (think newspaper headlines or short biographies) about Japanese baseball players. I want to know which players are being discussed, but in order to translate their names I first need to extract them.
6565

6666
In my sheet, I select the cells that contain the relevant text. In the **ROSETTE** tab I click the **Extract Entities** icon in the ribbon and hit the **Go** button. A status bar will appear on the right hand side to show Rosette’s progress. When it finishes, you’ll see an option to open your results, which will appear in a new sheet.
6767

68-
! Image 10
68+
![](https://github.com/rosette-api-community/rosette-for-excel/blob/screenshots/Image10.png)
6969

7070
In the results sheet I can see the extracted entities and their type. In this case let’s say I’m interested in the locations and organizations mentioned in the text in addition to the names.
7171

7272
First, I’ll sort the sheet by “Entity Type.”
7373

74-
! Image 11
74+
![](https://github.com/rosette-api-community/rosette-for-excel/blob/screenshots/Image11.png)
7575

7676
Then, I’ll feed the `PERSON`, `LOCATION`, and `ORGANIZATION` entities into the **Translate Names** function.
7777

78-
! Image 12
78+
![](https://github.com/rosette-api-community/rosette-for-excel/blob/screenshots/Image12.png)
7979

8080
Again, I’ll see my results in a new sheet.
8181

82-
! Image 13
82+
![](https://github.com/rosette-api-community/rosette-for-excel/blob/screenshots/Image13.png)
8383

8484
If I wanted, I could copy and paste the column of translated names back over to my extracted entities sheet, which would also link me back to my original sentences. I could also use a formula instead of a ribbon function to produce the same effect. Below, I’ve added a column to my extracted entities sheet, and run the **Translate Names** formula on the extracted entities.
8585

86-
! Image 14
86+
![](https://github.com/rosette-api-community/rosette-for-excel/blob/screenshots/Image14.png)
8787

8888
Baseball players aren’t the only names you might want to translate. If your business operates in multiple countries, with sales representatives using different languages and scripts to track leads and opportunities, imagine running this process on your SalesForce records. You could also use Rosette to analyze reviews or comments submitted by visitors to your website from around the world.
8989
## Next Steps

0 commit comments

Comments
 (0)